Files
Forge-Engine/scripts/migrate_flat_project_slugs.py
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

84 lines
3.5 KiB
Python

"""Script à usage unique (PAS exécuté au runtime du moteur) : migre les
projets encore rangés à plat (projects/<slug>/game.db, l'ancien schéma)
vers la structure par utilisateur (projects/<owner_folder>/<project_part>/,
voir db/games/project_slug.py et le plan "Structure de dossiers
propriétaire/projet") — db/game_dir.py sait déjà lire les deux formes,
cette migration n'est donc pas bloquante pour faire tourner le moteur,
mais range enfin les dossiers comme voulu et met à jour project_slug (voir
auth/set_project_slug.py) pour les comptes concernés.
owner_folder = l'ancien slug plat lui-même : c'était déjà, historiquement,
slugify(email) pour le SEUL projet d'un compte "user" (voir l'ancienne
version de routes/auth/register_2fa.py, avant l'onboarding guidé) — donc
le bon dossier propriétaire, tel quel. project_part = slugify(nom du jeu
stocké en _meta), pour donner un vrai nom de dossier PROJET distinct.
Mode simulation par défaut (n'écrit rien, affiche ce qui serait fait) —
`--apply` requis pour exécuter réellement :
python scripts/migrate_flat_project_slugs.py # aperçu
python scripts/migrate_flat_project_slugs.py --apply # exécute
"""
import os
import sys
_BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.insert(0, _BASE_DIR)
import auth # noqa: E402
import db # noqa: E402
from auth.connection import connect as connect_auth_db # noqa: E402
from db.constants import PROJECTS_DIR # noqa: E402
from db.games.project_slug import build_slug # noqa: E402
def _flat_project_slugs() -> list[str]:
"""Slugs plats trouvés directement sous projects/ (un dossier avec
game.db à la racine, pas dans un sous-dossier propriétaire)."""
if not os.path.isdir(PROJECTS_DIR):
return []
found: list[str] = []
for entry in sorted(os.listdir(PROJECTS_DIR)):
entry_path = os.path.join(PROJECTS_DIR, entry)
if os.path.isfile(os.path.join(entry_path, "game.db")):
found.append(entry)
return found
def migrate(apply: bool = False) -> None:
slugs = _flat_project_slugs()
if not slugs:
print("Aucun projet à plat trouvé — rien à migrer.")
return
conn = connect_auth_db()
for old_slug in slugs:
game_meta = db.game_meta(old_slug)
project_part = db.slugify(game_meta["name"]) or "jeu"
new_slug = build_slug(old_slug, project_part)
owning_users = [
dict(r) for r in conn.execute("SELECT id, email FROM _users WHERE project_slug = ?", (old_slug,)).fetchall()
]
print(f"{old_slug!r} -> {new_slug!r} (comptes concernés : {[u['email'] for u in owning_users] or 'aucun'})")
if not apply:
continue
old_dir = os.path.join(PROJECTS_DIR, old_slug)
new_dir = os.path.join(PROJECTS_DIR, old_slug, project_part)
# Renommer EN PLACE (dossier propriétaire = ancien dossier projet,
# déplacé dans son propre sous-dossier) demanderait un dossier
# intermédiaire — plus sûr de passer par un nom temporaire.
tmp_dir = old_dir + ".migrating"
os.rename(old_dir, tmp_dir)
os.makedirs(os.path.dirname(new_dir), exist_ok=True)
os.rename(tmp_dir, new_dir)
for user in owning_users:
auth.set_project_slug(user["id"], new_slug)
conn.close()
if apply:
print(f"{len(slugs)} projet(s) migré(s).")
else:
print("Aperçu seulement — relance avec --apply pour exécuter.")
if __name__ == "__main__":
migrate(apply="--apply" in sys.argv)