Revise deep dive documentation to analyze DDD patterns in the URIAE codebase, focusing on the Economic and Social Solidarity context. Address shared language, bounded contexts, and semantic issues, while providing recommendations for improvement and a proposed glossary for ESS terminology.

An IA assisted dive into domain from legacy code
2026-04-10 17:13:25 +02:00 · 2026-04-10 12:27:36 +02:00
7 changed files with 1359 additions and 9 deletions
--- a/docs/deep-dive-any-domain.md
+++ b/docs/deep-dive-any-domain.md
@@ -0,0 +1,234 @@
+# Analyse DDD Stratégique — Plateforme ESS
+
+Analyse du code source URIAE (bundles Symfony sous `src/Uriae/`) selon les patterns stratégiques du Domain-Driven Design, dans le contexte de l’Économie Sociale et Solidaire (ESS) et des travailleurs en insertion / SIAE.
+---
+
+## 1. Langage Partagé
+
+### Constat
+
+- Le code mélange **anglais** (`Employee`, `User`, `HiringStatus`, `Town`) et **français** (`Contrat`, `ParcoursInsertion`, `Structure`, `Accompagnement`, `SituationSortie`), avec des artefacts hybrides (`TypeEmployee` dont le docblock cite encore `TypeSalarie`).
+- Des termes **alignés insertion / SIAE** apparaissent clairement : `ParcoursInsertion`, `SiaeType`, `TypeContratAsp`, `FicheContratAsp`, `CodeRome`, `SiteTravail`, `AnnexeFinanciere`, `Financement`, catégories de **sortie** (`TypeSituationSortie` avec notions type durable/transition côté référentiel).
+- Le **cœur personne–emploi** est nommé **Employee** alors que les commentaires et l’UI parlent d’**employé** / **salarié** ; `TypeEmployee` distingue **Candidat**, **En insertion**, **Permanent** — vocabulaire partiellement adapté aux parcours IAE mais pas à toute la diversité ESS.
+- **Structure** + **FormeJuridique** + **SiaeType** reflètent une **structure porteuse** (multi-sites, annexes, typologie SIAE) plutôt qu’une modélisation fine « association / SCIC / mutuelle » au niveau métier juridique.
+- **Suivi** côté métier insertion est riche (`Action`, `Accompagnement`, `Evaluation`, `FormationInterne`, `Potentiel`, `Problematique`, `Habilitation`) ; le bundle **Asp** réutilise le mot **Suivi** pour des **échanges de fichiers ASP** — **homonymie** avec le contexte « suivi salarié ».
+
+### Problèmes détectés
+
+- **Écart vocabulaire ESS élargi** : peu de traces explicites dans le code des statuts **bénévole**, **coopérateur**, **adhérent-salarié**, **ESAT**, **volontariat**, ni des **agréments** type ESUS/CAE comme concepts de domaine nommés ; l’implémentation semble **centrée SIAE / contrat / ASP** plutôt que sur tout le spectre ESS décrit dans un cadrage large.
+- **Employee** comme terme unique **aplati** salariés en insertion, permanents et candidats, sans langage ubiquitaire distinct pour « personne accompagnée » vs « salarié classique » si c’est une distinction métier pour les utilisateurs.
+- **Union** en code = **fédération / instance nationale** de la plateforme, pas « syndicat » ni « union type ESS » au sens juridique — risque de **faux amis** avec les acteurs métier.
+- **SituationSortie** vit dans le namespace **Union** alors qu’elle modélise un **segment de parcours de sortie** lié au salarié — le **langage des packages** ne suit pas le **langage du parcours insertion**.
+- Duplication sémantique **Suivi** (Asp vs Suivi) et **TypeEmployee** / **salarié** dans les libellés affichés (`getName()` qui préfixe « Salarié(e) ») masque les cas limites ESS.
+
+### Recommandations
+
+- Tenir un **atelier glossaire** avec le métier en partant des écrans et des entités existantes, puis **tracer** : terme UI ↔ nom de classe ↔ table SQL.
+- Introduire des **alias métier** dans la doc produit et, à terme, des **value objects / read models** nommés comme le métier (ex. **TravailleurAccompagne**, **RéférentielSortieInsertion**) **sans tout renommer d’un coup** si le coût est trop élevé.
+- **Renommer ou préfixer** dans le langage technique ce qui prête à confusion (`AspSuivi` vs `SuiviSalarié`, `Federation` ou `InstancePlateforme` vs `Union` si pertinent).
+
+### Glossaire ESS proposé
+
+| Terme métier ESS | Terme trouvé dans le code | Statut |
+|---|---|---|
+| **Travailleur / personne accompagnée** (générique) | `Employee`, commentaires « employé » | Présent mais générique RH |
+| **Salarié en insertion (IAE / parcours)** | `TypeEmployee::EN_INSERTION`, `ParcoursInsertion` | Présent, cœur du modèle |
+| **Salarié permanent** | `TypeEmployee::PERMANANT`, `PERMANANT_SORTI` | Présent |
+| **Candidat / postulant** | `TypeEmployee::CANDIDAT`, état `Postulant` | Présent |
+| **Structure ESS (association, SCOP, etc.)** | `Structure`, `FormeJuridique` | Structure oui ; typologie juridique ESS limitée aux données référentielles |
+| **SIAE / dispositif insertion** | `SiaeType`, mesures ASP, fixtures EI/ACI/AI/ETTI | Fortement présent |
+| **Contrat de travail / conventionnement** | `Contrat`, `Conventionnement` (réf. union) | Présent (contrat + catalogue partenaire/conventionnement) |
+| **Financement / annexe** | `Financement`, `AnnexeFinanciere`, `ChiffreCle` | Présent côté structure |
+| **Sortie d’insertion / typologie** | `SituationSortie`, `TypeSituationSortie` | Présent ; **emplacement bundle incohérent** |
+| **Accompagnement socio-professionnel** | `Accompagnement`, `Action`, taxonomies `TypeAction` | Présent |
+| **Évaluation / compétences** | `Evaluation`, `Savoir`, grilles | Présent |
+| **Conditions sociales (RSA, AAH, RQTH…)** | `HiringStatus` | Présent sous nom anglais |
+| **Conformité ASP / déclarations** | `FicheContratAsp`, fichiers mensuels/annuels | Présent (intégration forte) |
+| **Bénévole / coopérateur / mutuelle salarié** | *(peu ou pas de modèle dédié repéré)* | **Absent ou non modélisé explicitement** |
+| **Agrément ESUS, dispositif CAE, etc.** | *(non saillant dans l’échantillon de code analysé)* | **À valider côté données** ; risque **sous-langage** |
+| **Convention collective métier (Éclat, Nexem…)** | *(non saillant)* | **Hors modèle explicite** dans l’exploration |
+
+---
+
+## 2. Contextes Bornés
+
+### Constat
+
+Les bundles `Employee`, `Suivi`, `Structure`, `Union`, `Asp`, plus `Bilan` / `Home` / `Import` / `Export` / `User` / `Helper`, matérialisent un **découpage technique Symfony** qui **recoupe** en partie des frontières métier.
+
+### Problèmes détectés
+
+- **Union** concentre à la fois des **référentiels fédérateurs** et des **données de parcours** (`SituationSortie`) et des **écrans d’admin** sur des entités **Suivi** et **Employee** — **fusion artificielle** de plusieurs problématiques.
+- **Employee** embarque des **collections Suivi** (relations Doctrine vers `Accompagnement`, `Evaluation`, etc.) — **couplage bidirectionnel** qui empêche de voir **Suivi** comme contexte autonome.
+- **ASP** lit/écrit le contexte contrat/personne au-delà d’une simple intégration — frontière **Conformité déclarative** vs **Vie du contrat** peu lisible dans le code.
+- **Bilan / Home** agrègent plusieurs contextes sans couche de **lecture dédiée** explicite (risque de **modèle transactionnel** utilisé comme **vue transverse**).
+
+### Recommandations
+
+- Valider par le métier un **découpage par capacités** : *Parcours & contrat*, *Suivi & évaluation*, *Structure & gouvernance*, *Référentiels fédération*, *Télédéclaration / ASP*, *Reporting*.
+- Déplacer progressivement les **CRUD** vers le **bundle propriétaire** du concept (cf. phases F/G du playbook dans `deep-dive-context-map.md`).
+- Introduire des **ports** (interfaces applicatives) aux frontières bundle avant tout big-bang de renommage.
+
+### Découpage proposé
+
+1. **Contexte « Travailleur & emploi »** — lifecycle, contrats, parcours insertion, états, documents administratifs.  
+2. **Contexte « Suivi & développement des compétences »** — actions, formations, évaluations, problématiques, habilitations, potentiel.  
+3. **Contexte « Structure & exploitation »** — profil structure, sites, secteurs, alertes, agenda, compétences structure, chiffres / annexes.  
+4. **Contexte « Référentiels fédération »** — union/plateforme, partenaires, catalogues publiés, **types de sortie** comme langage publié.  
+5. **Contexte « Déclarations & interopérabilité ASP »** — fiches, statuts, fichiers, erreurs, éligibilité.  
+6. **Contexte « Lecture / pilotage »** — bilan, tableaux de bord, exports.  
+7. **Contexte « Accès & sécurité »** — utilisateurs, rôles (plutôt générique).
+
+---
+
+## 3. Noyau Partagé
+
+### Constat
+
+Des concepts **transverses** existent déjà : identifiants entiers Doctrine, **Structure** comme tenant, **Town** / territoire, **Code ROME**, typologies **SIAE**, **TypeSituationSortie** avec codes ASP, liens **Contrat ↔ FicheContratAsp**.
+
+### Problèmes détectés
+
+- Le **graphe Doctrine partagé** (Employee ↔ Suivi ↔ Structure ↔ Union) fait office de **shared kernel implicite** **trop large** : toute évolution entraîne des effets en cascade.
+- Des règles **spécifiques ASP** ou **à une convention** risquent d’être **mélangées** à des invariants **génériques** (période de contrat, identité) si elles restent dans les mêmes entités/services.
+- **Duplications** possibles entre formatage, validations transverses et **référentiels** édités depuis plusieurs bundles (chemins Union vs Structure signalés dans la doc interne).
+
+### Recommandations
+
+- Définir un **Shared Kernel minimal et versionné** : surtout **identifiants stables**, **codes référentiels publiés**, et **valeurs communes** (ex. période calendaire, identité légère en lecture).
+- Isoler les **politiques** (éligibilité ASP, règles d’évaluation) dans des **services de contexte**, pas dans des entités « fourre-tout ».
+- Documenter ce qui est **contrat publié** (ex. codes de sortie consommés par ASP et reporting) vs **détail interne**.
+
+### Candidats au Shared Kernel
+
+| Candidat | Justification métier ESS |
+|---|---|
+| **Identifiants stables** (`EmployeeId`, `StructureId`, `ContractId`…) | Traçabilité multi-contextes, audits, financeurs, déclarations |
+| **Référentiel de typologie de sortie** (codes + libellés publiés) | Alignement **ASP**, **statistiques** et **parcours** |
+| **Référentiel territorial** (`Town`, département, région) | Adresses structures, personnes, partenaires |
+| **Typologie SIAE / mesure** (lecture) | Conditionne écrans, règles ASP et indicateurs |
+| **Code ROME** (référence ou service de validation partagé) | Contrat et déclarations cohérents |
+| **Période / intervalle de dates métier** (value object) | Contrats, sorties, durées d’aide, durées d’accompagnement |
+
+**À exclure du noyau partagé** (exemples) : règles **d’éligibilité ASP** détaillées, **workflow de validation d’évaluation**, **règles de grille** spécifiques à une fédération, logique **fusion de structures**.
+
+---
+
+## 4. Carte de Contextes
+
+### Constat
+
+Les dépendances réelles passent surtout par **Doctrine**, **contrôleurs** et **services Symfony** ; la direction « métier » (qui **impose** le langage à l’autre) n’est pas toujours **explicite** dans le code, mais on peut la **déduire**.
+
+### Problèmes détectés
+
+- **Couplage fort** Employee ↔ Suivi masque une relation **client–fournisseur** ou **ACL** souhaitable.
+- **ASP en aval** de Employee/Structure mais avec **mutations** possibles côté intégration — relation **conformiste / ACL** peu respectée en pratique.
+- **Union** **en amont** pour certains référentiels mais **en aval opérationnel** pour d’autres données — rôle **flou**.
+
+### Recommandations
+
+- Rendre explicites les **relations de contexte** (Open Host Service, Published Language, ACL, Anti-Corruption Layer) dans la doc et dans les **points d’extension** du code.
+- Prioriser la **dépendance unidirectionnelle** : Référentiels et Structure → Contrat/Parcours ; Suivi → identité Travailleur en **lecture** ; ASP → **snapshots** ou événements.
+
+### Context Map
+
+```
+                    +------------------+
+                    |  Référentiels    |
+                    |  Fédération      |
+                    |  (Union BC)      |
+                    +--------+---------+
+                             | Published Language (codes sortie, catalogues)
+              +--------------+--------------+
+              |                             |
+              v                             v
+     +----------------+            +------------------+
+     | Structure &    |            | Suivi &          |
+     | Exploitation   |            | Compétences      |
+     | (tenant)       |            | (actions,        |
+     +--------+-------+            |  évaluations)    |
+              |                    +--------+---------+
+              | scopes / refs               |
+              v                             |
+     +----------------+                     |
+     | Travailleur &  |<--------------------+
+     | Emploi         |  (Employee upstream
+     | (contrat,      |   for identity; Suivi
+     |  parcours)     |   should be downstream)
+     +--------+-------+
+              |
+              | contract snapshots / eligibility inputs
+              v
+     +----------------+
+     | ASP &          |
+     | Déclarations   |
+     +--------+-------+
+              |
+              v
+     +----------------+
+     | Lecture /      |
+     | Bilan / Export |
+     +----------------+
+
+Légende relationnelle (intention cible):
+  Fédération --[Published Language]--> Travailleur / ASP / Suivi
+  Structure --[Supplier]--> Travailleur, Suivi, ASP
+  Travailleur --[Supplier]--> Suivi (ACL côté Suivi recommandé)
+  ASP --[Downstream Conformist + ACL]--> Travailleur (pas de mutation directe idéale)
+  Bilan --[Separate Read Model]--> tous
+```
+
+---
+
+## 5. 🎯 Distillation du Domaine
+
+### Constat
+
+La **valeur différenciante** probable de la plateforme pour l’ESS cible (d’après le code et les deep dives) réside dans le **couplage métier insertion + SIAE + suivi + structure**, plutôt que dans l’auth ou les imports génériques.
+
+### Problèmes détectés
+
+- Une part importante de la **complexité** semble portée par **l’intégration ASP** et les **invariants contrat/sortie** — c’est cohérent avec le **cœur métier**, mais le **mélange avec la persistance** et les **autres bundles** peut **disperser** cette richesse.
+- Les **référentiels** et l’**admin trans-bundle** peuvent **absorber** de l’effort maintenance **sans** être la **différenciation** produit.
+- **User** / infrastructure web : nécessaires mais **ne doivent pas** dominer l’architecture si le produit vend du **parcours ESS**.
+
+### Recommandations
+
+- **Investir** explicitement (tests, modules, documentation métier) sur : **ParcoursInsertion**, **Contrat + sortie**, **règles ASP**, **HiringStatus**, **Suivi d’insertion** — là où se jouent **conformité** et **qualité d’accompagnement**.
+- **Réduire le coût** sur le **générique** (auth standard, utilitaires) via bibliothèques ou modules minces.
+- Mesurer où se concentrent les **bugs et évolutions réglementaires** ; aligner la **structure des équipes** et des **bounded contexts** sur ces zones.
+
+### Classification des domaines
+
+| Contexte | Catégorie | Justification |
+|---|---|---|
+| **Travailleur, contrat, parcours insertion, sortie** | **Core Domain** | Cœur de la promesse « accompagner le parcours » + états métier |
+| **Règles & cycles ASP (déclarations, éligibilité)** | **Core Domain** (ou **Core** fortement lié) | Spécificité réglementaire et opérationnelle IAE/SIAE |
+| **Suivi (actions, évaluations, formations, problématiques)** | **Supporting Domain** | Très important pour l’usage terrain mais peut être structuré comme soutien au parcours |
+| **Structure (profil, sites, alertes, chiffres, annexes)** | **Supporting Domain** | Indispensable, mais beaucoup de structures pourraient être partagées avec d’autres outils administratifs |
+| **Référentiels fédération** | **Supporting Domain** (avec **Published Language**) | Stabilité et gouvernance ; valeur par la **cohérence** plus que par l’algorithme |
+| **Bilan, Home, exports agrégés** | **Supporting Domain** (voire **Generic** si simple) | Lecture / reporting ; souvent candidat **read model** |
+| **Import / Export techniques** | **Generic Subdomain** | Pipelines ETL classiques |
+| **User, auth, helpers transverses** | **Generic Domain** | Standard industrie |
+
+---
+
+## 🏁 Synthèse Globale
+
+### Score de maturité DDD
+
+| Dimension | Score (1-5) | Commentaire |
+|---|---|---|
+| **Ubiquitous Language** | **2** | Richesse métier insertion/SIAE visible, mais mélange FR/EN, homonymies, et écarts avec vocabulaire ESS élargi |
+| **Bounded Contexts** | **2** | Bundles = indices utiles ; frontières réelles brouillées (Union, graphe Employee–Suivi) |
+| **Context Map explicite** | **3** | Bonne base dans `deep-dive-context-map.md` ; pas encore reflétée par des séams techniques partout |
+| **Shared Kernel discipline** | **2** | Noyau implicite trop large via ORM ; candidats légitimes identifiables |
+| **Distillation (priorisation Core)** | **2** | Le Core est **dans** le code mais **noyé** dans la technique ; risque de sous-investissement sur read models et ACL |
+
+### ⚡ 3 actions prioritaires
+
+> 1. **Trancher et documenter** le glossaire **ESS** (travailleur, insertion, structure, sortie, déclaration) et **corriger** les **faux amis** (`Union`, double sens de `Suivi`).  
+> 2. **Clarifier la propriété** de **`SituationSortie`** et des **écrans référentiels** (déplacer vers Employee/Suivi ou APIs dédiées) pour **aligner bundles et contextes métier**.  
+> 3. **Isoler ASP et Suivi** derrière des **ports + anti-corruption** (IDs stables, snapshots, événements), pour **réduire le noyau partagé implicite** et sécuriser les évolutions **réglementaires**.
+
--- a/docs/deep-dive-asp-domain.md
+++ b/docs/deep-dive-asp-domain.md
@@ -0,0 +1,181 @@
+# ASP Bundle Deep Dive
+
+## Ubiquitous Language
+
+- **FicheContratAsp**: ASP-facing contract dossier with ASP IDs, statuses, and errors.  
+  Path: `src/Uriae/AspBundle/Entity/FicheContratAsp.php`
+- **TypeContratAsp**: ASP contract typology (`NPT`, `I`, `R1..R99`) and renewal semantics.  
+  Path: `src/Uriae/AspBundle/Entity/TypeContratAsp.php`
+- **Suivi**: trace line for ASP file exchanges.  
+  Path: `src/Uriae/AspBundle/Entity/Suivi.php`
+- **ModificationAsp**: ASP modification request with dedicated lifecycle.  
+  Path: `src/Uriae/AspBundle/Entity/ModificationAsp.php`
+- **FichierEnvoiAsp / FichierRetourAsp**: outbound/inbound ASP files.  
+  Paths: `src/Uriae/AspBundle/Entity/AbstractFichierAsp.php`, `src/Uriae/AspBundle/Entity/FichierRetourAsp.php`
+- **SuiviMensuelEtSortieAsp**: monthly batch submission root.  
+  Path: `src/Uriae/AspBundle/Entity/SuiviMensuelEtSortieAsp.php`
+- **FicheSuiviMensuelEtSortieAsp**: monthly line per contract.  
+  Path: `src/Uriae/AspBundle/Entity/FicheSuiviMensuelEtSortieAsp.php`
+- **SortieEtSuiviAnnuel / FicheSortieEtSuiviAnnuel**: annual exit/follow-up model.  
+  Paths: `src/Uriae/AspBundle/Entity/SortieEtSuiviAnnuel.php`, `src/Uriae/AspBundle/Entity/FicheSortieEtSuiviAnnuel.php`
+- **Erreur**: unified internal/return error catalog by ASP domain type.  
+  Path: `src/Uriae/AspBundle/Entity/Erreur.php`
+
+## Domain Core
+
+- **De facto root: `FicheContratAsp`**
+  - Carries ASP IDs, multi-channel statuses (inscription/sortie/renewal), ASP and internal errors.
+  - Hard-linked to `Contrat` (Employee context).
+  - Paths:
+    - `src/Uriae/AspBundle/Entity/FicheContratAsp.php`
+    - `src/Uriae/EmployeeBundle/Entity/Contrat.php`
+
+- **Monthly submission cluster**
+  - Root: `SuiviMensuelEtSortieAsp`
+  - Child lines: `FicheSuiviMensuelEtSortieAsp`
+  - Paths:
+    - `src/Uriae/AspBundle/Entity/SuiviMensuelEtSortieAsp.php`
+    - `src/Uriae/AspBundle/Entity/FicheSuiviMensuelEtSortieAsp.php`
+
+- **Annual submission cluster**
+  - Root: `SortieEtSuiviAnnuel`
+  - Child lines: `FicheSortieEtSuiviAnnuel`
+  - Paths:
+    - `src/Uriae/AspBundle/Entity/SortieEtSuiviAnnuel.php`
+    - `src/Uriae/AspBundle/Entity/FicheSortieEtSuiviAnnuel.php`
+
+- **Status behavior**
+  - Generic status set in `StatusTrait`.
+  - Modification flow has separate status constants.
+  - Paths:
+    - `src/Uriae/AspBundle/Traits/StatusTrait.php`
+    - `src/Uriae/AspBundle/Entity/ModificationAsp.php`
+
+## Invariants / Concistency
+
+- `src/Uriae/AspBundle/Traits/StatusTrait.php`
+  - Status is constrained to allowed values.
+
+- `src/Uriae/AspBundle/Entity/FicheContratAsp.php`
+  - Clearing both ASP IDs resets auto flags/dates and reverts transfer status branch.
+  - Setting both ASP IDs manually marks manual provenance and transmitted status.
+
+- `src/Uriae/AspBundle/Entity/TypeContratAsp.php`
+  - Contract type codes constrained to `NPT`, `I`, `R1..R99`.
+  - Renewal semantics inferred from label set.
+
+- `src/Uriae/AspBundle/Repository/FicheContratAspRepository.php`
+  - Inscription/renewal/sortie/modification candidate filtering encoded via cross-context query rules.
+  - Monthly candidate contracts depend on period overlap + ASP IDs presence.
+
+- `src/Uriae/AspBundle/Validator/ErreursInternesValidator.php`
+  - EI duration <= 24 months.
+  - Work hours/salary/annexe prerequisites.
+  - Renewal sequence integrity and ASP ID prerequisites.
+  - Aid/resource/PE/agrement consistency mapped to error catalog entries.
+
+- `src/Uriae/AspBundle/Model/FichierRetourAsp/ProcessFichierRetourAsp.php`
+  - Return-line length depends on SIAE type.
+
+- `src/Uriae/AspBundle/Model/FichierRetourAsp/ProcessFichierRetourAspSuivieMensuelEtSortie.php`
+  - Monthly return line must have expected structure and success code handling.
+
+- `src/Uriae/AspBundle/Model/FichierRetourAsp/ProcessFichierRetourAspSortieEtSuiviAnnuel.php`
+  - Annual return parsing enforces line count format and matching sent file expectations.
+  
+## Cross-context Dependencies
+
+- **ASP -> Employee**
+  - `FicheContratAsp` linked to `Contrat`.
+  - ASP processing mutates employee-related fields.
+  - Paths:
+    - `src/Uriae/AspBundle/Entity/FicheContratAsp.php`
+    - `src/Uriae/EmployeeBundle/Entity/Contrat.php`
+    - `src/Uriae/AspBundle/Manager/AspFicheContratManager.php`
+
+- **ASP -> Structure**
+  - Depends on structure metadata (`SiaeType`, `AnnexeFinanciere`, measures, ASP IDs).
+  - Paths:
+    - `src/Uriae/StructureBundle/Entity/Structure.php`
+    - `src/Uriae/StructureBundle/Entity/SiaeType.php`
+    - `src/Uriae/StructureBundle/Entity/AnnexeFinanciere.php`
+
+- **ASP -> Union**
+  - Uses sortie/typology references for mappings and checks.
+  - Paths:
+    - `src/Uriae/UnionBundle/Entity/SituationSortie.php`
+    - `src/Uriae/UnionBundle/Entity/TypeSituationSortie.php`
+
+- **ASP -> Suivi (indirect reporting coupling)**
+  - Aggregated reporting joins via broader employee/bilan query paths.
+  - Paths:
+    - `src/Uriae/EmployeeBundle/Repository/EmployeeRepository.php`
+    - `src/Uriae/BilanBundle/Model/Formatter.php`
+
+## DDD Slicing
+
+- **Aggregates (candidate)**
+  - `AspContractDossier` (replacement concept for `FicheContratAsp`).
+  - `AspModificationRequest`.
+  - `AspMonthlySubmission` + `MonthlySubmissionLine`.
+  - `AspAnnualExitSubmission` + `AnnualExitSubmissionLine`.
+
+- **Domain services (candidate)**
+  - `AspEligibilityPolicy`.
+  - `AspInternalErrorPolicy`.
+  - `AspReturnFileParser` (pure parsing).
+  - `AspSubmissionDomainService` (state transitions and domain decisions).
+
+- **Repository interfaces (domain-facing)**
+  - `AspContractDossierRepository`.
+  - `AspMonthlySubmissionRepository`.
+  - `AspAnnualExitSubmissionRepository`.
+  - `AspErrorCatalogRepository`.
+
+- **Domain events (candidate)**
+  - `AspSubmissionRequested`.
+  - `AspSubmissionAccepted`.
+  - `AspSubmissionRejected`.
+  - `AspIdsAssignedToContract`.
+  - `AspInternalRuleViolationDetected`.
+  - `AspMonthlyLineAccepted`.
+  - `AspMonthlyLineRejected`.
+
+- **Value objects (candidate)**
+  - `AspEmployeeId`, `AspContractId`.
+  - `TransmissionStatus`.
+  - `AspErrorCode`.
+  - `SubmissionPeriod`.
+  - `AnnexeNumber`.
+  - `MesureCode`.
+  - `AspLineNumber`.
+
+## Reading Order
+
+1. `src/Uriae/AspBundle/Entity/FicheContratAsp.php`  
+2. `src/Uriae/AspBundle/Traits/StatusTrait.php`  
+3. `src/Uriae/AspBundle/Entity/TypeContratAsp.php`  
+4. `src/Uriae/AspBundle/Repository/FicheContratAspRepository.php`  
+5. `src/Uriae/AspBundle/Validator/ErreursInternesValidator.php`  
+6. `src/Uriae/AspBundle/Manager/AbstractAspManager.php`  
+7. `src/Uriae/AspBundle/Manager/AspFicheContratManager.php`  
+8. `src/Uriae/AspBundle/Model/FichierRetourAsp/ProcessFichierRetourAsp.php`  
+9. `src/Uriae/AspBundle/Model/FichierRetourAsp/ProcessFichierRetourAspRenouvellement.php`  
+10. `src/Uriae/AspBundle/Model/FichierRetourAsp/ProcessFichierRetourAspModification.php`  
+11. `src/Uriae/AspBundle/Controller/AbstractInscriptionRenouvellementSortieController.php`  
+12. `src/Uriae/AspBundle/Controller/InscriptionController.php`  
+13. `src/Uriae/AspBundle/Controller/RenouvellementController.php`  
+14. `src/Uriae/AspBundle/Controller/ModificationController.php`  
+15. `src/Uriae/AspBundle/Entity/SuiviMensuelEtSortieAsp.php`  
+16. `src/Uriae/AspBundle/Entity/FicheSuiviMensuelEtSortieAsp.php`  
+17. `src/Uriae/AspBundle/Manager/SuiviMensuelManager.php`  
+18. `src/Uriae/AspBundle/Model/FichierRetourAsp/ProcessFichierRetourAspSuivieMensuelEtSortie.php`  
+19. `src/Uriae/AspBundle/Entity/SortieEtSuiviAnnuel.php`  
+20. `src/Uriae/AspBundle/Entity/FicheSortieEtSuiviAnnuel.php`  
+21. `src/Uriae/AspBundle/Model/SortieEtSuiviAnnuelManager.php`  
+22. `src/Uriae/AspBundle/Model/FichierRetourAsp/ProcessFichierRetourAspSortieEtSuiviAnnuel.php`  
+23. `src/Uriae/EmployeeBundle/Entity/Contrat.php`  
+24. `src/Uriae/EmployeeBundle/Controller/ContratsController.php`  
+25. `src/Uriae/EmployeeBundle/Form/Type/ContratType.php`  
+26. `src/Uriae/StructureBundle/Entity/SiaeType.php`  
+27. `src/Uriae/UnionBundle/Entity/TypeSituationSortie.php`
--- a/docs/deep-dive-employee-domain.md
+++ b/docs/deep-dive-employee-domain.md
@@ -2,6 +2,203 @@

 ## Ubiquitous Language

+- **Employee / Salarie / Employe**: central person lifecycle record.  
+  Path: `src/Uriae/EmployeeBundle/Entity/Employee.php`
+- **TypeEmployee**: profile category driving workflows/filters.  
+  Paths: `src/Uriae/EmployeeBundle/Entity/Employee.php`, `src/Uriae/EmployeeBundle/Repository/EmployeeRepository.php`
+- **Employee state** (`Postulant`, `En contrat`, `Sorti`): lifecycle projection from contracts/sortie.  
+  Paths: `src/Uriae/EmployeeBundle/Entity/Employee.php`, `src/Uriae/EmployeeBundle/Model/EmployeeStateUpdater.php`
+- **Contrat**: contract period + métier + site + ASP bridge.  
+  Path: `src/Uriae/EmployeeBundle/Entity/Contrat.php`
+- **ParcoursInsertion**: insertion timeline + sortie segments.  
+  Path: `src/Uriae/EmployeeBundle/Entity/ParcoursInsertion.php`
+- **SituationSortie**: exit segment with dates/type.  
+  Path: `src/Uriae/UnionBundle/Entity/SituationSortie.php`
+- **FirstHome**: intake/prescriber/resource/mutuelle context.  
+  Path: `src/Uriae/EmployeeBundle/Entity/FirstHome.php`
+- **AdministrativeInformation**: civil/admin identity block (NIR/NTT, nationality, birth info).  
+  Path: `src/Uriae/EmployeeBundle/Entity/AdministrativeInformation.php`
+- **PersonnalDetail**: address/contact block.  
+  Path: `src/Uriae/EmployeeBundle/Entity/PersonnalDetail.php`
+- **HiringStatus**: eligibility and social condition matrix (RSA, AAH, RQTH, etc.).  
+  Path: `src/Uriae/EmployeeBundle/Entity/HiringStatus.php`
+
+
 ## Domain Core

+- **De facto root: `Employee`**
+  - Owns/coordinates personal, admin, intake, insertion, contracts, jobs, medical visits, receipts, competencies.
+  - Path: `src/Uriae/EmployeeBundle/Entity/Employee.php`
+
+- **Contract lifecycle cluster**
+  - `Contrat` + ASP contract dossier + sortie semantics.
+  - Paths:
+    - `src/Uriae/EmployeeBundle/Entity/Contrat.php`
+    - `src/Uriae/AspBundle/Entity/FicheContratAsp.php`
+    - `src/Uriae/UnionBundle/Entity/SituationSortie.php`
+
+- **Insertion timeline cluster**
+  - `ParcoursInsertion` with associated sortie segments.
+  - Path: `src/Uriae/EmployeeBundle/Entity/ParcoursInsertion.php`
+
+- **Profile/intake clusters**
+  - `PersonnalDetail`, `AdministrativeInformation`, `HiringStatus`, `FirstHome`.
+  - Paths:
+    - `src/Uriae/EmployeeBundle/Entity/PersonnalDetail.php`
+    - `src/Uriae/EmployeeBundle/Entity/AdministrativeInformation.php`
+    - `src/Uriae/EmployeeBundle/Entity/HiringStatus.php`
+    - `src/Uriae/EmployeeBundle/Entity/FirstHome.php`
+
 ## Invariants / Concistency
+
+- `src/Uriae/EmployeeBundle/Entity/Employee.php`
+  - State constrained to known values.
+  - `civility` drives derived sex.
+  - Sortie considered complete only when both date + type are present.
+  - Contract timeline helpers (first/last/previous/initial logic).
+
+- `src/Uriae/EmployeeBundle/Model/EmployeeStateUpdater.php`
+  - Recomputes state from contracts/sortie chronology.
+
+- `src/Uriae/EmployeeBundle/Entity/Contrat.php`
+  - Contract date ordering constraints.
+  - ROME validity constraints.
+  - ASP-specific duration-in-months rounding behavior.
+
+- `src/Uriae/EmployeeBundle/Form/Validator/DateEffectiveContratValidator.php`
+  - Prevents new/update contract when previous relevant contract has no effective end date.
+
+- `src/Uriae/EmployeeBundle/Form/Validator/CodeRomeValidator.php`
+  - Rejects expired ROME codes at contract start.
+  - Adds date-threshold behavior around 2022 policy.
+
+- `src/Uriae/EmployeeBundle/Entity/ParcoursInsertion.php`
+  - Agreement number format constraints.
+  - First/last sortie determination rules by entry dates.
+
+- `src/Uriae/UnionBundle/Entity/SituationSortie.php`
+  - Sortie type/date consistency (both required together).
+
+- `src/Uriae/EmployeeBundle/Model/SituationSortieUpdater.php`
+  - Rebuilds contract-sortie mapping.
+  - Removes empty sorties.
+  - Creates sortie for orphan contracts.
+  - Triggers state refresh.
+
+- `src/Uriae/EmployeeBundle/Entity/AdministrativeInformation.php`
+  - Birth date required and validated.
+  - NIR/NTT consistency via validators.
+
+- `src/Uriae/EmployeeBundle/Form/Validator/SocialSecurityNumberValidator.php`
+  - NIR shape + civility constraints.
+  - NTT fallback requirement when NIR absent in specific cases.
+
+- `src/Uriae/EmployeeBundle/Form/Validator/TemporaryTechnicalNumberValidator.php`
+  - NIR/NTT mutual exclusivity.
+
+- `src/Uriae/EmployeeBundle/Entity/HiringStatus.php`
+  - Coherence between social flags (RSA/ayant-droit, sans-ressources, AAH-handicap linkage).
+  - Young-in-difficulty age window logic based on DOB + first contract.
+
+- `src/Uriae/EmployeeBundle/Entity/PersonnalDetail.php`
+  - At least one phone required.
+  - Phone/address/town/zip consistency checks.
+
+- `src/Uriae/EmployeeBundle/Entity/FirstHome.php`
+  - PE inscription-dependent fields required conditionally.
+  - PE identifier formatting.
+  - Conventionneur-only partner constraint.
+  
+## Cross-context Dependencies
+
+- **Employee -> Suivi**
+  - Paths:
+    - `src/Uriae/EmployeeBundle/Entity/Employee.php`
+    - `src/Uriae/SuiviBundle/Entity/Accompagnement.php`
+    - `src/Uriae/SuiviBundle/Entity/Evaluation.php`
+    - `src/Uriae/SuiviBundle/Entity/Problematique.php`
+    - `src/Uriae/SuiviBundle/Entity/Potentiel.php`
+  - DDD direction idea: Suivi consumes Employee identity/reference, not full object graph.
+
+- **Employee -> ASP**
+  - Paths:
+    - `src/Uriae/EmployeeBundle/Entity/Contrat.php`
+    - `src/Uriae/AspBundle/Entity/FicheContratAsp.php`
+    - `src/Uriae/AspBundle/Manager/AspFicheContratManager.php`
+  - DDD direction idea: ASP as downstream integration context reacting to contract events.
+
+- **Employee -> Union**
+  - Paths:
+    - `src/Uriae/EmployeeBundle/Entity/ParcoursInsertion.php`
+    - `src/Uriae/UnionBundle/Entity/SituationSortie.php`
+  - DDD direction idea: shared kernel or ACL around sortie taxonomy.
+
+- **Employee <-> Structure**
+  - Paths:
+    - `src/Uriae/EmployeeBundle/Entity/Employee.php`
+    - `src/Uriae/StructureBundle/Entity/Structure.php`
+  - DDD direction idea: explicit IDs/reference objects instead of deep bidirectional graph.
+
+
+## DDD Slicing
+- **Aggregates (candidate)**
+  - `EmployeeProfile` (identity + personal/admin + hiring status).
+  - `EmploymentLifecycle` (contracts + state projection + timeline fields).
+  - `InsertionJourney` (parcours + sortie segments).
+  - `IntakeContext` (first home/resources/mutuelle data).
+  - `EmployeeCompetency` (employee-competence assignment).
+
+- **Domain services (candidate)**
+  - `EmployeeStatePolicy` (from `EmployeeStateUpdater`).
+  - `SituationSortieRebuilder` (from `SituationSortieUpdater`).
+  - `ContractTimelineCalculator` (first/last contract rules).
+  - `HiringStatusPolicy` (coherence rules currently scattered in entity callbacks/validators).
+
+- **Repository interfaces (domain-facing)**
+  - `EmployeeRepository` (aggregate retrieval only).
+  - `ContractRepository` (active/last/chronology views).
+  - `InsertionJourneyRepository`.
+  - Separate read-model queries for reporting/export/bilan.
+
+- **Domain events (candidate)**
+  - `ContractAdded`, `ContractUpdated`, `ContractRemoved`.
+  - `EmployeeStateChanged`.
+  - `SituationSortieRecomputed`.
+  - `AspSubmissionAcknowledged` (integration side).
+
+- **Value objects (candidate)**
+  - `EmployeeState`, `EmployeeTypeSlug`.
+  - `ContractPeriod`.
+  - `SocialSecurityNumber`, `TemporaryTechnicalNumber`.
+  - `AgreementNumber`, `PoleEmploiId`.
+  - `PhoneNumber`, `PostalAddress`, `ZipCode`.
+
+`src/Uriae/EmployeeBundle/Entity/Employee.php`
+
+## Reading Order (Employee domain deep dive)
+
+1. `src/Uriae/EmployeeBundle/Entity/Employee.php`  
+2. `src/Uriae/EmployeeBundle/Entity/Contrat.php`  
+3. `src/Uriae/EmployeeBundle/Entity/ParcoursInsertion.php`  
+4. `src/Uriae/UnionBundle/Entity/SituationSortie.php`  
+5. `src/Uriae/EmployeeBundle/Model/SituationSortieUpdater.php`  
+6. `src/Uriae/EmployeeBundle/Model/EmployeeStateUpdater.php`  
+7. `src/Uriae/EmployeeBundle/EventSubscriber/ContratChangeSubscriber.php`  
+8. `src/Uriae/EmployeeBundle/Entity/AdministrativeInformation.php`  
+9. `src/Uriae/EmployeeBundle/Entity/HiringStatus.php`  
+10. `src/Uriae/EmployeeBundle/Entity/PersonnalDetail.php`  
+11. `src/Uriae/EmployeeBundle/Entity/FirstHome.php`  
+12. `src/Uriae/EmployeeBundle/Entity/Pmsmp.php`  
+13. `src/Uriae/EmployeeBundle/Form/Validator/DateEffectiveContratValidator.php`  
+14. `src/Uriae/EmployeeBundle/Form/Validator/CodeRomeValidator.php`  
+15. `src/Uriae/EmployeeBundle/Form/Validator/SocialSecurityNumberValidator.php`  
+16. `src/Uriae/EmployeeBundle/Form/Validator/TemporaryTechnicalNumberValidator.php`  
+17. `src/Uriae/EmployeeBundle/Repository/EmployeeRepository.php`  
+18. `src/Uriae/EmployeeBundle/Repository/ContratRepository.php`  
+19. `src/Uriae/EmployeeBundle/Controller/ContratsController.php`  
+20. `src/Uriae/EmployeeBundle/Controller/InsertionController.php`  
+21. `src/Uriae/AspBundle/Entity/FicheContratAsp.php`  
+22. `src/Uriae/AspBundle/Manager/AspFicheContratManager.php`  
+23. `src/Uriae/SuiviBundle/Entity/Accompagnement.php`  
+24. `src/Uriae/SuiviBundle/Entity/Evaluation.php`  
+25. `src/Uriae/StructureBundle/Entity/Structure.php`
--- a/docs/deep-dive-in-code.md
+++ b/docs/deep-dive-in-code.md
@@ -4,23 +4,24 @@

 ### Core Domain

- `src/Uriae/EmployeeBundle` : core employee lifecycle (identity, admin info, contracts, insertion path, documents, competencies)
- - `src/Uriae/SuiviBundle`:
- - `src/Uriae/AspBundle`: 
- - `src/Uriae/StructureBundle`: 
- - `src/Uriae/UnionBundle`: 
+- `src/Uriae/EmployeeBundle` : core employee lifecycle
+ - `src/Uriae/SuiviBundle`: follow-up domain
+ - `src/Uriae/AspBundle`: ASP integration boundary
+ - `src/Uriae/StructureBundle`: tenant/organization scope
+ - `src/Uriae/UnionBundle`: shared referentials

 ### Metrics Domain
- - `src/Uriae/BilanBundle`: 
+ - `src/Uriae/BilanBundle`: cross-context reporting/metrics aggregation

 ### Pipeline Domain
- - `src/Uriae/ImportBundle`: 
- - `src/Uriae/ExportBundle`: 
+ - `src/Uriae/ImportBundle`: batch ingestion pipelines
+ - `src/Uriae/ExportBundle`: batch extraction pipelines


 ## InDepth maps

 ### EmployeeBundle
+
 - **Core entities**
  - `src/Uriae/EmployeeBundle/Entity/Employee.php`
  - `src/Uriae/EmployeeBundle/Entity/Contrat.php`
@@ -46,3 +47,170 @@
  - `src/Uriae/EmployeeBundle/Command/UpdateSituationSortieCommand.php`
  - `src/Uriae/EmployeeBundle/Command/UpdateContratDatesEmployeCommand.php`
  - `src/Uriae/EmployeeBundle/Command/AnonymisationProcessCommand.php`
+  
+### SuiviBundle
+
+- **Core entities**
+  - `src/Uriae/SuiviBundle/Entity/Action.php` (abstract parent).
+  - `src/Uriae/SuiviBundle/Entity/Accompagnement.php`.
+  - `src/Uriae/SuiviBundle/Entity/Evaluation.php`.
+  - `src/Uriae/SuiviBundle/Entity/Event.php`.
+  - `src/Uriae/SuiviBundle/Entity/Rdv.php`.
+  - `src/Uriae/SuiviBundle/Entity/Problematique.php`.
+  - `src/Uriae/SuiviBundle/Entity/FormationInterne.php`.
+  - `src/Uriae/SuiviBundle/Entity/ParticipationFormation.php`.
+- **Repositories**
+  - `src/Uriae/SuiviBundle/Repository/AccompagnementRepository.php`.
+  - `src/Uriae/SuiviBundle/Repository/EvaluationRepository.php`.
+- **Forms**
+  - `src/Uriae/SuiviBundle/Form/Type/AccompagnementType.php`.
+  - `src/Uriae/SuiviBundle/Form/Type/EvaluationType.php`.
+  - `src/Uriae/SuiviBundle/Form/Type/RdvType.php`.
+  - `src/Uriae/SuiviBundle/Form/Type/ProblematiqueType.php`.
+- **Controllers**
+  - `src/Uriae/SuiviBundle/Controller/SuiviController.php`.
+  - `src/Uriae/SuiviBundle/Controller/AccompagnementController.php`.
+  - `src/Uriae/SuiviBundle/Controller/BilanIndividuelController.php`.
+- **Services/Models**
+  - `src/Uriae/SuiviBundle/Model/FormatterBilanIndividuel.php`.
+- **Fixtures**
+  - `src/Uriae/SuiviBundle/DataFixtures/ORM/shared/LoadTypeAction.php`.
+  - `src/Uriae/SuiviBundle/DataFixtures/ORM/shared/LoadReferentielEvaluation.php`.
+- **Commands**
+  - `src/Uriae/SuiviBundle/Command/MigrateActionCommand.php`.
+  - `src/Uriae/SuiviBundle/Command/DesactivateHabilitationsCommand.php`.
+
+### AspBundle
+
+- **Core entities**
+  - `src/Uriae/AspBundle/Entity/FicheContratAsp.php`.
+  - `src/Uriae/AspBundle/Entity/ModificationAsp.php`.
+  - `src/Uriae/AspBundle/Entity/Suivi.php`.
+  - `src/Uriae/AspBundle/Entity/FichierEnvoiAsp.php`.
+  - `src/Uriae/AspBundle/Entity/FichierRetourAsp.php`.
+- **Repositories**
+  - `src/Uriae/AspBundle/Repository/FicheContratAspRepository.php`.
+- **Forms**
+  - `src/Uriae/AspBundle/Form/Type/FicheContratAspType.php`.
+  - `src/Uriae/AspBundle/Form/Type/FichierRetourAspType.php`.
+- **Controllers**
+  - `src/Uriae/AspBundle/Controller/InscriptionController.php`.
+  - `src/Uriae/AspBundle/Controller/ModificationController.php`.
+  - `src/Uriae/AspBundle/Controller/SuiviMensuelEtSortieController.php`.
+- **Managers**
+  - `src/Uriae/AspBundle/Manager/AspFicheContratManager.php`.
+  - `src/Uriae/AspBundle/Manager/InscriptionManager.php`.
+  - `src/Uriae/AspBundle/Manager/ModificationManager.php`.
+  - `src/Uriae/AspBundle/Manager/RenouvellementManager.php`.
+- **Fixtures**
+  - `src/Uriae/AspBundle/DataFixtures/ORM/shared/LoadTypeContratAsp.php`.
+  - `src/Uriae/AspBundle/DataFixtures/ORM/shared/LoadNatureEmploi.php`.
+- **Commands**
+  - `src/Uriae/AspBundle/Command/UpdateAspFileCommand.php`.
+  - `src/Uriae/AspBundle/Command/MigrateRenouvellementCommand.php`.
+
+### StructureBundle
+
+- **Core entities**
+  - `src/Uriae/StructureBundle/Entity/Structure.php`.
+  - `src/Uriae/StructureBundle/Entity/SiteTravail.php`.
+  - `src/Uriae/StructureBundle/Entity/Alerte.php`.
+  - `src/Uriae/StructureBundle/Entity/Competence.php`.
+  - `src/Uriae/StructureBundle/Entity/HeadOffice.php`.
+- **Repositories**
+  - `src/Uriae/StructureBundle/Repository/StructureRepository.php`.
+  - `src/Uriae/StructureBundle/Repository/CompetenceRepository.php`.
+- **Forms**
+  - `src/Uriae/StructureBundle/Form/Type/AddStructureFormType.php`.
+  - `src/Uriae/StructureBundle/Form/Type/InformationStructureType.php`.
+  - `src/Uriae/StructureBundle/Form/Type/AlerteType.php`.
+- **Controllers**
+  - `src/Uriae/StructureBundle/Controller/StructureController.php`.
+- **Services/Models**
+  - `src/Uriae/StructureBundle/Model/EvaluationUpdater.php`.
+  - `src/Uriae/StructureBundle/Model/DiaryHandler.php`.
+- **Fixtures**
+  - `src/Uriae/StructureBundle/DataFixtures/ORM/shared/LoadTownDepartementRegion.php`.
+  - `src/Uriae/StructureBundle/DataFixtures/ORM/shared/LoadTypeSiae.php`.
+  - `src/Uriae/StructureBundle/DataFixtures/ORM/shared/LoadFormeJuridique.php`.
+- **Commands**
+  - `src/Uriae/StructureBundle/Command/UpdateStructureEvaluationsCommand.php`.
+  - `src/Uriae/StructureBundle/Command/AddAlerteCommand.php`.
+  - `src/Uriae/StructureBundle/Command/SendDiaryMailerCommand.php`.
+
+### UnionBundle
+
+- **Core entities**
+  - `src/Uriae/UnionBundle/Entity/Partenaire.php`.
+  - `src/Uriae/UnionBundle/Entity/SituationSortie.php`.
+  - `src/Uriae/UnionBundle/Entity/TypeSituationSortie.php`.
+  - `src/Uriae/UnionBundle/Entity/Conventionnement.php`.
+  - `src/Uriae/UnionBundle/Entity/Union.php`.
+- **Repositories**
+  - `src/Uriae/UnionBundle/Repository/PartenaireRepository.php`.
+  - `src/Uriae/UnionBundle/Repository/SituationSortieRepository.php`.
+- **Forms**
+  - `src/Uriae/UnionBundle/Form/Type/PartenaireType.php`.
+  - `src/Uriae/UnionBundle/Form/Type/SituationSortieType.php`.
+  - `src/Uriae/UnionBundle/Form/Type/ConventionnementType.php`.
+- **Controllers**
+  - `src/Uriae/UnionBundle/Controller/ReferentielInsertionController.php`.
+  - `src/Uriae/UnionBundle/Controller/SituationsSalariesController.php`.
+- **Fixtures**
+  - `src/Uriae/UnionBundle/DataFixtures/ORM/shared/LoadTypeSituationsSortie.php`.
+  - `src/Uriae/UnionBundle/DataFixtures/ORM/shared/LoadTypePartenaire.php`.
+  - `src/Uriae/UnionBundle/DataFixtures/ORM/shared/LoadConventionnement.php`.
+
+### Others Bundles
+
+- **Bilan**
+  - `src/Uriae/BilanBundle/Controller/BilanController.php`.
+  - `src/Uriae/BilanBundle/Model/Formatter.php`.
+  - `src/Uriae/BilanBundle/Form/Model/Filter.php`.
+  - `src/Uriae/BilanBundle/Form/Model/FilterUnion.php`.
+  - `src/Uriae/BilanBundle/Form/Model/FilterFactory.php`.
+- **Import**
+  - `src/Uriae/ImportBundle/Controller/ImportController.php`.
+  - `src/Uriae/ImportBundle/Model/Import/ImportFactory.php`.
+  - `src/Uriae/ImportBundle/Model/Import/AbstractImport.php`.
+  - `src/Uriae/ImportBundle/Model/Import/ImportSalarie.php`.
+  - `src/Uriae/ImportBundle/Model/Import/ImportContrat.php`.
+  - `src/Uriae/ImportBundle/Model/Import/ImportParcours.php`.
+  - `src/Uriae/ImportBundle/Model/Import/ImportExportAsp.php`.
+- **Export**
+  - `src/Uriae/ExportBundle/Controller/ExportController.php`.
+  - `src/Uriae/ExportBundle/Model/Export/AbstractExport.php`.
+  - `src/Uriae/ExportBundle/Model/Export/ExportFactory.php`.
+  - `src/Uriae/ExportBundle/Model/Export/ExportSalarie.php`.
+  - `src/Uriae/ExportBundle/Model/Export/ExportContrat.php`.
+  - `src/Uriae/ExportBundle/Model/Export/ExportParcours.php`.
+  - `src/Uriae/ExportBundle/Model/Export/ExportSuivi.php`.
+
+  
+## Cross-context Dependencies
+
+- **Employee <-> Suivi**
+  - `src/Uriae/EmployeeBundle/Entity/Employee.php` references many Suivi entities.
+  - `src/Uriae/SuiviBundle/Controller/*` pivot around `Employee`.
+  - `src/Uriae/SuiviBundle/Form/Type/AccompagnementType.php` mixes Employee + Partenaire + Structure data.
+
+- **Employee <-> ASP**
+  - `src/Uriae/EmployeeBundle/Entity/Contrat.php` owns ASP link.
+  - `src/Uriae/EmployeeBundle/Controller/ContratsController.php` includes ASP behavior.
+  - `src/Uriae/AspBundle/Repository/FicheContratAspRepository.php` joins Contract/Employee/Structure.
+
+- **Employee <-> Union**
+  - `src/Uriae/EmployeeBundle/Entity/Contrat.php` links sortie taxonomy.
+  - `src/Uriae/EmployeeBundle/Model/SituationSortieUpdater.php` manipulates Union sortie references.
+  - `src/Uriae/EmployeeBundle/Repository/EmployeeRepository.php` uses sortie semantics for metrics.
+
+- **Structure as tenancy seam**
+  - `src/Uriae/StructureBundle/Entity/Structure.php` is shared by User/Employee/Asp/Suivi.
+  - `src/Uriae/AspBundle/Manager/AspFicheContratManager.php` requires structure-level configuration.
+  - `src/Uriae/ImportBundle/Controller/ImportController.php` and `src/Uriae/ExportBundle/Controller/ExportController.php` are structure-scoped.
+
+- **Bilan as aggregate seam**
+  - `src/Uriae/BilanBundle/Model/Formatter.php` crosses Employee + Suivi + Union + Asp + Structure.
+  - `src/Uriae/BilanBundle/Controller/BilanController.php` orchestrates cross-context queries.
+
+## Reading Order
--- a/docs/deep-dive-structure-domain.md
+++ b/docs/deep-dive-structure-domain.md
@@ -0,0 +1,199 @@
+# Structure Bundle Deep Dive
+
+## Ubiquitous Language
+
+- **Structure**: tenant-like operational organization that owns users/employees/configuration.  
+  Path: `src/Uriae/StructureBundle/Entity/Structure.php`
+- **HeadOffice / Groupe**: grouping of structures with admin ownership.  
+  Path: `src/Uriae/StructureBundle/Entity/HeadOffice.php`
+- **SiaeType**: structure typology and ASP capabilities (`aspEnabled`, `aspFileEnabled`, `mesure`, `idAsp`).  
+  Path: `src/Uriae/StructureBundle/Entity/SiaeType.php`
+- **FormeJuridique**: legal form reference.  
+  Path: `src/Uriae/StructureBundle/Entity/FormeJuridique.php`
+- **Town / Department / Region**: territorial reference model.  
+  Path: `src/Uriae/StructureBundle/Entity/Town.php`
+- **SiteTravail**: work site linked to structure.  
+  Path: `src/Uriae/StructureBundle/Entity/SiteTravail.php`
+- **Sector**: operational sector linked to structure.  
+  Path: `src/Uriae/StructureBundle/Entity/Sector.php`
+- **PersonneContact**: structure contact person.  
+  Path: `src/Uriae/StructureBundle/Entity/PersonneContact.php`
+- **AnnexeFinanciere**: yearly annex identifier for structure financing context.  
+  Path: `src/Uriae/StructureBundle/Entity/AnnexeFinanciere.php`
+- **ChiffreCle** / **Financement**: yearly KPI and funding model.  
+  Paths: `src/Uriae/StructureBundle/Entity/ChiffreCle.php`, `src/Uriae/StructureBundle/Entity/Financement.php`
+- **Alerte**: threshold rule per type with display/order metadata.  
+  Path: `src/Uriae/StructureBundle/Entity/Alerte.php`
+- **Diary / DiaryEvent / DiaryMailer**: operational alert calendar and recipients.  
+  Paths: `src/Uriae/StructureBundle/Entity/Diary.php`, `src/Uriae/StructureBundle/Entity/DiaryEvent.php`, `src/Uriae/StructureBundle/Entity/DiaryMailer.php`
+- **Competence**: structure-scoped competence catalog reused by employees.  
+  Path: `src/Uriae/StructureBundle/Entity/Competence.php`
+- **Fusion**: merge workflow between structures with cross-context remapping.  
+  Path: `src/Uriae/StructureBundle/Controller/StructureController.php`
+
+## Domain Core
+
+- **Likely root today: `Structure`**
+  - Central owner of users, employees, sectors, sites, alerts, diary, annexes, and financial records.
+  - Paths:
+    - `src/Uriae/StructureBundle/Entity/Structure.php`
+    - `src/Uriae/StructureBundle/Repository/StructureRepository.php`
+
+- **Monitoring configuration cluster**
+  - `Alerte`, `Diary`, `DiaryEvent`, `DiaryMailer`.
+  - Paths:
+    - `src/Uriae/StructureBundle/Entity/Alerte.php`
+    - `src/Uriae/StructureBundle/Entity/Diary.php`
+    - `src/Uriae/StructureBundle/Entity/DiaryEvent.php`
+    - `src/Uriae/StructureBundle/Entity/DiaryMailer.php`
+
+- **Profile and topology cluster**
+  - Identity/legal/contact + work organization (`SiteTravail`, `Sector`).
+  - Paths:
+    - `src/Uriae/StructureBundle/Entity/Structure.php`
+    - `src/Uriae/StructureBundle/Entity/FormeJuridique.php`
+    - `src/Uriae/StructureBundle/Entity/SiaeType.php`
+    - `src/Uriae/StructureBundle/Entity/SiteTravail.php`
+    - `src/Uriae/StructureBundle/Entity/Sector.php`
+
+- **Financial cluster**
+  - Annex, key figures, financings.
+  - Paths:
+    - `src/Uriae/StructureBundle/Entity/AnnexeFinanciere.php`
+    - `src/Uriae/StructureBundle/Entity/ChiffreCle.php`
+    - `src/Uriae/StructureBundle/Entity/Financement.php`
+
+- **Boundary reality**
+  - Structure aggregate currently directly traverses multiple contexts (Employee/User/Suivi/Union/Asp), especially in controller workflows.
+
+## Invariants / Concistency
+
+- `src/Uriae/StructureBundle/Entity/Structure.php`
+  - Structure name uniqueness.
+  - Mandatory fields for information and characteristics contexts.
+  - SIRET length and structural validation coupling.
+  - Town cannot be sentinel invalid value.
+  - At least one activity sector required.
+  - Category activity constrained to a fixed set of values.
+  - Bidirectional consistency for collections (users, employees, sectors, sites, alerts, diary).
+
+- `src/Uriae/StructureBundle/Form/Validator/SiretValidator.php`
+  - SIRET validated with Luhn checksum.
+
+- `src/Uriae/StructureBundle/Form/Validator/AnnexeFinanciereValidator.php`
+  - Annex values must match allowed patterns.
+
+- `src/Uriae/StructureBundle/Entity/Alerte.php`
+  - Alert type constrained to known constants and default behavior fields.
+
+- `src/Uriae/StructureBundle/Entity/Diary.php`
+  - Default diary event initialization and base config defaults.
+
+- `src/Uriae/StructureBundle/Controller/CompetenceController.php`
+  - Competence deletion blocked if linked to employee competences.
+
+- `src/Uriae/StructureBundle/Controller/StructureController.php`
+  - Admin-only operations for create/delete/toggle SMS.
+  - On creation, default alert templates are provisioned.
+  - On delete, users are disabled or reassigned depending on group role.
+
+- `src/Uriae/StructureBundle/Repository/StructureRepository.php`
+  - Soft-deleted structures excluded from normal retrieval paths.
+  
+## Cross-context Dependencies
+
+- **Structure <-> User**
+  - Paths:
+    - `src/Uriae/StructureBundle/Entity/Structure.php`
+    - `src/Uriae/UserBundle/Entity/User.php`
+    - `src/Uriae/UserBundle/Security/SuccessHandler.php`
+
+- **Structure <-> Employee**
+  - Paths:
+    - `src/Uriae/StructureBundle/Entity/Structure.php`
+    - `src/Uriae/EmployeeBundle/Entity/Employee.php`
+    - `src/Uriae/EmployeeBundle/Repository/EmployeeRepository.php`
+
+- **Structure <-> Suivi**
+  - Paths:
+    - `src/Uriae/SuiviBundle/Entity/TypeAction.php`
+    - `src/Uriae/SuiviBundle/Entity/CategorieSavoir.php`
+    - `src/Uriae/StructureBundle/Model/EvaluationUpdater.php`
+    - `src/Uriae/StructureBundle/Controller/ReferentielInsertionController.php`
+
+- **Structure <-> Union**
+  - Paths:
+    - `src/Uriae/UnionBundle/Entity/Partenaire.php`
+    - `src/Uriae/StructureBundle/Controller/StructureController.php`
+
+- **Structure <-> ASP**
+  - Paths:
+    - `src/Uriae/StructureBundle/Entity/SiaeType.php`
+    - `src/Uriae/AspBundle/Model/GeneratorFactory.php`
+    - `src/Uriae/AspBundle/Manager/AbstractAspManager.php`
+    - `src/Uriae/AspBundle/Entity/AbstractFichierAsp.php`
+
+
+## DDD Slicing
+
+- **Aggregates (candidate)**
+  - `StructureProfile` (identity/legal/contact/territory/SIAE/head-office).
+  - `StructureWorkOrganization` (sites/sectors/activity sectors).
+  - `StructureMonitoringConfig` (alerts/diary/events/recipients).
+  - `StructureFinancialProfile` (annexes/key figures/financing).
+
+- **Value objects (candidate)**
+  - `Siret`, `PhoneNumber`, `EmailAddress`, `PostalAddress`.
+  - `ActivityCategory`.
+  - `AlertThresholds` and `AlertOperand`.
+  - `ApiTokenCiphertext`.
+
+- **Domain services (candidate)**
+  - `StructureMergeService`.
+  - `StructureProvisioningService`.
+  - `StructureAlertPolicyService`.
+  - `StructureDiaryComputationService`.
+
+- **Repository interfaces (domain-facing)**
+  - `StructureRepository`.
+  - `StructureMonitoringRepository`.
+  - `StructureFinancialRepository`.
+  - `StructureMergeReadModel`.
+  - `StructureReferenceDataRepository`.
+
+- **Domain events (candidate)**
+  - `StructureCreated`.
+  - `StructureMerged`.
+  - `StructureSoftDeleted`.
+  - `StructureMonitoringConfigured`.
+  - `StructureSiaeTypeChanged`.
+  - `StructureUsersReassigned`.
+
+## Reading Order
+
+1. `src/Uriae/StructureBundle/Entity/Structure.php`  
+2. `src/Uriae/StructureBundle/Repository/StructureRepository.php`  
+3. `src/Uriae/StructureBundle/Controller/StructureController.php`  
+4. `src/Uriae/StructureBundle/Entity/Alerte.php`  
+5. `src/Uriae/StructureBundle/Repository/AlerteRepository.php`  
+6. `src/Uriae/StructureBundle/Entity/Diary.php`  
+7. `src/Uriae/StructureBundle/Entity/DiaryEvent.php`  
+8. `src/Uriae/StructureBundle/Entity/DiaryMailer.php`  
+9. `src/Uriae/StructureBundle/Model/DiaryHandler.php`  
+10. `src/Uriae/StructureBundle/Controller/AlerteController.php`  
+11. `src/Uriae/StructureBundle/Entity/SiaeType.php`  
+12. `src/Uriae/StructureBundle/Entity/HeadOffice.php`  
+13. `src/Uriae/StructureBundle/Entity/SiteTravail.php`  
+14. `src/Uriae/StructureBundle/Entity/Sector.php`  
+15. `src/Uriae/StructureBundle/Entity/Competence.php`  
+16. `src/Uriae/StructureBundle/Form/Validator/AnnexeFinanciereValidator.php`  
+17. `src/Uriae/StructureBundle/Form/Validator/SiretValidator.php`  
+18. `src/Uriae/StructureBundle/Model/EvaluationUpdater.php`  
+19. `src/Uriae/EmployeeBundle/Entity/Employee.php`  
+20. `src/Uriae/EmployeeBundle/Entity/Contrat.php`  
+21. `src/Uriae/EmployeeBundle/Entity/Pmsmp.php`  
+22. `src/Uriae/EmployeeBundle/Repository/EmployeeRepository.php`  
+23. `src/Uriae/SuiviBundle/Entity/TypeAction.php`  
+24. `src/Uriae/SuiviBundle/Entity/CategorieSavoir.php`  
+25. `src/Uriae/AspBundle/Model/GeneratorFactory.php`  
+26. `src/Uriae/UserBundle/Entity/User.php`
--- a/docs/deep-dive-suivi-domain.md
+++ b/docs/deep-dive-suivi-domain.md
@@ -0,0 +1,224 @@
+# Suivi Bundle Deep Dive
+
+## Ubiquitous Language
+
+- **Suivi salarié**: umbrella follow-up workflow for active/exited employees.  
+  Paths: `src/Uriae/SuiviBundle/Controller/SuiviController.php`, `src/Uriae/SuiviBundle/Resources/translations/messages.fr.yml`
+- **Action**: abstract intervention (`dateDebut`, `duree`, `typeAction`, `commentaire`, `structure`).  
+  Path: `src/Uriae/SuiviBundle/Entity/Action.php`
+- **Accompagnement**: socio-professional support action with objective/result/encadrants/partenaires.  
+  Path: `src/Uriae/SuiviBundle/Entity/Accompagnement.php`
+- **Evaluation**: employee assessment action with notes and validation lifecycle.  
+  Path: `src/Uriae/SuiviBundle/Entity/Evaluation.php`
+- **Note**: score item per savoir with bounded values.  
+  Path: `src/Uriae/SuiviBundle/Entity/Note.php`
+- **Savoir taxonomy** (`TypeSavoir`, `CategorieSavoir`, `Savoir`): evaluation referential tree.  
+  Paths: `src/Uriae/SuiviBundle/Entity/TypeSavoir.php`, `src/Uriae/SuiviBundle/Entity/CategorieSavoir.php`, `src/Uriae/SuiviBundle/Entity/Savoir.php`
+- **Action taxonomy** (`AxeTypeAction`, `CategorieTypeAction`, `TypeAction`): insertion action referential tree.  
+  Paths: `src/Uriae/SuiviBundle/Entity/AxeTypeAction.php`, `src/Uriae/SuiviBundle/Entity/CategorieTypeAction.php`, `src/Uriae/SuiviBundle/Entity/TypeAction.php`
+- **FormationInterne** + **ParticipationFormation**: training and attendee participation.  
+  Paths: `src/Uriae/SuiviBundle/Entity/FormationInterne.php`, `src/Uriae/SuiviBundle/Entity/ParticipationFormation.php`
+- **Potentiel**: employability/motivation/mobility profile.  
+  Path: `src/Uriae/SuiviBundle/Entity/Potentiel.php`
+- **Problematique**: insertion issue lifecycle and resolution.  
+  Path: `src/Uriae/SuiviBundle/Entity/Problematique.php`
+- **Habilitation**: employee certification/authorization with expiry.  
+  Path: `src/Uriae/SuiviBundle/Entity/Habilitation.php`
+- **RDV** and **Event**: appointment and event timeline entries.  
+  Paths: `src/Uriae/SuiviBundle/Entity/Rdv.php`, `src/Uriae/SuiviBundle/Entity/Event.php`
+
+## Domain Core
+
+- **Practical root today: `Employee` (outside Suivi)**
+  - Most Suivi entities attach to `Employee` and are also maintained from Employee-side relations.
+  - Path: `src/Uriae/EmployeeBundle/Entity/Employee.php`
+
+- **Action hierarchy**
+  - Polymorphic root `Action` with concrete subclasses:
+    - `Accompagnement`
+    - `Evaluation`
+    - `FormationInterne`
+  - Path: `src/Uriae/SuiviBundle/Entity/Action.php`
+
+- **Evaluation subgraph**
+  - `Evaluation` + `Note` collection and validation lifecycle.
+  - Paths:
+    - `src/Uriae/SuiviBundle/Entity/Evaluation.php`
+    - `src/Uriae/SuiviBundle/Entity/Note.php`
+
+- **Formation subgraph**
+  - `FormationInterne` + participants + costs.
+  - Paths:
+    - `src/Uriae/SuiviBundle/Entity/FormationInterne.php`
+    - `src/Uriae/SuiviBundle/Entity/ParticipationFormation.php`
+
+- **Potentiel and conformite subgraphs**
+  - `Potentiel`, `Problematique`, `Habilitation`.
+  - Paths:
+    - `src/Uriae/SuiviBundle/Entity/Potentiel.php`
+    - `src/Uriae/SuiviBundle/Entity/Problematique.php`
+    - `src/Uriae/SuiviBundle/Entity/Habilitation.php`
+
+- **Reference models**
+  - Action and savoir taxonomies are mutable references with strong structure-level administration.
+  - Paths:
+    - `src/Uriae/SuiviBundle/Entity/TypeAction.php`
+    - `src/Uriae/SuiviBundle/Entity/CategorieTypeAction.php`
+    - `src/Uriae/SuiviBundle/Entity/AxeTypeAction.php`
+    - `src/Uriae/SuiviBundle/Entity/TypeSavoir.php`
+    - `src/Uriae/SuiviBundle/Entity/CategorieSavoir.php`
+    - `src/Uriae/SuiviBundle/Entity/Savoir.php`
+
+## Invariants / Concistency
+
+- `src/Uriae/SuiviBundle/Entity/Note.php`
+  - Note value must be numeric and in allowed range.
+
+- `src/Uriae/SuiviBundle/Entity/Evaluation.php`
+  - New evaluation starts unvalidated.
+  - Note initialization uses selected categories and default non-evaluated value.
+
+- `src/Uriae/SuiviBundle/Repository/EvaluationRepository.php`
+  - Creation flow expects previous evaluations to be validated.
+  - First/last evaluation selection is based on validated subset.
+
+- `src/Uriae/SuiviBundle/Controller/EvaluationController.php`
+  - Blocks new evaluation when prior validations are pending.
+
+- `src/Uriae/SuiviBundle/Model/Bilan/CategoryNode.php`
+  - Non-evaluated notes ignored from score computation.
+
+- `src/Uriae/SuiviBundle/Model/Bilan/FamilyNode.php`
+  - Category score threshold drives strong/weak point classification.
+
+- `src/Uriae/SuiviBundle/Entity/FormationInterne.php`
+- `src/Uriae/SuiviBundle/Form/Validator/Collection/ArrayLength.php`
+  - Formation must have at least one participant.
+
+- `src/Uriae/SuiviBundle/Entity/Action.php`
+- `src/Uriae/SuiviBundle/Entity/ParticipationFormation.php`
+  - Duration fields (`heures/minutes`) recompute total duration via lifecycle logic.
+
+- `src/Uriae/SuiviBundle/Repository/TypeActionRepository.php`
+  - Accompagnement-compatible action types are axis-filtered and category-filtered.
+
+- `src/Uriae/SuiviBundle/Form/Type/FormationInterneType.php`
+  - Formation action type constrained to specific axis.
+
+- `src/Uriae/SuiviBundle/Entity/TypeAction.php`
+  - `structure = null` means global type; non-null means structure-owned type.
+
+- `src/Uriae/StructureBundle/Controller/GrilleEvaluationController.php`
+  - Prevents deleting a savoir when notes exist.
+
+- `src/Uriae/SuiviBundle/Repository/HabilitationRepository.php`
+  - Expiry alerts depend on active habilitation + employee state.
+
+- `src/Uriae/SuiviBundle/Command/DesactivateHabilitationsCommand.php`
+  - Batch deactivation for outdated active habilitations.
+
+- `src/Uriae/SuiviBundle/Repository/RdvRepository.php`
+  - SMS target list filtered by send flag + next-day date rule.
+
+  
+## Cross-context Dependencies
+
+- **Suivi <-> Employee (strong coupling)**
+  - Paths:
+    - `src/Uriae/SuiviBundle/Entity/*`
+    - `src/Uriae/EmployeeBundle/Entity/Employee.php`
+  - Direction idea: Suivi depends on Employee identity/reference boundary, not shared rich object graph.
+
+- **Suivi <-> Structure**
+  - Paths:
+    - `src/Uriae/SuiviBundle/Entity/Action.php`
+    - `src/Uriae/SuiviBundle/Entity/TypeAction.php`
+    - `src/Uriae/SuiviBundle/Entity/CategorieSavoir.php`
+    - `src/Uriae/StructureBundle/Controller/GrilleEvaluationController.php`
+    - `src/Uriae/StructureBundle/Controller/ReferentielInsertionController.php`
+  - Direction idea: explicit catalog management contract instead of direct structure controllers mutating Suivi references.
+
+- **Suivi -> Union**
+  - Paths:
+    - `src/Uriae/SuiviBundle/Entity/FormationInterne.php`
+    - `src/Uriae/SuiviBundle/Entity/Accompagnement.php`
+  - Direction idea: consume Union referentials through explicit read model/ACL.
+
+- **Suivi -> User**
+  - Paths:
+    - `src/Uriae/SuiviBundle/Entity/Rdv.php`
+    - `src/Uriae/SuiviBundle/Entity/Event.php`
+    - `src/Uriae/SuiviBundle/Entity/Habilitation.php`
+  - Direction idea: reference user identity and role policy via dedicated boundary service.
+
+## DDD Slicing
+
+- **Subcontexts**
+  - `suivi-actions` (`Accompagnement`, `Evaluation`, `FormationInterne`, `ParticipationFormation`)
+  - `suivi-potentiel` (`Potentiel`, `Problematique`, projet/experience profile)
+  - `suivi-interactions` (`Rdv`, `Event`)
+  - `suivi-conformite` (`Habilitation`)
+  - `suivi-referentiels` (taxonomy aggregates)
+
+- **Aggregates (candidate)**
+  - `EvaluationAggregate` (evaluation + notes).
+  - `FormationInterneAggregate` (formation + participations + costs).
+  - `AccompagnementAggregate`.
+  - `PotentielAggregate`.
+  - `HabilitationAggregate`.
+  - `RdvAggregate`.
+  - `EventAggregate`.
+
+- **Domain services (candidate)**
+  - `EvaluationPolicyService`.
+  - `FormationParticipationService`.
+  - `HabilitationExpiryService`.
+  - `RdvNotificationPolicy`.
+
+- **Repository interfaces (domain-facing)**
+  - `EvaluationRepository`, `AccompagnementRepository`, `FormationInterneRepository`.
+  - `HabilitationRepository`, `RdvRepository`, `ProblematiqueRepository`.
+  - `TypeActionCatalog`, `SavoirCatalog`.
+
+- **Domain events (candidate)**
+  - `EvaluationCreated`, `EvaluationValidated`.
+  - `FormationParticipantAdded`, `FormationParticipantRemoved`.
+  - `HabilitationExpired`, `HabilitationDeactivated`.
+  - `RdvPlanned`, `RdvSmsRequested`.
+
+- **Value objects (candidate)**
+  - `DurationMinutes`.
+  - `NoteValue`.
+  - `Avancement`.
+  - `ResolutionMode`.
+  - `ActionTypeCode`.
+  - `StructureScope`.
+
+## Reading Order
+
+1. `src/Uriae/EmployeeBundle/Entity/Employee.php`  
+2. `src/Uriae/SuiviBundle/Entity/Action.php`  
+3. `src/Uriae/SuiviBundle/Entity/Evaluation.php`  
+4. `src/Uriae/SuiviBundle/Entity/Note.php`  
+5. `src/Uriae/SuiviBundle/Entity/Accompagnement.php`  
+6. `src/Uriae/SuiviBundle/Entity/FormationInterne.php`  
+7. `src/Uriae/SuiviBundle/Entity/ParticipationFormation.php`  
+8. `src/Uriae/SuiviBundle/Entity/Potentiel.php`  
+9. `src/Uriae/SuiviBundle/Entity/Problematique.php`  
+10. `src/Uriae/SuiviBundle/Entity/Habilitation.php`  
+11. `src/Uriae/SuiviBundle/Entity/Rdv.php`  
+12. `src/Uriae/SuiviBundle/Entity/Event.php`  
+13. `src/Uriae/SuiviBundle/Entity/TypeAction.php`  
+14. `src/Uriae/SuiviBundle/Entity/CategorieSavoir.php`  
+15. `src/Uriae/SuiviBundle/Entity/TypeSavoir.php`  
+16. `src/Uriae/SuiviBundle/Repository/EvaluationRepository.php`  
+17. `src/Uriae/SuiviBundle/Repository/FormationInterneRepository.php`  
+18. `src/Uriae/SuiviBundle/Repository/TypeActionRepository.php`  
+19. `src/Uriae/SuiviBundle/Repository/HabilitationRepository.php`  
+20. `src/Uriae/SuiviBundle/Controller/EvaluationController.php`  
+21. `src/Uriae/SuiviBundle/Controller/FormationInterneController.php`  
+22. `src/Uriae/SuiviBundle/Controller/AccompagnementController.php`  
+23. `src/Uriae/SuiviBundle/Model/FormatterBilanIndividuel.php`  
+24. `src/Uriae/StructureBundle/Controller/GrilleEvaluationController.php`  
+25. `src/Uriae/StructureBundle/Controller/ReferentielInsertionController.php`  
+26. `src/Uriae/StructureBundle/Model/DiaryHandler.php`
--- a/docs/deep-dive-union-domain.md
+++ b/docs/deep-dive-union-domain.md
@@ -0,0 +1,147 @@
+# Union Bundle Deep Dive
+
+## Ubiquitous Language
+
+- **Union**: federation-level identity (sigle, organisme, address, contact) stored in `union_informations`.  
+  Path: `src/Uriae/UnionBundle/Entity/Union.php`
+- **Partenaire**: partner actor (moral/physical), typed via `TypePartenaire`, optionally scoped to a `Structure`.  
+  Path: `src/Uriae/UnionBundle/Entity/Partenaire.php`
+- **TypePartenaire**: partner role label (ordered list).  
+  Path: `src/Uriae/UnionBundle/Entity/TypePartenaire.php`
+- **Conventionnement**: ordered conventionnement catalog entry.  
+  Path: `src/Uriae/UnionBundle/Entity/Conventionnement.php`
+- **ButFormation**: ordered training-goal catalog entry.  
+  Path: `src/Uriae/UnionBundle/Entity/ButFormation.php`
+- **TypeSituationSortie**: exit typology with ASP codes per SIAE type and category constants (`Durable`, `Transition`, etc.).  
+  Path: `src/Uriae/UnionBundle/Entity/TypeSituationSortie.php`
+- **SituationSortie**: employee insertion exit segment (dates, type, contracts grouping) tied to `ParcoursInsertion`.  
+  Path: `src/Uriae/UnionBundle/Entity/SituationSortie.php`
+- **HomepageMessage**: union-wide homepage banner text.  
+  Path: `src/Uriae/UnionBundle/Entity/HomepageMessage.php`
+
+## Domain Core
+
+- **Union profile aggregate (catalog root)**
+  - Single-row style configuration for the federation.
+  - Depends on `StructureBundle` `Town` for city reference.
+  - Path: `src/Uriae/UnionBundle/Entity/Union.php`
+
+- **Partner directory**
+  - `Partenaire` + `TypePartenaire` (many-to-many typing).
+  - Optional `Structure` scope blurs pure “union referential” vs “structure-local partner”.
+  - Paths: `src/Uriae/UnionBundle/Entity/Partenaire.php`, `src/Uriae/UnionBundle/Entity/TypePartenaire.php`
+
+- **Ordered catalogs**
+  - `Conventionnement`, `ButFormation` with `position` ordering.
+  - Paths: `src/Uriae/UnionBundle/Entity/Conventionnement.php`, `src/Uriae/UnionBundle/Entity/ButFormation.php`
+
+- **Exit taxonomy + lifecycle segment (boundary anomaly)**
+  - `TypeSituationSortie` is clearly union-level referential.
+  - `SituationSortie` is **employee insertion state**: links `ParcoursInsertion`, `Contrat[]`, and exit type. It lives in Union bundle but behaves as **Employee / insertion journey** domain.
+  - Paths: `src/Uriae/UnionBundle/Entity/TypeSituationSortie.php`, `src/Uriae/UnionBundle/Entity/SituationSortie.php`
+
+- **Admin referential UI (not Union-owned data)**
+  - Controllers under Union manage `SuiviBundle` taxonomies (`AxeTypeAction`, `CategorieTypeAction`, `TypeAction`) and evaluation grid (`TypeSavoir`, `CategorieSavoir`, `Savoir`) using `StructureBundle` form types.
+  - Paths:
+    - `src/Uriae/UnionBundle/Controller/ReferentielInsertionController.php`
+    - `src/Uriae/UnionBundle/Controller/GrilleEvaluationController.php`
+
+## Invariants / Concistency
+
+- `src/Uriae/UnionBundle/Entity/Union.php`
+  - Sigle, adresse, code postal (length 5), telephone constraints (via `@Telephone` from Structure bundle).
+
+- `src/Uriae/UnionBundle/Entity/Partenaire.php`
+  - Libellé not blank.
+
+- `src/Uriae/UnionBundle/Entity/TypePartenaire.php`, `Conventionnement.php`, `ButFormation.php`
+  - Name not blank; position field for ordering.
+
+- `src/Uriae/UnionBundle/Entity/TypeSituationSortie.php`
+  - Libellé not blank; ASP code fields length-capped per SIAE column.
+
+- `src/Uriae/UnionBundle/Entity/SituationSortie.php`
+  - Callback `isSituationSortieValid`: if `dateSortie` set then `typeSituationSortie` required.
+  - Callback `isDateSortieValid`: if `typeSituationSortie` set then `dateSortie` required.
+  - `setParcoursInsertion` / `addContrat` maintain bidirectional graph with Employee entities.
+
+- `src/Uriae/UnionBundle/Controller/NatureEmploisController.php`
+  - Metier delete allowed only when no contract references that metier.
+
+- `src/Uriae/UnionBundle/Controller/SituationsSalariesController.php`
+  - Position assignment on add for `ProblemeInsertion` / `DureeAide` (via Employee repositories).
+  
+## Cross-context Dependencies
+
+- **Union -> Structure**
+  - `Union` uses `Town`.  
+  - `Partenaire` optional `Structure`.  
+  - Paths: `src/Uriae/UnionBundle/Entity/Union.php`, `src/Uriae/UnionBundle/Entity/Partenaire.php`
+
+- **Union (entity) -> Employee**
+  - `SituationSortie` -> `ParcoursInsertion`, `Contrat`.  
+  - Path: `src/Uriae/UnionBundle/Entity/SituationSortie.php`
+
+- **Union (controllers) -> Employee**
+  - Metier, resource categories, problem types, aide durations.  
+  - Paths: `src/Uriae/UnionBundle/Controller/NatureEmploisController.php`, `src/Uriae/UnionBundle/Controller/SituationsSalariesController.php`
+
+- **Union (controllers) -> Suivi**
+  - Insertion referential + evaluation grid.  
+  - Paths: `src/Uriae/UnionBundle/Controller/ReferentielInsertionController.php`, `src/Uriae/UnionBundle/Controller/GrilleEvaluationController.php`
+
+- **Downstream consumers**
+  - Employee (`ParcoursInsertion`, `Contrat`, `FirstHome`), Suivi (`Partenaire`, `ButFormation`), Asp (`TypeSituationSortie` codes), Bilan/reporting.
+
+## DDD Slicing
+
+Treat **Union** as two conceptual areas:
+
+### A) Federation referential (true Union BC)
+
+- **Aggregates (candidate)**
+  - `UnionOrganizationProfile` (current `Union` entity).
+  - `PartnerDirectory` (`Partenaire` + types; clarify global vs structure-scoped partners as separate AR or explicit `PartnerScope` VO).
+  - `ConventionnementCatalog`, `ButFormationCatalog`.
+  - `ExitTypeCatalog` (`TypeSituationSortie` only).
+
+- **Value objects (candidate)**
+  - `PartnerLabel`, `ExitTypeCode`, `AspExitCodeBySiae` (wrap per-SIAE code columns).
+
+- **Domain services**
+  - `PartnerTypingPolicy` (conventionneur-only rules currently enforced in Employee `FirstHome` should align with Union vocabulary).
+
+### B) Relocate out of Union (employee insertion)
+
+- **SituationSortie** as part of **Employee / InsertionJourney** aggregate (or its own AR owned by Employee context), with Union only providing `ExitTypeId` / published catalog.
+
+- **Application layer**
+  - “Union admin” use cases that today edit Suivi/Employee referentials should become explicit **application services** in the owning BC, callable from Union UI via APIs or shared kernel interfaces—not direct entity manipulation from Union controllers.
+
+## Reading Order
+
+1. `src/Uriae/UnionBundle/Entity/Union.php`  
+2. `src/Uriae/UnionBundle/Repository/UnionRepository.php`  
+3. `src/Uriae/UnionBundle/Controller/InformationsController.php`  
+4. `src/Uriae/UnionBundle/Entity/Partenaire.php`  
+5. `src/Uriae/UnionBundle/Entity/TypePartenaire.php`  
+6. `src/Uriae/UnionBundle/Repository/PartenaireRepository.php`  
+7. `src/Uriae/UnionBundle/Controller/PartenairesController.php`  
+8. `src/Uriae/UnionBundle/Entity/Conventionnement.php`  
+9. `src/Uriae/UnionBundle/Entity/ButFormation.php`  
+10. `src/Uriae/UnionBundle/Repository/ConventionnementRepository.php`  
+11. `src/Uriae/UnionBundle/Repository/ButFormationRepository.php`  
+12. `src/Uriae/UnionBundle/Controller/FormationsController.php`  
+13. `src/Uriae/UnionBundle/Entity/TypeSituationSortie.php`  
+14. `src/Uriae/UnionBundle/Entity/SituationSortie.php`  
+15. `src/Uriae/UnionBundle/Repository/SituationSortieRepository.php`  
+16. `src/Uriae/UnionBundle/Controller/SituationsSortiesController.php`  
+17. `src/Uriae/UnionBundle/Entity/HomepageMessage.php`  
+18. `src/Uriae/UnionBundle/Controller/HomepageMessageController.php`  
+19. `src/Uriae/UnionBundle/Controller/ReferentielInsertionController.php`  
+20. `src/Uriae/UnionBundle/Controller/GrilleEvaluationController.php`  
+21. `src/Uriae/UnionBundle/Controller/NatureEmploisController.php`  
+22. `src/Uriae/UnionBundle/Controller/SituationsSalariesController.php`  
+23. `src/Uriae/UnionBundle/Controller/TypologieSiaeController.php`  
+24. `src/Uriae/EmployeeBundle/Entity/ParcoursInsertion.php`  
+25. `src/Uriae/EmployeeBundle/Model/SituationSortieUpdater.php`
Author	SHA1	Message	Date
Guillaume Dauster	931fbff884	Revise deep dive documentation to analyze DDD patterns in the URIAE codebase, focusing on the Economic and Social Solidarity context. Address shared language, bounded contexts, and semantic issues, while providing recommendations for improvement and a proposed glossary for ESS terminology.	2026-04-10 17:13:25 +02:00
Guillaume Dauster	3142cc1f45	An IA assisted dive into domain from legacy code	2026-04-10 12:27:36 +02:00