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
2026-08-29 19:14:19 +02:00
co-authored by Claude Sonnet 5
parent 1289079da5
commit dcbec16818
21 changed files with 398 additions and 2 deletions
+9
View File
@@ -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