[PO] STEP_1 — Setup projet & pipeline CI/CD (Spark · M1 · 2026-06-29 v2)

[ncast-dev]

[PO] STEP_1 — Setup projet & pipeline CI/CD | Spark · Milestone 1

Milestone : M1 — L'Étincelle Capturée
Durée cible : ~24h
Dépendances : Décision stack CTO requise avant démarrage

---

Objectif

Initialiser la base de code Spark et mettre en place le pipeline CI/CD complet pour que toutes les étapes suivantes puissent livrer en confiance.

Périmètre

• Structure monorepo : backend/ · frontend/ · agents/
• CI (GitHub Actions) : lint + tests + build à chaque PR → ci.yml
• CD : déploiement staging automatique (Railway/Render)
• GET /health → {"status": "ok"} accessible en staging
• Lancement local en 1 commande : make dev
• Aucun secret en clair dans le repo

Acceptance Criteria

• La commande make dev lance l'environnement local, vérifié par test_local_env_starts
• backend/main.py expose GET /health → 200, vérifié par test_health_endpoint
• ci.yml passe au vert à chaque push, vérifié par test_ci_pipeline
• backend/config.py lit les variables depuis l'env (pas de secrets hardcodés), vérifié par test_no_secrets_in_config

Fichiers créés (Writes)

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

Livrable

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

---

Directive PO — Spark · 2026-06-29