Le schéma SQL¶

Objectif : lire le schéma SQL exact de la table des événements ; Forge garde le SQL
visible.

Ce que vous allez apprendre : get_stats_events_schema_sql retourne le
CREATE TABLE de forge_stats_events. Fidèle à la charte (principe 5), Forge Stats
n'a pas d'ORM : on lit le schéma réel.

Troisième palier du niveau débutant de la progression stats.

Module opt-in

Ce starter suppose forge-mvc-stats installé (palier « Installation »).

Ce que ce starter montre¶

get_stats_events_schema_sql() → le CREATE TABLE ;
la liste des colonnes ;
une transformation pure (on montre le SQL, on ne l'exécute pas).

Classes Forge utilisées¶

Classe / fonction	Rôle dans ce starter	Référence
`forge_mvc_stats.get_stats_events_schema_sql`	Le `CREATE TABLE` de `forge_stats_events`.	Stats
`forge_mvc_stats.STATS_EVENTS_COLUMNS`	Les colonnes de la table.	Stats

Tester¶

forge run

Ouvrez https://localhost:8000/stats-schema : le CREATE TABLE exact s'affiche.

Le contrôleur¶

# mvc/controllers/stats_schema_controller.py
from core.http.request import Request
from core.http.response import Response
from core.mvc.controller.base_controller import BaseController

from forge_mvc_stats import STATS_EVENTS_COLUMNS, STATS_EVENTS_TABLE, get_stats_events_schema_sql


class StatsSchemaController(BaseController):

    @staticmethod
    def index(request: Request) -> Response:
        return BaseController.render(
            "stats_schema/index.html",
            context={
                "table": STATS_EVENTS_TABLE,
                "columns": list(STATS_EVENTS_COLUMNS),
                "schema_sql": get_stats_events_schema_sql(),
            },
            request=request,
        )

Comprendre ce code¶

On lit le schéma réel qui sera créé en base : aucune abstraction ne le cache
(charte principe 5, « garder SQL visible »).
Exposer le SQL plutôt qu'un ORM rend le comportement auditable et prévisible.
L'application applique ce CREATE TABLE une fois (migration), puis Forge Stats y écrit.

La vue¶

<!-- mvc/views/stats_schema/index.html -->
<!DOCTYPE html>
<html lang="fr">
<head>
  <meta charset="UTF-8">
  <title>Le schéma SQL — Forge</title>
</head>
<body>
  <h1>Le schéma SQL</h1>

  <p>Table : <code>{{ table }}</code> — colonnes : <code>{{ columns | join(', ') }}</code></p>

  <p>Le <code>CREATE TABLE</code> exact (SQL visible, aucun ORM) :</p>
  <pre><code>{{ schema_sql }}</code></pre>

  <p>Vous lisez le schéma réel : Forge ne cache rien derrière un ORM (charte principe 5).</p>
</body>
</html>

La route¶

Dans mvc/routes.py, ajoutez l'import en tête de fichier et la route dans le groupe public.

# mvc/routes.py
from mvc.controllers.stats_schema_controller import StatsSchemaController

with router.group("", public=True) as public:
    public.add("GET", "/stats-schema", StatsSchemaController.index, name="stats_schema_index")

À retenir¶

get_stats_events_schema_sql montre le CREATE TABLE exact.
SQL visible, pas d'ORM (charte principe 5).
Le schéma est auditable avant toute exécution.

Après ce starter¶

Vous avez les briques (événement, schéma). La suite (intermédiaire) : enregistrer.

Bilan du niveau débutant