VocabulAyr/jeu/validation.py
VocabulAyr 05335d39a6 VocabulAyr 0.03
Menu utilisateur du rail identique au mobile (Mon avatar, Paramètres, Admin, Déconnexion) ; titre du site masqué sur téléphone/tablette.
Fragment réutilisable _image_upload.html pour le fond (Paramètres) et l'avatar, à la façon BibliothequAyr ; nouvelle route POST /api/fond/ (admin, Pillow, plafond 5 Mo) ; retrait du fond via BoiteDialog.
Icônes SVG du site à la place des Bootstrap Icons jamais chargées ; les 9 favicons voyagent dans le projet.
Aucune migration ; moteur, anti-régression et journal intacts.
2026-11-08 15:32:06 +00:00

131 lines
5.8 KiB
Python
Executable file

# -*- coding: utf-8 -*-
"""Contrôle de structure des mots : le filet de sécurité du savoir.
`verifier_entree(d)` contrôle une entrée de catalogue (la forme
historique complet=True) et renvoie la liste de ses erreurs (vide si
tout va bien). `verifier_base()` contrôle tous les mots en base.
Les commandes `importer_mots`, `ajouter_mot` et `verifier_mots`
s'appuient dessus : aucune écriture sans contrôle préalable.
"""
import re
TAMPONS = {"JUNIOR", "ADOS", "SÉNIOR"}
REGISTRES = {"soutenu", "commun", "populaire"}
PISTES = {"sens", "origines", "registre", "emplois", "voisins"}
SLUG_RE = re.compile(r"^[a-z0-9]+(?:-[a-z0-9]+)*$")
# champs requis par type de mini-jeu (ce que le moteur lit dans chaque étape)
ETAPES = {
"choose": ("prompt", "items"),
"choose1": ("prompt", "items"),
"chain": ("slots", "decoys"),
"registre": ("prompt", "reponse", "pourquoi"),
"judge": ("prompt", "items"),
"sort": ("prompt", "la", "lb", "items"),
}
def _err(cond, message, erreurs, ou):
if cond:
erreurs.append(f"{ou} : {message}" if ou else message)
def verifier_entree(d, ou=""):
"""Contrôle une entrée de catalogue ; renvoie une liste d'erreurs."""
e = []
_err(not isinstance(d, dict), "entrée illisible (objet attendu)", e, ou)
if not isinstance(d, dict):
return e
slug = d.get("id") or ""
_err(not SLUG_RE.match(slug), f"identifiant suspect « {slug} »", e, ou)
for champ in ("title", "kind", "teaser", "mapNote"):
_err(not str(d.get(champ) or "").strip(), f"« {champ} » est vide", e, ou)
_err(d.get("stamp") not in TAMPONS,
f"tampon inconnu « {d.get('stamp')} » (attendus : JUNIOR, ADOS, SÉNIOR)", e, ou)
carte = d.get("card") or {}
for champ in ("def", "date", "registre", "anecdote"):
_err(not str(carte.get(champ) or "").strip(), f"card.{champ} est vide", e, ou)
etym = carte.get("etym")
_err(not isinstance(etym, list) or not etym or
not all(isinstance(x, str) and x.strip() for x in etym),
"card.etym doit être une liste non vide de textes", e, ou)
vois = carte.get("vois")
_err(not isinstance(vois, list) or
not all(isinstance(x, str) and x.strip() for x in vois),
"card.vois doit être une liste de textes", e, ou)
pistes = d.get("pistes") or {}
_err(set(pistes.keys()) != PISTES,
f"les pistes doivent être exactement {sorted(PISTES)} (trouvées : {sorted(pistes.keys())})", e, ou)
for nom, piste in pistes.items():
sous = f"{ou}/pistes.{nom}" if ou else f"pistes.{nom}"
_err(not str(piste.get("one") or "").strip(), "l'introduction (one) est vide", e, sous)
_err(not str(piste.get("reward") or "").strip(), "la récompense (reward) est vide", e, sous)
steps = piste.get("steps")
_err(not isinstance(steps, list) or not steps, "aucune étape (steps)", e, sous)
if isinstance(steps, list):
for i, s in enumerate(steps):
_verifier_etape(s, e, f"{sous}.steps[{i}]")
resolve = d.get("resolve") or {}
perles = resolve.get("beads") or {}
ok = perles.get("ok")
_err(not isinstance(ok, list) or not ok or
not all(isinstance(x, str) and x.strip() for x in ok),
"resolve.beads.ok doit être une liste non vide de textes", e, ou)
intrus = perles.get("decoys")
_err(not isinstance(intrus, list) or not intrus or
not all(isinstance(x, dict) and str(x.get("t") or "").strip()
and str(x.get("why") or "").strip() for x in intrus),
"resolve.beads.decoys doit être une liste non vide de {t, why}", e, ou)
return e
def _verifier_etape(s, e, ou):
if not isinstance(s, dict):
_err(True, "étape illisible (objet attendu)", e, ou)
return
t = s.get("type")
if t == "slider":
_err(True, "le type « slider » a été retiré : étape « registre » attendue", e, ou)
return
if t not in ETAPES:
_err(True, f"type d'étape inconnu « {t} » (attendus : {sorted(ETAPES)})", e, ou)
return
for champ in ETAPES[t]:
_err(s.get(champ) in (None, ""), f"champ « {champ} » manquant", e, ou)
if t in ("choose", "choose1", "judge", "sort"):
items = s.get("items")
# un judge peut n'apporter qu'une seule phrase à juger ;
# les autres mini-jeux ont besoin de vrais choix
minimum = 1 if t == "judge" else 2
_err(not isinstance(items, list) or len(items) < minimum,
f"au moins {minimum} proposition(s) sont attendue(s)", e, ou)
if isinstance(items, list):
n_ok = 0
for j, it in enumerate(items):
sous = f"{ou}.items[{j}]"
if t == "judge":
_err(not str(it.get("s") or "").strip(), "phrase (s) vide", e, sous)
else:
_err(not str(it.get("t") or "").strip(), "texte (t) vide", e, sous)
_err(not str(it.get("why") or "").strip(), "explication (why) vide", e, sous)
n_ok += 1 if it.get("ok") else 0
if t == "choose":
_err(n_ok < 1, "aucune bonne réponse", e, ou)
if t == "choose1":
_err(n_ok != 1, "exactement une bonne réponse attendue", e, ou)
if t == "chain":
for cle in ("slots", "decoys"):
bloc = s.get(cle)
_err(not isinstance(bloc, list) or
not all(isinstance(x, dict) and str(x.get("t") or "").strip()
and str(x.get("why") or "").strip() for x in bloc),
f"{cle} doit être une liste de {{t, why}} remplis", e, ou)
_err(not s.get("slots"), "il faut au moins un maillon juste", e, ou)
if t == "registre":
_err(s.get("reponse") not in REGISTRES,
f"réponse « {s.get('reponse')} » hors du ternaire (soutenu, commun, populaire)", e, ou)