Klassio — SaaS de gestion scolaire

Plateforme de gestion financière et administrative pour établissements scolaires. La clarté derrière chaque établissement.

Démarrer — pour un développeur qui découvre Klassio

Tout ce qui suit a été rejoué sur un clone vierge du dépôt GitHub, le 01/10/2026 (macOS, Python 3.9). Rien ne demande une clé, un compte ou un accès à la production : le dépôt n'en contient aucun, et l'environnement de développement n'en a pas besoin.

L'architecture en une minute

	En développement	En production
Un seul serveur — Flask, backend/app.py : il sert les pages et l'API	http://localhost:5001	Render (render.yaml, Procfile)
Pages — HTML et JavaScript, sans étape de build	servies par ce même serveur	idem
Base	SQLite, un fichier local (backend/klassio_demo.db)	PostgreSQL
E-mail	capturé, rien ne part	Brevo

Il n'y a plus de second serveur de pages sur le port 4173 (retiré le 29/09) : ce montage faisait échouer les testeurs — appels perdus, « serveur injoignable », 504 derrière un proxy. Tout passe par http://localhost:5001.

Le frontend est servi tel qu'il est dans le dépôt : ni bundle ni source map. Le schéma vit dans backend/schema.sql (schema_postgres.sql en est généré) ; les migrations sont additives (db._migrate()) et s'appliquent à chaque démarrage.

Pas à pas — macOS et Linux

git clone https://github.com/Yversplayer/klassio-saas.git
cd klassio-saas
./installer.sh              # Python, dépendances, configuration, école fictive — ~2 min
./demarrer.sh --testeur     # lance Klassio ; Ctrl-C pour l'arrêter

Ouvrez http://localhost:5001 (le site) ou http://localhost:5001/app/connexion.html.

• ./demarrer.sh --reseau --testeur : accessible aussi depuis un téléphone sur le même Wi-Fi (l'adresse s'affiche au démarrage).
• ./installer.sh --recreer : remet l'école fictive à zéro.

Pas à pas — Windows

git clone https://github.com/Yversplayer/klassio-saas.git
cd klassio-saas
python -m venv backend_venv
backend_venv\Scripts\activate
pip install -r requirements-dev.txt
copy backend\.env.example backend\.env
python backend\tools\demo.py
set KLASSIO_CONTOURNER_ABONNEMENT=1
python backend\app.py

Puis http://localhost:5001. (PowerShell : $env:KLASSIO_CONTOURNER_ABONNEMENT="1" au lieu de set.)

Le mode testeur — pourquoi --testeur

Il n'existe pas de mode gratuit : une école créée par « Créer mon espace » dépose ses fichiers Excel, choisit son offre, et ne s'ouvre qu'une fois son premier paiement déclaré (ouverture provisoire de 72 h) puis confirmé par la plateforme. Le mode testeur (KLASSIO_CONTOURNER_ABONNEMENT=1) lève ces blocages pour tester le reste du logiciel : l'étape « Votre offre » affiche alors « Entrer sans payer (testeur) ». C'est un réglage du serveur, refusé si la base visée n'est pas sur votre machine. Lancez sans --testeur pour éprouver le vrai parcours payant (voir plus bas).

Au démarrage, le serveur écrit la base qu'il utilise. Vérifiez que c'est backend/klassio_demo.db : c'est la preuve que vous êtes sur les données fictives.

Les tests automatiques

backend_venv/bin/python -m unittest discover -s backend/tests -t backend    # ~3 min, SQLite
backend_venv/bin/python backend/tools/pg_tests.py                            # la même suite sur un vrai PostgreSQL 16

Le second démarre un PostgreSQL local et jetable, sans Docker, sans droits administrateur et sans réseau, puis le détruit. Les deux doivent être verts. (Windows : backend_venv\Scripts\python au lieu de backend_venv/bin/python.)

Les comptes de démonstration

demo.py crée une école fictive : 300 élèves, leurs notes, leurs présences, leurs incidents et leurs paiements. Son nom se termine par « DÉMONSTRATION » et s'affiche en tête de chaque écran. Les données sont reproductibles (graine fixe) : deux développeurs obtiennent exactement les mêmes élèves.

Mot de passe commun : ChargeKlassio2026!

Rôle	Identifiant	Ce qu'il doit voir
Direction	[email protected]	tout l'établissement : 300 élèves, finances, rapports
Directeur des disciplines	[email protected]	la discipline du jour, les absences, les appels non faits
Professeur	[email protected]	ses classes seulement — 6 sur 42
Parent	[email protected]	ses enfants seulement — 3 sur 300

Ces comptes n'existent que sur votre machine. Leurs adresses appartiennent au domaine .test, réservé : aucune n'existe réellement. Le mot de passe est publié ici précisément parce qu'aucune base réelle ne peut le recevoir : les outils de démonstration refusent toute base PostgreSQL distante.

Le plus instructif est d'essayer ce qui doit être refusé : les rapports en tant que parent, le dossier d'un enfant qui n'est pas le sien, l'équipe en tant que professeur. Le refus vient du serveur, pas d'un bouton masqué — il tient même en appelant l'API à la main.

python backend/tools/demo.py --recreer reconstruit la base à l'identique. Il refuse d'effacer un fichier qui contiendrait un seul compte hors du domaine fictif.

Le compte Direction a aussi l'accès Plateforme (rubrique Plateforme de la barre latérale) : c'est lui qui confirme ou rejette les paiements déclarés.

Tester Klassio de fond en comble

Une heure suffit pour tout voir. Cochez au fur et à mesure ; ce qui doit être refusé compte autant que ce qui doit marcher.

1. Le site et la démo — http://localhost:5001

• La landing défile jusqu'au pied de page (rideau « Prêt à commencer ? »), sur ordinateur puis en format téléphone.
• Tarifs : quatre offres ; « Choisir École » ouvre l'inscription avec École présélectionnée.
• La démo (/demo.html) : l'appel, le portail, le dossier en coupe, le mur d'écrans, puis la visite interactive.

This is the beginning of the README. Read the rest at the original. Read the full README ↗