Ajoute les événements personnalisés (backend) : déclencher/écouter
Première moitié de la fonctionnalité "événements" (NEED_ACTION et autres) : une entité game-wide (nom, description, "a un paramètre élément" oui/non), déclenchable comme nouvelle action du graphe de logique depuis n'importe quelle scène/modèle, et écoutable comme nouveau type de déclencheur depuis n'importe quel autre. L'UI (nouvel onglet "Événements" dans screen_edit.html, formulaires de nœud, exécution côté client dans play.html) suit dans un commit séparé. - db/custom_events/ (calqué sur db/global_vars/) : CRUD de la table _custom_events (nom unique, description, has_element_param). create_custom_event est idempotent par nom (même convention que create_global_variable) — sans risque en cas de double soumission. - screens/flow/ : 3 nouvelles colonnes sur _flow_nodes (trigger_custom_event_id/target_custom_event_id : quel événement un nœud écoute/déclenche ; target_element_from_event : indicateur réutilisable par n'importe quel nœud Action utilisant déjà target_element_id, pour résoudre "l'élément transmis par l'événement en cours" au lieu d'une cible fixe — contourne la contrainte de clé étrangère de target_element_id, qui empêche d'y stocker un sentinel comme EVENT_ROW_ID directement). Nouveau trigger_event "evenement" et action_type "declencher_evenement". - screens/custom_events/ (PAS dans db/, même séparation que screens/elements/delete_element.py) : delete_custom_event, la SEULE suppression d'entité game-wide du moteur à vraiment cascader (demande explicite) — supprime tous les nœuds/arêtes qui référencent l'événement, sur TOUTES les scènes ET tous les modèles à la fois (aucun filtre screen_id nécessaire : un modèle est un écran caché, même table _flow_nodes). list_custom_event_usages : où un événement est écouté/déclenché, pour l'onglet Événements à venir. - routes/custom_events/ : CRUD monté sous /game/<slug>/events/..., redirige vers l'éditeur de scène/modèle d'origine (screen_id transmis par le formulaire) avec l'onglet "events" à ouvrir. tests/test_custom_events.py (nouveau) : idempotence à la création, usages détectés sur deux écrans différents, suppression qui retire bien les DEUX nœuds (un sur une vraie scène, un sur un modèle/écran caché) en une seule opération, sans toucher aux écrans eux-mêmes. 207 tests au total. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
william
co-authored by
Claude Sonnet 5
Claude Sonnet 5
parent
1289079da5
commit
dcbec16818
+6
-1
@@ -55,7 +55,9 @@ from .labels.element_action_properties import (
|
||||
from .labels.element_visibility import ELEMENT_VISIBILITY_VALUES, ELEMENT_VISIBILITY_LABELS
|
||||
from .labels.data_operations import DATA_OPERATIONS, DATA_OPERATION_LABELS
|
||||
|
||||
from .flow.constants import TRIGGER_EVENTS, CONDITION_OPERATORS, CONDITION_OPERATOR_LABELS, CLICKED_ROW_ID
|
||||
from .flow.constants import (
|
||||
TRIGGER_EVENTS, CONDITION_OPERATORS, CONDITION_OPERATOR_LABELS, CLICKED_ROW_ID, EVENT_ROW_ID,
|
||||
)
|
||||
|
||||
from .rendering.render_element_html import render_element_html
|
||||
from .rendering.trigger_for import _trigger_for
|
||||
@@ -117,4 +119,7 @@ from .animations.update_animation_clip import update_animation_clip
|
||||
from .animations.delete_animation_clip import delete_animation_clip
|
||||
from .animations.animate_css_catalog import ANIMATE_CSS_CATALOG, ANIMATE_CSS_LABELS
|
||||
|
||||
from .custom_events.list_custom_event_usages import list_custom_event_usages
|
||||
from .custom_events.delete_custom_event import delete_custom_event
|
||||
|
||||
from .payload.full_game_payload import full_game_payload
|
||||
|
||||
@@ -0,0 +1,9 @@
|
||||
"""Tout ce qui touche à la fois _custom_events (db/custom_events/) ET
|
||||
_flow_nodes/_flow_edges (screens/flow/) — jamais dans db/custom_events/,
|
||||
pour la même raison que screens/elements/delete_element.py n'est pas
|
||||
dans db/ : ce sont deux domaines différents (une entité game-wide, des
|
||||
nœuds de graphe), le nettoyage croisé vit dans screens/, pas db/."""
|
||||
from .list_custom_event_usages import list_custom_event_usages
|
||||
from .delete_custom_event import delete_custom_event
|
||||
|
||||
__all__ = ["list_custom_event_usages", "delete_custom_event"]
|
||||
@@ -0,0 +1,30 @@
|
||||
import db
|
||||
from ..flow.ensure_flow_schema import ensure_flow_schema
|
||||
|
||||
|
||||
def delete_custom_event(slug, event_id):
|
||||
"""Seule suppression d'entité game-wide du moteur qui cascade
|
||||
RÉELLEMENT (demande explicite) : une variable globale ou une
|
||||
définition d'objet supprimée laisse des références pendantes
|
||||
tolérées ailleurs (voir db/global_vars/, db/definitions/) — un
|
||||
événement, lui, doit emporter avec lui TOUS ses écouteurs (nœuds
|
||||
Déclencheur, trigger_custom_event_id) et déclencheurs (nœuds Action,
|
||||
target_custom_event_id), sur TOUS les écrans ET modèles à la fois
|
||||
(aucun filtre screen_id, comme screens/elements/delete_element.py —
|
||||
un modèle est un écran caché, même table _flow_nodes)."""
|
||||
ensure_flow_schema(slug)
|
||||
conn = db.connect(slug)
|
||||
conn.execute(
|
||||
"""DELETE FROM _flow_edges WHERE from_node_id IN
|
||||
(SELECT id FROM _flow_nodes WHERE trigger_custom_event_id = ? OR target_custom_event_id = ?)
|
||||
OR to_node_id IN
|
||||
(SELECT id FROM _flow_nodes WHERE trigger_custom_event_id = ? OR target_custom_event_id = ?)""",
|
||||
(event_id, event_id, event_id, event_id),
|
||||
)
|
||||
conn.execute(
|
||||
"DELETE FROM _flow_nodes WHERE trigger_custom_event_id = ? OR target_custom_event_id = ?",
|
||||
(event_id, event_id),
|
||||
)
|
||||
conn.execute("DELETE FROM _custom_events WHERE id = ?", (event_id,))
|
||||
conn.commit()
|
||||
conn.close()
|
||||
@@ -0,0 +1,37 @@
|
||||
import db
|
||||
from ..flow.ensure_flow_schema import ensure_flow_schema
|
||||
|
||||
|
||||
def list_custom_event_usages(slug):
|
||||
"""Pour CHAQUE événement, où est-il écouté ("ecoute", nœud Déclencheur)
|
||||
et déclenché ("declenche", nœud Action) — une seule requête plutôt
|
||||
qu'une par événement, pour l'onglet Événements (screen_edit.html) qui
|
||||
les affiche tous à la fois. Aucun filtre screen_id : couvre aussi bien
|
||||
les écrans que les modèles (un modèle est un écran caché, voir
|
||||
screens/element_types/create_element_type.py), exactement comme la
|
||||
suppression en cascade (delete_custom_event.py).
|
||||
|
||||
Renvoie {event_id: [{"screen_id", "screen_name", "is_template", "role"}, ...]}."""
|
||||
ensure_flow_schema(slug)
|
||||
conn = db.connect(slug)
|
||||
rows = conn.execute(
|
||||
"""
|
||||
SELECT DISTINCT n.id AS node_id, s.id AS screen_id, s.name AS screen_name, s.is_template AS is_template,
|
||||
CASE WHEN n.trigger_custom_event_id IS NOT NULL THEN n.trigger_custom_event_id
|
||||
ELSE n.target_custom_event_id END AS event_id,
|
||||
CASE WHEN n.trigger_custom_event_id IS NOT NULL THEN 'ecoute'
|
||||
ELSE 'declenche' END AS role
|
||||
FROM _flow_nodes n
|
||||
JOIN _screens s ON s.id = n.screen_id
|
||||
WHERE n.trigger_custom_event_id IS NOT NULL OR n.target_custom_event_id IS NOT NULL
|
||||
ORDER BY s.name
|
||||
"""
|
||||
).fetchall()
|
||||
conn.close()
|
||||
usages = {}
|
||||
for row in rows:
|
||||
usages.setdefault(row["event_id"], []).append({
|
||||
"screen_id": row["screen_id"], "screen_name": row["screen_name"],
|
||||
"is_template": bool(row["is_template"]), "role": row["role"],
|
||||
})
|
||||
return usages
|
||||
@@ -21,6 +21,16 @@
|
||||
# AUTOINCREMENT SQLite).
|
||||
CLICKED_ROW_ID = -1
|
||||
|
||||
# Même principe que CLICKED_ROW_ID, pour un second contexte dynamique :
|
||||
# "la ligne de Répéteur transmise par l'événement personnalisé en cours
|
||||
# d'exécution" (voir screens/custom_events/, nœud Déclencheur
|
||||
# trigger_event="evenement") — stockable directement dans target_row_id
|
||||
# (déjà sans contrainte de clé étrangère, voir ensure_flow_schema.py) au
|
||||
# même titre que CLICKED_ROW_ID, résolu côté client (templates/play.html)
|
||||
# via window.lastEventParams.row_id au lieu de window.lastClickedRowId.
|
||||
# Valeur distincte de CLICKED_ROW_ID pour ne jamais les confondre.
|
||||
EVENT_ROW_ID = -2
|
||||
|
||||
TRIGGER_EVENTS = [
|
||||
("clic", "Au clic"),
|
||||
("soumission", "À la soumission"),
|
||||
@@ -42,6 +52,14 @@ TRIGGER_EVENTS = [
|
||||
# cacher/montrer un élément selon l'état de la partie SANS qu'un clic
|
||||
# explicite soit nécessaire pour le réévaluer.
|
||||
("affichage", "À l'affichage de l'écran"),
|
||||
# Écoute un événement personnalisé (voir screens/custom_events/),
|
||||
# déclenché depuis N'IMPORTE QUEL autre graphe (une autre scène, un
|
||||
# autre modèle) via l'action "declencher_evenement" — ni élément ni
|
||||
# écran précis : trigger_custom_event_id (quel événement) est le seul
|
||||
# réglage propre à ce nœud, retrouvé par un scan global de
|
||||
# gameData.flows côté client (voir dispatchGameEvent() dans
|
||||
# templates/play.html), au même titre que findTriggerNode().
|
||||
("evenement", "Sur un événement personnalisé"),
|
||||
]
|
||||
|
||||
CONDITION_OPERATORS = [
|
||||
@@ -69,4 +87,16 @@ FLOW_NODE_FIELDS = {
|
||||
"action_type", "target_screen_id", "target_element_id", "element_property", "element_value",
|
||||
"target_definition_id", "target_row_id", "target_field", "data_operation", "data_value",
|
||||
"target_variable",
|
||||
# Événements personnalisés (voir screens/custom_events/) : quel
|
||||
# événement un nœud Déclencheur écoute (trigger_event="evenement") ou
|
||||
# un nœud Action déclenche (action_type="declencher_evenement") —
|
||||
# target_element_id/target_row_id (déjà ci-dessus, EVENT_ROW_ID
|
||||
# compris) portent les paramètres transmis au déclenchement.
|
||||
# target_element_from_event : indicateur réutilisable par N'IMPORTE
|
||||
# QUEL nœud Action qui accepte déjà target_element_id (v1 : seule
|
||||
# "modifier_element" le supporte) — contourne la contrainte de clé
|
||||
# étrangère de target_element_id (impossible d'y stocker un sentinel
|
||||
# comme EVENT_ROW_ID sur target_row_id) en résolvant "l'élément
|
||||
# transmis par l'événement en cours" côté client à la place.
|
||||
"trigger_custom_event_id", "target_custom_event_id", "target_element_from_event",
|
||||
}
|
||||
|
||||
@@ -72,5 +72,24 @@ def ensure_flow_schema(slug):
|
||||
conn.execute("ALTER TABLE _flow_nodes ADD COLUMN cond_variable TEXT")
|
||||
if "cond_variable_chemin" not in cols:
|
||||
conn.execute("ALTER TABLE _flow_nodes ADD COLUMN cond_variable_chemin TEXT")
|
||||
if "trigger_custom_event_id" not in cols:
|
||||
# Événements personnalisés (voir screens/custom_events/) : quel
|
||||
# événement un nœud Déclencheur écoute (trigger_event="evenement")
|
||||
# ou un nœud Action déclenche (action_type="declencher_evenement").
|
||||
# Pas de FK vers _custom_events : une suppression d'événement
|
||||
# nettoie déjà ces colonnes elle-même (voir
|
||||
# screens/custom_events/delete_custom_event.py), une contrainte
|
||||
# ferait double emploi sans rien apporter de plus.
|
||||
conn.execute("ALTER TABLE _flow_nodes ADD COLUMN trigger_custom_event_id INTEGER")
|
||||
if "target_custom_event_id" not in cols:
|
||||
conn.execute("ALTER TABLE _flow_nodes ADD COLUMN target_custom_event_id INTEGER")
|
||||
if "target_element_from_event" not in cols:
|
||||
# Indicateur réutilisable par n'importe quel nœud Action qui
|
||||
# accepte déjà target_element_id (v1 : seule "modifier_element") —
|
||||
# contourne la contrainte de clé étrangère de target_element_id
|
||||
# (impossible d'y stocker un sentinel comme EVENT_ROW_ID sur
|
||||
# target_row_id) en résolvant "l'élément transmis par l'événement
|
||||
# en cours" côté client (templates/play.html) à la place.
|
||||
conn.execute("ALTER TABLE _flow_nodes ADD COLUMN target_element_from_event INTEGER NOT NULL DEFAULT 0")
|
||||
conn.commit()
|
||||
conn.close()
|
||||
|
||||
@@ -8,5 +8,6 @@ ACTION_TYPE_LABELS = {
|
||||
"ouvrir_ligne": "Ouvrir la ligne de Répéteur cliquée",
|
||||
"activer_onglet": "Afficher cet élément, masquer tous ses frères",
|
||||
"attendre": "Attendre quelques secondes avant de continuer",
|
||||
"declencher_evenement": "Déclencher un événement",
|
||||
"rien": "Ne rien faire",
|
||||
}
|
||||
|
||||
@@ -4,4 +4,5 @@ TRIGGER_LABELS = {
|
||||
"affichage": "À l'affichage de l'écran",
|
||||
"survol": "Au survol",
|
||||
"fin_survol": "Fin du survol",
|
||||
"evenement": "Sur un événement personnalisé",
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user