Sprint 0 — Fondations & CI/CD de base

Mise en place GitLab, Docker, Alembic. Les fondations sont fragiles. 😅

---

INC-001 — Variable GitLab CI Protected sur feature branch

Contexte : Pipeline test stage
Symptôme :

pydantic_core.ValidationError: SECRET_KEY Field required

Cause :

Variable GitLab CI marquée "Protected"
Feature branch non protégée → variable non injectée

Fix :

Settings → CI/CD → Variables → SECRET_KEY
Protected : ❌ → Masked : ✅

Leçon :

Protected  = injecté uniquement sur branches protégées (main, develop)
Masked     = cache la valeur dans les logs → suffisant pour la sécurité
Règle : CI/CD variables → Masked uniquement sauf secrets production

---

INC-002 — Pydantic BaseSettings priorité .env vs variables d'environnement

Contexte : Docker Compose networking
Symptôme :

Connection refused: localhost:5432

Cause :

Pydantic BaseSettings lit le fichier .env en priorité
DB_HOSTNAME=localhost dans .env écrase DB_HOSTNAME=db injecté par Docker

Fix :

# Créer un fichier .env.docker séparé
DB_HOSTNAME=db   # nom du service Docker Compose

Leçon :

Pydantic BaseSettings priorité :
1. Variables d'environnement (haute)
2. Fichier .env (basse par défaut)
→ En dev Docker : utiliser .env.docker
→ En CI/CD : pas de fichier .env (variables injectées)

---

INC-003 — Migration Alembic dupliquée

Contexte : Démarrage de l'application
Symptôme :

sqlalchemy.exc.ProgrammingError: DuplicateTable relation "users" already exists

Cause :

Migration c9e6377cb51d_new_migration.py recréait des tables
déjà créées par les migrations précédentes

Fix :

# Identifier et supprimer la migration problématique
rm alembic/versions/c9e6377cb51d_new_migration.py

Leçon :

Toujours vérifier l'historique Alembic avant d'ajouter une migration
alembic history --verbose
Ne jamais créer une migration qui recrée des tables existantes

---

📊 Résumé Sprint 0

• 3 incidents : Variables, Networking, Database
• Clé : Comprendre les priorités (Protected vs Masked, .env vs env vars)
• Durée de fix : ~5-10 min chacun (quand on sait 😅)

→ Voir Sprint 1