User Flow 03 — Corriger un Bug
Persona
Marc, dev senior. Alerte Slack : « Les utilisateurs ne peuvent plus se connecter ».
La Demande
/atoox --bugfix "Les utilisateurs reçoivent une erreur 500 à la connexion depuis ce matin"
Ce qu'ATOOX détecte
Intention : BUG
Domaines : tech
Équipe assemblée : CTO
Mode activé : --bugfix
Le Flow
BF-00 Intake → Comprendre le bug : erreur 500 sur /api/auth/login
→ Depuis quand ? Ce matin 08h47
→ Combien d'utilisateurs ? Tous
BF-01 Reproduce → Tenter de reproduire localement
→ Reproduit ✅ : JWT_SECRET manquant en variable d'env
BF-02 Root Cause → Cause racine : déploiement hier soir, .env.production
mis à jour mais JWT_SECRET supprimé par erreur
BF-03 Impact → Impact : CRITIQUE — 100 % des users bloqués
→ Données : pas de perte (les sessions existent)
BF-04 Plan Fix → Solution : restaurer JWT_SECRET dans .env.production
→ Ajout validation au démarrage : vérifier JWT_SECRET existe
BF-05 Implement → Code : startup check dans server.ts
→ if (!process.env.JWT_SECRET) throw new Error(...)
BF-06 Verify → Test local ✅ : connexion fonctionne
BF-07 Non-Regression → Tests existants passent ✅
→ Nouveau test : « server refuse de démarrer sans JWT_SECRET »
BF-08 Prevent → Ajout dans CI : variable d'env check
→ Documentation : « Variables requises en production »
BF-09 Finish → Commit : fix: add JWT_SECRET validation on startup
→ PR #43 : hotfix, prête à merge
Résultat Final
- Bug corrigé + test de non-régression
- Prévention : check au démarrage + CI
- Tout documenté pour le post-mortem