Files
Forge-Engine/.env.example
T
williamandClaude Sonnet 5 c57420c8c9 Phase 3 : hardening qualite de code - typage strict, securite, dead code, a11y
Config strictement stricte partout (ruff, mypy --strict, bandit, vulture,
import-linter, eslint, stylelint), aucune regle desactivee "pour ne pas
casser le build" - l'existant a ete corrige pour la satisfaire plutot que
l'inverse. Hooks pre-commit locaux (language: system) bloquants.

- Typage mypy --strict propage a tout le moteur (db, screens, auth, core,
  ai, routes, puis publish/scripts/tests/app.py/build_css.py).
- Securite : fuite de handle fichier Windows corrigee dans l'export SCORM
  (routes/publish/export_scorm.py), CSRF/RNG non-crypto/xAPI documentes
  (# nosec, # NOSONAR justifies), nouveau db.json_for_script() (echappe
  "</script>" dans le JSON embarque en <script>, 25 sites).
- Architecture : imports circulaires/F811 nettoyes, contrats
  import-linter respectes, code mort retire (vulture).
- Accessibilite : 69 champs de formulaire sans label correctement
  associe corriges (for/id ou aria-label) sur 11 templates.
- ESLint/Stylelint : lot mecanique JS/CSS, regles ajustees puis
  appliquees (aucune desactivee sans verification individuelle).
- Tests : isolation du compte admin partage (nettoyage ponctuel +
  fixture de teardown automatique en filet de securite), suite complete
  verte (591 tests Python, 241 tests JS).
- SonarQube Community Build self-heberge (Docker + PostgreSQL) : rapport
  complet analyse point par point, faux positifs documentes.
- .gitattributes ajoute (LF force) : core.autocrlf=true sur cette machine
  faisait echouer ESLint (linebreak-style) via un bug connu de git
  (checkout "en place" qui ignore l'eol force sur un fichier deja
  present sur disque - contourne en supprimant puis recreant chaque
  fichier suivi).

djLint (H021, styles inline) volontairement saute pour ce commit -
backlog assume, deja documente, traite dans un lot separe.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-15 16:06:15 +02:00

54 lines
2.4 KiB
Bash

# Deux usages distincts pour ce fichier, jamais mélangés :
# - En LOCAL (poste de dev) : copier en ".env" à la racine du dépôt et
# renseigner les clés IA ci-dessous — core/flask_app.py les charge lui-
# même (python-dotenv), rien d'autre à faire. Jamais committer ce ".env"
# (déjà dans .gitignore).
# - En PRODUCTION : ce fichier configure docker-compose.prod.yml (image,
# port) — copier en ".env" à côté de docker-compose.prod.yml sur le
# serveur. L'app elle-même n'y lit AUCUN fichier .env en production
# (aucun n'y est déployé) : les variables y sont posées directement sur
# l'hôte/le conteneur, docker-compose.prod.yml les lui transmettant.
# Adresse complète de l'image dans le registre Gitea, ex :
# gitea.exemple.com/mon-compte/forge-engine
REGISTRY_IMAGE=
# Tag d'image à déployer (le pipeline CI le fixe généralement au commit SHA)
IMAGE_TAG=latest
# Port exposé sur l'hôte de production
PORT=5050
# Réinitialisation de mot de passe par email (auth/send_email.py) — un
# serveur SMTP existant (ex. Mailcow) suffit, aucun service tiers requis.
# Laisser vide désactive l'envoi (le lien de réinitialisation n'est alors
# jamais transmis à l'utilisateur, seule une erreur est journalisée côté
# serveur — jamais montrée telle quelle à l'utilisateur).
SMTP_HOST=
SMTP_PORT=587
SMTP_USER=
SMTP_PASSWORD=
SMTP_FROM=
# Onglet "IA" (voir ai/client.py) — clé du compte Anthropic Console
# (console.anthropic.com), PAS l'abonnement claude.ai Entreprise (deux
# systèmes de facturation séparés). Laisser vide désactive le chat IA
# (message d'erreur clair affiché au créateur, jamais une 500).
ANTHROPIC_API_KEY=
# Génération d'images (voir ai/scenario_client.py) — compte Scenario
# (scenario.com), clé + secret (authentification Basic), et l'id du
# modèle entraîné sur le style graphique unique de Forge Engine (voir
# l'étude préalable : un seul style pour tout le moteur, pas par projet).
# Laisser vide désactive juste la génération d'images (le reste du chat
# IA continue de fonctionner).
SCENARIO_API_KEY=
SCENARIO_API_SECRET=
SCENARIO_MODEL_ID=
# Debogueur Werkzeug (traceback interactif + auto-reload) pour le
# developpement local uniquement — ne jamais activer ailleurs qu'en local
# (app.py, python app.py direct ; sans effet en production, qui utilise
# gunicorn). Laisser vide/0 = desactive par defaut.
FORGE_DEBUG=0