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

[ncast-dev]

Directive PO — STEP_1 (Milestone 1 : L'Étincelle Capturée)

Objectif

Bootstrapper le projet Spark : structure de repo, modèle Idea, base de données SQLite, et endpoints REST minimaux permettant de créer une idée et d'appeler le LLM.

Travail attendu (~24h)

Structure de repo :

spark/
  main.py
  models/idea.py
  api/ideas.py
  database.py
  tests/

Stack : Python 3.12, FastAPI, SQLModel, Anthropic SDK, pytest

Endpoints à implémenter :

• POST /ideas → crée une idée brute (raw_text), retourne { id, created_at }
• GET /ideas/{id} → récupère une idée
• GET /health → healthcheck

Acceptance Criteria (tous vérifiables par test automatisé)

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

Fichiers créés (ownership exclusif)

• 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

Dépendances

Aucune — premier step du milestone.

Contexte marché

Lovable atteint 500 M$ ARR (mai 2026) en partant du prototype. Spark se distingue en partant de l'intention floue via dialogue socratique. Ce STEP_1 pose les fondations de cet avantage différenciateur.

---

Roadmap complète : docs/product/ROADMAP.md — Steps M1 : docs/product/STEP_1.md à STEP_5.md