Priorités de Développement - Aaperture

Source de vérité : Ce document est la référence principale pour les priorités de développement. Point d’entrée vers les plans : ROADMAP.md. Pour une vue détaillée par domaine fonctionnel, consultez PLAN_AMELIORATIONS_CRM.md.

Ce document liste les priorités de développement basées sur l'analyse de la documentation et l'état actuel du projet.

Dernière mise à jour : 2026-09-05 — Vague C cleanup (voir APP_CLEANUP_MAP.md) :

Produit commercial Proposal DELETED (FE/BE + Liquibase 0277)
Day-planner client proposals KEEP ; GC R2 proposal-covers/ / proposal-defaults/ optionnel
Progression / recommendations deleted (Vague A)
Billing = export CSV (Pennylane in-app retiré)
SMS deferred (UI hidden ; provider backlog)
Friends KEEP + port mobile backlog (aaperture-mobile / /mobile/network)
Gmail plugin FREEZE — scope à part / plus tard (ne pas ouvrir dans les MRs cleanup ; plan dédié)

Nouveau chantier lancé

Galleries library / session decoupling : démarrage du refactor pour sortir les galeries du simple contexte session, ajouter une vraie page owner /galleries, permettre des galeries non assignées, et réduire l’onglet session à une surface contextuelle. Source active : GALLERIES_LIBRARY_PLAN.md.
Gallery sharing / recipient delivery : préparation du chantier pour partager des galeries à des destinataires nommés, ajouter un vrai panier de téléchargement côté galerie, et notifier le photographe lors des téléchargements. Source active : GALLERIES_SHARING_PLAN.md.

🎯 Prochaines étapes recommandées

Priorité	Sujet	Où
Haute	Billing / export comptable CSV – export-first (Pennylane in-app done/deleted)	`ACCOUNTING_EXPORT_GUIDE.md`
⏸️ Pause	Storage abstraction + migration Scaleway – abstraction livrée, migration en pause (on reste sur R2)	§ Priorité Haute > Storage abstraction / Scaleway
Haute	Relances automatiques – devis/factures/sessions réellement fiables via workflows	§ Prochain focus recommandé
Moyenne	Friends → mobile – port UX réseau vers `aaperture-mobile` (`/mobile/network*`)	`INVITATIONS_FRIENDS_IMPROVEMENTS.md`
Moyenne	Portail client V2 – documents enrichis	§ Priorité Moyenne > Portail client V2
Moyenne	Analytics business – conversion, revenus, lecture business	§ Priorité Moyenne > Analytics business
Moyenne	Iris proactive V1 – signaux contextualisés (pas le bloc Cmd+K recommendations, deleted)	§ Priorité Moyenne > Iris proactive V1
Basse	SMS provider – deferred ; UI hidden	backlog
—	Gmail plugin	FREEZE — scope à part / plus tard
—	Proposal product	DELETED (FE/BE + DB `0277`) — day-planner client proposals KEEP; R2 GC later — `APP_CLEANUP_MAP.md` Vague C

🚀 Priorité plateforme immédiate

Le socle staging + SOPS + promotion prod est maintenant validé.
Avant de relancer un gros lot produit, les priorités opérationnelles sont :

Garder staging comme vraie porte de validation
- smoke test sur tout lot significatif
- tenant / booking / portal / lead forms / OAuth / storage provider / Sentry / backups
Réduire la dérive entre local, staging et production
- garder les fichiers infra/env/*.env.enc comme source de vérité
- éviter le retour de variables runtime app dans GitLab
Optimisation pipeline / build
- mesurer les temps réels
- optimiser ensuite les builds Docker / cache uniquement si nécessaire
Perception publique
- derniers loaders/flickers publics hors booking
- QA visuelle emails transactionnels sur vrais envois

✅ Focus soldés récemment

Proposal product (commercial /proposal + builder + upsells) : DELETED (FE/BE + Liquibase 0277) — soldé / retiré du produit ; day-planner client proposals KEEP ; writes R2 proposal-* denied (GC optionnel). Voir APP_CLEANUP_MAP.md Vague C.
Aaperture Companion desktop auth handoff: public client contract with Authorization Code + PKCE, strict loopback redirect validation, Redis-backed short-lived requests and one-time codes, token exchange, minimal profile endpoint, OpenAPI generation, and interruption/abuse tests. The web login now preserves the request through email and Google authentication, supports an already authenticated browser, approves the request and returns to the desktop loopback callback. The remaining integration step is the Electron-side listener, token exchange and secure storage.
Galeries / slideshow (socle livraison) : qualité d’export persistée et normalisée pour le rendu MP4 sur la file dédiée gallery-slideshow, editor timeline aligné avec la persistance (dont durée de cover), pages galerie publique et portail client réutilisant les mêmes primitives de présentation que l’owner ; règles ESLint documentées dans docs/AGENTS_FRONTEND.md et docs/AGENTS_BACKEND.md pour éviter les régressions CI.
Workspaces & surfaces produit - passe transverse de cohérence : harmonisation large des vues quote, invoice, contract, organization, user, contact, session, des listes denses, des settings, des écrans admin/system, du calendrier, du portail client, des surfaces publiques et des workspaces secondaires. Le lot sort du focus immédiat sauf régression UI concrète ou écran resté manifestement en dehors du contrat commun.
Lead forms - fiabilité de réception et conversion : durcissement de la création automatique de contact depuis une soumission, action manuelle “créer un contact” depuis la liste des soumissions, matching UI amélioré après refresh, et migration SQL guest_count corrigée.
Lead forms - intégration publique : embed iframe simplifié en version sans script, hauteur fixe documentée, et clarification du comportement d’email côté propriétaire / auto-réponse.
Emails transactionnels : correctifs de rendu de signature HTML, sanitation, dépendances Nest (UserEmailSenderService, StorageService, HtmlSanitizerService) et stabilité du build TypeScript backend.
Documentation active : recentrage sur docs/README.md, docs/PRIORITES.md et docs/ROADMAP.md comme points d’entrée, avec nettoyage des priorités devenues non urgentes.
Booking public : réduction du range chargé, suppression de la dépendance Google Calendar dans l’availability publique, vue hebdomadaire, empty states dédiés et confirmation réalignée avec la page studio.
CRM pipeline workspace : route dédiée /pipeline, vraie page lead /pipeline/$leadId, suppression du flux detail legacy, vues système métier, quick actions, sélection multiple légère, refacto massif frontend et meilleure cohérence visuelle badges/filtres/table.
CRM pipeline - stabilisation de la liste : la liste principale du pipeline a été réalignée sur le shell commun des autres pages (ListPageContent), avec scroll interne du tableau, tri sur les colonnes principales et bulk actions reconnectées. Le prochain incrément CRM n’est plus un sujet structurel de table, mais la page lead dédiée et les flows métier qu’elle porte.
Assistant CRM / chat workspace : Iris devient le nom produit du chat, shell unifié sidebar/window/mobile/fullscreen, contexte unifié, mémoire courte métier, résultats d’action plus prescriptifs, formulaires inline mieux préremplis, et rendu conversationnel largement nettoyé.
Messages / inbox workspace : page messages, liste de conversations, threads, panneau fichiers et création de conversation harmonisés pour former un vrai workspace quotidien cohérent au lieu d’un assemblage de sous-écrans hétérogènes.
Modales create/edit (lot formellement refermé) : pattern FormEntityModal étendu sur quotes, invoices, contracts, organizations, user session types, user providers, rates, payment plans et task types, avec fermeture locale, formulaires compatibles modal-first, duplication locale quand utile (rates, payment plans) et rendu modal harmonisé sans cadres internes parasites. Le lot sort du focus prioritaire et ne revient plus qu’au fil des écrans secondaires restants.
Fiches contact / session (polish UX) : harmonisation des headers de tabs et sous-sections, overview transformés en hubs plus utiles, timeline et blocs financiers plus lisibles, sidebar session densifiée, bloc équipe / documents améliorés, sticky tabs mobile et hiérarchie visuelle mieux alignée entre contact et session. Le sujet sort du focus immédiat sauf régression UI concrète.

🎯 Prochain focus recommandé

Le réalignement 2026 change l’ordre des chantiers actifs. Le meilleur enchaînement recommandé devient :

Billing / export CSV : already export-first post Vague A; deepen export UX / fiscal packaging as needed (ACCOUNTING_EXPORT_GUIDE.md).
Storage abstraction / Scaleway : ⏸️ en pause (2026-10-23) : on reste sur R2 ; abstraction StorageProvider livrée.
Relances automatiques : fiabiliser les relances devis/factures et rappels session via workflows + BullMQ.
Friends → aaperture-mobile : port UX via /mobile/network* (KEEP web).

Soldé / deleted : produit commercial Proposal (/proposal, builder, upsell dynamique dédié, ADDON quote lines) — retiré FE/BE/DB (0277) ; ne plus prioriser. Day-planner proposals KEEP.

🧹 Prochain nettoyage recommandé

Vague D (orphan schema) : done — Liquibase 0278
Suite : Galleries F002 (orchestration slideshow), R2 GC Proposal — APP_CLEANUP_MAP.md

Assistant CRM / chat workspace

Le chat Iris n’est plus à traiter comme un simple panneau utilitaire. Il devient un espace de travail CRM transversal.

Objectifs du lot:

unifier les variantes sidebar, window, mobile et fullscreen autour d’un shell commun,
rendre la conversation lisible comme un vrai chat produit,
traiter les pièces jointes, formulaires inline et résultats d’actions comme des objets conversationnels cohérents,
clarifier la hiérarchie historique / contexte / action,
fiabiliser l’upload de fichiers sans dégrader le flux principal par URL signée.

Prochains incréments recommandés:

finir les scénarios E2E critiques (message + pièce jointe + action, contextes métier, formulaires inline),
consolider les actions métier depuis les résultats assistant vers le pipeline/CRM,
continuer le durcissement runtime/lint/types sur les derniers flux agent,
documenter explicitement la stratégie presigned upload principal + fallback backend de sécurité.

Le booking public sort du focus prioritaire immédiat sauf :

incident de performance réel
bug de disponibilité
régression visible sur les états vides ou la confirmation

Gouvernance documentaire

Objectif: garder une documentation rapide à parcourir, non contradictoire, et exploitable en production.
Décisions:
- docs/README.md devient l'index court des docs actives.
- une source de vérité par sujet; les duplicats deviennent des pointeurs.
- les documents obsolètes sont supprimés de docs/ (détail dans git).
Outillage agent local:
- .agents/frontend-performance/SKILL.md
- .agents/docs-performance/SKILL.md

✅ Complété Récemment

Proposal default cover (upload) + page Proposal defaults + settings API - 100% complété (2026-02-28)
- ✅ Cover par défaut en fichier : l’image de cover par défaut des proposals n’est plus une URL saisie à la main mais un fichier uploadé (presigned URL → PUT R2, clé proposal-defaults/{userId}/...).
- ✅ Backend : colonne proposal_default_cover_image_key (migration 0192), GET me/settings renvoie une URL signée calculée à partir de la clé, DTO user settings accepte null pour tous les champs optionnels (évite 400 sur sauvegarde).
- ✅ Stockage : StorageAccessService autorise upload/lecture pour proposal-defaults/{userId}/... (utilisateur = propriétaire du dossier).
- ✅ Frontend : page dédiée /settings/proposal-defaults avec zone d’upload (glisser-déposer, aperçu, suppression), lien depuis le builder proposal ; entrée menu « Proposal defaults » ; types OpenAPI régénérés.
- Documentation : backend/src/storage/README.md (règles d’accès proposal-defaults, clés métier et lecture).
Tests E2E auth + Agent helpers + doc DI - 100% complété (2026-02-27)
- ✅ E2E auth smoke : frontend/e2e/auth.smoke.spec.ts – parcours login UI (email → mot de passe → dashboard), requiert E2E_EMAIL / E2E_PASSWORD
- ✅ Tests unitaires Agent : ActionHelpers (validateRequiredParams, replacePlaceholders, extractEntityId, buildContextFromResults + actionResult, 14 tests), EntitySearchHelper.searchContactByName (4 tests)
- ✅ Documentation : docs/DI_CONVENTIONS.md – conventions DI NestJS, Core Modules, tests
Messagerie – Recherche plein-texte + présence + portail client - 100% complété (2026-02-28)
- ✅ Recherche plein-texte (app) : debounce 300 ms, appels client-messages et friend-messages search à partir de 2 caractères, fusion des résultats, snippets avec surlignage (reste gris, match blanc gras), bouton croix pour vider la recherche, scroll au message trouvé à l’ouverture
- ✅ Ping présence : envoi d’un Client.Ping toutes les 60 s depuis useGlobalMessages lorsque le socket est connecté (mise à jour last_seen_at)
- ✅ Portail client : bouton croix sur le champ recherche, surlignage du terme dans le nom du photographe et l’aperçu du dernier message (ConversationsPanel, ConversationItem)
- Documentation : PLAN_AMELIORATIONS_CRM.md (messagerie / CRM)
Notifications Invitations & Amis + UX Portail client + Skeleton loaders - 100% complété (2026-02-26)
- ✅ Notifications in-app + email : invitation acceptée (parrain), demande d'ami reçue (destinataire), demande d'ami acceptée (expéditeur) — FR/EN selon locale, liens vers /invitations et /friends
- ✅ Portail client (fiche contact) : fallback statut compte par email si pas de lien client_account_contacts, bloc « Aucune adresse email » avec bouton « Modifier le contact », rafraîchissement statut (staleTime 0, refetch on focus)
- ✅ Skeleton loaders : ListPageSkeleton pour listes contacts et sessions (useSkeletonWhenLoading), DashboardPageSkeleton pour chargement initial du dashboard
- Documentation : docs/INVITATIONS_FRIENDS_IMPROVEMENTS.md, docs/FRONTEND_NEXT_STEPS.md
Proposal v2/v3 + add-ons par SessionType (socle + builder dédié + email proposal + UX publique premium) - 98% complété (2026-03-13)
- ✅ Tarifs add-ons : user_rates enrichi (is_addon, is_active, addon_*) + endpoint GET /api/user-rates/addons-catalog
- ✅ Devis add-ons traçables : quote_items.item_type = ADDON, provenance line_origin, line_metadata, user_rate_id
- ✅ Proposal public par token dédié : endpoints publics /api/public/proposals/:token (read/selection/apply/accept)
- ✅ Builder API v3 : /upsells, /link, /builder, /presentation, /preview-email, /send-email
- ✅ Traçabilité : quote_revisions + patch add-ons UPSSELL uniquement
- ✅ OpenAPI : schemas/paths proposals + types générés backend/frontend alignés
- ✅ Frontend public premium : /proposal/:token|slug, navigation immersive, auto-update/auto-apply, invitation finale
- ✅ Builder dédié : /quotes/:quoteId/proposal (slug/token, cover dropzone, validité du lien, email proposal, read-only si devis accepté)
- ✅ Custom proposal items : support builder/public/apply au devis
- ✅ Story defaults Proposal : defaults user settings (titre + texte) + préremplissage builder (migration 0190)
- ✅ Correctifs clés : emails Proposal slug-first, access read-only public après acceptation, fallback contract_template_id depuis SessionType en édition de devis, fixes de calculs/UX Review
- ✅ Garde métier : proposal en lecture seule (read-only) après acceptation, builder bloqué si devis non prêt
- ✅ Tests backend read-only : proposals.controller.spec – putPresentation, putUpsells, createLink rejettent avec UnauthorizedException quand le devis est accepté (2026-02-27)
- ✅ QA UX : loading/error/empty states, responsive mobile/desktop, alignements, wording (ProposalBuilderPage, PublicProposalPage, ProposalUpsellsPanel) (2026-02-27)
- ✅ Share & Send finalisé : génération automatique de lien, sauvegarde du slug avant envoi, état du lien clarifié (active, expired, read-only) et blocage explicite si le lien n’est pas envoyable
- 🔎 Reste léger : suivi post-cut, QA opportuniste et E2E complémentaire seulement si besoin
- Documentation : produit DELETED — voir APP_CLEANUP_MAP.md Vague C (plan Proposal retiré)
Chat agent - Stabilisation post-refonte - 100% complété (2026-02-08)
- ✅ Suppression complète du streaming front/back (pipeline unique request/response)
- ✅ Renommage d’état UI en isProcessing
- ✅ Affichage à chaud des formulaires sans refresh (cache/déduplication corrigés)
- ✅ Préremplissage formulaires unifié (action.parameters + requestInfo.initialValues)
- ✅ Format unique des retours d’action via metadata.actionResult
- ✅ Rendu UI harmonisé succès/erreur/warning
- ✅ Tests ciblés backend/frontend pour contrat actionResult et prefill
Messagerie & fichiers conversation (app + portail + contacts) - 100% complété (2026-02-04)
- ✅ UI unifiée : ClientThreadView partagé entre app, portail client et onglet communications
- ✅ Previews sécurisées : URLs signées + cache, modal plein écran pour images
- ✅ Uploads résilients : presigned URL + fallback backend côté portail (CORS)
- ✅ Temps réel : événement WebSocket commun pour messages + fichiers (refresh conversations + fichiers)
- ✅ UX : loaders de conversation, scroll interne (pas de scroll page)
Messagerie globale (app + portail) + notifications différées - 100% complété (2026-01-31)
- ✅ Routes agnostiques : endpoints app en /client-messages/app/* (alias legacy conservé)
- ✅ Vue globale messages : liste contacts + amis, tri par dernier message, pastilles non‑lus, gestion présence légère
- ✅ Actions : suppression conversation, accès profil, message “compte client non créé”
- ✅ Email différé si non‑lu : 1er message non‑lu programmé (30 min), annulation si lu
- ✅ Settings utilisateur : opt‑in/out des emails de notifications messages via sidebar
- ✅ Invitations client sans compte : envoi d’un email d’invitation avec extrait du message
- Fichiers clés : client-messages backend + templates email, MessagesPage + sidebar settings, hooks messages app/portail
Revue complète Portail Client - Phases 3, 4, 5 (i18n, UX, robustesse) - 100% complété (2026-01-31)
- ✅ i18n : suppression des chaînes françaises hardcodées dans la messagerie ("fr-FR", "Hier", "Vous: "), locale dynamique, defaultValues EN
- ✅ Clés de traduction : ajout galleries, profile, logout (nav), yesterday, you, markReadError (messages), downloadError, fileTooLarge (files), sendError (contacts)
- ✅ Toasts d'erreur : envoi message client, markAsRead, envoi message photographe
- ✅ Validation upload : limite 10 MB côté frontend avec toast d'erreur
- ✅ Fix download : clé uploadError → downloadError dans ClientPortalFilesPage
- ✅ UX responsive : hauteur messages h-[600px] → h-[calc(100vh-12rem)] min-h-[500px]
- ✅ Badge ContactCard : "Invitation en attente" ajouté dans la liste contacts (même pattern que ContactHero)
- Fichiers clés : ClientPortalMessagesPage, ClientPortalFilesPage, ContactCard, ContactClientMessagesSection, ClientPortalLayout, traductions EN/FR
Harmonisation Portail Client ↔ Accès Client (UI + fonctionnalités) - 100% complété (2026-01-31)
- ✅ Navigation & Header unifiés : structure, logo, tokens background/foreground
- ✅ Heading accueil : “Votre espace sécurisé” + “Bienvenue, {{name}}” sur /portal/dashboard et /client
- ✅ Retrait du nom dans le header : “Bienvenue, {{name}}” conservé en heading, pas dans le header global
- ✅ Galeries côté portail :
  - Route /portal/galleries
  - Page dédiée + navigation + compteur dans dashboard
  - Galerie disponible dans ClientPortalSessionViewPage
- ✅ Paiement par virement côté portail :
  - Bloc virement dans /portal/documents (onglet factures + section factures)
  - Affichage même sans IBAN (message “infos bancaires manquantes”)
  - Bloc virement ajouté dans la vue séance
- ✅ Données API :
  - ClientProject.galleryUrl/galleryPassword
  - ClientDocuments.invoices[].bankDetails
- Fichiers clés :
  - Backend : backend/src/client-accounts/*, openapi/components/client-auth.yaml
  - Frontend : ClientPortalLayout, ClientAccessPage, ClientPortalDocumentsPage, ClientPortalSessionViewPage, ClientPortalGalleriesPage, ClientPortalDashboardPage
Système d'Authentification Client - Phases 1→5 - 100% complété (2026-01-30)
- ✅ Phase 1 - MVP Authentification :
  - Migration DB (0161) : 7 tables créées
  - Backend : modules client-auth, client-accounts
  - Frontend : auth pages, dashboard, layout
  - OpenAPI : schemas et paths complets
  - i18n : traductions FR/EN
- ✅ Phase 2 - Expérience Client :
  - ClientPortalSessionsPage : liste avec filtres, recherche, groupement
  - ClientPortalSessionViewPage : détail avec timeline et documents
  - ClientPortalDocumentsPage : vue unifiée devis/factures/contrats
  - Navigation simplifiée (Dashboard, Séances, Documents)
- ✅ Phase 3 - Messagerie :
  - Migration DB (0162) : table client_messages
  - Backend : module client-messages avec CRUD complet
  - Endpoints photographe dans contacts.controller.ts
  - Frontend : ClientPortalMessagesPage avec conversations et fil de discussion
  - Hooks TanStack Query pour messages en temps réel
  - OpenAPI : schemas et paths pour messagerie
- ✅ Phase 4 - Fichiers & Préférences :
  - ClientPortalFilesPage : upload, download, suppression, vue responsive
  - ClientPortalSettingsPage : profil, sécurité, notifications, thème, suppression compte
  - Préférences client persistées et appliquées (thème, timezone)
- ✅ Phase 5 - Côté Photographe :
  - Invitations portail client (création, statut, relances)
  - Validation token côté portail + re‑invitation qui invalide l'ancien token
- Routes : /portal/login, /portal/dashboard, /portal/sessions, /portal/documents, /portal/messages, /portal/files, /portal/settings
- Phases restantes : aucune
- Documentation : docs/CLIENT_AUTHENTICATION_PLAN.md - Journal d'implémentation complet
Notifications automatiques de session - Partiellement implémenté, flux à fiabiliser
- ✅ Settings utilisateur : configuration dans user_metadata.session_reminder_settings
- ✅ UI/settings : réglages exposés dans la sidebar session
- ✅ Moteur v2 : les workflows utilisent workflow_tasks, workflow_task_actions, session_workflow_task_runs
- ⚠️ Trou fonctionnel actuel : les rappels 1 semaine / 24h / 1h ne sont pas générés automatiquement pour les nouvelles sessions
- ⚠️ Ancienne documentation : l’ancien document sur les notifications de session était basé sur des tables supprimées en 0173 et ne reflète plus le runtime réel
- Source de vérité actuelle : docs/WORKFLOWS_ARCHITECTURE.md
Settings contextuels avec Sidebar - Partiellement complété (2026-01-29)
- ✅ Intégration des panneaux de settings directement dans les vues User
- ✅ UserSettingsSidebarContent avec tabs Profile, Subscription, Permissions
- ❌ AdminPanelPage : Sidebar retirée (2026-01-29) - La page Admin est déjà une page de configuration, les tabs restent inline
- ✅ Pattern uniforme avec ContextualSettingsSidebar réutilisable
- ✅ Bouton Settings (icône roue crantée) dans les headers :
  - Bouton icon-only (size="icon") avec variant outline
  - Icône Settings de lucide-react positionnée dans le header à droite
  - Texte sr-only pour l'accessibilité
  - Pattern uniforme appliqué sur InsightsPage, UserViewPage
- ✅ Footer fixe avec actions (Cancel/Save) dans les panneaux
- ✅ SessionViewPage : Sidebar complétée (type de session, notifications)
- ✅ OrganizationViewPage : Sidebar complétée (membres, ressources partagées)
- ✅ DashboardPage : Sidebar complétée (widgets, rafraîchissement)
- Fichiers créés/modifiés :
  - Frontend :
    - frontend/src/pages/users/UserViewPage/components/UserSettingsSidebarContent.tsx (CREATED)
    - frontend/src/pages/sessions/SessionViewPage/components/SessionSettingsSidebarContent.tsx (CREATED)
    - frontend/src/pages/organizations/OrganizationViewPage/components/OrganizationSettingsSidebarContent.tsx (CREATED)
    - frontend/src/pages/dashboard/DashboardPage/components/DashboardSettingsSidebarContent.tsx (CREATED)
  - Modifications :
    - UserViewPage.tsx (bouton Settings + sidebar)
    - SessionViewPage.tsx (bouton Settings dans SessionHero + sidebar)
    - OrganizationViewPage.tsx (bouton Settings dans headerActions + sidebar, tabs members/resources déplacés dans sidebar)
    - DashboardPage.tsx (bouton Settings dans header + sidebar)
    - AdminPanelPage.tsx (tabs inline restaurés, sidebar retirée)
- Documentation : docs/FRONTEND_IMPROVEMENT_PLAN.md, docs/PLAN_AMELIORATIONS_CRM.md, docs/AGENTS_FRONTEND.md
Améliorations UI/UX pour Insights - 100% complété (2026-01-28)
- ✅ Graphiques et visualisations (barres et camemberts pour sévérité/statut)
- ✅ Vue calendrier avec navigation mensuelle
- ✅ Groupement intelligent (par type, entité, ou date)
- ✅ Actions en lot (sélection multiple et actions groupées)
- ✅ Filtres sauvegardés (persistance localStorage)
- ✅ Export multi-format (CSV, Excel, JSON, PDF, DOCX) avec génération backend et URLs signées
- ✅ Menu "More" pour regrouper les actions Generate/Export
- ✅ Settings contextuels avec Sidebar Hover pour configuration rapide
- Fichiers créés/modifiés :
  - Frontend : frontend/src/pages/insights/InsightsPage/components/InsightsCharts.tsx, InsightsCalendarView.tsx, SavedFiltersMenu.tsx, etc.
  - Backend : backend/src/export/export.service.ts (support insights)
- Documentation : PLAN_AMELIORATIONS_CRM.md — améliorations UI/UX (insights)
LOT F : Nouvelles Règles d'Insights - 100% complété (2026-01-28)
- ✅ CONTACT_NO_ACTIVITY - Contacts sans interaction depuis X jours
- ✅ QUOTE_EXPIRING - Devis proches de leur date d'expiration
- ✅ INVOICE_PAYMENT_REMINDER - Rappels de paiement automatiques
- ✅ SESSION_FOLLOWUP_MISSING - Sessions terminées sans suivi client
- ✅ CONTRACT_EXPIRING - Contrats proches de leur expiration
- ✅ RECURRING_SESSION_MISSING - Sessions récurrentes non créées
- ✅ EMAIL_BOUNCE - Emails en erreur (bounce, spam, invalid) - Détecte les emails échoués dans scheduled_emails
- ❌ LOW_STOCK - RETIRÉ (2026-01-28) - Ne correspond pas au domaine CRM
- ✅ Règles personnalisées : Système complet permettant aux utilisateurs de créer leurs propres règles
- Fichiers créés :
  - Backend : backend/src/insights/generation/rules/*.rule.ts (7 nouvelles règles), backend/src/insights/custom-insight-rules.*
  - Frontend : frontend/src/pages/insights/InsightsPage/components/CustomRulesTab.tsx
  - Tests : backend/src/__tests__/insights/generation/rules/email-bounce.rule.spec.ts
  - Migrations : infra/liquibase/changes/0145_create_custom_insight_rules/, 0148_add_low_stock_and_email_bounce_insight_types/
- Documentation : PLAN_AMELIORATIONS_CRM.md — LOT F (insights)
LOT D : Personnalisation et Configuration pour Insights - 100% complété (2026-01-27)
- ✅ Table insight_settings pour stocker les configurations utilisateur/organisation
- ✅ Configuration des seuils de règles (ex: jours avant alerte pour devis en attente)
- ✅ Activation/désactivation de règles spécifiques
- ✅ Configuration des emails d'insights :
  - ✅ Résumés quotidiens/hebdomadaires avec horaires configurables
  - ✅ Notifications immédiates pour insights critiques
  - ✅ Filtres configurables (types, sévérités, scope)
- ✅ Service d'envoi d'emails avec templates HTML
- ✅ Scheduler automatique pour envoi aux heures configurées
- ✅ Interface de configuration dans le frontend (dialog avec onglets)
- ✅ Support multi-tenant (settings personnels et organisation)
- ✅ Intégration dans le rule engine pour utiliser les seuils configurables
- Fichiers créés :
  - Backend : backend/src/insights/insight-settings.*, backend/src/insights/insights-email.*
  - Frontend : frontend/src/client/insights/useInsightSettings.ts, frontend/src/pages/insights/InsightsPage/components/InsightSettingsDialog.tsx
  - Migrations : infra/liquibase/changes/0144_create_insight_settings/
- Documentation : PLAN_AMELIORATIONS_CRM.md — LOT D
LOT C : Support Multi-Tenant pour Insights - 100% complété (2026-01-27)
- ✅ Génération d'insights au niveau organisation (partagés entre membres)
- ✅ Filtrage par organisation dans l'API et l'UI
- ✅ Permissions : Vérification de l'appartenance à l'organisation
- ✅ Notifications : Tous les membres de l'organisation sont notifiés
- ✅ Sélecteur d'organisation dans le frontend
- ✅ Tests unitaires pour la génération multi-tenant
- Fichiers modifiés :
  - Backend : backend/src/insights/generation/insights-generator.service.ts, backend/src/insights/insights.repository.ts, backend/src/insights/insights.service.ts, backend/src/insights/insights.controller.ts
  - Frontend : frontend/src/client/insights/useInsights.ts, frontend/src/pages/insights/InsightsPage/InsightsPage.tsx
  - Tests : backend/src/__tests__/insights/generation/insights-generator-organization.spec.ts
- Documentation : PLAN_AMELIORATIONS_CRM.md — LOT C
LOT B : LLM-assisted Summarization - 100% complété (2026-01-27)
- ✅ Service d'enrichissement LLM pour améliorer titres et résumés
- ✅ Cache des résultats (7 jours) pour éviter les appels répétés
- ✅ Anonymisation des données avant envoi à OpenAI
- ✅ Activation automatique basée sur la présence d'une clé OpenAI
- ✅ Tests unitaires complets (11 tests, 100% passants)
- Documentation : PLAN_AMELIORATIONS_CRM.md — LOT B
LOT A : IA Proactive Insights (MVP Production) - 100% complété (2026-01-27)
- ✅ Migrations & Modèle : Tables ai_insights, ai_insight_events, ai_insight_feedback avec enums et indexes
- ✅ 8 Règles d'insights : QuoteStale, InvoiceOverdue, InvoicePartiallyPaid, SessionPrepMissing, SessionPostprodLag, SessionWithoutDelivery, BookingUpcoming, ChecklistIncomplete
- ✅ Génération automatique : Scheduler quotidien à 3h du matin + génération réactive via events
- ✅ Queue & Processor : BullMQ avec retry/backoff, traitement asynchrone
- ✅ API complète : 7 endpoints REST avec validation Zod
- ✅ Interface utilisateur : Page Insights avec tabs (Open/Read/Archived), filtres avancés, badge compteur
- ✅ Notifications : In-app + WebSocket + push pour insights critiques
- ✅ Tests : 50+ tests unitaires (>80% coverage) + tests d'intégration
- ✅ i18n : Traductions FR/EN complètes
- ✅ Documentation : Plan d'implémentation complet, README backend
- ✅ Corrections post-MVP (2026-01-27) : Colonnes SQL corrigées, sérialisation JSONB, navigation/breadcrumb configurés
- Fichiers créés :
  - Backend : backend/src/insights/ (repository, service, controller, rules, generator, scheduler, event handlers)
  - Frontend : frontend/src/pages/insights/, frontend/src/client/insights/
  - Tests : backend/src/__tests__/insights/ (8 fichiers de tests)
  - Migrations : infra/liquibase/changes/0143_create_ai_insights/
- Documentation : PLAN_AMELIORATIONS_CRM.md
- Référence : PLAN_AMELIORATIONS_CRM.md - Section "Insights Proactifs & Intelligence"
Système de réservation publique - 100% complété
- ✅ Interface publique avec calendrier interactif
- ✅ Gestion des conflits avec verrouillage Redis
- ✅ Tests unitaires et d'intégration complets (149 tests)
- ✅ Documentation complète
- ✅ Mise en avant sur la landing page - Section dédiée ajoutée avec présentation des avantages (2026-01-17)
Global Search & IA - Phase 1 - 100% complété
- ✅ Assistant conversationnel intégré
- ✅ Builder de vues personnalisées via prompts
- ✅ Génération d'actions complexes
Tests d'intégration pour conflits de réservation - 100% complété
- ✅ 7 tests d'intégration pour scénarios concurrents
- ✅ Tests de verrouillage et nettoyage
Intégration Stripe complète - 100% complété
- ✅ Gestion des abonnements (création, annulation, reprise)
- ✅ Paiement des factures via Stripe Payment Intents
- ✅ Collecte de méthodes de paiement via SetupIntent
- ✅ Attachement de méthodes de paiement au client Stripe
- ✅ Webhooks pour synchronisation automatique
- ✅ Historique des paiements
- ✅ Interface utilisateur complète avec Stripe Elements
Backup et disaster recovery - 100% complété
- ✅ Sauvegardes automatiques quotidiennes (scheduler NestJS à 2h du matin)
- ✅ Vérification d'intégrité avec checksum SHA-256
- ✅ Monitoring complet (statut, durée, erreurs)
- ✅ Alertes email en cas d'échec
- ✅ Plan de disaster recovery documenté
- ✅ Statistiques de backup pour monitoring
- Documentation : docs/DISASTER_RECOVERY.md
- Référence : PLAN_AMELIORATIONS_CRM.md - Section "Infrastructure & Robustesse"
Gestion des timeouts - 100% complété
- ✅ Configuration centralisée via module TimeoutConfig
- ✅ Timeouts configurables pour toutes les opérations (DB, APIs externes, HTTP, cron, migrations, backups)
- ✅ Middleware HTTP global pour timeout des requêtes - ✅ Appliqué
- ✅ Timeouts dans scripts shell (migrations, backups) - ✅ Appliqué
- ✅ Timeouts DB (pool et requêtes) - ✅ Appliqué
- ✅ Utilitaires de timeout avec support retry - ✅ Disponibles et utilisés
- ✅ Application des timeouts dans services OpenAI - ✅ Appliqué (tous les appels API wrappés)
- ✅ Application des timeouts dans services Google Calendar/Gmail - ✅ Appliqué (helper withCalendarTimeout utilisé)
- ✅ Application des timeouts dans schedulers cron - ✅ Appliqué (tous les schedulers wrappés avec executeWithTimeoutAndRetry)
- Documentation : docs/TIMEOUT_MANAGEMENT.md, docs/ENV_VARIABLES_TIMEOUT.md
- Référence : PLAN_AMELIORATIONS_CRM.md - Section "Infrastructure & Robustesse"
Amélioration du processus de migration - 100% complété
- ✅ Validation automatique des migrations avant exécution
- ✅ Backup automatique avant migration en production
- ✅ Logging complet dans table migration_logs (statut, durée, erreurs)
- ✅ Rollback automatique en cas d'échec
- ✅ Vérification de l'ordre des migrations
- ✅ Script amélioré migrate-improved.sh avec toutes les fonctionnalités
- ✅ Tests automatisés de migration dans CI/CD - Job test:migrations qui valide les migrations avant déploiement
- ✅ Interface admin pour visualiser les migrations - Onglet "Migrations" avec statistiques, liste des migrations, détection des migrations manquantes
- ✅ Alertes automatiques en cas d'échec de migration - Scheduler NestJS qui vérifie quotidiennement les migrations échouées et envoie des emails d'alerte
- ✅ Validation avancée - Détection des migrations manquantes via comparaison DB/changelog (parsing du changelog-master.yaml et comparaison avec migration_logs)
- Documentation : docs/MIGRATION_PROCESS.md
- Référence : PLAN_AMELIORATIONS_CRM.md - Section "Infrastructure & Robustesse"
Système d'export centralisé multi-formats - 100% complété
- ✅ Service centralisé ExportService pour tous les exports
- ✅ Support multi-formats : PDF, Word (DOCX), CSV, Excel (XLSX), JSON
- ✅ Endpoints unifiés avec paramètre format pour toutes les entités
- ✅ Conversion HTML→Word pour quotes, invoices, contracts
- ✅ Composant frontend réutilisable ExportFormatDialog
- ✅ Exports pour : sessions, contacts, quotes, invoices, conversations, roadmaps, contract templates
- ✅ Types TypeScript générés depuis OpenAPI
- ✅ Documentation complète
- Documentation : docs/EXPORT_SYSTEM.md
- Référence : PLAN_AMELIORATIONS_CRM.md - Section "Export & Import"
Navigation mobile améliorée - 100% complété
- ✅ Menu utilisateur full-screen sur mobile (UserMenuMobile)
- ✅ Sous-menus expansibles avec chevrons
- ✅ Contenu scrollable pour menus longs
- ✅ Détection automatique mobile/desktop dans UserDropdown
- ✅ Navigation tactile optimisée
Système de facturation robuste et conforme - 100% complété (2024-12-19)

✅ Numérotation séquentielle atomique (format YYYY-000001)
✅ Immutabilité vérifiable avec snapshots complets
✅ Conformité France/UE avec validation complète
✅ Calculs précis avec wrapper Money (decimal.js)
✅ Avoirs (credit notes) avec génération PDF
✅ Paiements unifiés (Stripe/PayPal/Manual) avec réconciliation automatique
✅ Export comptable CSV avec mapping personnalisable
✅ Audit trail complet de tous les événements
✅ Endpoints admin (régénérer PDF, vérifier hash)
✅ Préparation E-invoicing (structure prête)
✅ Tests complets (12 unitaires + 2 intégration)
- ✅ Dernière mise à jour : Correction complète des mocks Kysely dans credit-notes.service.spec.ts (7/7 tests passent, tous les mocks alignés avec l'exécution réelle)
- ✅ Statistiques : 425 tests passent, 1 test ignoré (test complexe de réconciliation)
Documentation : docs/BILLING_*.md (5 documents)
Référence : BILLING.md

Refactoring InvoiceFormPage.tsx - 100% complété (2025-12-19)
Refactoring AdminPanelPage.tsx - 100% complété (2025-12-19)
- ✅ Réduction de 1091 → 101 lignes (-91%)
- ✅ Extraction de composants : UsersTab, AccessTab, ServerTab
- ✅ Création de hooks : useUsersTab, useAccessTab, useServerTab
- ✅ Architecture modulaire et maintenable
- ✅ Pas d'erreurs TypeScript ou lint
- Fichiers créés :
  - frontend/src/pages/admin/AdminPanelPage/components/UsersTab.tsx
  - frontend/src/pages/admin/AdminPanelPage/components/AccessTab.tsx
  - frontend/src/pages/admin/AdminPanelPage/components/ServerTab.tsx
  - frontend/src/pages/admin/AdminPanelPage/hooks/useUsersTab.ts
  - frontend/src/pages/admin/AdminPanelPage/hooks/useAccessTab.ts
  - frontend/src/pages/admin/AdminPanelPage/hooks/useServerTab.ts
- Documentation : frontend/src/pages/admin/AdminPanelPage/REFACTORING_COMPLETE.md
- Référence : FRONTEND_IMPROVEMENT_PLAN.md, FRONTEND_NEXT_STEPS.md
Refactoring SessionViewPage.tsx - 100% complété (2025-12-19)
- ✅ Réduction de 1083 → 210 lignes (-81%)
- ✅ Extraction de composants : SessionHeader, SessionInfoSidebar
- ✅ Création de hooks : useSessionViewPage, useSessionEvents, useSessionFiles
- ✅ Architecture modulaire et maintenable
- ✅ Pas d'erreurs TypeScript ou lint
- Fichiers créés :
  - frontend/src/pages/sessions/SessionViewPage/components/SessionHeader.tsx
  - frontend/src/pages/sessions/SessionViewPage/components/SessionInfoSidebar.tsx
  - frontend/src/pages/sessions/SessionViewPage/hooks/useSessionViewPage.ts
  - frontend/src/pages/sessions/SessionViewPage/hooks/useSessionEvents.ts
  - frontend/src/pages/sessions/SessionViewPage/hooks/useSessionFiles.ts
- Documentation : frontend/src/pages/sessions/SessionViewPage/REFACTORING_COMPLETE.md
- Référence : FRONTEND_IMPROVEMENT_PLAN.md, FRONTEND_NEXT_STEPS.md
Refactoring SessionFormPage.tsx - 100% complété (2025-12-19)
- ✅ Réduction de 1068 → 235 lignes (-78%)
- ✅ Extraction de composants : SessionDetailsForm
- ✅ Création de hooks : useSessionForm
- ✅ Création de constants : SESSION_STATUS_VALUES
- ✅ Architecture modulaire et maintenable
- ✅ Pas d'erreurs TypeScript ou lint
- Fichiers créés :
  - frontend/src/pages/sessions/SessionFormPage/components/SessionDetailsForm.tsx
  - frontend/src/pages/sessions/SessionFormPage/hooks/useSessionForm.ts
  - frontend/src/pages/sessions/SessionFormPage/constants.ts
- Documentation : frontend/src/pages/sessions/SessionFormPage/REFACTORING_COMPLETE.md
- Référence : FRONTEND_IMPROVEMENT_PLAN.md, FRONTEND_NEXT_STEPS.md
Refactoring QuoteFormPage.tsx - 100% complété (2025-12-19)
- ✅ Réduction de 992 → 280 lignes (-72%)
- ✅ Extraction de composants : QuoteDetailsForm
- ✅ Création de hooks : useQuoteForm
- ✅ Architecture modulaire et maintenable
- ✅ Pas d'erreurs TypeScript ou lint
- Fichiers créés :
  - frontend/src/pages/quotes/QuoteFormPage/components/QuoteDetailsForm.tsx
  - frontend/src/pages/quotes/QuoteFormPage/hooks/useQuoteForm.ts
- Documentation : frontend/src/pages/quotes/QuoteFormPage/REFACTORING_COMPLETE.md
- Référence : FRONTEND_IMPROVEMENT_PLAN.md, FRONTEND_NEXT_STEPS.md
Refactoring SubscriptionPlansPage.tsx - 100% complété (2025-12-19)
- ✅ Réduction de 951 → 175 lignes (-82%)
- ✅ Extraction de composants : AdminInfoCard, CurrentSubscriptionCard, PlanCard, CreateSubscriptionDialog, CancelSubscriptionDialog
- ✅ Création de hooks : useSubscriptionPlans
- ✅ Création de helpers : parsePrice, isValidPrice
- ✅ Architecture modulaire et maintenable
- ✅ Pas d'erreurs TypeScript ou lint
- Fichiers créés :
  - frontend/src/pages/subscription/SubscriptionPlansPage/components/AdminInfoCard.tsx
  - frontend/src/pages/subscription/SubscriptionPlansPage/components/CurrentSubscriptionCard.tsx
  - frontend/src/pages/subscription/SubscriptionPlansPage/components/PlanCard.tsx
  - frontend/src/pages/subscription/SubscriptionPlansPage/components/CreateSubscriptionDialog.tsx
  - frontend/src/pages/subscription/SubscriptionPlansPage/components/CancelSubscriptionDialog.tsx
  - frontend/src/pages/subscription/SubscriptionPlansPage/hooks/useSubscriptionPlans.ts
  - frontend/src/pages/subscription/SubscriptionPlansPage/helpers.ts
- Documentation : frontend/src/pages/subscription/SubscriptionPlansPage/REFACTORING_COMPLETE.md
- Référence : FRONTEND_IMPROVEMENT_PLAN.md, FRONTEND_NEXT_STEPS.md
Refactoring GdprPortalPage.tsx - 100% complété (2025-12-19)
- ✅ Réduction de 920 → 120 lignes (-87%)
- ✅ Extraction de composants : ConsentsTab, RightsTab, RequestsTab, LegalTab
- ✅ Création de hooks : useGdprPortal
- ✅ Création de constants : getConsentTypes, getRequestTypes, getStatusLabels
- ✅ Architecture modulaire et maintenable
- ✅ Pas d'erreurs TypeScript ou lint
- Fichiers créés :
  - frontend/src/pages/gdpr/GdprPortalPage/components/ConsentsTab.tsx
  - frontend/src/pages/gdpr/GdprPortalPage/components/RightsTab.tsx
  - frontend/src/pages/gdpr/GdprPortalPage/components/RequestsTab.tsx
  - frontend/src/pages/gdpr/GdprPortalPage/components/LegalTab.tsx
  - frontend/src/pages/gdpr/GdprPortalPage/hooks/useGdprPortal.ts
  - frontend/src/pages/gdpr/GdprPortalPage/constants.ts
- Documentation : frontend/src/pages/gdpr/GdprPortalPage/REFACTORING_COMPLETE.md
- Référence : FRONTEND_IMPROVEMENT_PLAN.md, FRONTEND_NEXT_STEPS.md
Refactoring DashboardPage.tsx - 100% complété (2025-12-19)
Système de progression — DELETED (Vague A, 2026-07)
- ~~XP / badges / défis / coins~~ removed from app code; progression_* tables → later DB drop wave.
- Référence : APP_CLEANUP_MAP.md, DB_CLEANUP_AUDIT.md
Système d'invitations et d'amis - 100% complété (2026-01-16)
- ✅ Backend :
  - ✅ Système d'invitations : Chaque utilisateur a 5 invitations de base, peut gagner plus via progression
  - ✅ Création d'invitations : Invitation par email avec token (lien) et code (6 caractères)
  - ✅ Acceptation d'invitations : Via token ou code lors de l'inscription
  - ✅ Gestion du solde : Suivi des invitations gagnées, utilisées et disponibles
  - ✅ Système d'amis : Demandes mutuelles, acceptation, rejet, suppression
  - ✅ Amitié automatique : Création automatique d'amitié mutuelle lors de l'acceptation d'invitation
  - ✅ Récompenses référent : XP (50), coins (25), invitations supplémentaires (1) lors de l'inscription d'un invité
  - ✅ Intégration organisations : Limitation de l'ajout aux organisations aux amis uniquement
  - ✅ Visibilité utilisateur : Paramètre is_visible dans user_metadata pour contrôler la visibilité
- ✅ Frontend :
  - ✅ RightSidebar : Panneau latéral avec onglets Chat/Amis pour basculer entre les deux
  - ✅ FriendsList : Liste des amis avec recherche et actions rapides
  - ✅ InvitationsPage : Page complète pour gérer les invitations (solde, création, liste, codes)
  - ✅ FriendsPage : Page complète pour gérer les amis (liste, demandes, ajout)
  - ✅ Hooks React Query : useInvitations, useFriends avec toutes les mutations
  - ✅ Modification MembersTab : Filtrage pour n'afficher que les amis dans la sélection
  - ✅ Intégration DashboardLayout : RightSidebar remplace Agent avec onglets
- Documentation : backend/src/invitations/README.md, backend/src/friends/README.md
- Référence : PLAN_AMELIORATIONS_CRM.md - Section "Collaboration & Partage"
Système d'organisations - 100% complété (2026-01-16)
- ✅ Backend :
  - ✅ Création et gestion d'organisations : Les utilisateurs peuvent créer des organisations et inviter d'autres utilisateurs
  - ✅ Gestion des membres : Rôles (OWNER, ADMIN, MEMBER, VIEWER) avec permissions granulaires
  - ✅ Partage de ressources : Partage de sessions, devis, factures, contrats, contacts avec permissions (read, write, delete)
  - ✅ Système d'invitations : Invitations par email avec tokens sécurisés
  - ✅ Vérification d'accès : Service helper pour vérifier l'accès aux ressources via organisations
  - ✅ Intégration dans les services existants : Support du partage via OrganizationAccessService
- ✅ Frontend :
  - ✅ Hooks React Query complets : useOrganizations, useOrganization, useOrganizationMembers, useOrganizationResources, et toutes les mutations
  - ✅ Pages complètes : Liste, création, édition, vue détaillée avec onglets (Overview, Members, Resources)
  - ✅ Composants : CreateOrganizationDialog, MembersTab, ResourcesTab avec gestion complète des membres et ressources
  - ✅ Routes intégrées : /organizations, /organizations/new, /organizations/$id, /organizations/$id/edit
  - ✅ Traductions complètes : Toutes les traductions i18n pour les organisations
  - ✅ Formulaires : Utilisation de react-hook-form avec validation Zod
  - ✅ Optimistic updates : Mises à jour optimistes et invalidation du cache React Query
- Documentation : backend/src/organizations/README.md
- Référence : PLAN_AMELIORATIONS_CRM.md - Section "Collaboration & Partage"
Navigation breadcrumb améliorée - 100% complété (2026-01-27)
- ✅ Composant Breadcrumb réutilisable avec support mobile et desktop
- ✅ Navigation contextuelle pour quotes et invoices avec liens vers sessions/contacts parents
- ✅ Intégration dans le header avec affichage adaptatif (dropdown mobile, navigation desktop)
- ✅ Support des icônes et traductions i18n
- ✅ Gestion des paramètres de recherche pour préserver le contexte de navigation
Liens portail client pour documents - 100% complété (2026-01-27)
- ✅ Génération de liens portail client pour contracts, invoices et quotes
- ✅ Partage sécurisé via tokens d'accès client
- ✅ Interface utilisateur pour copier et partager les liens
- ✅ Intégration dans les pages de détail des documents
Génération PDF directe - 100% complété (2026-01-27)
- ✅ Génération PDF directe pour invoices et quotes sans passer par le système d'export
- ✅ Endpoints dédiés avec URLs signées temporaires
- ✅ Amélioration des performances et de l'expérience utilisateur
- ✅ Support du téléchargement direct depuis le portail client
Améliorations système d'export - 100% complété (2026-01-27)
- ✅ Amélioration du styling des exports (PDF, Word, Excel, CSV)
- ✅ Gestion améliorée des statuts d'export avec feedback utilisateur
- ✅ Interface utilisateur améliorée pour la sélection de formats
- ✅ Support des exports planifiés avec templates personnalisables
Synchronisation migrations depuis Liquibase - 100% complété (2026-01-27)
- ✅ Endpoint admin /migrations/sync-from-liquibase pour synchroniser les logs de migration
- ✅ Synchronisation automatique depuis la table databasechangelog de Liquibase
- ✅ Détection et import des migrations exécutées directement avec Liquibase
- ✅ Interface admin avec bouton de synchronisation manuelle
- ✅ Prévention des doublons lors de la synchronisation
- Documentation : backend/src/migrations/README.md (à mettre à jour)
Réinitialisation de mot de passe - 100% complété (2026-01-27)
- ✅ Système complet de réinitialisation de mot de passe avec tokens sécurisés
- ✅ Génération de tokens cryptographiquement sécurisés (32 bytes)
- ✅ Chiffrement AES-256-GCM des tokens avant stockage
- ✅ Hash SHA-256 pour recherche rapide O(1)
- ✅ Expiration des tokens après 60 minutes
- ✅ Utilisation unique des tokens avec opérations atomiques
- ✅ Envoi d'emails avec liens de réinitialisation
- ✅ Interface frontend complète avec validation
- ✅ Support Google OAuth avec codes d'invitation lors de l'inscription
- Documentation : backend/src/password-reset/README.md, backend/src/auth/README.md
Améliorations landing page - 100% complété (2026-01-27)
- ✅ Sections animées avec effets de transition fluides
- ✅ Background avec particules animées pour un effet visuel moderne
- ✅ Amélioration de l'expérience utilisateur et de l'engagement
- ✅ Optimisation des performances pour les animations
- ✅ Réduction de 895 → 85 lignes (-90%)
- ✅ Extraction de composants : QuickActionsCard, RevenueSection, DuplicatesSection, ContactsSection, SessionsSection, DocumentsSection
- ✅ Création de hooks : useDashboard
- ✅ Architecture modulaire et maintenable
- ✅ Pas d'erreurs TypeScript ou lint
- Fichiers créés :
  - frontend/src/pages/dashboard/DashboardPage/components/QuickActionsCard.tsx
  - frontend/src/pages/dashboard/DashboardPage/components/RevenueSection.tsx
  - frontend/src/pages/dashboard/DashboardPage/components/DuplicatesSection.tsx
  - frontend/src/pages/dashboard/DashboardPage/components/ContactsSection.tsx
  - frontend/src/pages/dashboard/DashboardPage/components/SessionsSection.tsx
  - frontend/src/pages/dashboard/DashboardPage/components/DocumentsSection.tsx
  - frontend/src/pages/dashboard/DashboardPage/hooks/useDashboard.ts
- Documentation : frontend/src/pages/dashboard/DashboardPage/REFACTORING_COMPLETE.md
- Référence : FRONTEND_IMPROVEMENT_PLAN.md, FRONTEND_NEXT_STEPS.md
Surveillance d'inactivité des formulaires publics - 100% complété (2025-12-20)
- ✅ Backend : migration 0118 (champs monitor_inactivity, inactivity_threshold_days, last_submission_at, last_inactivity_alert_sent_at), nouveaux services LeadFormsMonitoringService et LeadFormsScheduler pour envoyer les alertes quotidiennement en respectant une fenêtre de 24h.
- ✅ API : DTO (CreateLeadFormDto, UpdateLeadFormDto) enrichis, LeadFormSubmissionsService réinitialise les compteurs à chaque soumission et endpoint POST /lead-forms/{id}/acknowledge-inactivity pour accuser réception.
- ✅ Frontend : configuration dans LeadFormEditPage, hook useDashboard expose inactiveForms/handleAcknowledgeInactivity, composant RequestsSection affiche les alertes avec CTA et useLeadForms apporte la mutation useAcknowledgeLeadFormInactivity.
- ✅ Documentation : PLAN_AMELIORATIONS_CRM.md mis à jour avec la description détaillée et les suivis recommandés.
- ✅ Réduction de 1120 → 175 lignes (-84%)
- ✅ Extraction de composants : InvoiceDetailsForm, InvoiceItemsForm, InvoiceHeaderDates, InvoiceCompanyInfo, InvoiceContactInfo
- ✅ Création de hooks : useInvoiceForm, useInvoiceContactSelection, useInvoiceSessionSelection
- ✅ Extraction de types, helpers et constantes
- ✅ Architecture modulaire et maintenable
- ✅ Pas d'erreurs TypeScript ou lint
- Fichiers créés :
  - frontend/src/pages/invoices/InvoiceFormPage/components/InvoiceDetailsForm.tsx
  - frontend/src/pages/invoices/InvoiceFormPage/components/InvoiceItemsForm.tsx
  - frontend/src/pages/invoices/InvoiceFormPage/components/InvoiceHeaderDates.tsx
  - frontend/src/pages/invoices/InvoiceFormPage/components/InvoiceCompanyInfo.tsx
  - frontend/src/pages/invoices/InvoiceFormPage/components/InvoiceContactInfo.tsx
  - frontend/src/pages/invoices/InvoiceFormPage/hooks/useInvoiceForm.ts
  - frontend/src/pages/invoices/InvoiceFormPage/hooks/useInvoiceContactSelection.ts
  - frontend/src/pages/invoices/InvoiceFormPage/hooks/useInvoiceSessionSelection.ts
  - frontend/src/pages/invoices/InvoiceFormPage/types.ts
  - frontend/src/pages/invoices/InvoiceFormPage/helpers.ts
  - frontend/src/pages/invoices/InvoiceFormPage/constants.ts
- Documentation : frontend/src/pages/invoices/InvoiceFormPage/REFACTORING_COMPLETE.md
- Référence : FRONTEND_IMPROVEMENT_PLAN.md, FRONTEND_NEXT_STEPS.md

✅ Intégration dans MobileSidebar

Système de queue pour jobs lourds - 100% complété
- ✅ Module QueueModule avec configuration BullMQ et Redis
- ✅ Service QueueService pour gérer les queues et jobs
- ✅ 6 queues configurées : exports, google-calendar-sync, scheduled-emails, workflow-tasks, recurring-sessions, audit-cleanup
- ✅ 6 processors implémentés pour chaque type de job
- ✅ Migration complète des schedulers vers la queue (non-bloquant)
- ✅ Migration du ExportController vers la queue
- ✅ Intégration WebSocket pour mises à jour de statut en temps réel
- ✅ Endpoint /export/status/:jobId pour vérifier le statut des jobs
- ✅ Retry automatique avec backoff exponentiel
- ✅ Documentation complète
- Documentation : QUEUE_SYSTEM.md (résumé opérationnel), contrat routage BullMQ : docs/AGENTS_BACKEND.md § BullMQ
- Référence : PLAN_AMELIORATIONS_CRM.md - Section "Infrastructure & Robustesse"
Gestion centralisée des types via OpenAPI - 100% complété
- ✅ Audit complet des types utilisés dans frontend et backend
- ✅ Migration de tous les types partagés vers OpenAPI
Refactoring des services volumineux (Phase 6.5) - 100% complété
- ✅ duplicates.service.ts : 858 → 157 lignes (-82%) - 4 services créés
- ✅ storage.service.ts : 750 → 160 lignes (-79%) - 5 services créés
- ✅ pdf.service.ts : 683 → 84 lignes (-88%) - 4 services créés
- ✅ contacts.service.ts : 677 → 62 lignes (-91%) - 3 services créés
- ✅ Réduction globale : 2968 → 463 lignes (-84%)
- ✅ Lint et type-check passent sans erreurs
- ✅ Principes architecturaux respectés (SRP, Core Modules)
- ✅ Types scope-specific (frontend-only ou backend-only) dans fichiers types.ts appropriés
- ✅ Suppression des définitions de types dupliquées
- ✅ Mise à jour de tous les imports pour utiliser les types générés
- ✅ Vérification que tous les types OpenAPI sont correctement exportés
- ✅ Documentation complète des règles de gestion des types
- ✅ Correction des erreurs de validation OpenAPI
- Documentation : docs/AGENTS_OPENAPI.md
- Référence : PLAN_AMELIORATIONS_CRM.md - Section "Tests & Qualité"
Refactoring des services volumineux (Phase 6.6 - Priorité Haute) - 100% complété

✅ Refactoring de tous les fichiers de priorité haute (> 600 lignes)
✅ 8 fichiers refactorisés avec réduction moyenne de -82.8%

Refonte complète du chat agent - 100% complété (Décembre 2024)

✅ Architecture modulaire avec hooks spécialisés (useConversationState, useMessageState)
✅ Gestion optimiste des conversations (mise à jour immédiate de la liste)
✅ Correction du problème de suppression (plus de rechargement automatique)
✅ Améliorations visuelles (animations subtiles, transitions fluides)
✅ Séparation claire des responsabilités (conversations vs messages)
✅ Gestion propre du cache React Query
Documentation : docs/REFONTE_CHAT_AGENT.md
Référence : PLAN_AMELIORATIONS_CRM.md - Section "Architecture & Qualité"
✅ sessions.service.ts : 832 → 143 lignes (-83%)
✅ user-session-types.service.ts : 651 → 121 lignes (-81%)
✅ user-payment-plans.service.ts : 651 → 110 lignes (-83%)
✅ session-checklists.service.ts : 646 → 206 lignes (-68%)
✅ ai-search.service.ts : 637 → 144 lignes (-77%)
✅ backup.service.ts : 621 → 73 lignes (-88%)
✅ search.service.ts : 620 → 42 lignes (-93%)
✅ scheduled-emails.service.ts : 616 → 65 lignes (-89%)
Résultats globaux Phase 6.6 : 5,274 → 904 lignes (-82.8% de réduction)
✅ Tous les fichiers refactorisés < 400 lignes (objectif atteint)
✅ Services spécialisés créés pour chaque responsabilité (SRP)
✅ Architecture Clean respectée avec modules Core
✅ Tous les tests passent (lint + type-check)
Documentation : BACKEND_STRUCTURE_IMPROVEMENT_PLAN.md, BACKEND.md

Refactoring des services volumineux (Phase 6.7 - Priorité Moyenne) - 100% complété

✅ Refactoring de tous les fichiers de priorité moyenne (500-600 lignes)
✅ 10 fichiers refactorisés avec réduction moyenne de -83.3%
✅ user-rates.service.ts : 595 → 98 lignes (-84%)
✅ workflows-user.service.ts : 594 → 79 lignes (-87%)
✅ session-recurrence.service.ts : 593 → 106 lignes (-82%)
✅ email.service.ts : 545 → 91 lignes (-83%)
✅ google-calendar-events-sessions.service.ts : 541 → 148 lignes (-73%)
✅ notifications.service.ts : 526 → 96 lignes (-82%)
✅ user-metadata.service.ts : 512 → 43 lignes (-92%)
✅ export-excel.service.ts : 505 → 56 lignes (-89%)
✅ paypal.service.ts : 502 → 119 lignes (-76%)
✅ notion.service.ts : 500 → 67 lignes (-87%)
Résultats globaux Phase 6.7 : 5,406 → 903 lignes (-83.3% de réduction)
✅ 30 services spécialisés créés pour améliorer la maintenabilité
✅ Tous les fichiers refactorisés < 400 lignes (objectif atteint)
✅ Services spécialisés créés pour chaque responsabilité (SRP)
✅ Architecture Clean respectée avec modules Core
✅ Tous les tests passent (lint + type-check)
Documentation : BACKEND_STRUCTURE_IMPROVEMENT_PLAN.md, BACKEND.md

Refactoring des services volumineux (Phase 6.3, 6.4 et 6.5) - 100% complété
- ✅ SessionRoadmapWordService : 887 → 135 lignes (-85%)
  - 8 builders spécialisés créés dans backend/src/sessions/helpers/
  - Séparation claire des responsabilités (header, session info, weather, contacts, providers, checklist)
- ✅ PermissionsService : 812 → 339 lignes (-58%)
  - 4 services spécialisés créés : Subscription, Overrides, Plans, PlanData
  - Structure Core Module vérifiée, pas de dépendances circulaires
- ✅ WorkflowTasksService : 833 → 110 lignes (-87%)
  - 4 services spécialisés créés : Helpers, Creation, Execution, Query
  - Séparation claire entre création, exécution et requêtes
- ✅ WorkflowsDefaultService : 883 → 124 lignes (-86%)
  - 4 services spécialisés créés : CRUD, Phases, Tasks, Reset
  - Architecture modulaire pour la gestion des workflows par défaut
- ✅ DuplicatesService : 858 → 157 lignes (-82%)
  - 4 services spécialisés créés : Helpers, CRUD, Registration, Actions
  - Séparation claire entre CRUD, inscriptions et actions métier
- ✅ StorageService : 750 → 160 lignes (-79%)
  - 5 services spécialisés créés : Helpers, Config, URL, Upload, FileManagement, Image
  - Architecture modulaire pour la gestion du stockage R2/S3
- ✅ PdfService : 683 → 84 lignes (-88%)
  - 4 services spécialisés créés : Helpers, TableRendering, Rendering, Generation
  - Séparation claire entre génération, rendu et upload
- ✅ ContactsService : 677 → 62 lignes (-91%)
  - 3 services spécialisés créés : Sessions, CRUD, Timeline
  - Séparation claire entre CRUD, associations et timeline
- Résultats globaux Phase 6.3 et 6.4 : 3415 → 708 lignes (-79% de réduction)
- Résultats globaux Phase 6.5 : 2968 → 463 lignes (-84% de réduction)
- Total nouveaux services spécialisés créés : 32 services pour améliorer la maintenabilité
- ✅ Tous les fichiers refactorés < 400 lignes (objectif atteint)
- ✅ Lint et type-check passent sans erreurs
- ✅ Pas de dépendances circulaires, Core Modules correctement configurés
- Documentation : BACKEND_STRUCTURE_IMPROVEMENT_PLAN.md
- Référence : PLAN_AMELIORATIONS_CRM.md - Section "Architecture & Qualité"
Refonte complète du chat agent - 100% complété (Décembre 2024)

✅ Architecture modulaire avec hooks spécialisés (useConversationState, useMessageState)
✅ Gestion optimiste des conversations (mise à jour immédiate de la liste)
✅ Correction du problème de suppression (plus de rechargement automatique)
✅ Améliorations visuelles (animations subtiles, transitions fluides)
✅ Séparation claire des responsabilités (conversations vs messages)
✅ Gestion propre du cache React Query
Documentation : docs/REFONTE_CHAT_AGENT.md
Référence : PLAN_AMELIORATIONS_CRM.md - Section "Architecture & Qualité"
✅ Renommage menu "Administration" → "Système" pour éviter confusion
Documentation : docs/MOBILE_NAVIGATION.md
Référence : PLAN_AMELIORATIONS_CRM.md - Section "Mobile & PWA"

🚀 Priorité Haute (Impact élevé, Effort moyen)

Note :

✅ Refactoring backend priorité haute et moyenne terminé (Phase 6.6 et 6.7)

📋 Plan d'amélioration frontend : Voir docs/FRONTEND_IMPROVEMENT_PLAN.md pour le plan complet

🎯 Prochaines étapes frontend : Voir docs/FRONTEND_NEXT_STEPS.md pour la vue synthétique

🧩 Plan CRM relation clientèle : Voir docs/PLAN_AMELIORATIONS_CRM.md, section "Plan d'amélioration relation clientèle (2026-03)"

0.a Relation clientèle omnicanale (CRM) 🚀

Impact : Élevé (conversion, réactivité commerciale, qualité du suivi client)
Effort : Moyen-Élevé
Description : Structurer un socle CRM orienté exécution avec un tableau de suivi unique, des flux de création/édition en modale, et un suivi unifié des demandes email entrantes via Gmail.
Statut : 🚀 Priorité active (plan validé, implémentation à lancer)
Périmètre validé :
- Tableau de suivi clientèle : pipeline opérationnel par statuts avec actions rapides (assignation, relance, conversion en session/devis).
- Création/édition en modales : standardiser les CRUD principaux en overlays pour éviter les ruptures de contexte.
- Plugin Gmail : capter les demandes entrantes, associer contact/session, et suivre le statut de traitement.
Découpage recommandé :
- Phase 1 : Tableau de suivi clientèle + statuts + vues sauvegardées.
- Phase 2 : Migration progressive des écrans création/édition vers modales standard.
- Phase 3 : Intégration Gmail (OAuth, sync, déduplication, liaison CRM).
Référence détaillée : docs/PLAN_AMELIORATIONS_CRM.md (section dédiée 2026-03)

0.b Visual Day Planner mariage 🚀

Impact : Élevé (coordination client/prestataire, qualité d’exécution jour J, valeur premium perçue)
Effort : Moyen-Élevé
Description : Ajouter un planificateur visuel de journée mariage basé sur une timeline verticale avec drag/drop et publication client.
Décision technique : FullCalendar React (@fullcalendar/react, @fullcalendar/core, @fullcalendar/timegrid, @fullcalendar/interaction).
Statut : 🚧 En implémentation (backend day planner + intégration frontend scheduler en cours)
Périmètre MVP :
- template journée mariage pré-rempli,
- édition interne blocs horaires (CRUD + drag/drop/resize),
- publication client (scope publié),
- propositions client soumises puis validées/refusées côté photographe.
Référence détaillée : docs/PLAN_AMELIORATIONS_CRM.md (section "Visual Day Planner mariage")

0. Proposal v3 - Tests + QA + polish final ✅

Impact : Élevé (conversion devis + expérience client premium)
Effort : Moyen-Élevé
Description : Finaliser la phase v3 (tests backend/E2E, QA UX premium, derniers ajustements) après le builder dédié, l’email proposal et la route publique premium
Statut : ✅ Stabilisé en production (builder + email + public premium + Share & Send fiabilisé)
Complété :
- ✅ Add-ons user_rates filtrés par SessionType
- ✅ Endpoints proposals auth + publics par token dédié
- ✅ Patch de devis via quote_items ADDON traçables + quote_revisions
- ✅ OpenAPI schemas/paths + types générés backend/frontend
- ✅ Builder dédié /quotes/:quoteId/proposal + slug + cover + envoi email (new-proposal)
- ✅ Route publique premium /proposal/:token|slug + invitation portail en fin de flow
- ✅ Migration/suppression legacy /client
Complété (v3) :
- ✅ Tests backend read-only (putPresentation, putUpsells, createLink quand devis accepté)
- ✅ QA UX premium (loading/error/empty, responsive, alignements, wording)
- ✅ Tests backend preview-email / send-email (déjà couverts dans proposals-email.service.spec + controller)
- ✅ Share & Send fiabilisé : génération automatique de lien, save slug avant envoi, clarification état du lien, blocage explicite si expiré
Reste léger (v3) :
- suivi post-cut et QA opportuniste sur appareils réels
- E2E complémentaire uniquement si un nouveau parcours critique apparaît
Documentation : produit DELETED — voir APP_CLEANUP_MAP.md Vague C (plan Proposal retiré)

0.c Billing externalisé / Pennylane 🚀

Impact : Très élevé (continuité métier, réduction du risque réglementaire porté en interne, valeur visible portail/documents)
Effort : Moyen-Élevé
Description : introduire un BillingProvider avec PennylaneProvider comme cible initiale pour créer des factures externes depuis les devis acceptés et refléter les documents fiscaux dans Aaperture.
Statut : 🚀 Priorité active
Décision produit :
- Aaperture = source de vérité métier
- Pennylane = source de vérité fiscale / facturation externe
Périmètre MVP :
- création facture externe depuis devis accepté,
- récupération PDF,
- affichage app + portail,
- stockage des IDs externes, statuts et métadonnées minimales.
Référence détaillée : docs/ACCOUNTING_EXPORT_GUIDE.md (export-first; in-app Pennylane sync removed)

0.d Storage abstraction / Scaleway ⏸️

Impact : Élevé (souveraineté, maintenabilité infra, réduction du couplage provider)
Effort : Moyen-Élevé
Description : introduire StorageProvider, conserver une compatibilité S3 stricte, déployer ScalewayStorageProvider et migrer progressivement l’existant depuis R2.
Statut : ⏸️ en pause (2026-10-23) : on reste sur R2 ; abstraction StorageProvider livrée
Périmètre initial :
- nouveaux uploads vers Scaleway,
- dual-read temporaire,
- lazy migration pour l’existant,
- couverture documents, portal files, galleries, slideshow/video assets.
Référence détaillée : docs/PLAN_AMELIORATIONS_CRM.md (section "Storage abstraction / Scaleway")

0. Refactoring Frontend - Fichiers Critiques ✅ TERMINÉ

Impact : Essentiel pour la maintenabilité et la qualité du code
Effort : Moyen-Élevé
Description : Refactorer les fichiers frontend volumineux (> 400 lignes) pour améliorer la maintenabilité
Statut : ✅ Terminé - Tous les fichiers ont été refactorés
Objectif : Réduire tous les fichiers sous 400 lignes ✅ Atteint
Complété :
- ✅ router.tsx - 1119 → 227 lignes (-80%) - Routes extraites dans routes/
- ✅ InvoiceFormPage.tsx - 1120 → 175 lignes (-84%)
- ✅ AdminPanelPage.tsx - 1091 → 101 lignes (-91%)
- ✅ SessionViewPage.tsx - 1083 → 210 lignes (-81%)
- ✅ SessionFormPage.tsx - 1068 → 235 lignes (-78%)
- ✅ QuoteFormPage.tsx - 992 → 280 lignes (-72%)
Complété :
- ✅ QuotesInvoicesTab.tsx - 1300 → 252 lignes (-81%) - Hook principal + 6 composants de section
- ✅ LeadFormEditPage.tsx - 894 → 158 lignes (-82%) - Hook principal + 3 composants d'onglets
- ✅ StripeSubscriptionTab.tsx - 890 → 113 lignes (-87%) - Hook principal + 3 composants
- ✅ UserRateFormPage.tsx - 882 → 150 lignes (-83%) - Hook principal + 6 composants de sections
Fichiers prioritaires restants :
- ✅ ContactFormPage.tsx - 834 → 236 lignes (-72%) - Complété
- ✅ WeekTimelineView.tsx - 830 → 104 lignes (-87%) - Complété
- ✅ ProfilePage.tsx - 815 → 126 lignes (-85%) - Complété
- ✅ LeadFormStylingEditor.tsx - 802 → 46 lignes (-94%) - Complété
- ✅ DayTimelineView.tsx - 771 → 87 lignes (-89%) - Complété
- ✅ QuotesListPage.tsx - 786 → 217 lignes (-72%) - Complété
- ✅ UserViewPage.tsx - 747 → 201 lignes (-73%) - Complété
- ✅ AdminDefaultSessionTypesPage.tsx - 747 → 170 lignes (-77%) - Complété
- ✅ InfoTab.tsx (SessionViewPage) - 744 → 108 lignes (-85%) - Complété
- ✅ DefaultSessionTypesTab.tsx - 743 → 166 lignes (-78%) - Complété
- ✅ DuplicateViewPage.tsx - 741 → 222 lignes (-70%) - Complété
- ✅ OnboardingPlanSelection.tsx - 730 → 88 lignes (-88%) - Complété
- ✅ ChecklistTab.tsx (SessionViewPage) - 725 → 157 lignes (-78%) - Complété
- ✅ EventDialogs.tsx - 720 → 62 lignes (-91%) - Complété
- ✅ UserSessionTypeFormPage.tsx - 710 → 123 lignes (-83%) - Complété
- ✅ InvoicesListPage.tsx - 663 → 206 lignes (-69%) - Complété
- ✅ AdminDefaultPaymentPlansPage.tsx - 632 → 77 lignes (-88%) - Complété
- ✅ DefaultPaymentPlansTab.tsx - 630 → 79 lignes (-87%) - Complété
- ✅ ContractsListPage.tsx - 623 → 179 lignes (-71%) - Complété
- ✅ AnalyticsPage.tsx - 597 → 162 lignes (-73%) - Complété
- ✅ ContactsListPage.tsx - 601 → 273 lignes (-55%) - Complété
- ✅ AdminDefaultWorkflowFormPage.tsx - 591 → 190 lignes (-68%) - Complété
- ✅ AdminSubscriptionPlansPage.tsx - 560 → 92 lignes (-84%) - Complété
- ✅ DefaultWorkflowsTab.tsx - 542 → 126 lignes (-77%) - Complété
- ✅ AgendaListView.tsx - 531 → 85 lignes (-84%) - Complété
- ✅ LeadFormSubmissionsPage.tsx - 520 → 194 lignes (-63%) - Complété
- ✅ SettingsTab.tsx (LeadFormEdit) - 514 → 64 lignes (-88%) - Complété
Résultat final :
- ✅ 32 fichiers refactorisés au total
- ✅ ~15,000+ lignes de code réduites
- ✅ Réduction moyenne : ~75% par fichier
- ✅ 0 fichier restant à refactorer
Documentation :
- 📋 FRONTEND_IMPROVEMENT_PLAN.md - Référence active des règles de refactoring frontend
- 🎯 FRONTEND_NEXT_STEPS.md - Optimisations futures

1. Calendrier visuel amélioré ✅ COMPLÉTÉ

Impact : Essentiel pour la gestion des sessions
Effort : Moyen-Élevé
Description : Améliorer l'interface calendrier pour une meilleure visualisation et gestion des sessions
Statut : ✅ Complété (2025-01-27)
Réalisations :
- ✅ Vue timeline pour la semaine avec grille horaire (0h-23h)
- ✅ Vue timeline pour le jour avec grille horaire (0h-23h)
- ✅ Positionnement précis des événements/sessions
- ✅ Affichage des créneaux de disponibilité
- ✅ Navigation et scroll optimisés
- ✅ Visualisation des chevauchements (bordure rouge, icône d'alerte, tooltip)
- ✅ Légende interactive avec icônes et couleurs
- ✅ Filtres visuels (masquer/afficher sessions, événements, disponibilités)
- ✅ Vue agenda/liste chronologique
- ✅ Drag & drop dans toutes les vues (Month, Week, Day) avec zones droppables
Documentation : CALENDAR_SYNC_ARCHITECTURE.md, APP_OVERVIEW.md

2. Sécurité CASA pour validation Google ✅ COMPLÉTÉ

Impact : Validation Google requise pour intégration OAuth/Calendar
Effort : Moyen
Description : Corrections de sécurité critiques identifiées dans l'évaluation CASA pour passer la validation Google
Statut : ✅ Complété (2025-01-26)
Référence : SECURITY_ASSESSMENT_CASA.md
Score de sécurité : A (95/100) ⬆️
Améliorations critiques (Phase 1) : ✅ COMPLÉTÉ
- ✅ Supprimer valeur par défaut JWT_SECRET - Validation stricte implémentée
- ✅ Configurer CORS avec whitelist d'origines - Whitelist configurée via ALLOWED_ORIGINS
- ✅ Installer et configurer Helmet - Helmet configuré avec CSP et headers de sécurité
- ✅ Configurer whitelist d'origines pour WebSocket - Whitelist appliquée aux gateways WebSocket
Améliorations importantes (Phase 2) : ✅ COMPLÉTÉ
- ⚠️ Mettre à jour dépendances vulnérables (glob, js-yaml) - Nécessite breaking changes, à planifier
- ✅ Ajouter rate limiting global par défaut - Rate limit global (100 req/min) via APP_GUARD
- ✅ Implémenter protection CSRF - Guard CSRF avec validation des tokens
- ✅ Validation contenu fichiers (magic bytes) - Validation intégrée dans StorageController
Améliorations (Phase 3) : ✅ COMPLÉTÉ
- ✅ Implémenter refresh token - Refresh token JWT (access: 15min, refresh: 30 jours)
- ✅ Système d'alerte pour tentatives suspectes - SecurityAlertsService avec alertes email
- ✅ Sanitizer HTML côté serveur - HtmlSanitizerService avec DOMPurify

3. IA Proactive Insights (LOT A - MVP) ✅ 100% COMPLÉTÉ

Impact : Très élevé - Améliore la productivité en détectant automatiquement les situations nécessitant une action
Effort : Moyen-Élevé
Description : Système d'insights proactifs qui détecte automatiquement des situations nécessitant une action (devis en attente, factures en retard, sessions sans préparation, etc.) et les présente à l'utilisateur avec des actions suggérées
Statut : ✅ 100% complété (2026-01-27) - Toutes les fonctionnalités MVP implémentées et opérationnelles
Approche MVP : Règles déterministes (pas de LLM au début) pour garantir la fiabilité
Fonctionnalités :
- ✅ 8 types d'insights : Devis en attente, factures en retard, sessions sans préparation, etc.
- ✅ Génération automatique : Scheduler quotidien + triggers event-driven
- ✅ Notifications : In-app + WebSocket + push
- ✅ Interface dédiée : Insights Center avec filtres et actions
- ✅ Feedback utilisateur : Système de rating pour améliorer la pertinence
Livrables :
- A1. Modèle & Persistence (tables, migrations, types)
- A2. Génération "Rules First" (8 règles déterministes)
- A3. Job + Queue + Notifications (BullMQ, scheduler, event handlers)
- A4. API + UI (endpoints, hooks, composants)
Documentation : PLAN_AMELIORATIONS_CRM.md (insights)
Référence : PLAN_AMELIORATIONS_CRM.md - Section "Insights Proactifs & Intelligence"
Corrections post-MVP (2026-01-27) : Colonnes SQL corrigées, sérialisation JSONB, navigation/breadcrumb configurés

Prochaines étapes :

✅ LOT C : Support Multi-Tenant (Priorité Haute) - ✅ COMPLÉTÉ (2026-01-27)
✅ LOT B : LLM-assisted Summarization (Priorité Moyenne) - ✅ COMPLÉTÉ (2026-01-27)
✅ LOT D : Personnalisation et Configuration (Priorité Haute) - ✅ COMPLÉTÉ (2026-01-27)
✅ Améliorations UI/UX (Priorité Moyenne) - ✅ COMPLÉTÉ (2026-01-28) - Graphiques, calendrier, groupement, actions en lot, filtres sauvegardés, export multi-format, menu "More", settings contextuels
✅ LOT F : Nouvelles Règles d'Insights (Priorité Moyenne) - ✅ PARTIELLEMENT COMPLÉTÉ (2026-01-28) - 6 règles sur 8 implémentées + système de règles personnalisées
LOT E : Analytics et Intelligence (Priorité Basse) - À venir - Dashboard analytics, métriques de résolution, recommandations
✅ LOT D : Personnalisation et Configuration (Priorité Moyenne) - ✅ COMPLÉTÉ (2026-01-27) - Configuration des seuils, règles, et emails d'insights (résumés quotidiens/hebdomadaires, configuration par utilisateur/organisation)
✅ Améliorations UI/UX (Priorité Moyenne) - ✅ COMPLÉTÉ (2026-01-29) - Graphiques, actions en lot, export, Settings contextuels avec Sidebar (✅ UserViewPage et AdminPanelPage complétés)
LOT F : Nouvelles Règles (Priorité Moyenne) - Étendre la couverture
LOT E : Analytics (Priorité Basse) - Dashboard analytics sur les insights

4. Système d'Authentification Client ✅ PHASES 1→5 COMPLÉTÉES

Impact : Très élevé - Expérience client premium, vue multi-photographes, messagerie, fidélisation
Effort : Élevé (8-10 semaines en 5 phases)
Description : Système d'authentification client complet avec compte global, permettant aux clients de voir tous leurs projets avec tous leurs photographes depuis une interface unifiée, avec messagerie, espace fichiers personnel et préférences sauvegardées
Statut : 🚧 Phase 2 complétée (Janvier 2026)
- ✅ Phase 1 : MVP Authentification - Migration DB (7 tables), modules backend (client-auth, client-accounts), frontend (auth pages, dashboard, layout)
- ✅ Phase 2 : Expérience Client - Pages projets, documents, timeline
- ✅ Phase 3 : Messagerie client-photographe
- ✅ Phase 4 : Fichiers + Préférences (thème, notifications, timezone)
- ✅ Phase 5 : Côté photographe (invitations, statuts)
- 📋 Phase 3 : Messagerie - Communication client-photographe
- 📋 Phase 4 : Fichiers et Préférences
- 📋 Phase 5 : Côté Photographe (invitations)
Vision :
- Système hybride : Accès token (existant) pour accès rapide + Compte client (nouveau) pour expérience complète
- Compte global : Un email = un compte, visible par tous les photographes avec qui le client travaille
- Liaison Contact-ClientAccount : Les Contacts restent locaux au photographe, les ClientAccounts sont globaux
Fonctionnalités :
- Phase 1 - MVP Auth : Register, login, logout, forgot-password, reset-password, dashboard basique
- Phase 2 - Expérience : Vue projets multi-photographes, documents, timeline
- Phase 3 - Messagerie : Communication directe client-photographe
- Phase 4 - Fichiers : Espace personnel, préférences (notifications, thème, timezone)
- Phase 5 - Photographe : Invitation clients, indicateur compte actif, messages dans Contact
Architecture :
- 6 tables : client_accounts, client_account_contacts, client_messages, client_files, client_preferences, client_password_reset_tokens
- JWT séparés : Tokens client (type: "client") distincts des tokens user
- Guards séparés : ClientAuthGuard vs AuthGuard
- Sécurité : Rate limiting, vérification email, liaison sécurisée par email match
Endpoints :
- Auth : /api/client-auth/register, login, logout, forgot-password, reset-password, refresh
- Compte : /api/client-accounts/me, /me/photographers, /me/projects, /me/documents
- Messages : /api/client-messages/conversations, /conversations/:contactId
- Fichiers : /api/client-files/, /upload, /:fileId
- Photographe : /api/contacts/:id/invite-to-create-account, /:id/messages
Frontend :
- Layout : ClientPortalLayout avec header/sidebar dédiés + thème appliqué (light/dark/system)
- Pages : Login, Register, Dashboard, Projects, Documents, Messages, Files, Settings
- Hooks : useClientAuth, useClientProjects, useClientMessages, useClientFiles
Compatibilité :
- ✅ Tokens existants : L'accès token continue de fonctionner indépendamment
- ✅ Pas de migration forcée : Les Contacts existants restent tels quels
- ✅ Liaison progressive : Le photographe peut inviter ses clients quand il le souhaite
Documentation : docs/CLIENT_AUTHENTICATION_PLAN.md
Estimation : 8-10 semaines (5 phases)

5. Authentification à deux facteurs (2FA)

Impact : Sécurité critique
Effort : Moyen
Description : Implémenter l'authentification à deux facteurs pour renforcer la sécurité
Statut : Non commencé

6. Refonte chat agent avec commandes en /

Impact : Sécurisation des insertions, UX guidée
Effort : Moyen
Description : Commandes explicites (ex. /contact, /session, /devis, /facture, /aide) pour des flux guidés. Détection du préfixe / côté backend, routage vers formulaire structuré ou complétion. Frontend : menu de suggestions à la saisie de /, token inline + formulaire. Dual‑mode (commandes vs conversation libre) et fichiers de conversation avec OCR.
Statut : ✅ Complété (2026-02-06)
Référence : PLAN_AMELIORATIONS_CRM.md, REFONTE_CHAT_AGENT.md

7. Sécurisation des insertions agent (contacts/sessions) et doublons

Impact : Réduction des données incomplètes et des doublons
Effort : Moyen
Description : Règles métier côté agent : email requis pour la création de contact ; session avec start_date, title, location requis. Création uniquement via form builder (pas de création directe).
Statut : ✅ Complété (2026-02-06)
Référence : PLAN_AMELIORATIONS_CRM.md

8. Gestion des doublons (contacts)

Impact : Nettoyage des bases et fusion des données
Effort : Moyen-Élevé
Description : Bouton "Gérer les doublons" en haut de la liste des contacts et sur le dashboard. Regroupement par email ou par numéro de téléphone. Fusion : choix du contact à conserver, réattribution des entités liées (sessions, devis, factures, etc.), suppression des anciennes fiches après confirmation.
Statut : ✅ Complété
Livrables :
- ✅ Workspace de fusion (/contacts/duplicates) avec tri, recherche, badges de confiance, action "Ignorer ce groupe".
- ✅ API de prévisualisation (POST /contacts/merge/preview) avec conflits de champs + estimation des réattributions.
- ✅ Fusion enrichie (POST /contacts/merge) avec fieldOverrides et retour détaillé des entités réattribuées.
- ✅ Audit de fusion enrichi (metadata : IDs fusionnés + compte des réattributions).
- ✅ E2E ajouté : frontend/e2e/contacts-duplicates.spec.ts.
- ✅ Dashboard contacts : lien "dédoublonnage" masqué si aucun doublon détecté.
- ✅ Workspace dédoublonnage : bouton "Relancer l'analyse" pour forcer un rafraîchissement des groupes sans reload de page.
- ✅ Liste contacts : sélection multiple + suppression en lot + action "Fusionner la sélection".
- ✅ Workspace de dédoublonnage : support d'une sélection manuelle transmise depuis la liste contacts.
- ✅ Standard UI "mode sélection" appliqué aux listes Contacts, Sessions, Quotes et Invoices (barre de contexte, clic ligne pour sélectionner, actions de lot).
- ✅ Standard UI "mode sélection" étendu à Contracts (table + cards + suppression en lot).
- ✅ Hook partagé useListSelectionMode branché sur Contacts/Sessions/Quotes/Invoices/Contracts pour supprimer la duplication de logique.
- ✅ Hook partagé useBulkDelete branché sur Contacts/Sessions/Quotes/Invoices/Contracts pour unifier le flow suppression en lot.
- ✅ Composant partagé BulkDeleteDialog branché sur Contacts/Sessions/Quotes/Invoices/Contracts pour unifier la modale de confirmation.
- ✅ Groupes ignorés en dédoublonnage : persistance locale + actions "Afficher/Masquer ignorés" et "Réinitialiser".
- ✅ Détection email renforcée: canonicalisation Gmail (+alias, points du local-part, googlemail.com → gmail.com) dans ContactsMergeService.
- ✅ Test backend ajouté: backend/src/__tests__/contacts-merge.service.spec.ts (normalisation email classique + cas Gmail alias).
- ✅ Nettoyage OCR list views : bloc "Documents avec OCR" retiré des vues Session et Contact.
- ✅ Page /documents retirée du frontend (routes/navigation nettoyées).
- ✅ Documents liés (SessionView + ContactView) : mode sélection + suppression en lot branchés via FileList (toolbar, sélection multi-lignes, confirmation bulk delete).
- ✅ E2E ajouté/étendu : frontend/e2e/list-selection-mode.spec.ts (contacts + contracts + sessions + quotes + invoices).
- ✅ Dashboard contacts : détail explicite des groupes de doublons par critère (Email / Téléphone) en plus du total.
- ✅ Pattern partagé ListHeaderActions branché sur Contacts/Sessions/Quotes/Invoices/Contracts pour factoriser les actions d'entête en mode sélection vs mode normal.
- ✅ Workspace de dédoublonnage: état de recherche/filtres synchronisé à l'URL (groupBy, q, showIgnored) pour partager une vue directement.
Référence : PLAN_AMELIORATIONS_CRM.md

8.b Séquence validée (prochaines itérations)

✅ Item noté au backlog : Relances automatiques devis/factures impayés (emails + timeline + opt-out client).
🚧 Prochaine priorité (en cours) : Timeline unifiée des interactions contact/session (emails, messages, documents, paiements, notes) avec filtres.
- ✅ Filtres UX ajoutés sur la timeline contact (recherche + type d’événement).
- ✅ Timeline session branchée sur les interactions CRM du contact, scoppée à la session courante.
- ✅ Enrichissement metadata timeline backend : sessionId propagé sur événements devis/factures/emails pour filtrage fiable côté session.
- ✅ E2E ajouté : frontend/e2e/contact-timeline-filters.spec.ts.
🎯 Ensuite : Renforcement fiscal export/journal (archive ZIP + manifest/hash + traçabilité contrôle).
🚧 Puis (en cours) : Revue complète de la brique workflows (modèle, UX, exécution, observabilité, dettes techniques).
- ✅ Audit initial structuré + plan sprintable documenté.
- 🎯 Lot 0 prioritaire : nettoyage de l'existant avant extension (audit + repair safe + classification template/custom/legacy).
- 🎯 Sprint 1 ciblé: quick wins UX (mode basic/advanced, validations bloquantes, résumé avant sauvegarde).
- 🎯 Sprint 2 ciblé: simulation "dry-run" avant activation.
- 🎯 Sprint 4.1 ciblé: flows par défaut versionnés en base (seed idempotent).
- Référence: WORKFLOWS_REVIEW_PLAN.md

Impact : Conformité légale essentielle
Effort : Moyen-Élevé
Description : Portail complet pour gérer les données personnelles (export, suppression, rectification, consentements, traçabilité)
Statut : ✅ Complété (2025-01-27)
Livrables :
- ✅ Migrations GDPR (consentements, demandes, exports, logs d’effacement, activités de traitement)
- ✅ Service et contrôleur RGPD (accès, portabilité, rectification, effacement, opposition, limitation)
- ✅ Portail frontend /gdpr avec onglets Consentements / Mes droits / Mes demandes / Informations légales
- ✅ Textes légaux conformes (bases légales, durées de conservation, contact, CNIL)
- ✅ Export des données (JSON/CSV/XML), vérification par email, planification d’effacement et annulation

📋 Priorité Moyenne (Impact moyen, Effort variable)

0. Sync avancé Pennylane

Impact : Élevé (fiabilité du cycle financier visible, réduction des écarts de statut)
Effort : Moyen-Élevé
Description : étendre le MVP provider avec webhooks, synchronisation de statuts, paiements, avoirs et paiements partiels.
Statut : Planifié après le MVP Billing externalisé / Pennylane
Référence : PLAN_AMELIORATIONS_CRM.md

0.a Portail client V2

Impact : Élevé (expérience client plus cohérente, visibilité documentaire et financière)
Effort : Moyen
Description : enrichir le portail avec documents/factures externes, historiques d’action et meilleure lecture des états de paiement.
Statut : Planifié
Référence : PLAN_AMELIORATIONS_CRM.md

0.b Analytics business

Impact : Élevé (pilotage revenus, conversion et performance commerciale)
Effort : Moyen
Description : fournir une lecture business unifiée devis -> facture externe -> paiement, avec analytics par type de séance et tunnel de conversion.
Statut : Planifié
Référence : PLAN_AMELIORATIONS_CRM.md

0.c Iris proactive V1

Impact : Élevé (assistant réellement prescriptif, valeur quotidienne plus tangible)
Effort : Moyen-Élevé
Description : faire évoluer Iris vers des suggestions de priorités, relances et actions contextuelles pilotées par les signaux CRM/business.
Statut : Planifié
Référence : PLAN_AMELIORATIONS_CRM.md

1. Élargissement multi-corps de métier (événementiel)

Impact : Ouverture à d’autres métiers (traiteurs, DJ, wedding planners, etc.)
Effort : Élevé (planification)
Description : Planifier l’évolution terminologie (session vs événement vs prestation), champs communs vs spécifiques métier, portail client "client événementiel". Thèmes : i18n, types de session, rôles, onboarding par métier. Pas d’implémentation détaillée dans ce ticket.
Statut : Planification
Référence : PLAN_AMELIORATIONS_CRM.md, ROADMAP.md

2. Global Search & IA - Phase 2

Impact : Améliore la productivité
Effort : Moyen
Description :
- Création assistée par IA d'entités (contacts, sessions, devis, factures)
- Génération de rapports intelligents
- Rédaction assistée
Statut : Planifié
Référence : PLAN_AMELIORATIONS_CRM.md

3. Scheduled exports/reports ✅

Impact : Automatisation utile
Effort : Moyen
Description :
- ✅ Scheduled emails pour devis/factures/contrats (déjà implémenté)
- ✅ Système d'export centralisé multi-formats (PDF, Word, CSV, Excel, JSON) - Complété
- ✅ Scheduled exports (CSV, Excel, JSON, PDF, Word) avec récurrence - Complété
- ✅ Envoi automatique d'exports par email - Complété
- ✅ Sélection personnalisée des champs à exporter - Complété
- ✅ Templates d'export pré-configurés - Complété
- ✅ Système d'import CSV/Excel avec validation - Complété
  - ✅ Import pour Contacts - Complété
  - ✅ Import pour Sessions - Complété
  - ✅ Import pour Quotes - Complété
  - ✅ Import pour Invoices - Complété
  - ✅ Interface frontend complète avec boutons et dialogs pour toutes les entités - Complété
  - ✅ Mapping renforcé pour exports Google Contacts (headers Given Name / Family Name / E-mail 1 - Value / Phone 1 - Value / adresses) - Complété
  - ✅ Déduplication assistée à l'import contacts (warnings explicites sur doublons intra-fichier et contacts existants + option updateExisting) - Complété
  - ✅ Revue pré-import contacts avec actions par ligne (Créer / Mettre à jour / Ignorer) via endpoint preview + étape dédiée dans le wizard - Complété
- ❌ Scheduled report generation pour analytics - À venir
Statut : ✅ Complété (système d'export/import complet avec planification)
Documentation :
- docs/EXPORT_SYSTEM.md
- docs/IMPORT_SYSTEM.md
- docs/SCHEDULED_EXPORTS.md
- docs/EXPORT_TEMPLATES.md

4. Planification récurrente pour les sessions ✅

Impact : Améliore la productivité pour les sessions régulières
Effort : Moyen-Élevé
Description : Permettre de créer des sessions récurrentes (quotidien, hebdomadaire, mensuel, annuel) avec gestion des occurrences individuelles et synchronisation Google Calendar
Fonctionnalités :
- ✅ Patterns de récurrence (quotidien, hebdomadaire avec jours spécifiques, mensuel, annuel)
- ✅ Date de fin de récurrence
- ✅ Modification/suppression d'occurrences individuelles ou de toute la série
- ✅ Synchronisation Google Calendar (événements récurrents avec RRULE)
- ✅ Gestion des exceptions Google Calendar pour modifications/suppressions individuelles
- ✅ Interface utilisateur avec sélecteur de récurrence
- ✅ Génération dynamique des occurrences dans le calendrier
- ✅ Indicateur visuel pour les sessions récurrentes
Statut : ✅ Complété
Estimation : 5-7 jours de développement (réalisé)
Référence : PLAN_AMELIORATIONS_CRM.md - Section "Gestion des Sessions & Réservations"
Améliorations complétées récemment :
- ✅ Prévisualisation des occurrences (composant RecurrencePreview intégré dans le formulaire)
- ✅ Modification de recurrence_end_date avec suppression automatique des occurrences au-delà
- ✅ Modification du pattern de récurrence avec régénération automatique des occurrences
- ✅ Génération périodique des occurrences (job cron quotidien pour générer jusqu'à 12 mois à l'avance)
- Améliorations futures :
  - ✅ Synchronisation bidirectionnelle depuis Google Calendar (Complété)
    - ✅ Détection et synchronisation des occurrences modifiées dans Google Calendar
    - ✅ Détection et suppression des occurrences supprimées dans Google Calendar
    - ✅ Gestion des exceptions Google Calendar (modifications individuelles)
    - ✅ Résolution de conflits pour les événements récurrents

5. Segmentation avancée des contacts

Impact : Marketing plus efficace
Effort : Moyen
Description : Permettre une segmentation avancée des contacts pour des campagnes marketing ciblées
Statut : Non commencé

6. Workflows visuels

Impact : Automatisation puissante
Effort : Élevé
Description : Créer un système de workflows visuels pour automatiser des processus métier
Statut : Non commencé

7. Gestion des paiements ✅ COMPLÉTÉ

Impact : Améliore le suivi financier
Effort : Moyen-Élevé
Description : Système complet de gestion des paiements et abonnements via Stripe
Statut : ✅ Complété
Fonctionnalités implémentées :
- ✅ Gestion des abonnements : Création, annulation et reprise d'abonnements (FREE, BASIC, PRO)
- ✅ Paiement des factures : Paiement des factures via Stripe Payment Intents avec Stripe Elements
- ✅ Collecte de méthodes de paiement : SetupIntent pour collecter les méthodes de paiement pour les abonnements
- ✅ Attachement de méthodes de paiement : Attachement automatique des méthodes de paiement au client Stripe et définition comme méthode par défaut
- ✅ Webhooks Stripe : Synchronisation automatique des statuts d'abonnements et paiements via webhooks
- ✅ Historique des paiements : Suivi complet de tous les paiements effectués
- ✅ Interface utilisateur : Formulaires de paiement sécurisés avec Stripe Elements, gestion des abonnements dans l'interface utilisateur
Documentation : backend/src/stripe/README.md

8. Architecture Workers BullMQ - Déportement OCR PDF, Relances, IA, Exports ✅ ~95% COMPLÉTÉ

Impact : Très élevé - Améliore la maintenabilité, scalabilité et performance en déportant les actions lourdes
Effort : Élevé (4-6 semaines)
Description : Refactorisation de l'architecture pour séparer l'API synchrone (validation + persistance + enqueue) des workers asynchrones (exécution + retries + observabilité). Déportement des actions longues/lourdes (OCR PDF, relances, IA, exports) dans des workers BullMQ dédiés.
Priorité : Haute
Statut : ✅ ~95% complété (2026-01-31)
Complété :
- ✅ 5 workers isolés : WorkerEmailModule, WorkerAiModule, WorkerExportModule, WorkerDocModule, WorkerMlModule
- ✅ Processors implémentés : ExportBuildProcessor, EmailSendProcessor, AiRunProcessor, DocIngestProcessor, DocOcrProcessor, DocExtractStructuredProcessor, 6 ML processors
- ✅ Exports complets : ACCOUNTING (invoices/quotes), CONTACTS, SESSIONS, GDPR, CUSTOM (tous routés vers ExportService)
- ✅ OCR PDF : Pipeline complet d'ingestion, OCR, extraction structurée
- ✅ IA orchestrée : Tâches IA avec quotas, rate limiting, suivi des coûts
- ✅ Job tracking : JobRunsService avec suivi complet (QUEUED → RUNNING → COMPLETED/FAILED)
- ✅ Idempotence : generateJobId() avec hash stable pour déduplication
- ✅ Payloads versionnés : Tous les payloads { v: 1, ... } avec validation Zod
- ✅ DLQ Replay : Endpoint POST /api/job-runs/:id/replay pour rejouer les jobs échoués
- ✅ Tests unitaires : 73 tests couvrant tous les processors et services (7 fichiers)
- ✅ Admin UI : Page /system/jobs avec table des jobs, stats, filtres, et bouton replay
- ✅ Fix duplicate queue : Suppression du BullModule.registerQueue en double pour EXPORTS
Architecture :
- ✅ API synchrone : Validation (Zod) + persistance (Postgres) + enqueue (BullMQ)
- ✅ Workers asynchrones : Exécution + retries/backoff + idempotence + DLQ
- ✅ Contrats stables : Payloads versionnés { v: 1, ... } + validation Zod
- ✅ Storage centralisé : Artefacts stockés en R2 via FileObjectsService
- ✅ WorkerModule propre : Aucun import WebSocket/Search/Agent, uniquement infra + processors
- ✅ ScheduleModule : ScheduleModule.forRoot() uniquement dans ScheduleRuntimeModule
Tables transversales :
- ✅ job_runs : Suivi d'exécution et corrélation logs
- ✅ file_objects : Référentiel d'artefacts (R2)
- ✅ export_jobs : Suivi des jobs d'export
Restant (~5%) :
- ✅ Métriques Prometheus (compteurs succès/échec + histogramme durée des jobs via job_runs)
- ✅ Documentation DI_CONVENTIONS.md (2026-02-27) : principes NestJS, Core Modules, tests
Fichiers clés :
- Backend : src/workers/worker-*/, src/job-runs/, src/queue/
- Frontend : src/pages/admin/AdminJobsPage/, src/client/job-runs/
- Tests : src/__tests__/workers/ (7 fichiers, 73 tests)
Documentation :
- docs/WORKERS_ARCHITECTURE.md : Principes, process, queues, conventions jobs
- docs/DOCUMENT_PROCESSING_OCR.md : DDD + DB + endpoints + jobs + UI
- docs/AI_ORCHESTRATION.md : Tasks, quotas, coûts, endpoints, worker
- docs/EXPORTS.md : Types, statuts, R2, endpoints
- docs/OBSERVABILITY.md : job_runs, corrélation, métriques, DLQ
- docs/DI_CONVENTIONS.md : Conventions DI NestJS, Core Modules, tests (backend)
Référence : PLAN_AMELIORATIONS_CRM.md - Section "Infrastructure & Robustesse > 5.1. Architecture Workers BullMQ"

8. Monitoring et observabilité

Impact : Essentiel pour la stabilité et le debugging
Effort : Moyen
Description : Système complet de monitoring avec Sentry, métriques de performance, logs centralisés et alertes
Priorité : Haute
Statut : En cours (MVP observabilité terminé)
Avancement récent :
- ✅ Métriques jobs branchées sur le cycle de vie job_runs (success/fail + durée) via MetricsService
- ✅ Mapping automatique job_name → queue (EXPORTS, SCHEDULED_EMAILS, AI_INSIGHTS, PYTHON_ML)
- ✅ Endpoint GET /api/health/live (liveness probe)
- ✅ Endpoint GET /api/health/ready (readiness probe DB + Redis, statut ok/degraded/down, 503 si non prêt)
- ✅ Alerting applicatif (scheduler) branché sur health/ready down + spikes http_request_errors_total avec envoi Slack/email
- ✅ Alerting applicatif enrichi: détection des spikes queue_jobs_total{status="failed"} via scheduler + notification Slack/email
- ✅ Dashboard Grafana minimal provisionné (latence API p95, rate erreurs HTTP, rate jobs failed, durée jobs p95)
- ✅ Alertes Prometheus SLO HTTP ajoutées (warning >1% sur 10m, critical >5% sur 5m)
- ✅ Dashboard Grafana observabilité enrichi avec panels SLO (success rate, error budget remaining 30d, burn rate 1h/6h)
- ✅ Stack locale Prometheus/Grafana prête via profil Docker Compose monitoring
- ✅ Sous-domaines ops prod actifs (queues, grafana, prometheus) avec TLS et protections d’accès
- ✅ Admin panel: carte "Ops Status" + endpoint GET /api/ops/status + bouton test POST /api/observability/alerts/test
- ✅ Règles Prometheus enrichies (ApiTargetDown, HttpErrorsSpike, QueueJobsFailedSpike, ApiLatencyP95High)
Restant (prochaine itération) :
- ⏳ Logs centralisés (ELK/Loki/Cloud provider)
- ⏳ Intégration Alertmanager/PagerDuty/Opsgenie (au-delà du canal Slack/email actuel)
- ⏳ Dashboard avancé (SLO/SLI détaillés + vues coût/capacité)
Référence : PLAN_AMELIORATIONS_CRM.md - Section "Infrastructure & Robustesse"

9. Renforcement des tests E2E (Playwright)

Impact : Élevé (fiabilité des parcours critiques et réduction des régressions)
Effort : Moyen
Priorité : Haute
Statut : Planifié
Description :
- Intégrer les tests E2E en CI sur chaque PR avec blocage du merge sur échec du smoke path
- Publier automatiquement les artefacts de debug (screenshots, vidéos, traces)
- Couvrir en priorité les parcours critiques business :
  - Authentification (login/logout/session expirée)
  - Parcours coeur produit (création/édition/suppression des entités principales)
  - Paiement et onboarding (si applicable)
- Réduire la flakiness :
  - wait explicites sur états stables
  - Données seedées et isolation stricte des scénarios
  - Fixtures robustes et réutilisables
- Structurer la stratégie de suite :
  - Suite smoke (< 5 min) sur PR
  - Suite regression en nightly
  - Suites spécifiques par feature
- Mesurer et piloter la qualité :
  - Taux d'échec par spec
  - Temps moyen d'exécution
  - Top 5 tests instables à corriger en priorité
Avancement récent :
- ✅ Couverture e2e du mode sélection étendue (contacts, contracts, sessions, quotes, invoices) via frontend/e2e/list-selection-mode.spec.ts
- ✅ Smoke auth e2e : parcours login UI (email → mot de passe → dashboard) dans frontend/e2e/auth.smoke.spec.ts (2026-02-27, requiert E2E_EMAIL / E2E_PASSWORD)
Référence : frontend/e2e/README.md, frontend/playwright.config.ts

10. Conformité fiscale sans NF525 (article 286 CGI)

Impact : Élevé (confiance comptable, cadre documentaire et auditabilité)
Effort : Moyen
Priorité : Moyenne
Statut : Requalifié
Objectif :
- Maintenir un cadre documentaire et technique crédible autour de l'article 286 du CGI via attestation, conservation et archivage
- Compléter le dispositif sans en faire le chantier principal de roadmap, l’exécution court terme basculant sur Billing externalisé / Pennylane
Requalification 2026 :
- ce lot n’est pas supprimé,
- il passe d’un axe principal de facturation interne à un axe de gouvernance, d’archivage et de préparation au contrôle,
- les futurs statuts de facturation électronique doivent être relayés depuis le provider externe plutôt que recalculés intégralement dans Aaperture.
Plan d'action (6 blocs) :
- Bloc 1 - Attestation individuelle de conformité (obligatoire) :
  - Rédiger une attestation éditeur versionnée pour Aaperture
  - Rendre l'attestation téléchargeable
  - Inclure identification éditeur/logiciel, référence article 286 CGI, engagement et date/signature
- Bloc 2 - Conservation 6 ans (formalisée) :
  - Formaliser une politique de conservation (factures, avoirs, paiements, journaux, sauvegardes, restauration)
  - Ajouter un garde-fou technique simple (is_fiscal_locked = true) interdisant toute purge < 6 ans
- Bloc 3 - Archivage fiscal explicite :
  - Définir la notion "facture archivée" (PDF figé, hash, métadonnées figées, non modifiable, exportable)
  - Ajouter un export fiscal ZIP (/invoices, index.json, manifest.sha256)
  - Documenter le process d'archivage et de restitution
- Bloc 4 - Journal des événements fiscaux :
  - Exposer une vue dédiée des événements (émission facture, génération PDF, paiement, avoir, export)
  - Option : export CSV du journal fiscal
- Bloc 5 - Page "Conformité fiscale" :
  - Créer /settings/compliance avec attestation téléchargeable, export archive fiscale et FAQ NF525
  - Fournir un texte prêt à copier pour l'expert-comptable
- Bloc 6 - Dossier "contrôle fiscal ready" :
  - Structurer la doc dans docs/fiscal/ pour auditabilité et réponse rapide en contrôle
Roadmap suggérée : 10 jours max (attestation, conservation, archivage, export ZIP, journal fiscal, page conformité, FAQ, relecture finale)
Références :
- docs/fiscal/OVERVIEW.md
- docs/fiscal/ATTESTATION.md
- docs/fiscal/ARCHIVING.md
- docs/fiscal/RETENTION.md
- docs/fiscal/FAQ.md
En attente pour finaliser le Bloc 1 (attestation signée) :
- Données signataire : nom, fonction, ville, date de signature
- Identité éditeur à figer : raison sociale, adresse siège, email, site web, SIREN/SIRET (optionnel)
- Arbitrage de diffusion : format officiel final (.md et/ou .pdf) et version finale (v1.0.0 ou v1.0.1)
Avancement récent :
- ✅ Bloc 2 (partiel) : suppression de factures fiscalement verrouillées bloquée pendant 6 ans (status != DRAFT)
- ✅ Bloc 5 (partiel) : page /settings/compliance enrichie avec statut attestation + liens politiques de conservation/archivage/FAQ

8. Gestion des erreurs de connexion DB ✅

Impact : Réduction des erreurs dans les jobs cron
Effort : Faible
Description : Retry automatique pour les erreurs de connexion PostgreSQL dans les schedulers
Statut : ✅ Complété
Référence : PLAN_AMELIORATIONS_CRM.md - Section "Performance & Scalabilité"

🔧 Améliorations Agent IA (Priorité Moyenne)

0. Stabilisation post‑refonte chat agent

Objectif : Fiabiliser l’exécution quand une action / est explicitement choisie
À couvrir :
- Arbitrage / vs intention détectée
- Auto‑complétion @ par type et sélection d’élément
- Pré‑remplissage fiable des formulaires via tokens @
- Réponses plus “humaines” + formats de résultats uniformisés
- Cohérence des statuts de formulaires (DONE/CANCELED) sans duplicats
Statut : À planifier
Référence : REFONTE_CHAT_AGENT.md

1. Gestion des erreurs améliorée

Problème : Les erreurs sont parfois génériques ou peu informatives
Solution :
- Créer des types d'erreurs spécifiques pour chaque type d'action
- Fournir des messages d'erreur plus détaillés et actionnables
- Ajouter des codes d'erreur pour faciliter le debugging
Statut : À faire
Référence : REFONTE_CHAT_AGENT.md

2. Validation des actions avant exécution

Problème : Les actions sont exécutées directement sans validation approfondie
Solution :
- Ajouter une étape de validation pré-exécution
- Vérifier que toutes les données requises sont présentes
- Prévisualiser les changements avant exécution
- Demander confirmation pour les actions critiques
Statut : À faire

3. Historique et audit des actions

Problème : Pas de traçabilité complète des actions exécutées via l'agent
Solution :
- Enregistrer toutes les actions dans un log d'audit
- Associer chaque action à la conversation qui l'a déclenchée
- Permettre de voir l'historique des actions par conversation
Statut : À faire

4. Tests unitaires pour les helpers et handlers

Statut actuel :
- ✅ Tests unitaires pour ConflictDetectionHelper (26 tests) - Complété
- ✅ Tests unitaires pour ActionHelpers : validateRequiredParams, replacePlaceholders, extractEntityId, buildContextFromResults + actionResult (14 tests) (2026-02-27)
- ✅ Tests unitaires pour EntitySearchHelper.searchContactByName (4 tests) (2026-02-27)
- 🚧 Tests unitaires pour les handlers d'actions
Référence : REFONTE_CHAT_AGENT.md

📊 Priorité Basse (Impact variable, Effort élevé)

1. Global Search & IA - Phase 3

Impact : Intelligence avancée
Effort : Élevé
Description :
- Analyse et insights automatiques - 🚀 Déplacé vers LOT A (Priorité Haute) - Système d'insights proactifs avec règles déterministes. Voir section "IA Proactive Insights (LOT A - MVP)" dans Priorité Haute.
- Suggestions d'actions contextuelles
- Recherche conversationnelle
- Prédictions et recommandations
- Résumé et synthèse
Statut : Planifié (insights automatiques traités séparément en LOT A)

2. Statistiques avancées pour bookings

Impact : Améliore l'analyse des réservations
Effort : Moyen
Description :
- Dashboard avec statistiques avancées (réservations par période, taux d'annulation, créneaux populaires)
- Export des données (CSV, Excel, JSON)
- Graphiques et visualisations
Estimation : 5-7 jours de développement
Statut : Non commencé

3. Personnalisation de la page de réservation

Impact : Améliore l'expérience client
Effort : Moyen
Description :
- Personnalisation des couleurs et du thème
- Messages de confirmation personnalisés
- Support multilingue amélioré
Estimation : 3-4 jours de développement
Statut : Non commencé

4. Gestion des timezones pour bookings

Impact : Améliore l'expérience internationale
Effort : Moyen
Description :
- Détection automatique du timezone du client
- Affichage des heures dans le timezone local
- Conversion automatique lors de la réservation
Estimation : 3-4 jours de développement
Statut : Non commencé

5. Application mobile native

Impact : Accessibilité mobile
Effort : Très élevé
Description : Développer une application mobile native (iOS/Android)
Statut : Non commencé

6. Analytics prédictives

Impact : Insights avancés
Effort : Très élevé (nécessite ML)
Description : Utiliser le machine learning pour prédire les tendances
Statut : Non commencé

📝 Notes

Ce document est évolutif et doit être mis à jour régulièrement
Les priorités peuvent changer en fonction des retours utilisateurs
Certaines améliorations peuvent être combinées pour optimiser le développement
Il est important de valider les besoins avec les utilisateurs avant de développer

📚 Références

PLAN_AMELIORATIONS_CRM.md - Référence détaillée des améliorations par domaine fonctionnel
REFONTE_CHAT_AGENT.md - Référence active pour l'assistant Iris
BOOKING_IMPROVEMENTS.md - Améliorations du système de réservation
BOOKING_SYSTEM.md - Documentation du système de réservation

Nouveau chantier lancé​

🎯 Prochaines étapes recommandées​

🚀 Priorité plateforme immédiate​

✅ Focus soldés récemment​

🎯 Prochain focus recommandé​

🧹 Prochain nettoyage recommandé​

Assistant CRM / chat workspace​

Gouvernance documentaire​

✅ Complété Récemment​

🚀 Priorité Haute (Impact élevé, Effort moyen)​

0.a Relation clientèle omnicanale (CRM) 🚀​

0.b Visual Day Planner mariage 🚀​

0. Proposal v3 - Tests + QA + polish final ✅​

0.c Billing externalisé / Pennylane 🚀​

0.d Storage abstraction / Scaleway ⏸️​

0. Refactoring Frontend - Fichiers Critiques ✅ TERMINÉ​

1. Calendrier visuel amélioré ✅ COMPLÉTÉ​

2. Sécurité CASA pour validation Google ✅ COMPLÉTÉ​

3. IA Proactive Insights (LOT A - MVP) ✅ 100% COMPLÉTÉ​

4. Système d'Authentification Client ✅ PHASES 1→5 COMPLÉTÉES​

5. Authentification à deux facteurs (2FA)​

6. Refonte chat agent avec commandes en /​

7. Sécurisation des insertions agent (contacts/sessions) et doublons​

8. Gestion des doublons (contacts)​

8.b Séquence validée (prochaines itérations)​

9. GDPR / RGPD - Portail de gestion des données ✅ COMPLÉTÉ​

📋 Priorité Moyenne (Impact moyen, Effort variable)​

0. Sync avancé Pennylane​

0.a Portail client V2​

0.b Analytics business​

0.c Iris proactive V1​

1. Élargissement multi-corps de métier (événementiel)​

2. Global Search & IA - Phase 2​

3. Scheduled exports/reports ✅​

4. Planification récurrente pour les sessions ✅​

5. Segmentation avancée des contacts​

6. Workflows visuels​

7. Gestion des paiements ✅ COMPLÉTÉ​

8. Architecture Workers BullMQ - Déportement OCR PDF, Relances, IA, Exports ✅ ~95% COMPLÉTÉ​

8. Monitoring et observabilité​

9. Renforcement des tests E2E (Playwright)​

10. Conformité fiscale sans NF525 (article 286 CGI)​

8. Gestion des erreurs de connexion DB ✅​

🔧 Améliorations Agent IA (Priorité Moyenne)​

0. Stabilisation post‑refonte chat agent​

1. Gestion des erreurs améliorée​

2. Validation des actions avant exécution​

3. Historique et audit des actions​

4. Tests unitaires pour les helpers et handlers​

📊 Priorité Basse (Impact variable, Effort élevé)​

1. Global Search & IA - Phase 3​

2. Statistiques avancées pour bookings​

3. Personnalisation de la page de réservation​

4. Gestion des timezones pour bookings​

5. Application mobile native​

6. Analytics prédictives​

📝 Notes​

📚 Références​