Variables globales Objet/Tableau, lisibles via un chemin dans les conditions et filtres

Deux nouveaux types de variable globale (db/constants.py) : "objet" et
"tableau" — valeur stockée en JSON (colonne TEXT existante), avec
validation à la création/modification (db/global_vars/
coerce_structured_value.py) : un JSON invalide retombe sur un défaut sûr
("{}"/"[]") plutôt que de corrompre silencieusement la variable pour
toutes ses lectures suivantes. apply_variable_action.py n'a besoin
d'aucun changement — "definir_texte" écrit déjà n'importe quelle chaîne
telle quelle.

Nouvelle résolution de chemin, partagée (screens/rendering/
filter_repeater_rows.py::_resolve_variable_path) : navigue dans la
valeur JSON d'une variable selon un chemin ".champ"/"[index]" chaînable
(ex. ".arme.degats", "[0].valeur") — ne lève jamais, renvoie None si le
JSON est invalide ou qu'un segment du chemin ne correspond à rien.
Branchée à deux endroits, qui lisaient déjà une variable globale :

- La valeur de comparaison {{$nom_variable}} (filtres de Répéteur ET
  Condition de visibilité, qui partagent le même
  _resolve_filter_value()) accepte maintenant un chemin optionnel :
  {{$perso.nom}}, {{$scores[0]}}. Le sélecteur "Variable globale" du
  panneau de propriétés (screen_edit.html, .filterValueVariable) gagne un
  champ "Chemin optionnel" à côté du choix de variable — même regex
  étendue côté JS (_VAR_REF_RE) que côté Python (_VAR_REF_PATTERN), pour
  que la valeur round-trip correctement à la réouverture du panneau.

- La variable VÉRIFIÉE par une Condition de visibilité en mode "variable"
  (choisie via un <select>, pas la syntaxe {{$...}}) gagne son propre
  nouveau contrôle "Chemin dans la variable" (visibility_condition_
  controls.py) — nécessaire pour comparer un champ d'un Objet ou un
  élément d'un Tableau, pas seulement la variable entière.

game_dashboard.html (onglet Variables) : la valeur par défaut de la barre
de création devient un <textarea> (fonctionne aussi bien pour un JSON
multi-ligne qu'un scalaire court), et la cellule "Valeur" du tableau des
variables existantes devient un <textarea> quand le type est objet/
tableau.

4 nouveaux tests (tests/test_variable_object_array.py) : validation JSON
à la création, filtre de Répéteur avec chemin chaîné, condition de
visibilité avec accès par index de tableau, chemin invalide/absent sans
plantage.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
william
2026-08-27 14:28:23 +02:00
co-authored by Claude Sonnet 5
parent b21f56e364
commit aaf9954446
10 changed files with 237 additions and 19 deletions
+7 -1
View File
@@ -18,10 +18,16 @@ FIELD_TYPES = {
# Types disponibles pour une variable globale (voir db/global_vars/) — un
# sous-ensemble de FIELD_TYPES : ni "relation" (une variable globale n'a pas
# d'objet à pointer) ni "texte_long"/"date" (pas gérés par
# apply_variable_action.py, qui ne coerce que ces 4 types).
# apply_variable_action.py, qui ne coerce que ces 4 types). "objet"/
# "tableau" sont, eux, propres aux variables (pas de colonne SQL réelle,
# contrairement à un champ d'objet) : la valeur est stockée telle quelle
# (colonne TEXT) sous forme de JSON, lue via un chemin ".champ"/"[index]"
# (voir _resolve_variable_path dans screens/rendering/filter_repeater_rows.py).
GLOBAL_VARIABLE_TYPES = {
"texte": FIELD_TYPES["texte"],
"nombre_entier": FIELD_TYPES["nombre_entier"],
"nombre_decimal": FIELD_TYPES["nombre_decimal"],
"booleen": FIELD_TYPES["booleen"],
"objet": {"label": "Objet (JSON)"},
"tableau": {"label": "Tableau (JSON)"},
}
+21
View File
@@ -0,0 +1,21 @@
import json
def coerce_structured_value(var_type, value):
"""Pour une variable "objet"/"tableau" (voir db/constants.py), la
valeur stockée doit rester du JSON analysable — sinon la prochaine
lecture (_resolve_variable_path, screens/rendering/
filter_repeater_rows.py) échouerait silencieusement à chaque fois.
Un JSON invalide retombe donc sur un défaut sûr ("{}"/"[]") plutôt que
d'être stocké tel quel. Les autres types ne sont jamais touchés ici."""
if var_type not in ("objet", "tableau"):
return value
text = (value or "").strip()
fallback = "{}" if var_type == "objet" else "[]"
if not text:
return fallback
try:
json.loads(text)
except (TypeError, ValueError):
return fallback
return text
+2
View File
@@ -1,5 +1,6 @@
from ..connection import connect
from .ensure_global_vars_schema import ensure_global_vars_schema
from .coerce_structured_value import coerce_structured_value
def create_global_variable(slug, name, var_type="texte", default_value=""):
@@ -11,6 +12,7 @@ def create_global_variable(slug, name, var_type="texte", default_value=""):
name = (name or "").strip()
if not name:
return None
default_value = coerce_structured_value(var_type, default_value)
ensure_global_vars_schema(slug)
conn = connect(slug)
existing = conn.execute("SELECT id FROM _global_variables WHERE name = ?", (name,)).fetchone()
+9 -7
View File
@@ -1,16 +1,18 @@
from ..connection import connect
from .ensure_global_vars_schema import ensure_global_vars_schema
from .coerce_structured_value import coerce_structured_value
def update_global_variable(slug, var_id, var_type, value):
"""Modifie le type et la valeur d'une variable existante depuis la page
de gestion (voir game_variables.html) — le NOM reste volontairement
immuable après création : c'est par ce nom qu'une condition de
visibilité ou une action "Modifier une variable" la référence (voir
get_global_variable.py), la renommer casserait ces réglages en
silence."""
"""Modifie le type et la valeur d'une variable existante depuis le
tableau de bord (onglet Variables, game_dashboard.html) — le NOM reste
volontairement immuable après création : c'est par ce nom qu'une
condition de visibilité ou une action "Modifier une variable" la
référence (voir get_global_variable.py), la renommer casserait ces
réglages en silence."""
value = coerce_structured_value(var_type, str(value))
ensure_global_vars_schema(slug)
conn = connect(slug)
conn.execute("UPDATE _global_variables SET type = ?, value = ? WHERE id = ?", (var_type, str(value), var_id))
conn.execute("UPDATE _global_variables SET type = ?, value = ? WHERE id = ?", (var_type, value, var_id))
conn.commit()
conn.close()