Aller au contenu

Variables d'environnement backend — structure (valeurs réelles non reprises)

Contexte

Documentation de la structure des variables d'environnement du backend ESM. Les valeurs réelles (secrets JWT, mot de passe DB, etc.) vivent uniquement dans ProjetESM/Documents/env.md et le .env réel du serveur — volontairement non reproduites ici, cette base de connaissance n'étant pas un coffre-fort de secrets.

Contenu

Catégories de variables (noms et rôles, sans valeurs sensibles)

Catégorie Variables Rôle
Application NODE_ENV, PORT (4100), APP_NAME, APP_URL, FRONTEND_URL Config générale, URL publique esm.tekdhi.dev
Base de données DATABASE_URL Connexion PostgreSQL natif (esm_user@127.0.0.1:5432/esm_db)
JWT JWT_ACCESS_SECRET, JWT_REFRESH_SECRET, JWT_ACCESS_EXPIRES (24h), JWT_REFRESH_EXPIRES (7j) Secrets de signature — jamais à reproduire hors .env
Redis REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_DB, REDIS_URL, REDIS_TLS Fallback InMemory automatique si absent
CORS CORS_ORIGIN, CORS_METHODS, CORS_HEADERS Restreint à esm.tekdhi.dev
Sécurité BCRYPT_ROUNDS (12) Coût de hachage mot de passe
Rate limiting RATE_LIMIT_GLOBAL_*, RATE_LIMIT_AUTH_*, RATE_LIMIT_MASSE_* Fenêtres et plafonds par type de route
Email (SMTP) SMTP_HOST, SMTP_PORT, SMTP_SECURE, SMTP_USER, SMTP_PASS, EMAIL_FROM, EMAIL_FROM_NAME, EMAIL_LOGO_URL Envoi transactionnel
Logs LOG_LEVEL Niveau de verbosité

Où trouver les vraies valeurs

  • Fichier source complet (avec valeurs réelles) : ProjetESM/Documents/env.md — ne pas committer dans git, ne pas recopier ailleurs.
  • .env réel en production : sur le VPS, référencé par le script de déploiement deploy.sh --config projetesm.env.

Décision / Conclusion

Structure figée au 2026-06-17, cohérente avec le guide de déploiement (voir ProjetESM/debug/deploiement-docker-postmortem). Toute modification de ces variables doit être répercutée à la fois dans env.md (référence locale) et dans la config de déploiement VPS.

Liens connexes