[PO] STEP_1 — Setup projet & pipeline CI/CD (Milestone 1)

[ncast-dev]

Directive PO — Milestone 1 : STEP_1

Objectif

Initialiser la base de code Spark et mettre en place le pipeline CI/CD complet.

Périmètre (~24h)

• Initialiser le repo GitHub avec structure monorepo (backend/frontend/agents)
• Configurer la CI (GitHub Actions) : lint, tests, build à chaque PR
• Configurer le CD : déploiement automatique sur environnement staging
• Définir les variables d'environnement (LLM API key, DB URL, etc.)
• Créer le README avec instructions de lancement local
• Valider qu'un "Hello Spark" est accessible en staging

Acceptance Criteria

• La commande make dev lance l'environnement local sans erreur, vérifié par test_local_env_starts
• Le fichier backend/main.py expose GET /health retournant {"status": "ok"}, vérifié par test_health_endpoint
• Le workflow CI ci.yml s'exécute et passe au vert à chaque push, vérifié par test_ci_pipeline
• Aucun secret en clair dans le repo : backend/config.py lit les variables depuis l'environnement, vérifié par test_no_secrets_in_config

Writes

• backend/main.py
• backend/config.py
• Makefile
• .github/workflows/ci.yml

Contexte marché

Le marché no-code/low-code atteint 52 Md$ en 2026 (CAGR 28%). Lovable et Bolt livrent des prototypes en production en quelques heures — Spark doit avoir une infrastructure de déploiement solide dès le départ.

Livrable

PR mergée avec CI verte + URL staging fonctionnelle documentée dans le README.

---

Réf : docs/product/STEP_1.md — Milestone 1 : L'Étincelle Capturée