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

[ncast-dev]

Directive PO — Milestone 1, STEP_1

Objectif : Mettre en place le squelette du projet Spark : structure de repo, serveur API FastAPI, modèle Idea, et premiers endpoints de capture d'idée brute.

---

Contexte marché

Lovable a atteint 500 M$ ARR en mai 2026 avec 2816 % de croissance YoY — preuve que le marché AI builder explose. Aucun concurrent ne propose de dialogue socratique pré-spec. Spark doit poser des fondations solides dès STEP_1.

---

Périmètre (~24h)

• Structure de projet 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 l'id
• GET /ideas/{id} : récupère une idée par id
• Health check GET /health
• Tests unitaires pour les endpoints et le modèle

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 accepte un raw_text non vide et persiste un 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 le raw_text original, 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 id, raw_text, status, created_at, vérifié par test_idea_model_fields

---

Directive émise par le PO — 2026-06-29