Starters Forge¶

Forge · Parcours applicatifs

Apprendre Forge, palier par palier

Le parcours cœur pour les fondamentaux, puis un parcours par fonctionnalité pour chaque opt-in.

Qu'est-ce qu'un starter ?¶

Un starter est un parcours d'apprentissage que l'on réalise à la main en suivant la documentation.
Chaque palier montre le contrôleur, la vue et la route à créer pour comprendre une mécanique.
Un starter n'est pas un profil : voir Profil ou starter ?.

Par où commencer

Commencez par le parcours cœur ci-dessous, dans l'ordre, depuis Bonjour Forge.
Abordez les fonctionnalités (opt-ins) une fois les fondamentaux acquis.

Progression recommandée¶

Le parcours cœur welcome-forge est un tutoriel continu : un seul projet qui grandit palier après palier.
Les 11 paliers des fondamentaux, dans l'ordre :

Bonjour Forge : afficher une réponse texte avec Response.text(...). Suivre
Paramètres d'URL : lire une valeur avec request.query(...). Suivre
Première vue HTML : rendre une page avec BaseController.render(...). Suivre
Route dynamique : lire un paramètre comme /articles/{id}. Suivre
Inspecter une requête : explorer request.data avec Response.debug(...). Suivre
Réponse JSON : retourner des données avec Response.json(...). Suivre
Le jeton CSRF : la protection CSRF des formulaires. Suivre
Premier formulaire POST : envoyer des données depuis un formulaire. Suivre
Validation serveur : refuser ou accepter les données reçues. Suivre
Première base SQL : lire une donnée (MariaDB, migrations, SQL visible). Suivre
Écrire en base : insérer une ligne avec db.insert(...). Suivre

Le parcours cœur se poursuit ensuite avec les listes et la pagination, puis les relations et l'API JSON protégée.

Parcours par fonctionnalité¶

Chaque opt-in a son propre parcours d'apprentissage. Suivez-le quand vous ajoutez la fonctionnalité à votre projet.

Sécurité et accès¶

MFA : ajouter l'authentification multi-facteurs (TOTP, codes de récupération).
RBAC : rôles et permissions déclaratives.
Audit : journaliser les actions sensibles.

Données et persistance¶

Settings : paramètres applicatifs persistés.
Jobs : tâches de fond adossées à la base SQL.
Notifications : notifications in-app.
Import/Export CSV : importer et exporter des données.
Statistiques : compter et agréger des événements.
Pivot : tables pivot enrichies many_to_many.

Médias et fichiers¶

Fichiers : upload et service de fichiers sécurisés.
Images : traitement et galeries d'images.
Audio : upload, transcodage et lecture audio.
Vidéo : upload, transcodage et lecture vidéo.

Contenu et communication¶

Mail : envoyer des courriels.
i18n : internationaliser l'application.
QR Code : générer des QR Codes servables.

Applicatif et exploitation¶

Workflow : statuts et transitions.
Admin : back-office applicatif.
IoT : recevoir et exposer des données IoT.
Déploiement : préparer la mise en production.

Outils et infrastructure¶

Infrastructure de test : tester Forge et ses opt-ins.
Helpers : raccourcis et utilitaires applicatifs.
Markdown : rendre du contenu Markdown.

Catalogue des paquets et de leur API : Packages opt-in.

Profil ou starter ?¶

Un profil définit la base technique d'un projet créé avec forge new (forge new MonProjet --profile standard).
Un starter fournit un exemple applicatif que l'on construit après la création du projet.

Ils sont indépendants : un profil ne remplace pas un starter, un starter ne modifie pas le profil, et un starter peut illustrer un ou plusieurs profils.
Pour choisir un profil : Profils de projet.

Comment suivre un starter¶

Un starter se suit à la main, palier par palier : chaque palier indique le contrôleur, la vue et la route à créer.

Les starters ne se génèrent pas

Forge ne génère pas les starters et n'écrit jamais dans votre mvc/routes.py.
Vous créez vous-même chaque fichier et ajoutez chaque route, en suivant la documentation du palier (voir ADR-035).