[PO] STEP_3 — Extraction & structuration du brief (Milestone M1)

[ncast-dev]

Directive PO — STEP_3

Milestone : M1 — L'Étincelle Capturée
Dépend de : STEP_2 (Moteur de dialogue socratique) — COMPLETED

---

Objectif (~24h)

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

Périmètre

• Concevoir le schéma JSON du brief (titre, problème, cible, valeur unique, contraintes, prochaine action)
• Implémenter BriefExtractor qui parse la conversation et produit le JSON
• Écrire le schéma de validation Pydantic du brief
• Endpoint POST /brief/extract qui retourne le brief JSON depuis l'historique de session
• Tests unitaires couvrant : brief complet, brief partiel, conversation vide

Acceptance Criteria

• La classe BriefExtractor dans backend/brief/extractor.py produit un dict valide pour toute conversation ≥ 3 tours, vérifié par test_brief_extractor_valid_output
• Le modèle Pydantic BriefSchema dans backend/brief/schema.py rejette un brief sans champ problem, vérifié par test_brief_schema_validation
• L'endpoint POST /brief/extract retourne HTTP 200 avec JSON conforme au schéma, vérifié par test_brief_extract_endpoint
• La fonction brief_to_markdown() dans backend/brief/formatter.py produit un texte lisible sans champ vide, vérifié par test_brief_to_markdown

Writes

• backend/brief/extractor.py
• backend/brief/schema.py
• backend/brief/formatter.py
• backend/routes/brief.py

---

Assigné à : CTO / Senior Engineer
Référence complète : docs/product/STEP_3.md