ADV_PRO_1 — Instruction du dossier (réconciliation 3 voies)
Objet et finalité
Ouvrir le dossier dès la signature de la lettre de mission et garantir qu'il est complet et conforme avant de lancer la production. Le cœur du processus est la réconciliation 3 voies : croiser ce qui est dû (obligations légales calculées sur la situation du bien), ce qui est signé (prestations de la lettre de mission), ce qui est justifiable (pièces disponibles ou récupérables). [CORPUS — M1, UC-A02]
Finalité : transformer une commande commerciale en dossier instruit — périmètre figé, écarts levés ou tracés, prêt pour la coordination de production. C'est la porte d'entrée de la chaîne de valeur côté ADV (la DCM s'arrête à la commande signée). [CORPUS — 08 §1, §4]
Pilote
- Direction : ADV (Administration des Ventes & Relation Client).
- Agent pressenti : Agent Instruction / Complétude (ADV) — agent IA, consomme le catalogue C1/A1 (cadrage & obligations). [CORPUS — UC-A01/A02, M3]
- Supervision humaine : le dirigeant tranche les discordances non levables (porte STOP) et les cas non triviaux (escalade hybride sur la porte GO). [CORPUS — M1]
Déclencheurs (entrées)
- Lettre de mission signée reçue de la DCM (handoff J1) — déclencheur de la naissance du dossier. [CORPUS — 08 J1, M1]
- Contenu attendu du handoff J1 : lettre de mission + coordonnées client + type(s) de diagnostic commandés. [CORPUS — 08 §3]
- Contexte du bien : type de transaction (vente/location), nature (maison/immeuble, copropriété ou non), usage (habitation/ERP), date de construction, zonage (termites/ERP). [CORPUS — M3 C1]
Sorties et livrables
- Dossier ouvert : identifiant
dossier_idau formatYYMMDD-NN-CLIENT-VILLE, dossier Drive créé, canal Mattermost créé. [CORPUS — conventions CLAUDE.md, Lot 9] - Tableau de réconciliation 3 voies : dû × signé × justifiable, avec la liste des écarts (manques à réclamer, prestations à confirmer, discordances). [CORPUS — UC-A02]
- Liste des pièces à réclamer au client → alimente ADV_PRO_3 (collecte). [CORPUS — M1]
- Décision de porte : GO fin d'instruction (passage en production) ou STOP (blocage motivé). [CORPUS — M1]
- Périmètre figé des missions à produire → handoff J2 vers DEX. [CORPUS — 08 J2]
Acteurs
| Acteur | Rôle | Nature |
|---|---|---|
| Agent Instruction (ADV) | calcule le dû (C1), réconcilie, dresse les écarts | IA |
| Dirigeant | tranche STOP/GO non triviaux, valide le périmètre | humain |
| DCM | fournit la lettre de mission + coordonnées (amont J1) | humain/IA |
| Client / mandant (vendeur, notaire, agence) | source des pièces justificatives | externe |
| DEX | destinataire du périmètre instruit (aval J2) | IA |
Logigramme (étapes macro)
[J1] Lettre de mission signée reçue (DCM)
│
▼
1. Ouverture dossier : dossier_id, dossier Drive, canal Mattermost
│
▼
2. Lecture lettre de mission → prestations SIGNÉES extraites
│
▼
3. Calcul du DÛ (catalogue C1) : obligations légales selon situation du bien
│
▼
4. Inventaire du JUSTIFIABLE : pièces déjà fournies + pièces récupérables
│
▼
5. RÉCONCILIATION 3 voies → tableau d'écarts (dû × signé × justifiable)
│
├─ écart "dû non signé" → proposer avenant / alerter (sous-prestation manquante)
├─ écart "signé non justifiable" → pièce à réclamer (→ ADV_PRO_3)
│
▼
6. PORTE
├─◊ STOP — discordance non levable (le client ne peut justifier → blocage notaire) ◊
└─◊ GO fin d'instruction (auto-GO par défaut ; escalade dirigeant si non-trivial) ◊
│
▼
[J2] Périmètre figé → DEX (coordination & dispatch, ADV_PRO_2)
[CORPUS — M1 phase 1, 08 §1]
Procédures et instructions rattachées
- ADV_PQ_1 — Cadrage de la commande (réconciliation 3 voies).
- ADV_PQ_6 — Ouverture du dossier (dossier_id, dossier Drive, sous-dossiers, canal Mattermost).
- ADV_IQ_1 — Mode opératoire : déterminer le DT requis (cadrage C1) à partir de la situation du bien.
- ADV_IQ_2 — Mode opératoire : réconciliation 3 voies et arbitrage de porte STOP/GO.
- ADV_FQ_1 — Formulaire : fiche d'instruction & tableau de réconciliation 3 voies.
Interfaces amont/aval (handoffs)
| # | Sens | Avec | Contenu |
|---|---|---|---|
| J1 | amont (entrée) | DCM → ADV | lettre de mission + coordonnées client + type(s) de diagnostic [CORPUS — 08] |
| J2 | aval (sortie) | ADV → DEX | dossier_id + channel + liste des diagnostics à produire + docs préalables [CORPUS — 08] |
| interne | aval | ADV_PRO_1 → ADV_PRO_3 | liste des pièces manquantes à réclamer au client |
| support | transverse | ADV → DJC | en cas de doute juridique sur une obligation (option vices cachés, copro) [STANDARD] |
Indicateurs (KPI)
- Délai d'instruction : temps lettre de mission signée → GO fin d'instruction (cible indicative < 24 h ouvrées). [STANDARD] [À CONFIRMER]
- Taux d'auto-GO : part des dossiers instruits sans escalade dirigeant (mesure de la maturité du catalogue C1). [STANDARD]
- Taux de dossiers bloqués (STOP) et motif. [STANDARD]
- Taux d'écarts détectés dû≠signé (sous-prestations oubliées à la vente → manque à gagner évité). [STANDARD]
Enregistrements
- Fiche d'instruction + tableau de réconciliation (ADV_FQ_1) → prototype table
dossiers.instruction/registre_missions. [CORPUS — M2, Lot 6d tables] - Ligne
registre_dossiers(dossier ouvert). [CORPUS — Lot 6d] - Journal d'événements du dossier (porte franchie, escalade). [CORPUS — M2 Événement]
Cas d'usage rattachés
- UC-A01 — Cadrer le DT requis (situation client → diagnostics dus + validité + options juridiques). [CORPUS]
- UC-A02 — Réconciliation 3 voies (dû × signé × justifiable → manques à réclamer). [CORPUS]
- UC-A09 (partiel) — options juridiques portées dès l'instruction (ex. amiante / vices cachés). [CORPUS]
Roadmap (PQ/IQ/FQ restant à développer)
- ADV_IQ_3 [À COMPLÉTER] — Mode opératoire d'ouverture technique du dossier (création
dossier_id, dossier Drive, canal Mattermost) : à figer au Lot 9 (workflow administratif) car dépend du câblagemattermost_channel_create+ structure de dossier. [CORPUS — Lot 9] - ADV_FQ_2 [À COMPLÉTER] — Gabarit de lettre de mission / extraction structurée (dépend de la découverte CERTIM, fin juillet 2026). [CORPUS — 08 §0]
- Table de décision C1 exhaustive par
mission: dérivée du RAG tagué (Lot 8) puis minage A1 — voir M3. [CORPUS — ADR-041]