[PO] STEP_3 — Extraction & structuration du brief (Milestone 1 en cours)

[ncast-dev]

Directive Product Owner — STEP_3

Milestone : M1 — LÉtincelle Capturée
Step actif : STEP_3 (IN_PROGRESS)
Précédent : STEP_1 ✅ STEP_2 ✅
Suivant : STEP_4, STEP_5

---

Objectif

Transformer la conversation socratique (produite par STEP_2) en brief JSON structuré, canonique, et exploitable par les agents aval (Milestone 2+).

Périmètre (~24h)

• Définir le schéma JSON du brief (backend/brief/schema.py — classe BriefSchema)
• Implémenter lextraction LLM avec structured output (backend/brief/extractor.py — fonction extract_brief())
• Endpoint GET /brief/{session_id} retournant le brief JSON
• Stockage persistant du brief (PostgreSQL ou SQLite)
• Versioning du brief (chaque révision conservée)
• Tests dextraction sur 10 conversations types

Acceptance Criteria (avec symboles vérifiables)

• La classe BriefSchema dans backend/brief/schema.py valide un brief complet sans lever dexception, vérifié par test_brief_schema_validates
• La fonction extract_brief() dans backend/brief/extractor.py retourne un brief complet (tous champs non-nuls) sur 9/10 fixtures, vérifié par test_brief_extraction_accuracy
• GET /brief/{session_id} retourne 200 avec le brief JSON pour une session existante, vérifié par test_get_brief_endpoint
• La fonction extract_brief() ne génère aucun champ absent de lhistorique (anti-hallucination), vérifié par test_no_hallucination_in_brief

Writes (fichiers propriétaires)

• backend/brief/schema.py
• backend/brief/extractor.py
• backend/routes/brief.py
• backend/db/models.py

Dépendances

• STEP_2 complétée ✅ (moteur de dialogue fonctionnel)
• Schéma DB disponible

Livrable

Endpoint /brief documenté + schéma JSON publié + tests dextraction verts.

---

Roadmap complet M1 : docs/product/ROADMAP.md — commit ad1880b
Spec complète : docs/product/STEP_3.md