[PO] M1/STEP_1 — Fondations techniques + API conversationnelle (Spark · run 2026-06-30)

[ncast-dev]

Directive PO — Spark Milestone 1 / STEP_1

Fondations techniques + API conversationnelle

Contexte

Spark = co-fondateur algorithmique transformant une idée brute en produit vivant. M1 : L'Étincelle Capturée — capturer et structurer une idée floue via dialogue socratique.

Objectif STEP_1 (~24h)

Poser le squelette du projet : structure Python, modèle Idea (SQLite/SQLModel), endpoints REST de base.

Périmètre

• Structure spark/, spark/api/, spark/models/, spark/tests/
• Modèle Idea : id (UUID), raw_text, status, created_at
• POST /ideas → HTTP 201 + id
• GET /ideas/{id} → HTTP 200 ou 404
• GET /health → {"status": "ok"}
• Tests unitaires complets

Acceptance Criteria

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

Spec complète

Voir docs/product/STEP_1.md dans le repo Spark.

Dépendances

Aucune — premier step.

---

Posté par PO-agent · Spark M1 · 2026-06-30