Aller au contenu

🔄 Workflows Utilisateur - Teadle

Ce document décrit tous les parcours utilisateur de l'application Teadle, de la connexion jusqu'à l'utilisation des dashboards, incluant les fonctionnalités de reprise d'onboarding.

📋 Table des matières


🔐 Connexion

Flux de connexion standard

graph TD
    A[Page d'accueil] --> B[Formulaire de connexion]
    B --> C{Identifiants valides?}
    C -->|Oui| D[Appel API /security/login]
    C -->|Non| E[Affichage erreur]
    D --> F[Appel API /me]
    F --> G{finishedOnBoarding?}
    G -->|true| H[Redirection dashboard]
    G -->|false| I[Vérification données onboarding]
    I --> J{Données onboarding existantes?}
    J -->|Oui| K[Reprise d'onboarding]
    J -->|Non| L[Redirection onboarding initial]
    E --> B

Connexion OAuth

graph TD
    A[Clique sur OAuth] --> B[Ouverture popup]
    B --> C[Authentification provider]
    C --> D[Callback avec code]
    D --> E[API /security/user/{provider}/oauth]
    E --> F{finishedOnBoarding?}
    F -->|true| G[Redirection dashboard]
    F -->|false| H[Nettoyage localStorage onboarding]
    H --> I[Redirection onboarding approprié]

Étapes détaillées

  1. Page d'accueil (/)
  2. Formulaire email/mot de passe
  3. Boutons OAuth (LinkedIn, Google, Microsoft)
  4. Boutons d'inscription (Trainer, Organization)

  5. Validation des identifiants

  6. API : POST /security/login
  7. Gestion des erreurs (401, 500, etc.)

  8. Récupération des données utilisateur

  9. API : GET /me
  10. Vérification de finishedOnBoarding

  11. Redirection intelligente

  12. Si finishedOnBoarding: true → Dashboard approprié
  13. Si finishedOnBoarding: false → Vérification reprise d'onboarding

👨‍🏫 Inscription Trainer

Flux d'inscription par formulaire

graph TD
    A[Page d'accueil] --> B[Clique "Devenir formateur"]
    B --> C[Page sélection expérience]
    C --> D[Choix niveau d'expérience]
    D --> E[Page inscription]
    E --> F[Formulaire email/password]
    F --> G[API /security/trainer/register]
    G --> H[Redirection onboarding]

Flux d'inscription OAuth

graph TD
    A[Page inscription] --> B[Clique OAuth]
    B --> C[Authentification provider]
    C --> D[Callback OAuth]
    D --> E[API /security/user/{provider}/oauth]
    E --> F[Sauvegarde données onboarding]
    F --> G[Redirection onboarding]

Étapes détaillées

  1. Sélection du profil (/onboarding/trainer)
  2. Choix du niveau d'expérience
  3. Sauvegarde : onboardingStorage.saveSection('trainerExperience', {...})
  4. Bouton "Continuer"

  5. Inscription (/onboarding/trainer/signup)

  6. Formulaire email/password
  7. Boutons OAuth (LinkedIn, Google, Microsoft)
  8. API : POST /security/trainer/register
  9. Sauvegarde : onboardingStorage.saveSection('signup', {...})

  10. Redirection vers onboarding

  11. Token JWT reçu
  12. finishedOnBoarding: false

🏢 Inscription Organization

Flux d'inscription par formulaire

graph TD
    A[Page d'accueil] --> B[Clique "Devenir organisation"]
    B --> C[Page inscription]
    C --> D[Formulaire email/password]
    D --> E[API /onboarding/user-exist/check]
    E --> F{Email disponible?}
    F -->|Oui| G[Page validation email]
    F -->|Non| H[Erreur email existant]
    G --> I[Saisie code validation]
    I --> J[API /security/auth-code/verify]
    J --> K[API /security/organization/register]
    K --> L[Redirection onboarding]

Flux d'inscription OAuth

graph TD
    A[Page inscription] --> B[Clique OAuth]
    B --> C[Authentification provider]
    C --> D[Callback OAuth]
    D --> E[API /security/user/{provider}/oauth]
    E --> F[Sauvegarde données onboarding]
    F --> G[Redirection onboarding]

Étapes détaillées

  1. Inscription (/onboarding/organization/signup)
  2. Formulaire email/password
  3. Boutons OAuth (LinkedIn, Google, Microsoft)
  4. API : POST /onboarding/user-exist/check
  5. Sauvegarde : onboardingStorage.saveSection('signup', {...})

  6. Validation email (/onboarding/organization/email-validation)

  7. Envoi automatique du code
  8. API : POST /security/auth-code/send
  9. Saisie du code à 6 chiffres
  10. API : POST /security/auth-code/verify

  11. Création du compte

  12. API : POST /security/organization/register
  13. Token JWT reçu
  14. finishedOnBoarding: false

🎯 Onboarding Trainer

Flux complet

graph TD
    A[Inscription réussie] --> B[Informations personnelles]
    B --> C[Options de profil]
    C --> D[Édition expériences]
    D --> E[API /trainer/career]
    E --> F[Finalisation]
    F --> G[Dashboard trainer]

    B --> B1{signupMethod?}
    B1 -->|OAuth| B2[Pré-remplissage OAuth]
    B1 -->|Email| B3[Formulaire complet]
    B1 -->|Resume| B4[Pré-remplissage utilisateur]

Étapes détaillées

  1. Informations personnelles (/onboarding/trainer/personal-info)
  2. Prénom, nom
  3. Mot de passe (si pas OAuth/Resume)
  4. Acceptation CGV
  5. API : PUT /trainer/preferences
  6. Sauvegarde : onboardingStorage.saveSection('personalInfo', {...})

  7. Options de profil (/onboarding/trainer/profile-options)

  8. Configuration du profil
  9. Sauvegarde : onboardingStorage.saveSection('profileOptions', {...})
  10. Bouton "Continuer"

  11. Édition des expériences (/onboarding/trainer/experiences-edit)

  12. Import depuis CV (si applicable)
  13. Ajout/modification d'expériences
  14. API : POST /trainer/career
  15. Sauvegarde : onboardingStorage.saveSection('experiences', {...})

  16. Finalisation

  17. Depuis Options de profil (« Continuer plus tard ») : POST /user/onboarding/validate (finishOnboarding) puis onboardingStore.fetchProgress() (GET /me) pour synchroniser la progression onboarding et sampleData.
  18. Depuis Édition des expériences (après POST /trainer/career) : fetchProgress() avant redirection pour la même mise à jour.
  19. Nettoyage localStorage (parcours expériences)
  20. Redirection : dashboard formateur

🏢 Onboarding Organization

Flux complet

graph TD
    A[Inscription réussie] --> B[Informations personnelles]
    B --> C[Paramètres organisation]
    C --> D[API /organization/info]
    D --> E[Finalisation]
    E --> F[Dashboard organization]

    B --> B1{signupMethod?}
    B1 -->|OAuth| B2[Pré-remplissage OAuth]
    B1 -->|Email| B3[Formulaire complet]
    B1 -->|Resume| B4[Pré-remplissage utilisateur]

Étapes détaillées

  1. Informations personnelles (/onboarding/organization/personal-info)
  2. Prénom, nom
  3. Numéro de téléphone (optionnel)
  4. Acceptation CGV et opt-in
  5. API : PUT /organization/preferences
  6. Sauvegarde : onboardingStorage.saveSection('personalInfo', {...})

  7. Paramètres organisation (/onboarding/organization/settings)

  8. Nom de l'organisation
  9. Service au sein de l'organisation
  10. Type d'organisation
  11. API : PATCH /organization/info
  12. Sauvegarde : onboardingStorage.saveSection('settings', {...})

  13. Finalisation

  14. API : GET /me (mise à jour finishedOnBoarding)
  15. Redirection : /dashboard/organization

🔄 Reprise d'Onboarding

Détection automatique

graph TD
    A[Connexion utilisateur] --> B{finishedOnBoarding?}
    B -->|false| C[Vérification localStorage]
    C --> D{Données onboarding existantes?}
    D -->|Oui| E[Affichage bannière reprise]
    D -->|Non| F[Onboarding initial]
    E --> G[Utilisateur clique "Reprendre"]
    G --> H[Redirection étape appropriée]
    H --> I[Mode reprise activé]

Gestion du localStorage

graph TD
    A[Stockage des données] --> B[Section par étape]
    B --> C[trainerExperience]
    B --> D[signup]
    B --> E[personalInfo]
    B --> F[profileOptions]
    B --> G[experiences]
    B --> H[settings]

    I[Reprise détectée] --> J[Création données minimales]
    J --> K[signup: {signupMethod: 'resume', ...}]
    K --> L[Redirection étape appropriée]

Fonctionnalités de reprise

  1. Détection automatique
  2. Vérification finishedOnBoarding: false
  3. Analyse du localStorage
  4. Affichage bannière de reprise

  5. Mécanisme de reprise

  6. Reprise pilotée par les données persistées (signupMethod: 'resume')
  7. Redirection vers l'étape connectée attendue
  8. Préremplissage des données déjà connues

  9. Mode reprise

  10. Pré-remplissage des champs
  11. Masquage des étapes inutiles
  12. Sauvegarde des données existantes

  13. Gestion des données

  14. Section signup avec signupMethod: 'resume'
  15. Données utilisateur pré-remplies
  16. Conservation du token d'authentification

APIs de reprise

  • Vérification utilisateur : GET /me
  • Mise à jour préférences : PUT /trainer/preferences, PUT /organization/preferences
  • Finalisation : POST /trainer/career, PATCH /organization/info

📊 Dashboard Trainer

Quand l'onboarding n'est pas terminé, un bandeau droit affiche la progression. Comportement :

  • Ouvert par défaut à chaque arrivée sur le dashboard (refresh ou changement de page)
  • L'utilisateur peut le fermer (« Fermer » ou « Réduire ») ; la préférence n'est pas persistée
  • Au prochain chargement de page ou navigation, le bandeau s'ouvre à nouveau
  • Masqué définitivement une fois l'onboarding à 100 %

Item « Démarrer » (menu gauche) — FEAT-090

La signalétique onboarding n’est plus un badge sur « Tableau de bord » (ancien pattern DISC-005) : un item dédié Démarrer (icône fusée, badge X/5 corail ou coche verte) apparaît entre « Tableau de bord » et « Mon planning » lorsque useOnboardingStore().showInSidebar est vrai (onboarding en cours, ou terminé dans les 7 jours si la checklist n’est pas masquée). Lien interne /trainer/getting-started ; le menu utilisateur Guide de démarrage pointe vers la même page (plus de lien marketing externe). Bootstrap sans GET /me : hydrateProgressFromAuth() au tout début du setup de TrainerLayout (pas au onMounted, sinon les vues enfant montent avant et ratent fetchSampleDataPayload), puis filet au onMounted et quand auth.user.onboardingProgress devient disponible (watch). Copie si progress === null — d’abord depuis auth.user.onboardingProgress, sinon depuis un snapshot localStorage (onboardingProgressSnapshot.js, clé teadle_onboarding_progress_snapshot, TTL 24 h) pour conserver checklist et sampleData après un F5 avant le retour de /me. Le snapshot est écrit à chaque fetchProgress réussi et après les mutations qui touchent la progression (completeStep, dismiss, restore, dismissSampleData). Rafraîchissement réseau : fetchProgress() (GET /me) toutes les 5 minutes dans TrainerLayout + à chaque visite de la page Getting started uniquement.

La page Getting started (GettingStartedView) appelle à chaque affichage onboardingStore.fetchProgress() au montage (GET /me via authStore.fetchMe(), mise à jour de user.onboardingProgress), puis affiche un titre et sous-titre selon la progression, une barre segmentée à 5 blocs (OnboardingProgressBar), les actions masquer / réafficher la checklist (store dismiss / restore) puis une zone réservée à la checklist (FEAT-092). L’étape recommandée IMPORT_CALENDAR (« Connecter votre première organisation ») : CTA vers trainer-organizations-configure (/trainer/organizations/configure, ajout ou configuration d’organisation).
FEAT-095 : le masquage passe par un délai de grâce de 4 s (toast inline Gmail-style via BaseToast, action « Annuler », pause timer hover/focus) ; le dismiss backend n’est envoyé qu’à l’expiration.
FEAT-096 / FEAT-219 : section « Aller plus loin » affichée dès completedCount >= 3 (personnalisation facture, messagerie, statistiques, enrichissement CV → trainer-parcours-cv + lien aide), sans bloquer la checklist.
À la complétion des 5 étapes, une modale de célébration sobre une fois par navigateur (OnboardingCelebrationModal, flag localStorage teadle_onboarding_celebration_shown) — FEAT-094.

Accès et fonctionnalités

graph TD
    A[Connexion réussie] --> B{finishedOnBoarding?}
    B -->|true| C[Dashboard trainer]
    B -->|false| D[Redirection onboarding/reprise]
    C --> E[Vue opportunités]
    C --> F[Vue actions]
    C --> G[Vue planning]
    C --> H[Vue revenus]

Bandeaux onboarding dashboard (FEAT-097)

En tete du dashboard formateur (DashboardView.vue), trois bandeaux conditionnels pilotent le cycle de vie sample data (etats exclusifs) :

  • Sample data actif (SampleDataBanner, role status) : visible si onboardingProgress.sampleData.active === true et pas en fenetre pre-avert J-2 ; action "Supprimer les exemples" => POST /trainer/onboarding/sample-data/dismiss via onboardingStore.dismissSampleData().
  • Pre-avert J-2 (PreAvertBanner, role alert) : visible si sample actif et expiresAt <= now + 2 jours ; CTA "Partager mon profil" vers /trainer/getting-started.
  • Première vraie demande (FirstRealRequestBanner, vert maquette 🎉, role status) : visible hors mode sample si GET /trainer/dashboard/recent-requests retourne au moins un item avec isFirst: true (backend : lot affiché dans « À traiter » est le plus ancien lot du formateur en base — première demande encore en attente) et flag localStorage teadle_disc016_first_request_seen absent ; sous-titre depuis org / module / créneaux ; CTA « Voir la demande » vers /trainer/requests et pose du flag.

Injection sample dashboard (FEAT-098)

Quand sampleData.active === true, le dashboard passe en mode demonstration :

  • DashboardView.vue recupere onboardingStore.sampleDataPayload via fetchSampleDataPayload() (GET /trainer/onboarding/sample-data) et mappe vers les shapes attendues par les composants (effectiveSummary, effectiveInterventions*, effectiveRecentRequests, effectiveSchools). Le payload est mis en cache localStorage 24 h (onboardingSampleDataCache.js, cle teadle_onboarding_sample_data_cache) tant que le sample reste actif ; invalidation du cache uniquement si GET /me renvoie explicitement onboardingProgress.sampleData.active === false, après Supprimer les exemples (dismissSampleData), ou logout (clearBrowserStorageOnLogout). Pas de purge sur une réponse /me sans champ sampleData / active (évite un F5 qui efface le cache). Le snapshot teadle_onboarding_progress_snapshot (voir ci-dessus) évite de perdre le flag sampleData.active au premier rendu post-F5. Si sampleData.active === false dans la progression, aucun GET /trainer/onboarding/sample-data (le store court-circuite aussi la réhydratation depuis le cache).
  • Bandeau orange Donnees d'exemple : meme composant SampleDataBanner.vue que le dashboard (texte maquette ISS-003 / demandes intervenant) sur Mes demandes et Mes organisations lorsque les donnees d'exemple sont affichees.
  • Les composants KPI/listes reçoivent isSample (KpiStrip, MyDay, ToProcess, MySchools, MyIndicators, MyStatistics).
  • Les items sample portent un badge Exemple et les clics metier sont interceptes via sample-click (pas d'action irreversible immediate).
  • Demandes / Organisations : au montage, fetchSampleDataPayload() si sample actif (cache 24 h ci-dessus ; pas de GET /me dédié sur ces pages). Listes : requests.batches et cartes depuis dashboard.schoolBreakdowns (onboardingSampleData.js). Actions sensibles → SampleModal pour les lignes d'exemple.
  • FEAT-099 : sample-click ouvre SampleModal (guardrail) avec CTA "Completer mon profil" vers /trainer/getting-started ; fermeture possible via overlay, Escape ou bouton "Fermer".
  • FEAT-099 + FIX-106 : EmptyState.vue est utilise sur les empty states dashboard (ToProcess, MyDay, MySchools, MyIndicators, MyStatistics) avec onboardingLink vers /trainer/getting-started (labels contextuels par bloc).
  • Quand le sample est desactive (dismiss explicite ou premiere vraie demande), le dashboard rebascule automatiquement sur les donnees reelles.

Sections principales

  1. Opportunités (/dashboard/trainer)
  2. Nouvelles missions disponibles
  3. Filtres par domaine/compétence
  4. Bouton "Postuler"

  5. Actions à effectuer

  6. Missions en cours
  7. Documents à fournir
  8. Évaluations à compléter

  9. Planning hebdomadaire

  10. Sessions programmées
  11. Disponibilités (voir Gestion des disponibilités)
  12. Calendrier interactif

  13. Revenus

  14. Statistiques mensuelles
  15. Factures en attente
  16. Historique des paiements

🏢 Dashboard Organization

Accès et fonctionnalités

graph TD
    A[Connexion réussie] --> B{finishedOnBoarding?}
    B -->|true| C[Dashboard organization]
    B -->|false| D[Redirection onboarding/reprise]
    C --> E[Gestion formateurs]
    C --> F[Gestion missions]
    C --> G[Gestion facturation]
    C --> H[Statistiques]

Sections principales

  1. Gestion des formateurs
  2. Liste des formateurs
  3. Profils et compétences
  4. Évaluations et feedback

  5. Gestion des missions

  6. Missions en cours
  7. Planning des formations
  8. Suivi des performances

  9. Facturation

  10. Factures générées
  11. Paiements reçus
  12. Rapports financiers

  13. Statistiques

  14. Performance des formateurs
  15. Satisfaction clients
  16. Métriques d'activité

Factures reçues (InvoicesView, staff) — FEAT-252 / FEAT-278

  • Route : /staff/invoices — views/staff/InvoicesView.vue ; API staffAPI.getInvoices, getCreditNotes, downloadInvoicePDF, downloadCreditNotePDF, exportInvoices.
  • KPI : cartes Payée / En attente / En retard + Avoirs reçus (summary.creditNotesCount, montant summary.creditedTotalCents). Montants facture TTC nets des avoirs finalisés (summary.*AmountCents, filteredTotalCents).
  • Mode avoirs (FEAT-278) : clic carte KPI « Avoirs reçus » (kpiFilter === 'CREDIT_NOTES', isAvoirsMode) — table dédiée (GET /staff/credit-notes, lazy au premier basculement) ; filtres transversaux période / intervenants / recherche ; pagination serveur (limit 30). Clic ligne → drawer de la facture créditée (invoice imbriqué) ; PDF via downloadCreditNotePDF.
  • Mode factures : lignes avoir indentées sous la facture (displayedDocuments, montant négatif) ; PDF avoir par ligne.
  • Export : exportInvoices(format, filters) → GET /staff/invoices/export?format=csv|pdf. Mode factures : périmètre filtré (factures + avoirs liés). Mode avoirs : filters.type = 'creditNotes'. CSV 9 colonnes (Type Facture/Avoir, HT/TVA/TTC) ; PDF = ZIP factures + AV (max 200).
  • Feuilles de filtre (UX-613) : période, intervenant et statut sont des dialogues modaux (role="dialog", aria-modal, titre h2 + croix « Fermer », useFocusTrap, Échap rend le focus au déclencheur). Sous 640 px la feuille basse garde le voile ; au bureau le popover se ferme aussi au clic extérieur. « Effacer » et « Appliquer » : min-h-11 lg:min-h-6. Une seule feuille ouverte à la fois.

💰 Facturation formateur

Mon entreprise (CompanySettingsView) — TVA et facturation électronique (UX-457)

  • Sous-groupe « TVA et facturation électronique » (#tva-facturation-electronique, entre Identité et Informations bancaires) : régime de TVA (cs-vatRegime) avec option « À déclarer » proposée tant que le régime enregistré n'est pas déclaré (GET /trainer/company → vatRegimeDeclared: false, FEAT-450) ; la carte s'enregistre alors avec vatRegime: null (régime conservé, n° de TVA non exigé). Aide d'une ligne sous le régime (mention de TVA posée sur les factures), accordéon « Quel régime choisir ? » (BaseCollapse), bannière « Déclarez votre régime de TVA » (role="status") avec bouton « Choisir mon régime » (focus sur la liste).
  • Champs fiscaux : « TVA sur les débits » pour l'assujetti seul (aide visible ; envoyée fausse pour les autres régimes), n° de TVA intracommunautaire obligatoire pour l'assujetti seul (aide selon le régime), RCS (optionnel, aide), adresse électronique de l'annuaire (SIREN par défaut, aide ; seule une saisie « SIREN » ou « SIREN_suffixe » de l'entreprise, 125 caractères au plus, est acceptée à l'enregistrement — un e-mail est refusé).
  • Adresse structurée obligatoire : rue, code postal et ville (aria-required, messages d'erreur role="alert" reliés par aria-describedby, aria-invalid, focus sur le premier champ de saisie en erreur — CompactTextInput) — exigés par la finalisation Factur-X (EInvoiceReadinessValidator).
  • Hub (SettingsHubView.vue) : badge « Régime de TVA à déclarer » (BaseBadge warning) sur la tuile Mon entreprise, aria-label complété ; état lu par useTrainerCompanyVatRegime() (modules/profile).

Paramètres de facturation (BillingSettingsView)

  • Vue : /trainer/settings/billing (BillingSettingsView.vue, route trainer-billing-settings) ; l'identité de l'entreprise et la banque sont sur /trainer/settings/company (CompanySettingsView.vue). L'ancienne page « Mon entreprise » est supprimée (QUAL-377).
  • Section Facturation : TVA par défaut, Unité par défaut, Délai de paiement, Numérotation des factures (BUG-031), Numérotation des CRA (UX-039), Mentions légales (TVA exonérée, paiement). Données envoyées via PUT /trainer/billing/settings (et PATCH /trainer/company pour company) ; récupération via GET /trainer/billing/settings et GET /trainer/company.
  • Numérotation factures : préfixe personnalisable avec variables (annee), (mois), (jour) (conformité art. 289 CGI), numéro de séquence (verrouillé après première facture de l’année), aperçu en temps réel. Variables insérables par chips dans l’interface. Card libellée « Factures » (FEAT-274) — série distincte des avoirs.
  • Numérotation avoirs (FEAT-267 / FEAT-274) : 3ᵉ card « Avoirs » entre Factures et CRA ; préfixe AV-(annee)(mois)- par défaut, séquence et verrou indépendants (creditNotePrefixTemplate, creditNoteNextSequence, creditNoteIsLocked via PUT /trainer/billing/settings).
  • Numérotation CRA (UX-039) : même moteur que factures (préfixe + séquence, variables (annee)/(mois)/(jour)), template par défaut CRA-(annee)(mois)-, séquence CRA indépendante, section dédiée et aperçu du prochain CRA.
  • Rappel du régime de TVA et mentions (UX-458) : la carte « Informations d'entreprise » (lecture seule) affiche la ligne « Régime de TVA » (libellé du régime déclaré dans Mon entreprise, ou badge « À déclarer » quand company.vatRegimeDeclared est faux — FEAT-450) et la ligne « N° TVA » pour l'assujetti déclaré seul ; l'option de TVA par défaut à 0 % s'intitule « 0 % » (le régime se déclare dans Mon entreprise) ; l'aide des pénalités de retard précise qu'un champ vide pose la mention par défaut (BUG-442) ; le garde-fou anti-doublon (modules/invoicing/utils/legalMentionDuplicate.js) signale toute mention de TVA ressaisie (293 B ou 261-4-4) et le délai de paiement, sur Pénalités et Mention personnalisée.
  • Carte « Facturation électronique (Factur-X) » (UX-456, après « Paramètres par défaut », ancre #facturation-electronique) : bascule BaseToggle (role="switch", taille lg) qui n'ouvre qu'une modale — acceptation (BaseModal, « J'accepte le mandat ») ou désactivation (role="alertdialog", « Désactiver ») avec états chargement (spinner, aria-disabled) et erreur (BaseAlert dans la modale, le mandat ne change pas) ; enregistrement par PUT /trainer/billing/settings/electronic-invoicing-mandate (trainerAPI.updateElectronicInvoicingMandate, FEAT-452) ; toasts « Facturation électronique activée / désactivée » ; historique « Dernière acceptation / désactivation » en JJ/MM/AAAA à HH:mm (modules/invoicing/utils/mandateDate.js) ; texte intégral du mandat dévoilé par « Voir le texte du mandat » ; note BaseAlert pour la formation exonérée (mandat facultatif) ; bannière « Déclarez votre régime de TVA » (company.vatRegimeDeclared, FEAT-450) avec lien vers trainer-settings-company#tva-facturation-electronique.
  • Ces paramètres servent de défauts à la création de facture et sont exposés dans GET /trainer/invoices/config.
  • Annexes (onglet Annexes, BUG-1009 / UX-976) : pendant trainerAPI.uploadBillingDocument, le bouton « Enregistrer l'annexe » est en chargement (aria-busy, fermetures bloquées) ; après succès, annexSubmitting est remis à false avant closeAnnexModal() pour que la garde anti-fermeture pendant l'envoi ne retienne pas la modale ouverte.

Création de facture (CreateInvoiceView)

  • Préremplissage : paramètres et mentions légales chargés depuis la config entreprise (GET /trainer/invoices/config).
  • Bloc lecture seule « Paramètres appliqués » : affiche TVA, Unité, Délai appliqués à la facture (valeurs issues de l’entreprise au moment de la création).
  • Mention de TVA (textarea « Mentions légales ») : l'éditeur pose la mention du régime déclaré dans Mon entreprise (company.vatLegalMention de la config : 293 B en franchise, 261-4-4° a pour la formation exonérée, « Option pour le paiement de la taxe d'après les débits » pour un assujetti qui a exercé l'option) et la garantit à l'enregistrement ; régime non déclaré : repli 293 B tant que toutes les lignes sont à 0 %, suivi de la mention « débits » si l'option est cochée, que le formateur peut modifier (modules/invoicing/utils/vatLegalMention.js).
  • Bandeau droit : statut, numéro, modèle, actions (Sauvegarder, Finaliser, PDF, Envoyer, etc.) ; champs libres, libellé du délai de paiement (non éditable : même valeur que les paramètres entreprise « défauts nouvelles factures » ; persistée sur la facture en paymentTerm) et pied de page personnalisé sont dans l’aperçu HTML (Teleport), pas dans la sidebar. useBillingDocumentForm alimente toujours documentData ; toute modification met isDirty comme pour le corps de la facture.
  • Brouillon : tant que isDirty est vrai (création non sauvegardée ou modifications non enregistrées), les boutons Finaliser et Télécharger PDF sont désactivés (infobulle au survol), comme sur le CRA ; après chargement ou sauvegarde sans changement en attente, ils redeviennent actifs si les autres conditions le permettent (invoiceUuid, etc.).
  • Finaliser (BUG-847) : getFinalizeValidationError() exige un client, un objet (titre) et un produit sur chaque ligne. La description reste facultative (placeholder « Description (facultatif)… ») : une facture sans description se finalise ; le PDF n’imprime alors que l’objet.
  • Quantité et remise (UX-462) : en Jour / Forfait / Unité, la quantité se saisit dans un champ texte décimal analysé (LineDecimalInput, module invoicing : type="text" inputmode="decimal", virgule ou point, 2 décimales au plus, parseDecimal / formatDecimal de lib/natural-input.js), sans molette ni flèches qui changent la valeur ; la remise de même, bornée à 100 % et suivie de son unité « % ». Une saisie illisible est signalée à la sortie du champ et bloque l'enregistrement et la finalisation (garde de confirmFinalizeAndSend()), comme la durée et le prix.
  • Modale « Envoyer la facture par email » : bloc Pièces jointes mutualisé (components/Trainer/SendEmailAttachmentsBlock.vue) : une ligne par document (case à gauche), PDF principal obligatoire, puis annexes configurées (GET /trainer/billing/documents, types facture/avoir), puis fichier PDF optionnel à la volée. Les UUIDs cochés partent en attachmentIds[] dans le POST /trainer/invoices/{uuid}/send (attachment pour le fichier manuel).

Création / édition de facture — aperçu HTML (CreateInvoiceView)

Analogue à CreateCRAView, la vue CreateInvoiceView affiche un aperçu HTML de la facture en cours d'édition, avec un bandeau droit responsive (flex-col puis lg:flex-row) : pleine largeur sous le breakpoint lg, colonne ~288px (lg:w-72) au-delà.

Layout : - Zone principale : rendu HTML chargé via POST /trainer/invoices/preview (méthode trainerAPI.previewInvoice(data)), affiché en v-html (flex-1 min-w-0). Le corps inclut sous le pied de modèle (.bp-invoice-legal-stack) les mentions facture — dans l'éditeur, champ « Mentions légales » injecté dans #invoice-legal-mentions-slot (voir ci-dessous), dont le serveur ne rend pas le texte — puis les blocs paramètres facturation : pénalités si texte renseigné, confidentialité et texte perso uniquement si activés dans TrainerBillingSettings — affichage lecture seule dans l’aperçu ; pas de carte dédiée sous la preview (édition des blocs structurés : paramètres facturation). - Bandeau : statut, numéro fictif, sélecteur de modèle, boutons d'action (Sauvegarder, Finaliser, Télécharger PDF, Envoyer, Marquer payée, Supprimer). Marquer payée est proposé pour une facture finalisée, envoyée ou en retard (FINALIZED, SENT, OVERDUE) — un brouillon doit d'abord être finalisé.

Injection via <Teleport> (même pattern que CRA) : Les champs du formulaire sont injectés directement dans les slots du HTML du modèle : - #invoice-client-input-slot — sélecteur de client : organisations déjà associées uniquement (allow-create désactivé, comme le CRA). La saisie filtre la liste ; elle ne propose pas « Créer ». - #invoice-meta-issue-date-slot / #invoice-meta-due-date-slot — dates d'émission et d'échéance - #invoice-custom-fields-slot — champs personnalisés (libellés du modèle + inputs ; conteneur inv-custom-fields-wrap avec max-width ~20 rem ; valeurs indexées par libellé dans customFieldValues) - #invoice-subject-slot — sujet / description (inv-subject-wrap, max-width ~26 rem) - #invoice-line-items-tbody-spa — lignes de facture interactives (désignation + dropdown produit, date, quantité, type d’unité unité/jour/heure/forfait, prix unitaire HT, TVA, remise % si colonne modèle discount) ; réordonnancement par glisser-déposer sur la poignée à gauche de la désignation ; si le modèle n’a pas de colonne « unité » (data-inv-col="unit"), le sélecteur d’unité est affiché à côté de la quantité - #invoice-line-items-add-button-slot — bouton « Ajouter une ligne » - #invoice-totals-slot — même disposition que le HTML non-SPA : conteneur bp-totals avec Détails TVA (tableau Taux / Mont. TVA / Base HT, un ligne par taux, montants cohérents avec le récap) si settings.totals.showVat ; à droite le récap (HT, remise si colonne modèle, lignes TVA par taux, TTC) ; si TVA masquée dans le modèle, récap seul margin-left: auto - #invoice-payment-delay-slot — texte du délai (aligné sur billing.paymentTerm de la config / facture chargée ; pas de sélecteur) - #invoice-footer-custom-slot — textarea du pied de page personnalisé (si le modèle utilise un pied « custom ») : le contenu éditable est footerCustomText, prérempli avec settings.footer.text du modèle (watch immediate + réinit au changement de modèle) ; si documentData.footerCustomText est vide côté API, repli sur le texte du modèle (useBillingDocumentForm.applyFromApi) - #invoice-legal-mentions-slot — champ « Mentions légales » en tête de la pile légale du pied (invoiceData.legalMentions, prérempli de la mention du régime de TVA) : aide reliée, marqueur « modifié » de l'état modifié (clé legalMentions, bloc footer) ; à l'enregistrement d'un brouillon, la mention imposée par un régime déclaré, si elle a été effacée, est rétablie dans le champ avant la capture (restoreVatMention()) avec le toast « Mention de TVA rétablie » ; lecture seule pour un document émis

Rafraîchissement de l'aperçu : - Déclenché lors du changement de modèle ou de client. Les mentions légales, champ de l'aperçu (#invoice-legal-mentions-slot), ne le déclenchent pas : un rechargement remonterait le champ en cours de saisie. - BUG-849 : useLatestRequest (runInvPreview) n'applique que le dernier aperçu lancé : un gabarit de modèle précédent arrivé après ne remplace pas le modèle choisi. - Pendant le rafraîchissement, l'HTML courant n'est pas démonté (badge de chargement en coin) pour ne pas casser les <Teleport> actifs.

Totaux : calculés côté client depuis les lignes saisies et injectés via Teleport dans #invoice-totals-slot.

Génération depuis un CRA (?fromCra=) : - Depuis InvoicesView (action « Générer facture » sur un CRA sans facture liée) : navigation vers trainer-invoices-create?fromCra={uuid}. - CreateInvoiceView appelle POST /trainer/invoices/generate-from-activity-report/{uuid} puis redirige vers l’édition de la facture créée (trainer-invoices-view).

Import depuis l'agenda (ImportAgendaView) — UX-613

  • Route : /trainer/invoices/import-agenda (trainer-import-agenda). Filtres période, organisation et statut de facturation : popover au bureau, feuille basse sous 640 px (voile bg-black/50).
  • Dialogue : chaque panneau est un dialogue modal nommé (role="dialog", aria-modal, aria-labelledby vers le h2, croix « Fermer » 44 px sous sm, useFocusTrap, Échap rend le focus au déclencheur). Une seule feuille ouverte à la fois. « Appliquer » valide le brouillon ; fermer sans appliquer (croix, Échap, voile, clic extérieur) l'abandonne.

Liste factures / CRA (InvoicesView)

  • Chargement des onglets : au montage, seules Factures (GET /trainer/invoices) et la config (GET /trainer/invoices/config) sont fetchées. Avoirs et CRA : lazy load au premier affichage de l’onglet (watch activeTab, data === null). Badge compteur onglet = response.total (Factures, Avoirs, CRA). Filtre organisation partagé : ne recharge le CRA que si l’onglet a déjà été ouvert une fois.
  • Drawer détail facture : components/trainer/InvoiceDetailDrawer.vue — ouverture au clic ligne ou depuis les liens CRA (UX-073).
  • Cellule factures liées CRA : components/trainer/LinkedInvoicesCell.vue — popover position: fixed avec flip viewport (pattern linked-entities-cell-popover, UX-074).
  • Actions CRA : Voir · Renvoyer (statut SENT) · Générer facture (0 facture liée) · Supprimer (0 facture liée).
  • Modal G9 : si suppression impossible (CRA lié à des factures), dialogue d'alerte « Suppression impossible » (BaseModal alertdialog, rond rouge) + bouton « Fermer », focus rendu au bouton de suppression de la ligne (UX-499).
  • Dialogues de la liste (UX-499) : suppression d'un brouillon de facture et d'un CRA en alertdialog (BaseModal) — conséquence chiffrée, confirmation par la frappe de « Supprimer » ; « Marquer comme payée » en dialogue centré, date reliée à son libellé ; « Entreprise requise » (bouton « Nouvelle » et ses entrées, états vides, sans entreprise configurée) en alertdialog à deux sorties, « Annuler » et « Configurer mon entreprise ».
  • Toasts feedback (UX-075) : components/ui/BaseToast.vue monté en bas-droite (toast ref + showToast / alias showInlineToast pour les transitions KPI UX-070). Feedback transitoire sur marquage payé, suppression brouillon/CRA, envoi email CRA, rechargement liste ; erreurs API hors modales (plus de bannière markInvoicePaidError ni modale d’erreur suppression CRA).
  • Accessibilité WCAG 2.2 AA (UX-076) : skip-link « Aller au contenu principal » dans TrainerLayout.vue (#main-content) ; prefers-reduced-motion global (assets/main.css) ; focus visible sur checkboxes/radios filtres ; cibles tactiles 24×24 sur actions tableau factures ; déclaration publique frontend/docs/accessibility/InvoicesView.md.
  • Entrée de menu courante (UX-455) : dans TrainerLayout.vue (barre latérale et tiroir mobile) et components/(shared)/StaffNavItem.vue (espace Organisation), le lien actif porte aria-current="page" sous la même condition que sa classe active, sous-routes comprises (/trainer/invoices/… pour « Mes factures », /trainer/organizations/… pour « Organisations », isActiveRoute de StaffLayout) — router-link ne le pose de lui-même que sur la route exacte.
  • Section AVOIRS (FEAT-270) : dans le drawer facture, liste des avoirs + reste créditable ; CTA « Créer un avoir » / « Reprendre le brouillon » émet create-credit-note vers InvoicesView.
  • Éditeur d'avoir (FEAT-272) : route /trainer/invoices/:invoiceUuid/credit-notes/:uuid (CreditNoteEditorView.vue, name trainer-credit-note-edit). Depuis le drawer : handleCreateCreditNote reprend le brouillon existant ou appelle POST …/credit-note, puis navigue. Lecture : GET …/credit-notes (par facture) + GET …/creditable-balance + GET …/invoices/{uuid} + GET …/invoices/config ; écriture : PUT …/credit-notes/{uuid}, POST …/finalize. Désignation = sélecteur produit (+ création via POST …/invoices/product), TVA par ligne, garde « modifications non enregistrées » (useInvoiceUnsavedModalStore). Création de produit (BUG-1009 / UX-976) : après succès API, savingProduct est remis à false avant closeCreateProductModal() pour fermer la modale malgré la garde pendant l'envoi. Lien « facture complémentaire » → trainer-invoices-create?organizationUuid= (préremplissage client dans CreateInvoiceView).
  • Liste de documents (FEAT-273) : la table factures rend des documents via displayedDocuments — chaque avoir finalisé apparaît indenté sous sa facture (montant négatif, badge « Avoir », colonne Envoi neutralisée, pas de suppression). PDF avoir (FEAT-277) : bouton téléchargement actif sur chaque ligne d'avoir (trainerAPI.downloadCreditNotePDF → blob {publicNumber}.pdf). Le montant facture reste intact ; les 3 KPI (pendingAmount, overdueAmount, paidThisMonthAmount) sont TTC nets des avoirs finalisés. Drawer : repli liste n’affiche plus « Net HT » tant que le détail n’est pas chargé (amount liste = TTC).
  • Marque Factur-X (UX-459) : badge « Factur-X » (BaseBadge info + icône FileCheck, titre « Facture électronique Factur-X ») sur l'état figé isEInvoice du document, jamais sur le mandat courant : sous le numéro dans la liste des documents (ligne d'avoir indentée), à côté du badge « Avoir » dans l'onglet Avoirs, après le numéro dans le drawer (ligne « Facture électronique Factur-X — XML EN 16931 embarqué dans le PDF ») et après chaque avoir du panneau Avoirs. Brouillon sous mandat actif (GET /trainer/invoices/config → billing.electronicInvoicingMandate, prop electronicInvoicingMandate du drawer) : information « Sera émise en Factur-X à la finalisation », sans marque. Filtre à bascule « Factur-X » (aria-pressed, filters.eInvoice) après Envoi, avant « Colonnes », proposé seulement si le mandat est actif ou si summary.eInvoiceDocumentsCount (FEAT-451) est > 0.
  • Sélecteur de facture à créditer (FEAT-276) : menu « + Nouvelle » → « Créer un avoir » ouvre SelectInvoiceToCreditModal (fetch server-driven, scroll infini, reste créditable dérivé) ; sélection délègue à handleCreateCreditNote (FEAT-272).
  • Onglet Avoirs (FEAT-275) : 3ᵉ onglet « Avoirs » dans InvoicesView.vue (entre Factures et CRA) — recensement autonome des avoirs finalisés (GET /trainer/credit-notes via trainerAPI.getTrainerCreditNotes), complément de la vue imbriquée sous chaque facture (FEAT-273). Lazy load : fetch uniquement au premier affichage de l’onglet (watch activeTab). Pagination serveur (page, limit 30) ; filtres : organisation (multi, liste GET /trainer/invoices/config), période d’émission (presets current_month, last_7_days, etc.), recherche (numéro, facture créditée, motif). Compteur badge onglet et libellé « N avoir(s) » = response.total ; Total crédité = summary.totalCreditedCents seul. Table : numéro, date, organisation, facture créditée, motif, montant affiché négatif ; clic ligne ou action « Voir » → drawer de la facture créditée (openInvoiceFromCreditNote). PDF avoir (FEAT-277) : bouton téléchargement à côté de « Voir la facture créditée » (downloadCreditNotePDF).
  • Aperçu HTML avoir (FEAT-277, contrat API) : trainerAPI.previewCreditNote(invoiceUuid, previewData) → POST /trainer/invoices/{uuid}/credit-notes/preview renvoie { html }. Consommation éditeur d'avoir : hors scope FEAT-272 / Cas B #571 — le câblage viendra dans une mise à jour ultérieure.
  • Skeletons inline / reduced-motion (UX-077) : skeletons décoratifs par classe → motion-safe:animate-pulse (vues listées dans le ticket : staff/trainer Requests, Dashboard, GettingStarted, Messages, BillingSettings, ConfigureOrganization) ; filet main.css inchangé comme garde-fou.

Liste factures & CRA (InvoicesView.vue) et édition CRA (CreateCRAView.vue)

  • Aperçu HTML : CreateCRAView affiche un aperçu du document sur la largeur restante à 100 % du conteneur (billing_template_preview.html.twig : plus de max-width sur .billing-preview-root--cra, anciennement ~48rem centré), carte rounded-xl comme la facture, avec un bandeau droit pleine largeur en mobile et ~288 px à partir de lg : statut (Brouillon / Envoyé), code + modèle, puis actions (PDF, Enregistrer, Envoyer, Générer facture, Supprimer le CRA) — le header du layout n’affiche plus CRAHeaderActions (nettoyé au montage). Contenu v-html ; pendant un rafraîchissement, l’HTML courant n’est pas masqué (badge en coin). Lignes d’intervention (manuel, iCal) : éditées dans le tableau du modèle (tbody#cra-line-items-tbody-spa, en-têtes data-cra-col, bouton d’ajout Teleporté sous le tableau). La colonne Classe/Groupe (class_name) est un champ texte libre (comme les notes), persisté en base sur la ligne CRA et renvoyée par l’API ; à l’import Agenda, préremplissage depuis calendar_configurator_assignment.class_name. Dès l’init (et à chaque rafraîchissement), POST /trainer/activity-reports/preview est appelé : organizationUuid optionnel — sans client, l’aperçu HTML comporte un bandeau et un en-tête client vide : billingTemplateUuid, lineItems, documentData, etc. Après le chargement initial, le premier aperçu est planifié après deux nextTick pour laisser useBillingDocumentForm appliquer l’UUID par défaut ; un watch inclut aussi la liste des modèles CRA pour re-déclencher l’aperçu dès sa mise à jour. L’HTML d’aperçu CRA côté backend comporte des attributs data-bp="…" (cibles SPA) en plus de data-editable (pied de page, champs libres). En création de CRA, le choix d’école (client) et la période sont injectés dans l’en-tête du modèle par <Teleport> : #cra-client-input-slot ( SearchableSelect toujours visible, même logique que sur CreateInvoiceView — plus de bouton « Changer de client ») et #cra-period-input-slot ; le nom de l’organisation apparaît dans le HTML du modèle (<p class="bp-client-name"> dans billing_template_preview.html.twig, au-dessus de l’adresse) dès l’aperçu avec POST /activity-reports/preview ; l’adresse / contact suivent. Aperçu POST /activity-reports/preview : _craEditorRealDataOnly (pas de merge YAML). Aperçu rafraîchi en débouncé ; BUG-849 : useLatestRequest (runCraPreview) n'applique que le dernier aperçu lancé (saisie plus rapide que le serveur) et un appel qui vide l'aperçu (modèle ou période absents) coupe l'indicateur que l'aperçu caduc ne coupera plus ; « Ajouter une ligne manuelle ».
  • Tableau des interventions (UX-463) : colonnes de l'éditeur à largeur fixe (Date 160 px, Classe 96, Horaires · durée 320, Notes 176, Source 96, Actions 64 ; Formation absorbe le reste, plancher 64 rem), en ordre chronologique (modules/invoicing/utils/craLineOrder.js : date puis heure de début, ligne sans date en fin). « Ajouter une ligne manuelle » insère la ligne à sa date, met le focus sur sa Date et annonce sa position ; une date modifiée replace la ligne à la sortie du champ ou sur Entrée (surlignage 1,6 s, annonce role="status") ; l'ordre reçu au chargement n'est pas retouché. Date d'une ligne iCal, toutes les cellules d'un CRA lié à une facture : lecture en cellule (texte à la géométrie du champ), sans corbeille ni ajout. Pastille « Nouvelle » devant la Formation d'une ligne ajoutée depuis le dernier enregistrement. Sous chaque ligne, une rangée de messages : « Hors période » sous la Date, « L'heure de fin doit suivre l'heure de début. » et la durée recalculée sous les Horaires. État vide dans le cadre du tableau (emplacement #cra-line-items-empty-slot du gabarit).
  • Actions et dialogues du CRA (UX-464) : Télécharger PDF, Envoyer et Générer facture restent focalisables tant que le CRA n'est pas enregistré (aria-disabled, motif en infobulle role="tooltip" reliée par aria-describedby, affichée au survol, au focus et 3 s au toucher — useActionHint du module invoicing) ; Enregistrer et Supprimer le CRA de même quand une facture est liée (infobulle ; motif visible sous Supprimer), sous la note « Une facture est liée à ce CRA : il ne peut plus être modifié. ». Les refus de saisie (« Formation requise », « Dates invalides », « Client requis », « Erreur » pour une fin avant le début, désormais bloquante) s'affichent dans un alertdialog (BaseModal) qui rend le focus au champ à corriger ; la suppression se confirme en tapant « Supprimer » (conséquence chiffrée : lignes, durée, client, période) ; « Factures déjà générées » et « Génération de la facture en cours… » sur BaseModal.
  • Dialogues « Entreprise requise », « Événements déjà facturés » et échec de suppression du CRA (UX-491) : « Entreprise requise » (chargement ou enregistrement d'un CRA sans entreprise) et « Événements déjà facturés » (génération d'un CRA dont des lignes viennent d'événements déjà facturés) sont des alertdialog (BaseModal). Le premier propose « Annuler » (retour à la liste des factures et CRA) et « Configurer mon entreprise » (trainer-company) ; le second annonce le nombre d'événements, accordé, et, sur « Continuer », enchaîne sur le contrôle des factures liées. Un échec de suppression s'affiche dans le dialogue d'alerte du CRA (« Erreur lors de la suppression »), qui rend le focus à « Supprimer le CRA ».
  • Modale « Envoyer le CRA par email » : même composant SendEmailAttachmentsBlock que sur la facture (titre de modale aligné). Annexes configurées filtrées sur documentType === 'cra'. Envoi : POST /trainer/activity-reports/{uuid}/send avec attachmentIds[] et attachment optionnel. Succès (BUG-1009 / UX-976) : sendingEmail est remis à false avant closeSendModal(true) pour que la fermeture et le retour du focus vers « Renvoyer le CRA » ne soient pas bloqués par la garde anti-fermeture pendant l'envoi.

🔔 Notifications formateur (Mon compte)

Liste in-app (cloche, bandeau, popup) — GET /notification/list

  • Auth : 401 si l’appel est fait sans JWT valide (le backend ne renvoie plus une liste vide pour un utilisateur anonyme).
  • Où : layouts/TrainerLayout.vue via notificationAPI.getNotifications().
  • Quand : uniquement lorsque la route courante correspond à une entrée du menu latéral (noms listés dans constants/trainerMenuNotificationRoutes.js : tableau de bord, planning / partage / disponibilités, demandes, messages, organisations, liste des factures, hub paramètres). Les écrans « profonds » (ex. configuration d’organisation, édition de facture, sous-pages paramètres) ne déclenchent pas ce fetch.
  • Fréquence : au plus une fois toutes les 5 minutes ; l’horodatage du dernier fetch réussi est stocké dans localStorage sous la clé teadle_notification_list_last_fetch_at (réinitialisée à la déconnexion). Pas de polling périodique.

Préférences de notification (AccountView.vue)

La page Mon compte > Notifications permet au formateur de gérer ses optins email :

  • Toggle global « Activer toutes les notifications » : active/désactive tous les optins d'un coup.
  • Toggle « Bilan mensuel » : optin MONTHLY_SUMMARY, canal EMAIL uniquement. Quand activé, le formateur reçoit un email récapitulatif le 1er de chaque mois (interventions, revenus, répartition par école du mois précédent).
  • Le toggle « Bilan mensuel » est intégré dans le mécanisme du toggle global (coché/décoché avec les autres).

Paramètres > Notifications (NotificationsSettingsView.vue, FEAT-216)

Route /trainer/settings/notifications — Notifications (optins email/SMS, récapitulatifs, rappels). Les réglages de visibilité/partage ont migré vers Confidentialité & partage (PUB-8). Le taux de réponse cible (préférences tableau de bord) a été retiré.

Confidentialité & partage (SharingSettingsView.vue, FEAT-216 / PUB-8)

  • Route : /trainer/settings/sharing (name: trainer-settings-sharing) — hub Paramètres → tuile « Confidentialité & partage » ; deeplink hash (#section-profil-partage, etc.).
  • Mon profil & CV : toggle parent isProfilePublic → trainerAPI.updateVisibility() ; <TrainerSlugEditor> ; FEAT-220 (PUB-6) : compteur consultations anonyme (publicProfileViewCount + publicProfileLastViewedAt depuis /me, format FR) sous le slug — empty-state si 0, microcopy « Anonyme — jamais visible sur votre profil public » ; sous-toggles allowResumeDownload + showPublicAgenda → updateInfo() ; « Recevoir des demandes » (isOpenToRequests, DISC-025 issue 7) → composable useTrainerOpenToRequests (GET / PUT /trainer/profile/open-to-requests, interrupteur indisponible tant que la valeur n'est pas lue) ; R28 si profil privé ; lien « Voir mon profil… » → /profile/{slug} (publicProfileUrl).
  • UX-843 : libellés des sous-options = profil public (« Autoriser le téléchargement de mon CV (PDF) », « Afficher mes formations (diplômes) », « Afficher mes certifications », « Afficher mon planning de disponibilités ») — plus de « Les Organisations voient / peuvent télécharger ». Les 7 interrupteurs de la page et les 5 de TrainerSharingCard : role="switch" + aria-checked, aria-describedby vers l’aide (partage-aide-* / cv-partage-aide-*) ; noms accessibles contenant le libellé visible (WCAG 2.5.3) ; planning au pluriel sur les deux écrans (3.2.4).
  • Recommandations : allowMemberRecommendations → updateInfo() ; nom accessible = libellé « Autoriser les Organisations à me recommander ».
  • Partage planning : carte lien → trainer-planning-share (pas de duplication du moteur).
  • SSOT hub CV : TrainerSharingCard.vue (FEAT-215) — lien « Gérer tous les partages » → { name: 'trainer-settings-sharing', hash: '#section-profil-partage' }.

Demandes de réservation (formateur) — API & store (FEAT-052 / DISC-012)

  • trainerAPI.markBatchViewed(uuid) : PATCH /trainer/reservation/batch/{uuid}/view (Content-Type: application/merge-patch+json, corps vide). Idempotent côté backend si déjà vu.
  • trainerAPI.markAllBatchesViewed() : POST /trainer/reservation/batches/mark-all-as-viewed (corps vide). Action bulk idempotente pour marquer toutes les demandes vues (firstViewAt), réponse 200 alignée sur getReservationRequests() (liste + compteurs) pour resynchroniser le store.
  • dashboardAPI.getSummary() : GET /trainer/dashboard/summary — métriques du mois (fuseau formateur côté back). Après chargement, DashboardView.vue appelle trainerDashboardStore.setSummaryActivityPeriod() : le sous-titre « Voici votre activité pour … » dans TrainerLayout.vue lit summaryActivityPeriod (periodMonth, periodYear) ; tant que le résumé n’est pas chargé, repli sur la date locale du navigateur.
  • dashboardAPI.getRevenueByClient(period) : GET /trainer/dashboard/revenue-by-client — source du bloc Mes écoles (MySchools.vue, FEAT-078) avec toggle local de période (quarter par défaut, year, 12_months), re-fetch au changement de pill, affichage CA + tendance + prochaine session + dot de statut ; mapping couleur basé en priorité sur organizationStatus (ok/conflict/error/none) pour rester iso avec /trainer/organizations ; clic ligne/carte vers /trainer/invoices?organization={organizationId}.
  • DashboardView.vue (FEAT-077) : refonte en layout scrollable maquette (header + KpiStrip, BLOC 1 MyDay, BLOC 2 ToProcess, BLOC 3 MyIndicators, RevenueEvolutionChart, MyStatistics) ; retrait des composants onboarding du dashboard ; InterventionDrawer unique (hub → drill-down pour les demandes).
  • dashboardAPI.getUpcomingInterventions(limit, scope) : support du paramètre scope (today / week) ; utilisé pour peupler BLOC 1 avec deux appels parallèles (10,today et 20,week).
  • dashboardAPI.getRecentRequests(limit=5) : limite par défaut alignée à 5 ; utilisé dans BLOC 2 pour les demandes récentes et le delta localStorage (teadle_dashboard_requests_count).
  • dashboardAPI.getRevenueEvolution(period='12_months') : période par défaut alignée FEAT-076 ; consommée par RevenueEvolutionChart.vue avec toggle 6m/12m/Année.
  • trainerAPI.getPendingRequestsCount() : GET /trainer/dashboard/pending-requests-count — compteurs plats (legacy) ; préférer trainerAPI.getDashboardBadges() : GET /trainer/dashboard/badges — { notifications, requests: { pending, urgent, newUnseen }, unreadInbox: { total, conversations, notifications, critical } } pour le polling sidebar (stores/trainerDashboard.js, 2 min dans TrainerLayout.vue). Toast « nouvelle demande » si requests.pending augmente entre deux cycles. fetchBadges() déduplique les appels simultanés (une seule requête en vol). Throttling : au plus un GET réussi toutes les 2 min (rechargement F5 inclus) via localStorage.trainer_dashboard_badges_last_fetch_at ; le compteur affiché s’appuie sur trainer_pending_requests_count entre deux appels. Clé trainer_dashboard_badges_last_fetch_at retirée au logout.
  • staffAPI.getDashboardBadges() : GET /staff/dashboard/badges — même forme (y compris unreadInbox agrégé) ; stores/staffDashboard.js alimente le badge « Mes Demandes » + même toast (polling 2 min dans StaffLayout.vue). fetchPendingRequestsCount() déduplique les appels simultanés (une seule requête en vol). Throttling : au plus un GET réussi toutes les 2 min (rechargement F5 inclus) via localStorage.staff_dashboard_badges_last_fetch_at ; le compteur affiché s’appuie sur staff_pending_requests_count entre deux appels. Clé staff_dashboard_badges_last_fetch_at retirée au logout. Le chargement initial staff ne passe plus par auth : uniquement StaffLayout / vues dashboard.
  • Messagerie (MessagesInbox.vue, stores/messages.js) : au montage, fetchBadges() / fetchPendingRequestsCount() sans force — même plafond 2 min que le layout (pas d’appel systématique à chaque visite de /trainer/messages ou /staff/messages). Après marquage lu, applyUnreadInboxDelta sur le store dashboard ; quand GET /conversations a chargé toute la liste (items.length === totalItems), reconcileUnreadConversationsFromLoadedList aligne unreadInbox.conversations et total sans /badges. refreshInboxBadgesFromAuth après les actions ne force plus le GET (throttle respecté). Dès que unreadInbox.notifications (réponse /badges) passe à > 0, TrainerLayout / StaffLayout appellent syncUnreadCountFromBadges puis un GET /notifications/search silencieux (fetchNotifications(true, { silent: true })) pour remplir la liste de BellDropdown (badge rouge = même compteur) sans basculer le skeleton de la page Messages.
  • BellDropdown (FEAT-118 / DISC-019 V6) : la cloche header components/messages/BellDropdown.vue suit le pattern DS 2026 (ARIA dynamique aria-haspopup + aria-label avec count, fermeture Esc + retour focus, zone aria-live, séparation visuelle lu/non-lu, empty state rassurant, drawer mobile bottom-sheet). Actions : marquage lu unitaire au clic (POST /notifications/{uuid}/read) et bulk Tout marquer lu (POST /notifications/read-all via messagesStore.markAllNotificationsAsRead). Catégorie sync calendrier : prise en charge du type backend sync_failure (fallback payload category=calendar_sync_failure) avec deep-link vers /trainer/organizations/{uuid}/configure?tab=connecteurs.
  • trainerAPI.getBatchMessages(uuid) : GET /trainer/reservation/batch/{uuid}/messages — { messages: [{ uuid, senderName, senderType, content, createdAt }] } (FEAT-051).
  • trainerAPI.sendBatchMessage(uuid, content) : POST /trainer/reservation/batch/{uuid}/messages avec corps JSON { content } — même forme de réponse que le GET (FEAT-051). Utilisé par RequestDrawer.vue (FEAT-055).
  • useRequestsStore : charge les batches via getReservationRequests, expose filtres / tri / polling 30 s ; les méthodes messages / compteurs peuvent être branchées par les vues ou issues ultérieures selon besoin.
  • Acceptation (BUG-042) : AcceptModal.vue désactive le bouton « Confirmer l'acceptation » et affiche un indicateur de chargement pendant l’appel API ; en cas d’erreur serveur, RequestsView.vue ferme la modale (évite un état bloquant si la demande a toutefois été acceptée côté serveur) — l’utilisateur peut réessayer depuis la carte.
  • Acceptation — organisation de la demande (DISC-030 / FEAT-428) : AcceptModal.vue affiche l’organisation retenue sans question quand organizationResolution vaut deduced ou existing (FEAT-413 / FEAT-414) ; pour ambiguous / absent, « Continuer » ouvre l’étape 2 / 2 « À quelle organisation la rattacher ? » (focus sur le titre, croix = la demande reste en attente). Le choix est porté par OrganizationLinkPicker.vue (module Directory), composé par la vue (RequestsView.vue, et depuis BUG-1022 MessagesView.vue et DashboardView.vue, logique commune useBatchAcceptance) dans le slot organization-step (la modale n’importe plus le module Directory) : candidats avec « N événements · dernier le … » (organizationAPI.suggestOrganizationNames → GET /trainer/organization/name-suggestions?name=, FEAT-416, joints par uuid), « Rattacher à une autre organisation » (BaseSelect autocomplete sur le tableau de bord, option « Créer « X » » toujours dernière), « Créer l’organisation « X » » sous un nom corrigeable. Payload d’acceptation : organizationUuid, ou createOrganization: true + organizationName (nom corrigé, la saisie du demandeur reste intacte). Les props submitting / error sont portées par la vue : l’échec s’affiche en place avec « Réessayer » et la modale ne se ferme sur erreur que si le lot n’est plus en attente côté serveur (BUG-042 préservé) ; les toasts nomment l’organisation ; fermer sans accepter alors qu’un choix était attendu affiche « La demande est restée en attente. Aucune organisation n’a été créée. ».

📅 Mon planning (PlanningView) — FEAT-135 / DISC-023 Phase 1

  • Route : /trainer/planning — coquille h-screen flex flex-col overflow-hidden ; seule la zone sous la toolbar défile (flex-1 overflow-y-auto). TrainerLayout : overflow-hidden sur cette route.
  • Header (FEAT-137) : en-tête intégré dans la vue (hidden lg:flex) ; TrainerLayout masque sa barre titre en desktop (isPlanningSettingsChromeRoute inclut /trainer/planning). Actions : Configurer, compteur partages, Partager + BellDropdown. Mobile : titre dans le layout, actions dans une barre compacte sous le header layout.
  • Drawer partages (FEAT-141) : Teleport + slide-in (sm:w-96 / bottom-sheet mobile) ; liste compacte (loadPartages + normalizePlanningSharesResponse) ; liens Gérer tous les partages → trainer-planning-share ; Nouveau partage → trainer-planning-share?new=1 (ouvre modale FEAT-140) ; useFocusTrap + Escape.
  • Deep-link entrant (FEAT-143) : ?highlight=<eventId> (semaine + scroll + .is-highlighted via useCrossPageHighlight) ; ?date=YYYY-MM-DD (semaine ciblée). Redirections legacy /trainer/planning/share et /trainer/planning/availability → routes settings (router).
  • Drawer évènement (FEAT-142/144) : clic sur un bloc → slide-over consultation ; Supprimer l'évènement si isRemovable + règle >48h (eventAPI.deleteEvent) ; warning CA dans modale ; Annuler l'intervention (modale shell, distinct de la suppression).
  • Toolbar : CalendarToolbar.vue — chevrons période, label aria-live, « Aujourd'hui », switcher Jour / Semaine / Mois (role="group", aria-current).
  • Filtres : CalendarFilterBar.vue (checkbox par calendrier/org, compteur, « + Ajouter un calendrier » → stub log) — rangée role="group" nommée « Calendriers » (UX-776) ; libellé et (N) en text-grey-700 (UX-781).
  • Colonne gauche : BaseAlert banner perso (dismiss → localStorage), PlanningMiniCalendar (:ref-date, :view, @select-day), CalendarLegend (titre <h2> ; <h3> dans la feuille de date, UX-776).
  • Grilles DS (plus de FullCalendar sur cette route) : semaine = CalendarWeekGrid + CalendarEventBlock (lanes) ; mois = CalendarMonthGrid ; jour = CalendarDayAgenda. Clic événement → log (drawer FEAT-142).
  • API : GET planning via trainerAPI.getPlanning({ dateStart, dateEnd }) et fenêtre 5 mois getFiveMonthIsoRange(refDate) ; re-fetch au changement de mois (watch refDate). BUG-849 : useLatestRequest ignore une réponse de période dépassée (mini-calendrier puis « Aujourd'hui ») ; l'indicateur de chargement n'est coupé que par le dernier appel. Calendriers dérivés des événements (syncCalendarsFromEvents, id perso __personal_calendar__). Les demandes en attente apparaissent comme événements org (status: pending, libellé « Demande — {module} », data.requestId → CTA drawer Répondre vers Mes demandes).
  • États : skeleton motion-safe:animate-pulse ; erreur + Réessayer ; vide si aucun événement filtré sur la période visible (showEmptyPeriod + getPlanningEmptyPeriodTitle(view)).
  • Compteur partages (header) : reporté FEAT-137 (anciennement GET /trainer/planning/share + PlanningHeaderActions).
  • API dashboard formateur : GET /trainer/dashboard/badges au montage du TrainerLayout (polling 2 min, badges menu). GET /trainer/dashboard/summary, GET /trainer/dashboard/revenue-evolution (encaissé), GET /trainer/dashboard/revenue-forecast (prévisionnel) et les autres routes dashboardAPI (/upcoming-interventions, etc.) sont déclenchés uniquement par DashboardView (lazy route) ; les requêtes en vol sont ignorées si l’utilisateur quitte la page. GET /trainer/organization/dashboard (sync calendriers) n’est plus bootstrapé depuis le layout sur Planning — seulement sur routes organisations / configuration (trainerSyncBootstrapRoutes.js).

🗓️ Gestion des disponibilités {#gestion-des-disponibilites}

Vue Disponibilités (AvailabilityView)

  • Route : /trainer/settings/planning/availability (onglets horaires, feries, absences, personal).
  • Onglet Horaires hebdo (FEAT-138) : 2 niveaux — liste des plannings (cards + menu 3-points : renommer, dupliquer, défaut, supprimer) puis éditeur (nom, 7 jours, N plages startTime/endTime par jour, copier-vers, planning par défaut). Modèle direct rules:[{day, slots}] (sans availabilityWeekDays.js). Temps de trajet minimum uniquement dans Réglages avancés (collapse) → PUT /trainer/availability/configuration (minTravelTime, plus envoyé par plan). Suppression : BaseModal ; bloquée si partages actifs (MVP, pas de replaceBy API). Tabs : BaseTabs (APG clavier).
  • Onglets : Jours fériés et Absences via PUT /trainer/availability/configuration ; Agenda personnel (OAuth Google/Outlook ou lien / fichier iCal — TrainerPersonalCalendarConnector.vue → TrainerCalendarConnectorHub flow="personal").
  • Absences (FEAT-139) : chaque entrée vacationSlots[] accepte start, end et un motif optionnel label ; formulaire avec toggle Journée entière (défaut, T00:00/T23:59) ou Plage horaire (BaseInput type="time"). Métadonnée UI allDay locale (non envoyée au backend) + heuristique T00:00/T23:59 au chargement pour rétrocompat.
  • Fériés (FEAT-139) : callout BaseAlert, toggles BaseToggle par jour férié FR.
  • Agenda (FEAT-139) : callout BaseAlert + icône ShieldCheck ; TrainerPersonalCalendarConnector inchangé (OAuth/sync prod).

Page Partages (ShareCalendarView, FEAT-140)

  • Route : /trainer/settings/planning/shares — hub Paramètres → tuile Partages.
  • Liste : PlanningShareEntityCard (dot activité lastViewedAt, badges type, actions Copier/Configurer/Révoquer).
  • Modale unifiée : PlanningShareModal — 4 modes (lien public / contact d'org / email libre / abonnement iCal). Le mode iCal n'affiche que la visibilité, le planning d'horaires et une description : pas de permission, de durée ni de limite de réservations. Le lien n'expire pas ; le lien copié est /shared/planning/{uuid}/calendar.ics (façade nginx, comme og.png) ; Symfony sert le text/calendar en interne. Le flux ne contient que les événements des 12 mois passés et des 12 mois à venir.
  • Durées de validité (BUG-786) : sept valeurs acceptées par le serveur (24h, 7d, 1m, 3m, 6m, school_year, never) — défaut 7 jours (maquette). La liste s'affiche en mode lien et invitation e-mail. « 30 jours » (1m) = +30 jours ; « Année scolaire » = 31 août 23:59:59 au fuseau du formateur (année suivante à partir du 1er juillet) ; « Sans limite » = never. Un partage à un contact n'expire jamais (garde d'entité + migration Version20261021190000). Page publique : mêmes libellés (getExpirationText).
  • Révocation : PlanningShareRevokeModal (wrapper BaseModal) ; retrait ROLE_AGENDA si type contact.
  • Sidebar consultative : PlanningContactSidebar (distinct de ContactSidebar.vue page Organisations) — toggle agenda + lien « Modifier dans Organisations ».
  • API : getPlanningShares, createPlanningShare, updatePlanningShare, deletePlanningShare, getOrganizationContacts, updateOrganizationContactRoles.

Validation des créneaux horaires

Les créneaux (startTime / endTime) sont validés à trois niveaux :

  1. Frontend (UX) — AvailabilityView.vue (éditeur N slots, FEAT-138) :
  2. Par plage : fin après début (isSlotInvalid) ; chevauchement même jour (warning orange, slotOverlaps).
  3. Bouton « Enregistrer » désactivé si nom vide ou hasInvalidSlots (fin ≤ début sur une plage active).

  4. Infrastructure (API) — TrainerAvailabilitySlotRequest :

  5. Contrainte #[Assert\Callback] validateTimeRange() : vérifie endTime > startTime, violation sur le path endTime.

  6. Domain (entité) — TrainerAvailabilitySlot :

  7. Le constructeur lance une \InvalidArgumentException si endTime <= startTime.

🔄 Gestion des erreurs

Erreurs de connexion

  • 401 - Identifiants incorrects : Message d'erreur explicite
  • 429 - Trop de tentatives : Attendre avant nouvelle tentative
  • 500 - Erreur serveur : Réessayer plus tard

Erreurs d'inscription

  • 409 - Email déjà utilisé : Proposer connexion
  • 422 - Données invalides : Validation côté client
  • 500 - Erreur serveur : Réessayer plus tard

Erreurs OAuth

  • Annulation utilisateur : Retour à la page d'inscription
  • Erreur provider : Message d'erreur spécifique
  • Erreur callback : Redirection vers page d'erreur

Erreurs de reprise d'onboarding

  • Données corrompues : Nettoyage et redémarrage
  • Token expiré : Reconnexion requise
  • Étape manquante : Redirection vers étape appropriée

Soumission de réservation (Booking Wizard) — anti-double envoi (BUG-041)

  • Le CTA "Valider l'envoi" est désactivé pendant la requête (loading) pour bloquer les doubles clics.
  • submitBooking applique un garde-fou immédiat (if (loading) return) avant de lancer l’appel API.
  • Une clé idempotencyKey est générée côté front une seule fois par tentative et réutilisée sur les retries de la même tentative.
  • La clé est envoyée via le header Idempotency-Key sur :
  • publicAPI.createReservations(...)
  • staffAPI.createReservations(...)
  • En cas de succès, la clé est réinitialisée ; en cas d’échec, elle est conservée pour permettre un retry idempotent.

Profil public formateur (visiteur — PUB-4 / FEAT-211, PUB-5 / FEAT-212, PUB-12 / FEAT-217)

  • URL : /profile/{slug} (alignée nginx + PUBLIC_PROFILE_PATH).
  • Route : public-trainer-profile → PublicProfileView.vue (requiresAuth: false).
  • Rendu partagé (FEAT-221 / CV-8 / DISC-025) : sections profil (hero, bio, compétences clés, expériences, formations, certifications, légal, CV PDF) dans PublicProfileBody.vue ; PublicProfileView.vue fournit topbar (logo + publicProfileVanityLabel), CTA contact/agenda via props/events, modales FEAT-212/217. Calqué maquette espace-public/maquette-profil-public-intervenant.html (visiteur).
  • API : publicAPI.getTrainerProfile(slug) → GET /public/trainer/{slug} ; CV PDF → downloadTrainerCvPdf → GET /public/trainer/{slug}/cv/pdf ; demande GUEST → submitTrainerContactRequest → POST /public/trainer/{slug}/contact (contrat PUB-10, réponse générique anti-énumération) ; confirmation double opt-in → verifyContactRequest → POST /public/trainer/contact/verify (FEAT-213) ; planning free/busy → getTrainerAvailability → GET /public/trainer/{slug}/availability (PUB-11 / FEAT-214, 404 → null = agenda non publié).
  • Route verify : /contact/verify?token=… → ContactVerifyView.vue (3 états : vérification / confirmée / lien invalide).
  • États : chargement / profil chargé / page neutre 404 (icône EyeOff, copy maquette + lien retour app.teadle.com — R21 anti-énumération ; 410 Gone si profil effacé FEAT-218).
  • Bouton CV : visible si allowResumeDownload && !profileIsSparse.
  • CTA hero (Cas B — PUB-12) : après chargement du profil, sonde getTrainerAvailability(slug) ; si 200 → agendaAvailable → badge « Disponible — réponse sous 24 h » + ligne « Prochaine disponibilité : {mois FR|—} » + CTA « Demander un créneau » ; sinon → CTA « Prendre contact » (PUB-5). Modale agenda (BaseModal size="sm") : liste semaines free/busy (format FR Intl.DateTimeFormat), semaines libres → bouton « Demander » (pré-remplit contact.message avec la période puis ouvre la modale contact — R32, pas de réservation ferme), occupées → « Indisponible » (texte + pastille). Footer : « Ou envoyer une demande sans période précise » → modale contact non pré-remplie. Formateur fermé aux demandes (profile.isOpenToRequests === false, DISC-025 issue 7) : ni CTA, ni badge, ni prochaine disponibilité — mention « Ne reçoit pas de nouvelles demandes pour le moment. » (lien « Modifier dans Confidentialité & partage » pour le propriétaire) ; demande refusée en 409 pendant la saisie → message dans la modale, saisie gardée, focus sur « Fermer », puis sur la mention à la fermeture.
  • Modale contact (hero branche sans agenda ou depuis agenda) : BaseModal avec formulaire GUEST (Prénom+nom, Email pro, Organisation optionnel, Message). États idle / sending / error / sent (double opt-in : message « Vérifiez votre boîte mail… »). Fallback mailto: affiché uniquement si le DTO expose contactEmail (relais PUB-10). Lien RGPD vers https://app.teadle.com/confidentialite.

Hub « Mon parcours / CV » — aperçu public in-context (FEAT-221 / CV-8)

  • Route : trainer-parcours-cv → ParcoursCvView.vue.
  • Barre d’actions (mode édition) : « Voir mon profil public » + « Importer mon CV / LinkedIn » (router-link → trainer-enrichment, FEAT-191).
  • Aperçu : bandeau sticky bleu « Aperçu » + « Retour à l’édition » ; rendu via <PublicProfileBody heading-tag="h2"> alimenté par getTrainerProfile(ownSlug) (même DTO que la page visiteur, sans bouton CV). Carte in-page ParcoursCvPreviewCard : huit blocs en <h3> sous le <h2> du nom ; section Compétences : « Top 5 (recherche) » / « Autres » en <h4> text-grey-700 (UX-777). Formations et certifications : mêmes interrupteurs que le profil public (allowDiplomaSharing / allowCertificationSharing) ; section remplie mais masquée → ligne propriétaire + lien « Ce que vous partagez » vers l’encart #section-partage (BUG-833).
  • Profil privé (!isProfilePublic || !slug) : notice + lien « Activer le partage » → trainer-settings-sharing ; aucun appel API public.

🧪 Tests automatisés {#tests-automatises}

Tests Cypress implémentés

  • ✅ Tests de connexion (11/11 passés)
  • ✅ Tests d'onboarding de base (7/11 passés)
  • ✅ Tests de redirection OAuth (3/3 passés)

Couverture des workflows

  • ✅ Navigation vers onboarding
  • ✅ Flux de base trainer/organization
  • ✅ Callbacks OAuth
  • ✅ Reprise d'onboarding
  • ❌ Initiation OAuth (boutons non trouvés)

Commandes de test

// Compléter l'onboarding trainer
cy.completeTrainerOnboarding({
  email: 'trainer@test.com',
  password: 'Test123!',
  firstName: 'John',
  lastName: 'Trainer'
})

// Compléter l'onboarding organisation
cy.completeOrganizationOnboarding({
  email: 'org@test.com',
  password: 'Test123!',
  firstName: 'Jane',
  lastName: 'Organization'
})

📝 Notes techniques

APIs principales

  • Authentification : /security/login, /security/user/{provider}/oauth
  • Inscription : /security/trainer/register, /security/organization/register
  • Validation email : /security/auth-code/send, /security/auth-code/verify
  • Onboarding : /trainer/preferences, /organization/preferences, /organization/info
  • Utilisateur : /me
  • Contacts (trainer) : GET/POST/PUT/DELETE /trainer/organization/{uuid}/contact/... ; POST .../contact/{uuid_contact}/invite-teadle (invitation email, 201)
  • Fusion d’organisations (DISC-029) : route trainer-organizations-merge (/trainer/organizations/merge). Entrées : bannière suggestion ?a=&b= (paire connue, étape Choix sautée) ou kebab carte ?from= (étape Choix). Parcours OrganizationMergeView.vue + composants modules/directory/components/merge/* ; étapes dérivées de skippedSteps (GET /trainer/organization/merge/preview). Choix (?from=) : GET /trainer/organization/merge/candidates?from= renvoie pour chaque candidate origin, totalHours, moduleCount, hasRemoteConnector, providerType (plus uuid, name, campus, isSuggested). Exécution : POST /trainer/organization/merge ; retour liste via organizationMergeStore.consume() (toast RM34, mention E7). Fichiers : useOrganizationMerge, organizationMerge.js, mergeEntry.js. UX-1010 : à l’étape de confirmation, le texte « Fusionner » reste saisissable pendant l’envoi ; « Retour » est neutralisé par disabled natif (pas busy sur le voisin) ; région role="status" sr-only « Fusion des organisations en cours… » pendant isMerging.
  • A11y fiche / liste org formateur (UX-1010) : après association réussie + relecture initializeData() sur ConfigureOrganizationView.vue, le focus est replacé sur le panneau onglet Connecteurs (#panel-connecteurs). Sur OrganizationsView.vue, la modale de dissociation ne se ferme pas par Échap ou clic voile tant que dissociateLoading ; le bouton « Annuler » est disabled pendant l’envoi ; après succès + refreshData(), le focus va sur #main-content (carte / menu déclencheur absents).
  • Onboarding organisation (espace École) et suivi invité (UX-1011) : les succès et l’envoi en cours sont annoncés par les paragraphes sr-only role="status" déjà présents sous les boutons — les encarts verts de succès ne portent plus role="status" (StaffEmailValidationConnectedView, StaffInvitationConnectedView) ; la région sous « Valider » inclut successMessage (validation + renvoi de code, ce dernier restant annoncé aussi sous « Demander un nouveau code »). Gardes if (loading/isLoading/isSubmitting/regenerateSending) return sur submitForm / submitInvitations / requestLink / sendRegenerateLink pour qu’un second submit pendant l’envoi ne relance pas l’API. Suivi réservations (TrackingView) : la fenêtre « Recevoir un nouveau lien » annonce « Envoi du lien en cours… » puis la confirmation au succès.
  • Dashboard organisations (trainer) : GET /trainer/organization/dashboard — alimente OrganizationsView.vue (/trainer/organizations, refonte FEAT-040). Layout : titre + sous-titre + CTA dans le header global TrainerLayout (useTrainerOrganizationsHeader + OrganizationsListHeaderActions) ; zone scrollable avec barre de résumé (compteurs cliquables), recherche fond mushroom-50, tri (nom A→Z / Z→A, CA décroissant, formations = tri sur countUnlinkedAssignments), pills de statut. Ajout : CTA vers trainer-organizations-configure ; /trainer/organizations/add redirige (FEAT-048). Avatar liste : getColorForId(uuid || nom) + getInitials(nom) (useAvatarColor) pour cohérence maquette ; calendarColor reste disponible côté données. Par assignation : totalHours / totalRevenue (planifié) ; totalRealizedHours / totalRealizedRevenue ; si le backend expose totalInvoicedRevenue, la ligne « dont X € facturé » l’utilise, sinon repli sur totalRealizedRevenue. Statut organisation : assignment.status (ok/conflict/error/none) est la source de vérité pour badges + filtres (fallback legacy conservé côté front). Cartes : heures « réalisées / planifiées » et « Z % réalisé » en <dl> / <dt> / <dd> (UX-778) ; zone stats vide si totalHours === 0. Sync : countUnlinkedAssignments, lastImportErrorCode, bandeaux après POST …/sync + GET /process/{uuid}. providerType : libellé FR via calendarConnectorProviders.js (ligne métadonnées avec type + contact). Dissociation : menu kebab → modale confirmation (saisie « Supprimer ») → DELETE via organizationAPI.unassignTrainerOrganization, puis rechargement dashboard. Recherche : nom, type (libellé FR), fournisseur, contact (plus de filtre sur la ville).
  • Polling de synchronisation calendrier (DISC-019 / FEAT-108, PERF-115) : factorisé dans composables/useSyncPolling.js. createSyncPoller(options) sert aux cas multi-process (ex. OrganizationsView.vue, Map d’instances par organisation). useSyncPolling(options) sert aux cas single-process avec auto-cleanup (onUnmounted) côté ConfigureOrganizationView.vue. États terminaux inchangés : TERMINAL_STATES = ['validated', 'failed']. Fréquence dynamique PERF-115 : backoff progressif 1s (0-10s) -> 2s (10-30s, nominalPOLL_INTERVAL_MS) -> 5s (30s+), pause automatique quand l’onglet est caché (document.visibilityState === 'hidden'), reprise au retour visible avec tick immédiat et reset du backoff.
  • Store de synchronisation agrégée (DISC-019 / FEAT-109) : stores/syncStore.js centralise l’état multi-orgs (orgStates) et expose syncingCount, errorCount (>= 2 échecs consécutifs), syncGlobalState (error > syncing > stable), calmDotTooltip, lastGlobalSyncFormatted. bootstrap() consomme GET /trainer/organization/dashboard puis relance les pollers actifs via currentSyncProcessUuid. Les vues peuvent notifier startSync / onSyncComplete et le layout nettoie via stopAll().
  • Composant Calm Dot sidebar (DISC-019 / FEAT-110) : components/Trainer/SidebarSyncDot.vue consomme useSyncStore et rend 3 états utiles : rien en stable, dot bleu animé en syncing (compteur si > 1), badge rouge en error (prioritaire en coexistence). Navigation au clic : trainer-organizations (ou ?filter=error en rouge). A11y : role="status", aria-label dynamique, title via calmDotTooltip, fallback prefers-reduced-motion.
  • Toasts synchronisation (DISC-019 / FEAT-111) : composables/useToast.js gère un stack singleton max 3 (addToast, dismissToast, clearAllToasts) ; components/ui/ToastContainer.vue affiche le stack en Teleport bas-droite (right-[max(1.5rem,env(safe-area-inset-right))], UX-760) ; components/ui/SyncToast.vue encapsule BaseToast : succès (durationMs=5000, pausable=true) et erreur persistante (durationMs=0, CTA optionnel “Voir l’organisation”). UX-785 : racine aria-live="polite" — un toast émis sous un BaseModal n’est pas aria-hidden et reste annoncé.
  • Safe-area sous viewport-fit=cover (UX-760) : le contenu dans le flux est compensé latéralement par <body> ; chaque overlay / tiroir / toast / barre collée au document compense les bords qu’il touche (formes env(safe-area-inset-*) du design system UX-347). Recette : iPhone à encoche, portrait puis paysage — texte hors du capteur, pied du tiroir organisation au-dessus de la barre d’accueil, toast et en-tête du planning public hors des insets. Bureau : rendu identique (insets à 0).
  • Modales centrées écrites à la main (UX-771) : le panneau porte max-h-full overflow-y-auto (boîte de contenu du voile, safe-area comprise). Recette : iPhone paysage — « Nouveau message », « Accepter cette demande ? », « Annuler cette demande ? » — titre et croix visibles, actions atteintes en défilant ; portrait et bureau inchangés ; zoom 200 % d’une fenêtre 1280×720 : tout atteignable.
  • BaseButton formes sans boîte (FEAT-790 / FEAT-789) : tertiary, ctaTextuel, ghost, ghostRemove + tailles inline / standalone / row / icon + as (a, RouterLink). Les boutons à boîte existants restent des pilules. Recette : lien Tertiary bleu 44 px à 375 px ; CTA size="inline" dans une phrase sans cible ; Ghost rounded-lg px-4 ; ghostRemove nommé par aria-label.
  • Intégration layout (DISC-019 / FEAT-112) : layouts/TrainerLayout.vue monte ToastContainer globalement, ajoute SidebarSyncDot sur l’entrée menu Organisations (mobile + desktop non replié), déclenche syncStore.bootstrap() au onMounted et syncStore.stopAll() au onUnmounted.
  • OrganizationsView (DISC-019 / FEAT-113) : la carte org affiche un 5e badge prioritaire “Sync. en cours” (spinner bleu) qui masque les 4 badges métier pendant la sync locale (syncingOrganizations). La vue alimente useSyncStore (startSync au dispatch, onSyncComplete aux terminaux, stopSync sur erreurs) et émet des toasts globaux via useToast (succès/erreur + CTA connecteurs). Support deeplink ?filter=error : filtre appliqué au mount, scroll vers la première carte erreur, puis nettoyage de l’URL via router.replace.
  • ConfigureOrganizationView (DISC-019 / FEAT-114) : pas de changement UI sur l’onglet Connecteurs (progression/timeline/bannières conservées) ; la vue alimente useSyncStore en parallèle du polling local (startSync au démarrage upload/link/re-sync + callback OAuth ?syncProcess=, onSyncComplete en succès/échec terminal, stopSync en erreur de suivi). Toast global d’erreur ajouté via useToast pour les échecs sync OAuth/iCal (pas de toast succès).
  • Onglet Événements (config org) : organizationAPI.getOrganizationEvents(uuid, { page, limit, sort, filters }) → GET /trainer/organization/{uuid}/events, 20 par page (pagination numérotée, plus de défilement infini), tri par dateStart | label | category, filtres label, category (movable | synced | invoiced) et period — les périodes « 12 derniers mois » et « année scolaire » sont envoyées en custom avec periodStart / periodEnd calculés par l’écran (DISC-030 / FEAT-426). Appel au focus de l’onglet seulement (OrganizationEventsPanel, watch active + uuid), rechargé à chaque changement de filtre, de tri ou de page. Provenance à deux niveaux (constants/organizationEventProvenance.js : catégorie BaseContextTag + origine exacte, motif d’un événement non déplaçable dans le tiroir de détail). Sélection multiple des lignes déplaçables (case d’en-tête bornée à la page, remise à zéro à chaque rechargement), barre d’action collante (sticky bottom-0 ; scroll-pb-24 sur le conteneur défilant de la vue), modale de destination OrganizationEventsMoveModal : organizationAPI.previewOrganizationEventsMove → GET /trainer/organization/{uuid}/events/move/preview (tarif appliqué, contacts à copier), moveOrganizationEvents → POST /trainer/organization/{uuid}/events/move — ces deux méthodes relancent l’erreur axios telle quelle, le detail du 422 s’affiche ; succès = rechargement + toast avec lien vers la destination (SyncToast rend le cta de tout type), échec = bandeau tout-ou-rien (FEAT-427). Drawer : trainer-planning?date=&highlight= et trainer-requests?highlight= si provenance demande.

États de l'application

  • Non connecté : Accès aux pages publiques uniquement
  • Connecté, onboarding incomplet : Redirection vers onboarding/reprise
  • Connecté, onboarding complet : Accès aux dashboards

Stockage local

  • Token JWT : Authentification
  • Données onboarding : Progression du parcours (teadle_onboarding_data)
  • État OAuth : Gestion des callbacks

Services d'onboarding

  • onboardingStorage : Gestion du localStorage
  • onboardingGuard : Protection des routes
  • useOnboardingStore : progression DISC-016 (checklist post-login)

🔧 Services et composants

Services principaux

// Gestion du stockage
import { onboardingStorage } from '@/services/(onboarding)/onboardingStorage'

// Protection des routes
import { onboardingGuard } from '@/services/(onboarding)/onboardingGuard'

Composants d'onboarding

  • OnboardingLayout.vue : Layout avec étapes et scroll interne (h-screen h-svh flex flex-col, UX-358 + conteneur flex-1 overflow-y-auto) pour éviter un écran bloqué quand body est en overflow: hidden (cas modales/overlays).
  • OnboardingConnectedLayout.vue : même convention via utilitaires page-fullscreen / page-fullscreen-scroll (main.css, cascade h-screen h-svh UX-358) — header fixe, fil d’Ariane + slot dans la zone scrollable.
  • SharedPlanningView.vue (views/(unauthenticated)/Planning/) : vue publique pleine page alignée sur la même convention de scroll interne (.page-fullscreen + wrapper .page-fullscreen-scroll) pour rester scrollable même si body est temporairement verrouillé par un overlay. Titres de bloc en <h2> / <h3> (popover, légende, à propos, réservations) ; assistant BookingWizard : critères et créneau sélectionné en <h3>, alternative en <dt>/<dd> (UX-779). BUG-845 : barre d’info N/M lit info.bookingsUsed (lots du partage) et l’incrémente à l’événement success de l’assistant, sans recharger le planning. BUG-775 : toutes les heures (grille, aujourd’hui, assistant, découpage, « Chercher autre date ») sont des heures murales du fuseau annoncé (trainerTimezone), converties en instants ISO à l’envoi (utils/zonedTime.js). BUG-783 : Échap ferme le dialogue du dessus seulement (modale de créneaux, succès, drawer) — plus d’écouteur window qui fermait aussi l’assistant ni n’annulait la pause R3. UX-784 : modale « Chercher autre date » — sous-titre (durée, créneaux masqués, jours non travaillés) et aria-label « Sélectionner le créneau 09:00 le lundi 2 nov. » sur chaque bouton. BUG-782 (D-019) : la demande en cours survit à la fermeture de l’assistant (stockage de session) et, si la personne a coché « Garder ma demande en cours sur cet appareil », d’une visite à l’autre (stockage local, 30/60 jours) ; reprise à l’étape atteinte avec bandeau nommé ; « Recommencer » confirmé ; période recalée ou brouillon effacé si passé ; créneau retenu introuvable signalé à l’étape 2.
  • Auth / pages publiques hors layout : SigninView (FEAT-178) et l'entonnoir d'inscription du formateur (SignupView, TrainerActivationView, TrainerFinalizeProfileView, TrainerWelcomeView, TrainerEnrichmentView — UX-995) utilisent PublicLayout (DISC-024) : la page défile avec le document ; autres vues (PasswordResetView, suivi réservation, invitations, planning partagé, profil public, OAuthRedirect) : encore page-fullscreen + page-fullscreen-scroll legacy, à défilement interne. La racine App.vue est en min-h-full, sans hauteur fixe ni overflow-hidden, et body ne porte aucun overflow: hidden global : un tel verrou rogne sans défilement possible toute page à hauteur minimale (BUG-1035) ; un écran à défilement interne porte son propre verrou.
  • GettingStartedView.vue : checklist DISC-016 post-login
  • OnboardingChecklistItem.vue : item d'étape avec CTA
  • OnboardingCelebrationModal.vue : modale de célébration 5/5

Routes protégées

// Routes avec validation d'onboarding
meta: { requiresOnboardingValidation: true }

// Routes de reprise
'/onboarding/trainer/personal-info'
'/onboarding/organization/personal-info'

Maquettes HTML et jetons DS (cartes)

Référence pixel : _design-system/patterns/*.md dans le dossier maquettes OneDrive, sections @section:disc025-* pour profil public / inscription.

Cible Script Règle
Production frontend/src node scripts/codemod-cartes-ds.mjs src Lignes avec rounded-xl : border-mushroom-250 → 200 (table SITES)
Maquettes 05 Maquettes/ node scripts/codemod-cartes-maquettes.mjs "<chemin 05 Maquettes>" Même règle sur les .html + .md sous _design-system/patterns ; champs/boutons 250 inchangés

Validation maquettes : --check (code 1 si cartes rounded-xl encore en 250). Après campagne UX-991, le dashboard maquette et la prod partagent border-mushroom-200 sur les cartes.


Dernière mise à jour : novembre 2025