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

Durée Totale : ~15-30 min