elzed14/scolpay-benin

Paiement Scolaire Simple # 📚 ScolPay Bénin - Documentation Complète ## 🎯 Présentation du Projet **ScolPay** est une plateforme de gestion des paiements scolaires conçue pour le Bénin, permettant aux parents de payer les frais de scolarité directement aux écoles via Mobile Money (MTN & Moov), sans intermédiaire financier. ### 🌟 Vision Simplifier la gestion financière des établissements scolaires et faciliter les paiements pour les parents, tout en garantissant transparence et traçabilité. ### 🎯 Objectifs - ✅ Éliminer les files d'attente pour les paiements - ✅ Réduire les erreurs de gestion manuelle - ✅ Offrir un suivi en temps réel des paiements - ✅ Fournir des outils de recouvrement intelligents - ✅ Générer des statistiques financières pour les écoles --- ## 🚀 Fonctionnalités Principales ### 👨‍👩‍👧 Pour les Parents - 🔍 **Recherche d'élève** par matricule - 💳 **Paiement Mobile Money** (MTN, Moov) - 📄 **Reçu PDF instantané** - 📱 **Application mobile** (PWA installable) - 📴 **Mode hors ligne** avec synchronisation automatique ### 🏫 Pour les Écoles - 📊 **Dashboard financier élite** avec KPIs visuels - 👥 **Gestion des élèves** (CRUD, import Excel) - 💰 **Validation des paiements** en temps réel - 🎫 **Génération de cartes ID** avec QR codes - 📢 **Module de recouvrement** (détection impayés, SMS) - 📈 **Graphiques et statistiques** (Recharts) - 🔔 **Alertes automatiques** (top débiteurs) ### 👔 Pour les Administrateurs - 🏢 **Gestion des écoles** (validation, suspension) - 💼 **Gestion des abonnements** (4 tiers) - 📊 **Surveillance globale** (métriques plateforme) - 🔐 **Contrôle d'accès** et sécurité --- ## 🏗️ Architecture Technique ### Frontend - **Framework** : Next.js 16.1.1 (App Router, Turbopack) - **UI Library** : Tailwind CSS + Shadcn/ui - **Icons** : Lucide React - **Charts** : Recharts - **PWA** : Service Worker + Web App Manifest - **Offline** : IndexedDB via custom hooks ### Backend - **Database** : Supabase (PostgreSQL) - **Authentication** : Supabase Auth (Email/Password) - **St …