Forge-Engine/game_engine/scenes/ensure_scene_schema.py

import db


def ensure_scene_schema(slug: str) -> None:
    """Crée _scene_objects si nécessaire — le contenu d'une scène pour un
    jeu "jeu_2d" (voir db/games/get_game_type.py), équivalent de
    _screen_elements pour un jeu "document" mais en coordonnées PIXEL
    fixes (pas des % fluides — indispensable pour la collision/
    l'animation), sans arbre de nesting (pas de conteneurs imbriqués dans
    une scène de jeu 2D)."""
    conn = db.connect(slug)
    conn.executescript(
        """
        CREATE TABLE IF NOT EXISTS _scene_objects (
            id INTEGER PRIMARY KEY AUTOINCREMENT,
            scene_id INTEGER NOT NULL REFERENCES _screens(id) ON DELETE CASCADE,
            kind TEXT NOT NULL DEFAULT 'personnage',
            name TEXT,
            x REAL NOT NULL DEFAULT 100,
            y REAL NOT NULL DEFAULT 100,
            width REAL NOT NULL DEFAULT 128,
            height REAL NOT NULL DEFAULT 128,
            z_index INTEGER NOT NULL DEFAULT 1,
            attributes TEXT NOT NULL DEFAULT '{}',
            created_at TEXT DEFAULT CURRENT_TIMESTAMP
        );
        """
    )
    conn.commit()
    conn.close()