Acteur

Candidat (+ IA générative)

Préconditions

Utilisateur authentifié (Keycloak)

Flux Principal

1. Le candidat lance le wizard Clara (ScratchWizardModal, 3 étapes) 2. Il choisit un secteur (9), un niveau d’expérience (4) et un ton (4), avec texte libre optionnel 3. Le système appelle POST /api/v1/ai/generate-cv (CvGenerationService → GeminiClient, JSON mode, 8192 tokens) 4. Le CV complet généré alimente cvData dans le store 5. createNewCv() persiste le document (POST /api/v1/cv-documents) 6. Le candidat est redirigé vers l’éditeur (?screen=workspace&cv={id})

Flux Alternatif

A1 : partir d’un CV vierge sans passer par le wizard

Flux Exception

E1 : réponse IA non parsable → 502, le wizard reste ouvert E2 : quota/erreur IA → 429, message d’attente

Postconditions

Document cvDocuments créé (layout minimal, couleur #FF4D2E par défaut), éditable

Acteur

Candidat (+ IA générative)

Préconditions

Utilisateur authentifié ; fichier PDF ≤ 60 Mo

Flux Principal

1. Le candidat dépose un PDF (écran d’accueil ou chat Clara) 2. Contrôle local validatePdfSize() (type application/pdf, ≤ 60 Mo) 3. Upload vers MinIO sous resumes/{userId}/… 4. POST /api/v1/cv-documents/import-pdf avec l'`objectKey` 5. CvImportService : téléchargement MinIO → extraction texte (PDFBox, boundedElastic) 6. Structuration IA (generateJson + STRUCTURATION_PROMPT, 120 000 tokens max) 7. Normalisation (normalizeImportedData : ids, défauts) et création du document « CV importé »

Flux Exception

E1 : fileKey hors de resumes/{userId}/ → « Not authorized » E2 : JSON tronqué → réparation attemptFixTruncatedJson

Postconditions

CV pré-rempli ouvert dans l’éditeur

Acteur

Candidat

Préconditions

Utilisateur authentifié, profil renseigné

Flux Principal

1. Le candidat clique « Importer depuis mon profil » 2. POST /api/v1/cv-documents/import-profile 3. CvImportService charge User + UserSkill et construit : identité, résumé (bio), compétences 4. Si un CV-fichier est attaché au profil (resumeUrl) : import PDF (UC02) puis fusion mergeCvData (les données du profil priment) 5. Création du document « CV depuis profil »

Flux Exception

E1 : échec de l’import du PDF attaché → repli non bloquant sur les seules données du profil

Postconditions

CV créé ; expériences/formations vides si aucun PDF n’a pu être fusionné

Acteur

Candidat

Préconditions

Utilisateur authentifié

Flux Principal

1. Le candidat ouvre « Mes CV » (?screen=list) 2. GET /api/v1/cv-documents/me retourne les documents de l’utilisateur 3. L’écran affiche titre, dates, pourcentage de complétude (calcul client) 4. Recherche et filtres côté client ; clic → ouverture dans l’éditeur

Flux Alternatif

A1 : filtre par statut d’affichage ou CV récents

Flux Exception

E1 : aucun CV → renvoi vers l’écran d’accueil (UC01–UC03)

Postconditions

Le CV sélectionné est chargé dans le store (loadExistingCv)

Acteur

Candidat

Préconditions

CV existant appartenant au candidat

Flux Principal

1. Le candidat clique « Supprimer » et confirme 2. DELETE /api/v1/cv-documents/{id} 3. CvDocumentService.delete vérifie l’appartenance (userId) puis supprime le document 4. Le CV disparaît de la liste

Flux Exception

E1 : CV d’un autre utilisateur → DomainException « Not authorized »

Postconditions

Suppression définitive (pas de corbeille, pas de soft delete)

Acteur

Candidat

Préconditions

CV ouvert dans le workspace

Flux Principal

1. Le candidat édite une des 8 sections typées (identité, accroche, expériences, formations, compétences, langues, projets, certifications) via son formulaire dédié 2. Les champs riches utilisent l’éditeur TipTap (RichTextEditor) 3. Chaque saisie mute cvData dans le store ; l’aperçu live se rafraîchit en 300 ms 4. Include UC19 : l’autosave débouncé (2 s) persiste le document (PUT /api/v1/cv-documents/{id})

Flux Alternatif

A1 : ajouter/supprimer une section personnalisée (customSections dans data) A2 : compétences avec 4 dimensions notées (niveau, plaisir, ancienneté, potentiel) et 8 catégories

Flux Exception

E1 : CV sans id (jamais persisté) → création au premier autosave

Postconditions

Contenu à jour dans MongoDB (blob data du document)

Acteur

Candidat

Préconditions

CV ouvert dans le workspace

Flux Principal

1. Le candidat glisse-dépose les sections (SectionOrderControl, sortablejs) 2. La section identité est verrouillée en position 0 3. Interrupteurs de visibilité par section (SectionVisibilityControl → hiddenSections) 4. sectionOrder/hiddenSections sont enregistrés dans data via l’autosave (UC19)

Postconditions

Ordre et visibilité appliqués à tous les rendus (aperçu, export, partage)

Acteur

Candidat

Préconditions

CV en cours d’édition

Flux Principal

1. Le candidat ouvre la galerie (?screen=templates) 2. generateTemplates() produit 57 layouts × 20 palettes = 1140 combinaisons (100 % côté client) 3. Filtres : style (mod/min/cre/cls/tec/ele), layout, compatibilité ATS, couleur, recherche, tri 4. Aperçu plein écran (TemplatePreviewModal) avec rendu live du contenu réel 5. selectTemplate() applique le layout et écrase la couleur d’accent avec celle de la palette

Flux Alternatif

A1 : saisie d’une couleur hex libre

Flux Exception

E1 : layout inconnu au rendu → repli CvLayoutClassic

Postconditions

templateLayout mémorisé (chaîne libre) — persisté au prochain enregistrement du contenu

Acteur

Candidat

Préconditions

CV en cours d’édition

Flux Principal

1. Couleur d’accent : presets, saisie hex validée, contrôle de contraste (ColorCustomizer) 2. Police : 6 familles (dm-sans, syne, playfair, jetbrains, lora, outfit) 3. Taille de police (3 niveaux) et interlignage (compact/standard/airy) — StyleControls 4. Badge « Powered by ClaraJob » activable/désactivable 5. Rendu immédiat dans l’aperçu

Postconditions

fontFamily/fontSize/spacing dans data (autosave) ; accentColor et showBadge persistés au niveau du document

Acteur

Candidat

Préconditions

CV en édition

Flux Principal

1. Le candidat ouvre l’aperçu (?screen=preview ou panneau latéral de l’éditeur) 2. CvPagedPreview découpe le rendu au format A4 (595×842) via computePagesCount() 3. Zoom et bascule desktop/mobile 4. L’overlay plein écran de l’éditeur affiche une page A4 (794×1123 px)

Flux Exception

E1 : pagination approximative (mesure de hauteur) → le rendu de référence est l’impression (UC11)

Postconditions

Le candidat voit le rendu final paginé

Acteur

Candidat

Préconditions

CV ouvert

Flux Principal

1. Le candidat clique « Exporter » (EditorPreviewPanel) 2. useCvVectorExport.exportVectorPdf() : nextTick + requestAnimationFrame puis window.print() 3. Le navigateur rend CvPrintDocument (téléporté dans #cv-print-root, @media print, @page A4 marges 12 mm, break-inside: avoid) 4. Le candidat choisit « Enregistrer au format PDF » dans la boîte d’impression 5. Événement analytics Plausible cv_exported

Flux Exception

E1 : le candidat annule la boîte d’impression → aucun effet

Postconditions

PDF vectoriel enregistré par l’utilisateur ; aucun PDF stocké côté serveur (l’endpoint POST /api/v1/cvs/{cv_id}/export répond 501 Not Implemented)

Acteur

Candidat

Préconditions

CV persisté

Flux Principal

1. Le candidat active le partage (SharePanel, ?screen=share) 2. PUT /api/v1/cv-documents/{id}/share → CvShareService.updateShare(enabled, slug) 3. Le token UUID existe dès la création du document ; le slug personnalisé est optionnel (regex ^[a-z0-9][a-z0-9-]{1,58}[a-z0-9]$, unicité vérifiée) 4. Retour CvShareResponse avec tokenUrl et slugUrl ; URL copiable

Flux Alternatif

A1 : désactiver le partage à tout moment ; A2 : partage LinkedIn (URL seule)

Flux Exception

E1 : slug déjà pris → 409 Conflict

Postconditions

CV accessible publiquement ; pas d’expiration, de mot de passe, de QR code ni de compteur de vues (les KPI affichés par l’écran Partage sont illustratifs)

Acteur

Visiteur (non authentifié)

Préconditions

Partage activé sur le CV

Flux Principal

1. Le visiteur ouvre /cv/{tokenOuSlug} (CvPublicView) 2. GET /api/v1/cv-documents/shared/{token} (public, X-Robots-Tag: noindex) 3. Repli automatique sur GET /api/v1/cv-documents/shared/s/{slug} si introuvable 4. CvPublicResponse (data + design) est rendu en lecture seule avec le layout du document

Flux Exception

E1 : partage désactivé ou token inconnu → page introuvable

Postconditions

CV consulté sans compte ; aucune trace côté serveur (pas de compteur)

Acteur

Candidat (Admin pour la configuration du plafond)

Préconditions

CV persisté

Flux Principal

1. Écran Versions (?screen=versions, onglet « history ») 2. Créer : POST /api/v1/cv-documents/{id}/versions — snapshot immuable (data + layout + couleur), label par défaut « Version du yyyy-MM-dd » 3. Rotation FIFO : au-delà du plafond (10 par défaut), la plus ancienne est supprimée 4. Restaurer : POST …/versions/{versionId}/restore réécrit le contenu du document 5. Supprimer : DELETE …/versions/{versionId}

Flux Alternatif

A1 (Admin) : modifier le plafond via GET/PUT /api/v1/cv-documents/admin/config (collection appConfig, clé cv-builder.max-versions-per-cv)

Postconditions

Historique borné, restauration possible à tout moment

Acteur

Candidat

Préconditions

CV avec contenu ; description d’offre disponible

Flux Principal

1. Écran Adapter (?screen=adapt) : le candidat colle la description de l’offre 2. Le CV est sérialisé en texte (serializeCvToText) 3. POST /api/v1/cv/match → CvMatcherService : matching purement algorithmique (normalisation NFD, stop-words FR/EN, score = mots trouvés / total) — aucun appel IA 4. Affichage du score et des mots-clés manquants 5. « Créer une variante » : POST /api/v1/cv-documents/{id}/variants (cvVariants : nom, référence de l’offre, deltas, matchScore)

Flux Alternatif

A1 : consulter/supprimer les variantes (écran Versions, onglet « variants »)

Postconditions

Variante rattachée au CV maître, comparable (diff) et listée

Acteur

Candidat (+ IA générative)

Préconditions

CV ouvert ; écran Coach (?screen=ai-coach)

Flux Principal

1. Le candidat envoie un message (cooldown 5 s entre requêtes) 2. POST /api/v1/ai/chat avec message, cvData et les 10 derniers messages 3. CvChatService (persona « Clara ») répond en JSON : message + actions structurées (8 types : update_identity, update_section, set_experiences, set_education, set_skills, set_languages, add/remove_skill, set_full_cv) 4. Les actions modifiantes sont proposées en boutons ✅/❌ — jamais appliquées sans validation 5. À l’application : validation Zod (validateChatAction), snapshot d’annulation (mémoire, 20 max), mutation de cvData, puis autoSave()

Flux Alternatif

A1 : quick actions d’import (PDF, profil) depuis le chat ; A2 : undo

Flux Exception

E1 : erreur IA/429 → « L’IA est momentanément indisponible »

Postconditions

Conversations persistées en localStorage (50 max × 200 messages) — pas côté serveur

Acteur

Candidat (+ IA générative)

Préconditions

Champ riche en édition (accroche, expérience, projet)

Flux Principal

1. Boutons « Reformuler » / « Générer » dans RichTextEditor (TipTap) 2. Reformuler : POST /api/v1/ai/reformulate (contexte experience/summary/project, ton du wizard) 3. Générer : POST /api/v1/ai/generate-section (contexte enrichi : titre, top compétences) 4. Garde anti-refus (AiRefusalDetector → 422) 5. Succès → le contenu de l’éditeur est remplacé

Flux Exception

E1 : échec ou 429 → toast d’erreur, le contenu existant n’est jamais écrasé E2 : cooldown local 5 s entre appels

Postconditions

Texte amélioré dans la section ; persistance par l’autosave (UC19)

Acteur

Candidat

Préconditions

CV avec contenu

Flux Principal

1. Écran Score (?screen=ats) ou panneau latéral de l’éditeur 2. useCvScoring (100 % client, computed) : 8 sections notées /10 → total en % 3. Score ATS par bonus fixes (nom 15, titre 10, email 10, résumé 15, expérience 20, formation 10, compétences 15, langue 5) 4. Détection de 12 clichés (« dynamique », « motivé », « rigoureux »…) dans l’accroche et les expériences 5. Conseils contextuels (LinkedIn manquant, absence de chiffres, etc.)

Flux Exception

E1 : les listes de mots-clés ATS affichées sont illustratives (données fixes) — seuls les scores et clichés sont réellement calculés

Postconditions

Jauge et recommandations affichées — aucun appel réseau, aucune validation bloquante

Acteur

Système

Préconditions

CV ouvert dans le workspace

Flux Principal

1. watchDebounced (2 s, deep) surveille cvData dans CvWorkspaceView 2. À la stabilisation d’une édition : store.autoSave() 3. CV déjà persisté → PUT /api/v1/cv-documents/{id} (upsert complet du document) 4. CV jamais persisté → createNewCv() (POST /api/v1/cv-documents) 5. lastSavedAt mis à jour, indicateur « Enregistré »

Flux Alternatif

A1 : les actions IA validées dans le chat déclenchent autoSave() immédiatement

Flux Exception

E1 : le watch ne couvre que cvData — un changement de template ou de couleur seul n’est persisté qu’avec la prochaine édition de contenu

Postconditions

Document MongoDB à jour ; pas de timer périodique, pas de cache hors-ligne