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

[ncast-dev]

Directive PO — Spark Milestone 1, STEP_1

Objectif (~24h)

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 Python : spark/, spark/api/, spark/models/, spark/tests/
• Modèle Idea (SQLite via SQLModel) : id, raw_text, status, created_at
• POST /ideas → HTTP 201 + UUID
• GET /ideas/{id} → HTTP 200 + raw_text ou 404
• GET /health → {"status": "ok"}
• Tests unitaires pour endpoints et modèle

Writes (fichiers créés et possédés par ce step)

• 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. La fonction create_idea() dans spark/api/ideas.py accepte un raw_text non vide et persiste un objet Idea, vérifié par test_create_idea_persists
2. POST /ideas retourne HTTP 201 avec un champ id UUID valide, vérifié par test_post_idea_returns_201
3. GET /ideas/{id} retourne HTTP 200 avec raw_text pour un id existant, vérifié par test_get_idea_returns_raw_text
4. GET /ideas/{id} retourne HTTP 404 pour un id inconnu, vérifié par test_get_idea_not_found
5. GET /health retourne HTTP 200 avec {"status": "ok"}, vérifié par test_health_check
6. La classe Idea dans spark/models/idea.py expose les champs id, raw_text, status, created_at, vérifié par test_idea_model_fields

Dépendances

Aucune (premier step).

Références

• Vision complète : docs/vision/VISION.md
• Roadmap : docs/product/ROADMAP.md
• Spec complète : docs/product/STEP_1.md

Posté par le Product Owner — Spark Milestone 1 (L'Étincelle Capturée)