GESTION DIPE — Plateforme de Gestion Préscolaire

GESTION DIPE est une plateforme web ultra-légère, mobile-first, conçue pour les écoles préscolaires, crèches et garderies du Sénégal et de la zone francophone (optimisée pour connexions 3G et smartphones Android d'entrée de gamme).

---

1. Arborescence du Projet

GESTION DIPE/
├── index.html                 # Landing page publique complète avec maquette interactive
├── app.html                   # Application de gestion complète (Tableau de bord, Inscriptions, Cotisations, Bilans, Reçus)
├── verify.html                # Page publique d'authentification de reçu par QR code (sans exposition de données sensibles)
├── manifest.webmanifest       # PWA manifest pour installation écran d'accueil Android/iOS
├── sw.js                      # Service Worker (mise en cache statique hors-ligne)
├── css/
│   ├── design-system.css      # Variables officielles, typographie Poppins/Inter, palette WCAG AA, reset
│   ├── landing.css            # Styles spécifiques de la landing page publique
│   ├── app.css                # Styles applicatifs, navigation bureau/mobile, table-to-card, boutons Payé/Impayé
│   └── receipt.css            # Styles du reçu officiel format A5, cachet officiel, filigrane ANNULÉ et impression
├── js/
│   ├── config.js              # Paramètres globaux, devise FCFA, cascade administrative Sénégal (Régions/Départements/Communes)
│   ├── utils.js               # Formatage FCFA, dates, montants en lettres, vrai encodeur QR code (ISO 18004), CSV sécurisé
│   ├── stamp.js               # Générateur vectoriel de cachet officiel en SVG (double contour bleu #1E3A8A)
│   ├── demo-data.js           # 30 élèves sénégalais préscolaires, 3 sections, paiements d'inscriptions et cotisations
│   ├── auth.js                # Comptes & sessions (mots de passe chiffrés PBKDF2, anti-force brute, Supabase Auth)
│   ├── cloud-sync.js          # Sauvegarde automatique dans Supabase, restauration, publication des reçus
│   ├── store.js               # Moteur de données & règles strictes de calcul (pourcentages, unicité, numérotation de reçu, audit)
│   ├── landing.js             # Interactions landing page (menu mobile, accordéons FAQ, modales, démo interactive)
│   ├── onboarding.js          # Wizard de référencement en 4 étapes avec aperçu dynamique du cachet officiel
│   └── app.js                 # Logique applicative (Dashboard, Élèves, Inscriptions, Cotisations, Bilans, Reçus, WhatsApp)
├── sql/
│   ├── 01_schema.sql          # Tables, types énumérés, contraintes CHECK et index
│   ├── 02_views_functions.sql # Vues SQL de totaux agrégés, fonction de numérotation séquentielle et RPC
│   ├── 03_rls_policies.sql    # Politiques de sécurité Row Level Security (isolation multi-écoles étanche)
│   ├── 04_seed_data.sql       # Jeu de données de démonstration SQL prêt à exécuter
│   ├── 05_expenses_and_auth_trigger.sql # Dépenses + inscription atomique d'une école
│   ├── 06_other_revenues.sql  # Autres rentrées (dons, cantine, blouses...)
│   ├── 07_security_hardening.sql # Durcissement de sécurité
│   ├── 08_synchronisation_cloud.sql # Sauvegarde en ligne + reçus vérifiables depuis tout téléphone
│   └── A_EXECUTER_DANS_SUPABASE.sql # ⚠️ Script unique (05 + 06 + 07 + 08) à coller dans Supabase
├── server.js                  # Serveur local de test sécurisé (node server.js)
└── README.md                  # Ce guide de déploiement et checklist de validation

---

2. Guide de Déploiement Pas à Pas

Option A : Test Immédiat en Mode Autonome (Zéro Dépendance)

L'application intègre un moteur autonome avec jeu de données pré-rempli (demo-data.js et store.js) :

1. Lancez node server.js puis ouvrez http://localhost:3000 (ou ouvrez directement index.html dans un navigateur moderne).
2. Vous pouvez immédiatement tester l'intégralité des flux :
   • Clic sur Payé / Impayé avec recalcul en direct.
   • Émission instantanée du reçu A5 avec cachet vectoriel officiel et QR code.
   • Partage WhatsApp pré-formaté.
   • Consultation des pages dédiées Total des inscriptions et Bilan mensuel.
   • Test de vérification du reçu en ouvrant verify.html.

Option B : Déploiement en Production avec Supabase (PostgreSQL + RLS + Auth)

Étape 1 : Création du projet Supabase

1. Rendez-vous sur supabase.com et créez un projet (région recommandée : Europe de l'Ouest ou la plus proche de l'Afrique de l'Ouest).
2. Notez votre Project URL et votre anon public key dans Project Settings > API.

以上為 README 的開頭部分。其餘內容請閱讀原文。 檢視完整 README ↗