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

[ncast-dev]

Directive PO — STEP_1 : Fondations techniques + API conversationnelle

Milestone : M1 — L'Étincelle Capturée
Repo : https://github.com/ncast-dev/Hub
Commit de référence : b9a8cba

---

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 d'idée brute. Aucune logique socratique ici — on pose les rails.

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
• GET /health : health check

Fichiers à créer (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. La fonction create_idea() dans spark/api/ideas.py accepte un raw_text non vide et persiste un objet Idea en base, 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 pour un id existant, 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 les champs id, raw_text, status, created_at, vérifié par test_idea_model_fields

Dépendances

Aucune (premier step).

Contexte marché

Les concurrents (Lovable, Bolt, Emergent) exposent tous une API REST comme couche d'entrée. Spark doit traiter chaque idée comme un artefact versionné dès le départ. Lovable a atteint $100M ARR en juin 2025 et 8M utilisateurs, validant la demande massive pour ce type de plateforme [source: TechCrunch Nov 2025].

---

Ref : docs/product/STEP_1.md — Spark PO, 2026-07-02