🔄 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
- Inscription Trainer
- Inscription Organization
- Onboarding Trainer
- Onboarding Organization
- Reprise d'Onboarding
- Dashboard Trainer
- Dashboard Organization
- Facturation formateur
- Notifications formateur
- Gestion des disponibilités
- Gestion des erreurs
- Profil public formateur (visiteur — PUB-4)
- Tests automatisés
🔐 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
- Page d'accueil (
/) - Formulaire email/mot de passe
- Boutons OAuth (LinkedIn, Google, Microsoft)
-
Boutons d'inscription (Trainer, Organization)
-
Validation des identifiants
- API :
POST /security/login -
Gestion des erreurs (401, 500, etc.)
-
Récupération des données utilisateur
- API :
GET /me -
Vérification de
finishedOnBoarding -
Redirection intelligente
- Si
finishedOnBoarding: true→ Dashboard approprié - 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
- Sélection du profil (
/onboarding/trainer) - Choix du niveau d'expérience
- Sauvegarde :
onboardingStorage.saveSection('trainerExperience', {...}) -
Bouton "Continuer"
-
Inscription (
/onboarding/trainer/signup) - Formulaire email/password
- Boutons OAuth (LinkedIn, Google, Microsoft)
- API :
POST /security/trainer/register -
Sauvegarde :
onboardingStorage.saveSection('signup', {...}) -
Redirection vers onboarding
- Token JWT reçu
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
- Inscription (
/onboarding/organization/signup) - Formulaire email/password
- Boutons OAuth (LinkedIn, Google, Microsoft)
- API :
POST /onboarding/user-exist/check -
Sauvegarde :
onboardingStorage.saveSection('signup', {...}) -
Validation email (
/onboarding/organization/email-validation) - Envoi automatique du code
- API :
POST /security/auth-code/send - Saisie du code à 6 chiffres
-
API :
POST /security/auth-code/verify -
Création du compte
- API :
POST /security/organization/register - Token JWT reçu
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
- Informations personnelles (
/onboarding/trainer/personal-info) - Prénom, nom
- Mot de passe (si pas OAuth/Resume)
- Acceptation CGV
- API :
PUT /trainer/preferences -
Sauvegarde :
onboardingStorage.saveSection('personalInfo', {...}) -
Options de profil (
/onboarding/trainer/profile-options) - Configuration du profil
- Sauvegarde :
onboardingStorage.saveSection('profileOptions', {...}) -
Bouton "Continuer"
-
Édition des expériences (
/onboarding/trainer/experiences-edit) - Import depuis CV (si applicable)
- Ajout/modification d'expériences
- API :
POST /trainer/career -
Sauvegarde :
onboardingStorage.saveSection('experiences', {...}) -
Finalisation
- Depuis Options de profil (« Continuer plus tard ») :
POST /user/onboarding/validate(finishOnboarding) puisonboardingStore.fetchProgress()(GET /me) pour synchroniser la progression onboarding etsampleData. - Depuis Édition des expériences (après
POST /trainer/career) :fetchProgress()avant redirection pour la même mise à jour. - Nettoyage localStorage (parcours expériences)
- 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
- Informations personnelles (
/onboarding/organization/personal-info) - Prénom, nom
- Numéro de téléphone (optionnel)
- Acceptation CGV et opt-in
- API :
PUT /organization/preferences -
Sauvegarde :
onboardingStorage.saveSection('personalInfo', {...}) -
Paramètres organisation (
/onboarding/organization/settings) - Nom de l'organisation
- Service au sein de l'organisation
- Type d'organisation
- API :
PATCH /organization/info -
Sauvegarde :
onboardingStorage.saveSection('settings', {...}) -
Finalisation
- API :
GET /me(mise à jourfinishedOnBoarding) - 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
- Détection automatique
- Vérification
finishedOnBoarding: false - Analyse du localStorage
-
Affichage bannière de reprise
-
Mécanisme de reprise
- Reprise pilotée par les données persistées (
signupMethod: 'resume') - Redirection vers l'étape connectée attendue
-
Préremplissage des données déjà connues
-
Mode reprise
- Pré-remplissage des champs
- Masquage des étapes inutiles
-
Sauvegarde des données existantes
-
Gestion des données
- Section
signupavecsignupMethod: 'resume' - Données utilisateur pré-remplies
- 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
Sidebar d'onboarding (formateur, onboarding incomplet)
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, rolestatus) : visible sionboardingProgress.sampleData.active === trueet pas en fenetre pre-avert J-2 ; action "Supprimer les exemples" =>POST /trainer/onboarding/sample-data/dismissviaonboardingStore.dismissSampleData(). - Pre-avert J-2 (
PreAvertBanner, rolealert) : visible si sample actif etexpiresAt <= now + 2 jours; CTA "Partager mon profil" vers/trainer/getting-started. - Première vraie demande (
FirstRealRequestBanner, vert maquette 🎉, rolestatus) : visible hors mode sample siGET /trainer/dashboard/recent-requestsretourne au moins un item avecisFirst: true(backend : lot affiché dans « À traiter » est le plus ancien lot du formateur en base — première demande encore en attente) et flag localStorageteadle_disc016_first_request_seenabsent ; sous-titre depuis org / module / créneaux ; CTA « Voir la demande » vers/trainer/requestset pose du flag.
Injection sample dashboard (FEAT-098)
Quand sampleData.active === true, le dashboard passe en mode demonstration :
DashboardView.vuerecupereonboardingStore.sampleDataPayloadviafetchSampleDataPayload()(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, cleteadle_onboarding_sample_data_cache) tant que le sample reste actif ; invalidation du cache uniquement si GET /me renvoie explicitementonboardingProgress.sampleData.active === false, après Supprimer les exemples (dismissSampleData), ou logout (clearBrowserStorageOnLogout). Pas de purge sur une réponse/mesans champsampleData/active(évite un F5 qui efface le cache). Le snapshotteadle_onboarding_progress_snapshot(voir ci-dessus) évite de perdre le flagsampleData.activeau premier rendu post-F5. SisampleData.active === falsedans 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.vueque 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
Exempleet les clics metier sont interceptes viasample-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.batcheset cartes depuisdashboard.schoolBreakdowns(onboardingSampleData.js). Actions sensibles →SampleModalpour les lignes d'exemple. - FEAT-099 :
sample-clickouvreSampleModal(guardrail) avec CTA "Completer mon profil" vers/trainer/getting-started; fermeture possible via overlay, Escape ou bouton "Fermer". - FEAT-099 + FIX-106 :
EmptyState.vueest utilise sur les empty states dashboard (ToProcess,MyDay,MySchools,MyIndicators,MyStatistics) aveconboardingLinkvers/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
- Opportunités (
/dashboard/trainer) - Nouvelles missions disponibles
- Filtres par domaine/compétence
-
Bouton "Postuler"
-
Actions à effectuer
- Missions en cours
- Documents à fournir
-
Évaluations à compléter
-
Planning hebdomadaire
- Sessions programmées
- Disponibilités (voir Gestion des disponibilités)
-
Calendrier interactif
-
Revenus
- Statistiques mensuelles
- Factures en attente
- 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
- Gestion des formateurs
- Liste des formateurs
- Profils et compétences
-
Évaluations et feedback
-
Gestion des missions
- Missions en cours
- Planning des formations
-
Suivi des performances
-
Facturation
- Factures générées
- Paiements reçus
-
Rapports financiers
-
Statistiques
- Performance des formateurs
- Satisfaction clients
- Métriques d'activité
Factures reçues (InvoicesView, staff) — FEAT-252 / FEAT-278
- Route :
/staff/invoices—views/staff/InvoicesView.vue; APIstaffAPI.getInvoices,getCreditNotes,downloadInvoicePDF,downloadCreditNotePDF,exportInvoices. - KPI : cartes Payée / En attente / En retard + Avoirs reçus (
summary.creditNotesCount, montantsummary.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 (limit30). Clic ligne → drawer de la facture créditée (invoiceimbriqué) ; PDF viadownloadCreditNotePDF. - 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, titreh2+ 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 avecvatRegime: 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'erreurrole="alert"reliés pararia-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 » (BaseBadgewarning) sur la tuile Mon entreprise,aria-labelcomplété ; état lu paruseTrainerCompanyVatRegime()(modules/profile).
Paramètres de facturation (BillingSettingsView)
- Vue :
/trainer/settings/billing(BillingSettingsView.vue, routetrainer-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(etPATCH /trainer/companypour company) ; récupération viaGET /trainer/billing/settingsetGET /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,creditNoteIsLockedviaPUT /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.vatRegimeDeclaredest 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) : basculeBaseToggle(role="switch", taillelg) 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 (BaseAlertdans la modale, le mandat ne change pas) ; enregistrement parPUT /trainer/billing/settings/electronic-invoicing-mandate(trainerAPI.updateElectronicInvoicingMandate, FEAT-452) ; toasts « Facturation électronique activée / désactivée » ; historique « Dernière acceptation / désactivation » enJJ/MM/AAAA à HH:mm(modules/invoicing/utils/mandateDate.js) ; texte intégral du mandat dévoilé par « Voir le texte du mandat » ; noteBaseAlertpour la formation exonérée (mandat facultatif) ; bannière « Déclarez votre régime de TVA » (company.vatRegimeDeclared, FEAT-450) avec lien verstrainer-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,annexSubmittingest remis à false avantcloseAnnexModal()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.vatLegalMentionde 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.useBillingDocumentFormalimente toujoursdocumentData; toute modification metisDirtycomme pour le corps de la facture. - Brouillon : tant que
isDirtyest 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, moduleinvoicing:type="text" inputmode="decimal", virgule ou point, 2 décimales au plus,parseDecimal/formatDecimaldelib/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 deconfirmFinalizeAndSend()), 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 enattachmentIds[]dans lePOST /trainer/invoices/{uuid}/send(attachmentpour 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 (voilebg-black/50). - Dialogue : chaque panneau est un dialogue modal nommé (
role="dialog",aria-modal,aria-labelledbyvers leh2, croix « Fermer » 44 px soussm,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— popoverposition: fixedavec 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 » (
BaseModalalertdialog, 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) enalertdialogà deux sorties, « Annuler » et « Configurer mon entreprise ». - Toasts feedback (UX-075) :
components/ui/BaseToast.vuemonté en bas-droite (toastref +showToast/ aliasshowInlineToastpour 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èremarkInvoicePaidErrorni 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-motionglobal (assets/main.css) ; focus visible sur checkboxes/radios filtres ; cibles tactiles 24×24 sur actions tableau factures ; déclaration publiquefrontend/docs/accessibility/InvoicesView.md. - Entrée de menu courante (UX-455) : dans
TrainerLayout.vue(barre latérale et tiroir mobile) etcomponents/(shared)/StaffNavItem.vue(espace Organisation), le lien actif portearia-current="page"sous la même condition que sa classe active, sous-routes comprises (/trainer/invoices/…pour « Mes factures »,/trainer/organizations/…pour « Organisations »,isActiveRoutedeStaffLayout) —router-linkne 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-noteversInvoicesView. - Éditeur d'avoir (FEAT-272) : route
/trainer/invoices/:invoiceUuid/credit-notes/:uuid(CreditNoteEditorView.vue, nametrainer-credit-note-edit). Depuis le drawer :handleCreateCreditNotereprend le brouillon existant ou appellePOST …/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 viaPOST …/invoices/product), TVA par ligne, garde « modifications non enregistrées » (useInvoiceUnsavedModalStore). Création de produit (BUG-1009 / UX-976) : après succès API,savingProductest remis à false avantcloseCreateProductModal()pour fermer la modale malgré la garde pendant l'envoi. Lien « facture complémentaire » →trainer-invoices-create?organizationUuid=(préremplissage client dansCreateInvoiceView). - 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é (amountliste = TTC). - Marque Factur-X (UX-459) : badge « Factur-X » (
BaseBadgeinfo + icôneFileCheck, titre « Facture électronique Factur-X ») sur l'état figéisEInvoicedu 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, propelectronicInvoicingMandatedu 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 sisummary.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-notesviatrainerAPI.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,limit30) ; filtres : organisation (multi, listeGET /trainer/invoices/config), période d’émission (presetscurrent_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.totalCreditedCentsseul. 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/previewrenvoie{ 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) ; filetmain.cssinchangé comme garde-fou.
Liste factures & CRA (InvoicesView.vue) et édition CRA (CreateCRAView.vue)
- Aperçu HTML :
CreateCRAViewaffiche un aperçu du document sur la largeur restante à 100 % du conteneur (billing_template_preview.html.twig: plus demax-widthsur.billing-preview-root--cra, anciennement ~48rem centré), carterounded-xlcomme la facture, avec un bandeau droit pleine largeur en mobile et ~288 px à partir delg: statut (Brouillon / Envoyé), code + modèle, puis actions (PDF, Enregistrer, Envoyer, Générer facture, Supprimer le CRA) — le header du layout n’affiche plusCRAHeaderActions(nettoyé au montage). Contenuv-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êtesdata-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 depuiscalendar_configurator_assignment.class_name. Dès l’init (et à chaque rafraîchissement),POST /trainer/activity-reports/previewest appelé :organizationUuidoptionnel — 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 deuxnextTickpour laisseruseBillingDocumentFormappliquer l’UUID par défaut ; unwatchinclut 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 attributsdata-bp="…"(cibles SPA) en plus dedata-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(SearchableSelecttoujours visible, même logique que surCreateInvoiceView— 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">dansbilling_template_preview.html.twig, au-dessus de l’adresse) dès l’aperçu avecPOST /activity-reports/preview; l’adresse / contact suivent. AperçuPOST /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, annoncerole="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-slotdu 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 infobullerole="tooltip"reliée pararia-describedby, affichée au survol, au focus et 3 s au toucher —useActionHintdu moduleinvoicing) ; 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 unalertdialog(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… » surBaseModal. - 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}/sendavecattachmentIds[]etattachmentoptionnel. Succès (BUG-1009 / UX-976) :sendingEmailest remis à false avantcloseSendModal(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.vuevianotificationAPI.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
localStoragesous 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, canalEMAILuniquement. 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+publicProfileLastViewedAtdepuis/me, format FR) sous le slug — empty-state si 0, microcopy « Anonyme — jamais visible sur votre profil public » ; sous-togglesallowResumeDownload+showPublicAgenda→updateInfo(); « Recevoir des demandes » (isOpenToRequests, DISC-025 issue 7) → composableuseTrainerOpenToRequests(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-describedbyvers 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 surgetReservationRequests()(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.vueappelletrainerDashboardStore.setSummaryActivityPeriod(): le sous-titre « Voici votre activité pour … » dansTrainerLayout.vuelitsummaryActivityPeriod(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 (quarterpar défaut,year,12_months), re-fetch au changement de pill, affichage CA + tendance + prochaine session + dot de statut ; mapping couleur basé en priorité surorganizationStatus(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 1MyDay, BLOC 2ToProcess, BLOC 3MyIndicators,RevenueEvolutionChart,MyStatistics) ; retrait des composants onboarding du dashboard ;InterventionDrawerunique (hub → drill-down pour les demandes).dashboardAPI.getUpcomingInterventions(limit, scope): support du paramètrescope(today/week) ; utilisé pour peupler BLOC 1 avec deux appels parallèles (10,todayet20,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 parRevenueEvolutionChart.vueavec toggle6m/12m/Année.trainerAPI.getPendingRequestsCount():GET /trainer/dashboard/pending-requests-count— compteurs plats (legacy) ; préférertrainerAPI.getDashboardBadges():GET /trainer/dashboard/badges—{ notifications, requests: { pending, urgent, newUnseen }, unreadInbox: { total, conversations, notifications, critical } }pour le polling sidebar (stores/trainerDashboard.js, 2 min dansTrainerLayout.vue). Toast « nouvelle demande » sirequests.pendingaugmente 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) vialocalStorage.trainer_dashboard_badges_last_fetch_at; le compteur affiché s’appuie surtrainer_pending_requests_countentre deux appels. Clétrainer_dashboard_badges_last_fetch_atretirée au logout.staffAPI.getDashboardBadges():GET /staff/dashboard/badges— même forme (y comprisunreadInboxagrégé) ;stores/staffDashboard.jsalimente le badge « Mes Demandes » + même toast (polling 2 min dansStaffLayout.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) vialocalStorage.staff_dashboard_badges_last_fetch_at; le compteur affiché s’appuie surstaff_pending_requests_countentre deux appels. Cléstaff_dashboard_badges_last_fetch_atretirée au logout. Le chargement initial staff ne passe plus parauth: uniquementStaffLayout/ vues dashboard.- Messagerie (
MessagesInbox.vue,stores/messages.js) : au montage,fetchBadges()/fetchPendingRequestsCount()sansforce— même plafond 2 min que le layout (pas d’appel systématique à chaque visite de/trainer/messagesou/staff/messages). Après marquage lu,applyUnreadInboxDeltasur le store dashboard ; quandGET /conversationsa chargé toute la liste (items.length === totalItems),reconcileUnreadConversationsFromLoadedListaligneunreadInbox.conversationsettotalsans/badges.refreshInboxBadgesFromAuthaprès les actions ne force plus le GET (throttle respecté). Dès queunreadInbox.notifications(réponse/badges) passe à > 0,TrainerLayout/StaffLayoutappellentsyncUnreadCountFromBadgespuis unGET /notifications/searchsilencieux (fetchNotifications(true, { silent: true })) pour remplir la liste deBellDropdown(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.vuesuit le pattern DS 2026 (ARIA dynamiquearia-haspopup+aria-labelavec count, fermetureEsc+ retour focus, zonearia-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-allviamessagesStore.markAllNotificationsAsRead). Catégorie sync calendrier : prise en charge du type backendsync_failure(fallback payloadcategory=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}/messagesavec corps JSON{ content }— même forme de réponse que le GET (FEAT-051). Utilisé parRequestDrawer.vue(FEAT-055).useRequestsStore: charge les batches viagetReservationRequests, 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.vuedésactive le bouton « Confirmer l'acceptation » et affiche un indicateur de chargement pendant l’appel API ; en cas d’erreur serveur,RequestsView.vueferme 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.vueaffiche l’organisation retenue sans question quandorganizationResolutionvautdeducedouexisting(FEAT-413 / FEAT-414) ; pourambiguous/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é parOrganizationLinkPicker.vue(module Directory), composé par la vue (RequestsView.vue, et depuis BUG-1022MessagesView.vueetDashboardView.vue, logique communeuseBatchAcceptance) dans le slotorganization-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 paruuid), « Rattacher à une autre organisation » (BaseSelectautocomplete 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, oucreateOrganization: true+organizationName(nom corrigé, la saisie du demandeur reste intacte). Les propssubmitting/errorsont 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— coquilleh-screen flex flex-col overflow-hidden; seule la zone sous la toolbar défile (flex-1 overflow-y-auto).TrainerLayout:overflow-hiddensur cette route. - Header (FEAT-137) : en-tête intégré dans la vue (
hidden lg:flex) ;TrainerLayoutmasque sa barre titre en desktop (isPlanningSettingsChromeRouteinclut/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-highlightedviauseCrossPageHighlight) ;?date=YYYY-MM-DD(semaine ciblée). Redirections legacy/trainer/planning/shareet/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, labelaria-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éerole="group"nommée « Calendriers » (UX-776) ; libellé et(N)entext-grey-700(UX-781). - Colonne gauche :
BaseAlertbanner 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 :
GETplanning viatrainerAPI.getPlanning({ dateStart, dateEnd })et fenêtre 5 moisgetFiveMonthIsoRange(refDate); re-fetch au changement de mois (watch refDate). BUG-849 :useLatestRequestignore 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/badgesau montage duTrainerLayout(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 routesdashboardAPI(/upcoming-interventions, etc.) sont déclenchés uniquement parDashboardView(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(ongletshoraires,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/endTimepar jour, copier-vers, planning par défaut). Modèle directrules:[{day, slots}](sansavailabilityWeekDays.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 dereplaceByAPI). 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→TrainerCalendarConnectorHubflow="personal"). - Absences (FEAT-139) : chaque entrée
vacationSlots[]acceptestart,endet un motif optionnellabel; formulaire avec toggle Journée entière (défaut,T00:00/T23:59) ou Plage horaire (BaseInput type="time"). Métadonnée UIallDaylocale (non envoyée au backend) + heuristiqueT00:00/T23:59au chargement pour rétrocompat. - Fériés (FEAT-139) : callout
BaseAlert, togglesBaseTogglepar jour férié FR. - Agenda (FEAT-139) : callout
BaseAlert+ icôneShieldCheck;TrainerPersonalCalendarConnectorinchangé (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, commeog.png) ; Symfony sert letext/calendaren 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é + migrationVersion20261021190000). Page publique : mêmes libellés (getExpirationText). - Révocation :
PlanningShareRevokeModal(wrapperBaseModal) ; retraitROLE_AGENDAsi type contact. - Sidebar consultative :
PlanningContactSidebar(distinct deContactSidebar.vuepage 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 :
- Frontend (UX) —
AvailabilityView.vue(éditeur N slots, FEAT-138) : - Par plage : fin après début (
isSlotInvalid) ; chevauchement même jour (warning orange,slotOverlaps). -
Bouton « Enregistrer » désactivé si nom vide ou
hasInvalidSlots(fin ≤ début sur une plage active). -
Infrastructure (API) —
TrainerAvailabilitySlotRequest: -
Contrainte
#[Assert\Callback]validateTimeRange(): vérifieendTime > startTime, violation sur le pathendTime. -
Domain (entité) —
TrainerAvailabilitySlot: - Le constructeur lance une
\InvalidArgumentExceptionsiendTime <= 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. submitBookingapplique un garde-fou immédiat (if (loading) return) avant de lancer l’appel API.- Une clé
idempotencyKeyest 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-Keysur : 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.vuefournit topbar (logo +publicProfileVanityLabel), CTA contact/agenda via props/events, modales FEAT-212/217. Calqué maquetteespace-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 FRIntl.DateTimeFormat), semaines libres → bouton « Demander » (pré-remplitcontact.messageavec 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) :
BaseModalavec formulaire GUEST (Prénom+nom, Email pro, Organisation optionnel, Message). Étatsidle/sending/error/sent(double opt-in : message « Vérifiez votre boîte mail… »). Fallbackmailto:affiché uniquement si le DTO exposecontactEmail(relais PUB-10). Lien RGPD vershttps://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é pargetTrainerProfile(ownSlug)(même DTO que la page visiteur, sans bouton CV). Carte in-pageParcoursCvPreviewCard: 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). ParcoursOrganizationMergeView.vue+ composantsmodules/directory/components/merge/*; étapes dérivées deskippedSteps(GET /trainer/organization/merge/preview). Choix (?from=) :GET /trainer/organization/merge/candidates?from=renvoie pour chaque candidateorigin,totalHours,moduleCount,hasRemoteConnector,providerType(plusuuid,name,campus,isSuggested). Exécution :POST /trainer/organization/merge; retour liste viaorganizationMergeStore.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é pardisablednatif (pasbusysur le voisin) ; régionrole="status"sr-only « Fusion des organisations en cours… » pendantisMerging. - A11y fiche / liste org formateur (UX-1010) : après association réussie + relecture
initializeData()surConfigureOrganizationView.vue, le focus est replacé sur le panneau onglet Connecteurs (#panel-connecteurs). SurOrganizationsView.vue, la modale de dissociation ne se ferme pas par Échap ou clic voile tant quedissociateLoading; le bouton « Annuler » estdisabledpendant 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-onlyrole="status"déjà présents sous les boutons — les encarts verts de succès ne portent plusrole="status"(StaffEmailValidationConnectedView,StaffInvitationConnectedView) ; la région sous « Valider » inclutsuccessMessage(validation + renvoi de code, ce dernier restant annoncé aussi sous « Demander un nouveau code »). Gardesif (loading/isLoading/isSubmitting/regenerateSending) returnsursubmitForm/submitInvitations/requestLink/sendRegenerateLinkpour qu’un secondsubmitpendant 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— alimenteOrganizationsView.vue(/trainer/organizations, refonte FEAT-040). Layout : titre + sous-titre + CTA dans le header globalTrainerLayout(useTrainerOrganizationsHeader+OrganizationsListHeaderActions) ; zone scrollable avec barre de résumé (compteurs cliquables), recherche fondmushroom-50, tri (nom A→Z / Z→A, CA décroissant, formations = tri surcountUnlinkedAssignments), pills de statut. Ajout : CTA verstrainer-organizations-configure;/trainer/organizations/addredirige (FEAT-048). Avatar liste :getColorForId(uuid || nom)+getInitials(nom)(useAvatarColor) pour cohérence maquette ;calendarColorreste disponible côté données. Par assignation :totalHours/totalRevenue(planifié) ;totalRealizedHours/totalRealizedRevenue; si le backend exposetotalInvoicedRevenue, la ligne « dont X € facturé » l’utilise, sinon repli surtotalRealizedRevenue. 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 sitotalHours === 0. Sync :countUnlinkedAssignments,lastImportErrorCode, bandeaux aprèsPOST …/sync+GET /process/{uuid}.providerType: libellé FR viacalendarConnectorProviders.js(ligne métadonnées avec type + contact). Dissociation : menu kebab → modale confirmation (saisie « Supprimer ») →DELETEviaorganizationAPI.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 progressif1s (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.jscentralise l’état multi-orgs (orgStates) et exposesyncingCount,errorCount(>= 2échecs consécutifs),syncGlobalState(error > syncing > stable),calmDotTooltip,lastGlobalSyncFormatted.bootstrap()consommeGET /trainer/organization/dashboardpuis relance les pollers actifs viacurrentSyncProcessUuid. Les vues peuvent notifierstartSync/onSyncCompleteet le layout nettoie viastopAll(). - Composant Calm Dot sidebar (DISC-019 / FEAT-110) :
components/Trainer/SidebarSyncDot.vueconsommeuseSyncStoreet rend 3 états utiles : rien enstable, dot bleu animé ensyncing(compteur si > 1), badge rouge enerror(prioritaire en coexistence). Navigation au clic :trainer-organizations(ou?filter=erroren rouge). A11y :role="status",aria-labeldynamique,titleviacalmDotTooltip, fallbackprefers-reduced-motion. - Toasts synchronisation (DISC-019 / FEAT-111) :
composables/useToast.jsgère un stack singleton max 3 (addToast,dismissToast,clearAllToasts) ;components/ui/ToastContainer.vueaffiche le stack enTeleportbas-droite (right-[max(1.5rem,env(safe-area-inset-right))], UX-760) ;components/ui/SyncToast.vueencapsuleBaseToast: succès (durationMs=5000,pausable=true) et erreur persistante (durationMs=0, CTA optionnel “Voir l’organisation”). UX-785 : racinearia-live="polite"— un toast émis sous unBaseModaln’est pasaria-hiddenet 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 (formesenv(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+ taillesinline/standalone/row/icon+as(a,RouterLink). Les boutons à boîte existants restent des pilules. Recette : lien Tertiary bleu 44 px à 375 px ; CTAsize="inline"dans une phrase sans cible ; Ghostrounded-lg px-4;ghostRemovenommé pararia-label. - Intégration layout (DISC-019 / FEAT-112) :
layouts/TrainerLayout.vuemonteToastContainerglobalement, ajouteSidebarSyncDotsur l’entrée menu Organisations (mobile + desktop non replié), déclenchesyncStore.bootstrap()auonMountedetsyncStore.stopAll()auonUnmounted. - 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 alimenteuseSyncStore(startSyncau dispatch,onSyncCompleteaux terminaux,stopSyncsur erreurs) et émet des toasts globaux viauseToast(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 viarouter.replace. - ConfigureOrganizationView (DISC-019 / FEAT-114) : pas de changement UI sur l’onglet Connecteurs (progression/timeline/bannières conservées) ; la vue alimente
useSyncStoreen parallèle du polling local (startSyncau démarrage upload/link/re-sync + callback OAuth?syncProcess=,onSyncCompleteen succès/échec terminal,stopSyncen erreur de suivi). Toast global d’erreur ajouté viauseToastpour 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 pardateStart|label|category, filtreslabel,category(movable|synced|invoiced) etperiod— les périodes « 12 derniers mois » et « année scolaire » sont envoyées encustomavecperiodStart/periodEndcalculés par l’écran (DISC-030 / FEAT-426). Appel au focus de l’onglet seulement (OrganizationEventsPanel, watchactive+ uuid), rechargé à chaque changement de filtre, de tri ou de page. Provenance à deux niveaux (constants/organizationEventProvenance.js: catégorieBaseContextTag+ 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-24sur le conteneur défilant de la vue), modale de destinationOrganizationEventsMoveModal: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, ledetaildu 422 s’affiche ; succès = rechargement + toast avec lien vers la destination (SyncToastrend lectade tout type), échec = bandeau tout-ou-rien (FEAT-427). Drawer :trainer-planning?date=&highlight=ettrainer-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 localStorageonboardingGuard: Protection des routesuseOnboardingStore: 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 + conteneurflex-1 overflow-y-auto) pour éviter un écran bloqué quandbodyest enoverflow: hidden(cas modales/overlays).OnboardingConnectedLayout.vue: même convention via utilitairespage-fullscreen/page-fullscreen-scroll(main.css, cascadeh-screen h-svhUX-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 sibodyest temporairement verrouillé par un overlay. Titres de bloc en<h2>/<h3>(popover, légende, à propos, réservations) ; assistantBookingWizard: critères et créneau sélectionné en<h3>, alternative en<dt>/<dd>(UX-779). BUG-845 : barre d’infoN/Mlitinfo.bookingsUsed(lots du partage) et l’incrémente à l’événementsuccessde 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’écouteurwindowqui 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) etaria-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) utilisentPublicLayout(DISC-024) : la page défile avec le document ; autres vues (PasswordResetView, suivi réservation, invitations, planning partagé, profil public,OAuthRedirect) : encorepage-fullscreen+page-fullscreen-scrolllegacy, à défilement interne. La racineApp.vueest enmin-h-full, sans hauteur fixe nioverflow-hidden, etbodyne porte aucunoverflow: hiddenglobal : 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-loginOnboardingChecklistItem.vue: item d'étape avec CTAOnboardingCelebrationModal.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