Aide-mémoire de la progression Stats¶
Récapitulatif des paliers de la progression Bonjour Forge Stats et des API du module
opt-in forge-mvc-stats introduites à chaque étape.
Module opt-in — SQL visible
forge-mvc-stats est publié sur PyPI : pip install --pre forge-mvc-stats. Il
expose le SQL réel (schéma, insert, select) — aucun ORM (charte principe 5) — et
s'appuie sur des exécuteurs injectables (execute, fetch_all), donc testable
sans base réelle.
Niveau débutant — l'événement & le schéma¶
| # | Palier | Ce qu'on apprend | API-clé |
|---|---|---|---|
| 1 | Bonjour Forge Stats | Créer un événement, inspecter table/colonnes | make_event, STATS_EVENTS_TABLE |
| 2 | Nom d'événement | Normaliser/valider un nom | normalize_event_name, validate_event_name |
| 3 | Le schéma SQL | Lire le CREATE TABLE |
get_stats_events_schema_sql |
Niveau intermédiaire — enregistrer¶
| # | Palier | Ce qu'on apprend | API-clé |
|---|---|---|---|
| 1 | Le SQL d'insertion | Voir l'INSERT et ses valeurs |
get_track_event_sql, prepare_track_event_values |
| 2 | Enregistrer un événement | Tracker via un exécuteur injecté | track_event |
| 3 | Valider un événement | Refuser avant d'écrire | make_event, validate_event |
Niveau avancé — consulter¶
| # | Palier | Ce qu'on apprend | API-clé |
|---|---|---|---|
| 1 | Le SQL de consultation | Voir le SELECT filtrable |
get_stats_events_admin_sql |
| 2 | Lister les événements | Lire via fetch_all injecté |
list_stats_events |
| 3 | Normaliser une ligne | Ligne brute → dict propre | normalize_stats_event_row |