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

[ncast-dev]

Directive PO — Milestone 1, Step 1

Objectif (~24h) : Poser le squelette du projet Spark — structure de repo, serveur FastAPI, modèle Idea (SQLite/SQLModel), et premiers endpoints de capture d'idée brute.

Périmètre

• spark/main.py + spark/database.py : bootstrap FastAPI + SQLite
• spark/models/idea.py : modèle Idea (id UUID, raw_text, status, created_at)
• spark/api/ideas.py : POST /ideas (201 + id) et GET /ideas/{id} (200 ou 404)
• GET /health → {"status": "ok"}
• Tests unitaires couvrant tous les endpoints et le modèle

Acceptance Criteria (avec symboles vérifiables)

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

Fichiers attendus (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

Dépendances

Aucune (premier step).

---

Réf : docs/product/STEP_1.md — Spark Milestone 1 : L'Étincelle Capturée