[PO] STEP_1 — Fondations techniques + API conversationnelle (M1: Etincelle Capturee)

[ncast-dev]

Directive PO — STEP_1

Milestone : M1 — L'Etincelle Capturee

Objectif

Mettre en place le squelette du projet Spark : structure de repo, serveur API FastAPI, modele de donnees Idea, et premier endpoint de capture d'idee brute. Aucune logique socratique — on pose les rails.

Contexte marche

Le marche no-code IA atteint 8,6 Md$ en 2026 (CAGR 31 %) et devrait depasser 75 Md$ en 2034 [source: https://www.fortunebusinessinsights.com/no-code-ai-platform-market-110382]. Lovable atteint 500 M$ ARR avec 8 M utilisateurs. Spark doit poser des fondations robustes des le depart.

Perimetre (~24h)

• Structure Python : spark/, spark/api/, spark/models/, spark/tests/
• Modele Idea (SQLite via SQLModel) : id, raw_text, status, created_at
• POST /ideas : cree une idee brute, retourne l'id
• GET /ideas/{id} : recupere une idee
• Health check GET /health
• Tests unitaires endpoints + modele

Acceptance Criteria

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

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

Dependances

Aucune (premier step).

---

Directive generee automatiquement par le PO Agent — 2026-06-29