GetYourJob

## Spec (épopée) — Ajouter les rôles et compétences Agile manquants dans les listes et filtres

### Problème
Les rôles, compétences et outils spécifiques à l'Agilité à l'échelle (Coach Agile, Scrum Master SAFe, RTE, Agilité à l'échelle, Coaching Agile, Amélioration continue, Confluence, Miro) sont absents des listes de sélection (profil + offre) et des filtres de recherche. Le rôle générique « Scrum Master » englobe aujourd'hui « Coach Agile » comme synonyme, ce qui empêche de distinguer les spécialisations.

### Approche
Travail réparti sur deux surfaces :
- **Frontend (`GetYourJob/src/`)** : enrichir les listes statiques de rôles / compétences / outils consommées par la sélection de poste (profil et création d'offre), puis exposer ces nouvelles entrées dans les filtres de recherche.
- **Backend / taxonomie (`MatchingAgent/` + `docs/.../2026-04-20-role-normalization.md`)** : faire reconnaître les nouveaux rôles/compétences par la normalisation, en distinguant « Coach Agile », « Scrum Master SAFe » et « RTE » du « Scrum Master » générique, afin que le filtrage et le matching retournent des résultats pertinents.

Découpage par responsabilité (et non arbitraire), dépendances acycliques : la taxonomie alimente la pertinence des filtres ; les listes alimentent les filtres.

### Critères d'acceptation de l'épopée
- Coach Agile, Scrum Master SAFe et RTE sélectionnables dans « Leadership & Architecture » (profil + offre).
- Agilité à l'échelle, Coaching Agile, Amélioration continue disponibles en compétences ; Confluence et Miro en outils (Jira vérifié présent).
- Tous ces éléments filtrables dans la recherche, avec résultats pertinents (test utilisateur).
- Distinction de normalisation respectée (« Scrum Master SAFe » ≠ « Scrum Master ») conformément à role-normalization.md.
- Aucune régression sur les listes/filtres existants.

### Décision de découpage : OUI (épopée + 3 sous-tâches)
Le travail couvre deux surfaces de code (TS frontend + Python taxonomie) et trois responsabilités distinctes :

1. **#child-1 — Frontend : enrichir les listes rôles / compétences / outils** (S)
Ajout des entrées aux listes statiques consommées par la sélection de poste (profil + offre). Pré-requis des filtres côté UI.
2. **#child-2 — Frontend : exposer les nouveaux critères dans les filtres de recherche + test E2E de pertinence** (M)
Câblage des nouvelles entrées dans les filtres profils/offres, non-régression des filtres existants, validation E2E (recherche « Coach Agile » / « RTE » / « Miro » renvoie les bons résultats). Dépend de #child-1 et #child-3.
3. **#child-3 — Backend / taxonomie : normalisation des nouveaux rôles & compétences (role-normalization.md + MatchingAgent)** (M)
Distinguer Coach Agile / Scrum Master SAFe / RTE du Scrum Master générique, mapper les nouvelles compétences/outils, mettre à jour role-normalization.md. Condition de la pertinence des filtres.

Dépendances : #child-1 → #child-2 ; #child-3 → #child-2.

## Design brief — #29 « Ajouter les rôles et compétences Agile manquants » (sign-off UI)

**Verdict : aucun nouveau pattern, composant ni couleur.** C'est un enrichissement *additif* de listes/filtres déjà en place. Le travail design se limite à valider les placements et à confirmer la réutilisation des patterns existants. Section de cadrage ajoutée au design system (`DESIGN_SYSTEM.md`, section « SC — Sélecteurs rôles / compétences / outils »).

### Atomic Design — composants réutilisés (rien de neuf)
- **Sélecteur de rôle** (profil + offre) : `molecules/InlineRoleSelector.tsx`, piloté par `lib/role-picker-taxonomy.ts` — grille de cartes-boutons groupées par catégorie.
- **Filtre rôle** (recherche) : `molecules/RoleFilterPicker.tsx` câblé dans `organisms/TopFilterBar.tsx` + `organisms/MobileFilterModal.tsx` — même grille + compteurs.
- **Compétences / outils** (sélection et filtre) : `molecules/InlineSkillSelector.tsx` / `InlineSecondarySkillSelector.tsx` + dropdown technologies du `TopFilterBar` — recherche autocomplete → chips `rounded-full` dans un conteneur `flex flex-wrap gap-2`.

### Placements
- **Rôles** → catégorie **existante** « Leadership & Architecture » de la taxonomie : **Coach Agile** (distinct de Scrum Master qui reste dans « Autres »), **Scrum Master SAFe**, **Release Train Engineer (RTE)**.
- **Compétences** → liste existante (pas de nouvelle catégorie) : **Agilité à l'échelle (SAFe/LeSS)**, **Coaching Agile**, **Amélioration continue (Kaizen/Lean)**.
- **Outils** → liste existante : **Confluence**, **Miro**. ⚠️ Vérif : **Jira est actuellement ABSENT** du `TechnologyStackDatabase` — à ajouter aussi le cas échéant (Confluence/Miro/Jira ne sont pas dans la base techno aujourd'hui).

### Note d'implémentation (pour le dev, hors périmètre design)
Les rôles sont portés par l'**enum Prisma `RoleType`** + le normaliseur (`role-normalization.md`). Les 3 nouveaux rôles **ne sont pas un simple ajout de label** : ils exigent de nouvelles valeurs d'enum + règles de normalisation (sous-tâches #57 frontend / #60 backend-taxonomie). Les compétences/outils, eux, sont des chaînes libres recherchées — ajout simple dans la base techno.

### États (réutilisés, inchangés)
Vide (technos populaires), chargement (recherche debouncée 200 ms), erreur (`logError` + liste vide), renseigné (chips / cartes en bordure verte primaire).

### Overflow / wrapping du panneau de filtres — VÉRIFIÉ, scale OK
- Filtres compétences/outils : champ de saisie + dropdown de suggestions déjà borné (`max-h-80 overflow-hidden`, liste `max-h-60 overflow-y-auto`) → +Confluence/Miro/3 compétences ne change pas la hauteur visible.
- Filtre rôle : grille qui wrappe ; +3 rôles = au plus 1 ligne de grille en plus dans « Leadership & Architecture » (5 → 8 entrées), absorbée par le scroll du panneau (`MobileFilterModal` est un modal scrollable). **Aucune** modif de hauteur fixe / z-index / breakpoint requise.

### Tokens / couleurs / i18n
- Aucun nouveau token : bordure de sélection rôle = `primary` (Willow Green), chips = palette existante. Conforme v1.0 baseline.
- i18n : libellés rôles dans `role-picker-taxonomy.ts` ; toute clé UI nouvelle irait dans `en.ts` seul (`fr.ts` réexporte). Les nouveaux termes sont métier et identiques FR/EN — pas de nouvelle clé d'affichage strictement nécessaire.

### Mockup
Pas de mockup visuel produit : la surface visuelle est nulle (aucun nouveau composant). Le brief textuel ci-dessus + la section `DESIGN_SYSTEM.md` font office de référence design.

→ Statut transitionné **Spec → Design**.

h2. QA — Smoke test : *PASS* ✅ (reste en QA)

PR #232 (base @dev@) · branche @feat/redmine-29-agile-roles@ · worktree @.worktrees/redmine-29-agile-roles@ · 2026-06-11

*Méthode.* Un smoke UI complet (dev server + DB live + auth prod) n'étant pas praticable ici, la preuve de smoke s'appuie — comme prévu par le ticket — sur les suites vitest ajoutées (@RoleNormalizationService@ + @AgileRolesAndSkills.integration@), complétées par l'inspection des fichiers source modifiés. Ces suites assertent exactement les surfaces de données qui pilotent à la fois les *sélecteurs* (profil/offre) ET les *filtres de recherche* : @ROLE_PICKER_TAXONOMY@ (InlineRoleSelector + filtre rôle TopFilterBar/MobileFilterModal), @searchTechnologies@ (autocomplete compétences/outils), @RoleNormalizationService.normalizeRole@ (libellé brut → enum envoyé par le filtre = pertinence du filtre).

*Résultats.*
* @npx vitest run AgileRolesAndSkills.integration + RoleNormalizationService@ → *236 / 236 passés* (dont 13 nouveaux tests d'intégration).
* @npx prisma generate@ → OK (Prisma 6.12.0).
* @npx tsc --noEmit@ → erreurs présentes mais *uniquement dans des fichiers non touchés par #29* (pré-existantes, repo-wide ; tsc/lint standalone cassé sur Next 16, build via @ignoreBuildErrors@). Aucun fichier non-test modifié par #29 n'a d'erreur tsc → *pas de régression imputable à #29*.

h3. Acceptance criteria → résultat

| AC | Critère | Résultat |
| 1 | Coach Agile, Scrum Master SAFe, RTE dans « Leadership & Architecture » (sélecteur profil/offre) | *OK* |
| 2 | Compétences Agilité à l'échelle, Coaching Agile, Amélioration continue disponibles | *OK* |
| 3 | Outils Confluence + Miro disponibles ; Jira présent | *OK* |
| 4 | Nouveaux rôles/compétences/outils présents dans les filtres de recherche (@ALL_ROLE_TYPES@ + autocomplete) | *OK* |
| 5 | Filtre pertinent : « Coach Agile » → @AGILE_COACH@, « RTE » → @RELEASE_TRAIN_ENGINEER@ (libellé brut normalise vers l'enum du filtre) | *OK* |
| 6 | Priorités role-normalization.md : « Scrum Master SAFe » distinct de « Scrum Master » (@SCRUM_MASTER_SAFE@, jamais le bucket générique) | *OK* |
| 7 | Aucune régression : « Scrum Master » → @SCRUM_MASTER@, React résout toujours, tous les rôles existants présents | *OK* |

*Preuves jointes* (sans secret) : @qa_29_visual_proof.png@ (sortie verbose des 13 tests verts) + @qa_29_technical_proof.txt@ (commandes, gates, mapping AC, inspection source).

*Verdict : PASS — le ticket reste en QA* (la promotion preprod est hors périmètre QA).

preprod→master mergé → livré en production. Preprod → Shipped. (Suivi MatchingAgent #68 non livré — voir ci-dessous.)

preprod→master mergé → livré en production. Preprod → Shipped. (Portion MatchingAgent #68 NON livrée — voir le ticket.)