Forge — Starter Apps

Accueil Retour

Forge · Parcours applicatifs

Starter apps

Des parcours progressifs pour apprendre Forge avec JSON canonique, SQL visible, contrôleurs explicites et routes ajoutées manuellement.

Les starters sont d'abord des parcours pédagogiques. La génération automatique par forge starter:build est disponible pour les quatre starters.

Vue D'ensemble

Niveau	Starter	Objectif	Concepts
1	Contacts	Créer un CRUD complet sur une seule entité	make:entity, make:crud, formulaires, flash
2	Utilisateurs / authentification	Comprendre login, logout, sessions et routes protégées	sessions, CSRF, routes publiques/protégées
3	Carnet de contacts	Lire un modèle relationnel explicite	many_to_one, relations.json, JOIN SQL
4	Suivi pédagogique	Vitrine Forge complète avec auth, relations et dashboard	auth, routes protégées, many_to_one, seed de démo

Génération Automatique

forge starter:list
forge starter:build 1
forge starter:build contacts
forge starter:build contact-simple
forge starter:build 2
forge starter:build auth
forge starter:build utilisateurs-auth
forge starter:build 3
forge starter:build carnet
forge starter:build carnet-contacts
forge starter:build 4
forge starter:build suivi
forge starter:build suivi-comportement-eleves

Les alias 1, contacts et contact-simple ciblent le même starter Contacts. Les alias 2, auth, utilisateurs et utilisateurs-auth ciblent le starter Utilisateurs / authentification. Les alias 3, carnet et carnet-contacts ciblent le starter Carnet de contacts. Les alias 4, suivi et suivi-comportement-eleves ciblent le starter Suivi pédagogique.

• Parcours

  ---

  Les pages starter-app-XX.md expliquent les choix, le modèle et les étapes.

• Reconstruction

  ---

  Les fichiers rebuild.md servent à reconstruire vite, sans répéter toute la pédagogie.

• Génération

  ---

  La commande forge starter:build automatise les quatre starters. Utilisez forge starter:list pour voir les alias disponibles.

Préparer Un Projet

git clone --branch v1.3.0 --depth=1 https://github.com/caucrogeGit/Forge.git NomDuProjet
cd NomDuProjet
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install -e .
cp env/example env/dev
forge doctor
forge db:init

Adaptez env/dev avant forge db:init si vos identifiants MariaDB ou mots de passe diffèrent.

Règles Communes

• Les entités vivent dans mvc/entities/<entite>/<entite>.json.
• forge build:model régénère les projections SQL et *_base.py.
• Les fichiers manuels existants ne sont jamais écrasés.
• forge make:crud génère un squelette modifiable, pas une administration automatique.
• Les routes affichées par make:crud sont à copier manuellement dans mvc/routes.py.
• Les relations directes supportées en V1 sont many_to_one.
• Le many-to-many passe par une entité pivot explicite.

Fichiers De Reconstruction

Chaque starter dispose aussi d'un dossier de référence minimal :

Starter	README	Reconstruction
Contacts	README	rebuild.md
Utilisateurs / authentification	README	rebuild.md
Carnet de contacts	README	rebuild.md
Suivi pédagogique	README	rebuild.md