[PO] STEP_1 — Fondations techniques + API conversationnelle (Milestone 1 : L'Étincelle Capturée)

[ncast-dev]

Directive PO — STEP_1 : Fondations techniques + API conversationnelle

Milestone : M1 — L'Étincelle Capturée
Priorité : 🔴 Première à exécuter (aucune dépendance)
Durée estimée : ~24h

---

Objectif

Mettre en place le squelette du projet Spark : structure de repo, serveur API FastAPI, modèle de données Idea, et premier endpoint de capture d'idée brute. Aucune logique socratique ici — on pose les rails.

Périmètre

• Structure spark/, spark/api/, spark/models/, spark/tests/
• Modèle Idea (SQLite via SQLModel) : id, raw_text, status, created_at
• POST /ideas : crée une idée brute, retourne l'id
• GET /ideas/{id} : récupère une idée
• GET /health
• Tests unitaires endpoints + modèle

Acceptance Criteria

1. create_idea() dans spark/api/ideas.py persiste un Idea, vérifié par test_create_idea_persists
2. POST /ideas retourne HTTP 201 + champ id UUID, vérifié par test_post_idea_returns_201
3. GET /ideas/{id} retourne HTTP 200 + raw_text, vérifié par test_get_idea_returns_raw_text
4. GET /ideas/{id} retourne HTTP 404 pour id inconnu, vérifié par test_get_idea_not_found
5. GET /health retourne {"status": "ok"}, vérifié par test_health_check
6. Classe Idea expose id, raw_text, status, created_at, vérifié par test_idea_model_fields

Fichiers créés (Writes)

• spark/main.py
• spark/models/idea.py
• spark/api/ideas.py
• spark/database.py
• spark/tests/test_api_ideas.py
• spark/tests/test_model_idea.py

Step suivante

Dès STEP_1 DONE → débloquer STEP_2 (moteur socratique LLM) en parallèle avec rien d'autre.

---

Directive émise par le Product Owner — Spark Factory 2026-07-03