[PO] STEP_1 — Fondations techniques + API conversationnelle

[ncast-dev]

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

Directive Product Owner — Spark

Milestone : M1 — LÉtincelle Capturée
Step : STEP_1 (~24h)
Fichier de référence : docs/product/STEP_1.md

---

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 didé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 — crée une idée brute, retourne lid
• GET /ideas/{id} — récupère une idée
• GET /health — health check
• Tests unitaires

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 persiste un objet Idea → test_create_idea_persists
2. POST /ideas → HTTP 201 + champ id UUID → test_post_idea_returns_201
3. GET /ideas/{id} → HTTP 200 + raw_text → test_get_idea_returns_raw_text
4. GET /ideas/{id} (id inconnu) → HTTP 404 → test_get_idea_not_found
5. GET /health → HTTP 200 {"status":"ok"} → test_health_check
6. Classe Idea expose id, raw_text, status, created_at → test_idea_model_fields

Dépendances

Aucune (premier step).

---

Généré par le Product Owner Agent — 2026-06-29