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

[ncast-dev]

[PO] Directive M1 — STEP_1 : Fondations techniques + API conversationnelle

Milestone : M1 — L'Étincelle Capturée
Step : STEP_1 (~24h)
Priorité : CRITIQUE — bloque tous les steps suivants

---

Objectif

Mettre en place le squelette du projet Spark : structure de repo Python, serveur FastAPI, modèle de données Idea (SQLite/SQLModel), et premiers endpoints 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 : id (UUID), raw_text, status, created_at
• POST /ideas → crée une idée brute, retourne l'id (HTTP 201)
• GET /ideas/{id} → récupère une idée (HTTP 200 ou 404)
• GET /health → {"status": "ok"}
• Tests unitaires couvrant tous les endpoints et le modèle

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

Acceptance Criteria

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

Dépendances

Aucune — premier step, peut démarrer immédiatement.

---

Référence complète : docs/product/STEP_1.md