[PO] STEP_1 — Fondations techniques + API conversationnelle (Spark M1)

[ncast-dev]

Contexte M1 — L'Étincelle Capturée

Spark transforme une idée floue en brief structuré via dialogue socratique. 5 steps de ~24h chacun.

---

STEP_1 — Fondations techniques + API conversationnelle

Objectif : Poser les rails — structure de repo, API FastAPI, modèle Idea SQLite, endpoints CRUD, health check.

Périmètre

• spark/models/idea.py : modèle Idea (id, raw_text, status, created_at)
• spark/api/ideas.py : POST /ideas (HTTP 201 + UUID) et GET /ideas/{id}
• spark/database.py : init SQLite via SQLModel
• GET /health → {"status": "ok"}
• Tests unitaires complets

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 persiste un objet Idea, vérifié par test_create_idea_persists
2. POST /ideas retourne HTTP 201 + id UUID, vérifié par test_post_idea_returns_201
3. GET /ideas/{id} retourne HTTP 200 + raw_text original, vérifié par test_get_idea_returns_raw_text
4. GET /ideas/{id} retourne HTTP 404 sur id inconnu, vérifié par test_get_idea_not_found
5. GET /health retourne HTTP 200 + {"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

Dépendances

Aucune (premier step).

---

Référence complète : docs/product/STEP_1.md dans le repo principal.