[PO] STEP_1 — Setup projet & pipeline CI/CD | Spark M1

[ncast-dev]

Directive Product Owner — Spark Milestone 1

Step : STEP_1 — Setup projet & pipeline CI/CD
Milestone : M1 — L’Étincelle Capturée
Durée cible : ~24h

---

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

• 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 (Railway, Render ou équivalent)
• 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

Critères de succès

• git push → CI verte → déploiement staging automatique en < 5 min
• Environnement local lançable en 1 commande (make dev ou docker compose up)
• Secrets gérés via vault/env secrets (aucun secret en clair dans le repo)
• URL staging accessible et retournant 200

Dépendances

• Décision stack technique (Python/FastAPI + React recommandé, ou équivalent)
• Accès aux comptes cloud cible (GitHub, plateforme de déploiement)

Livrable

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

---

Directive émise par le Product Owner le 2026-06-25. Les 5 steps M1 sont détaillés dans docs/product/STEP_1.md à STEP_5.md.