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>

screens/flow/constants.py

@@ -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",
 }

screens/flow/ensure_flow_schema.py

@@ -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()