Files
Forge-Engine/db/games/project_slug.py
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

33 lines
1.6 KiB
Python

"""Convention du slug composé "propriétaire_projet" (voir le plan
"Structure de dossiers propriétaire/projet") : un slug encode en réalité
deux segments — le dossier PROPRIÉTAIRE (slugifié depuis l'email du
compte qui a créé le projet) et le dossier PROJET à l'intérieur — pour
que projects/ soit une vraie arborescence par utilisateur
(projects/<propriétaire>/<projet>/), sans jamais toucher aux ~40 fichiers
de routes qui déclarent <slug> dans leur URL : le slug reste, pour elles,
un seul segment plat et opaque.
"_" comme séparateur est sûr et non ambigu : slugify() (voir
db/slugify.py) ne produit jamais de "_", seulement [a-z0-9-]+ — un slug
composé peut donc toujours être découpé sans collision sur la PREMIÈRE
occurrence de "_" (le dossier propriétaire, lui, n'en contient jamais).
Seule une poignée de fonctions dans db/games/ (game_dir, create_game,
move_game, list_games) savent que le slug encode ce chemin composé — si
la convention change un jour, ce fichier est le seul à modifier."""
def build_slug(owner_folder: str, project_part: str) -> str:
return f"{owner_folder}_{project_part}"
def split_slug(slug: str) -> tuple[str, str | None]:
"""(owner_folder, project_part) si `slug` est bien composé, sinon
(slug, None) — un slug "plat" (créé avant cette convention, pas encore
migré par scripts/migrate_flat_project_slugs.py) reste lisible tel
quel par le code appelant (repli sur l'ancien comportement)."""
owner_folder, sep, project_part = slug.partition("_")
if not sep:
return slug, None
return owner_folder, project_part