# Guide d’utilisation — AubaineservicePro School

## Démarrage

Ouvrez `index.html` dans Chrome, Edge ou Firefox. Connectez-vous lors du premier démarrage avec **admin / admin123**. Changez immédiatement ce mot de passe dans le menu du profil, en haut à droite. Pour profiter de l’installation PWA et du cache hors ligne, servez le dossier via HTTPS ou un serveur HTTP local (voir `README.md`).

Les données sont conservées **sur cet appareil, dans ce navigateur**. Ne videz pas les données du site sans avoir téléchargé une sauvegarde JSON. Un autre appareil ou navigateur ne verra pas automatiquement ces données.

## Parcours conseillé

1. **Paramètres → Établissement** : importez le logo original (PNG, JPEG, WebP ou SVG de 2 Mo maximum), puis renseignez le nom, l’adresse, le téléphone et la devise.
2. **Paramètres → Années scolaires** : choisissez l’année de travail.
3. **Classes** : créez les niveaux, sections et capacités.
4. **Cours** : définissez les matières, coefficients et professeurs.
5. **Élèves** : créez les dossiers puis inscrivez-les dans une classe. Le matricule est attribué automatiquement.
6. **Frais** : définissez les tarifs par classe et année.
7. **Paiements** : encaissez les versements, imprimez les reçus et consultez le solde dans le dossier de l’élève.
8. **Notes** : choisissez classe, session et cours ; saisissez les cotes et imprimez les bulletins.
9. **Présence** : sélectionnez classe et date ; pointez présence, absence ou retard.
10. **Rapports** : générez les états puis exportez en CSV ou imprimez en PDF via le navigateur.

## Fonctions pratiques

- **Recherche globale** : `Ctrl+K` (ou `Cmd+K` sur Mac).
- **Recherche dans les tableaux** : saisissez un nom, matricule ou référence.
- **Tableaux** : cliquez sur un en-tête de colonne pour trier.
- **Sauvegarde** : Paramètres → Sauvegardes → Télécharger une sauvegarde JSON. Conservez-la à l’extérieur du navigateur.
- **Restauration** : Paramètres → Sauvegardes → Restaurer une sauvegarde. Les entrées de même identifiant sont fusionnées.
- **Thème sombre** : bouton d’apparence dans la barre supérieure.
- **Téléphone** : menu en bas de l’écran ; bouton « Plus » pour accéder à tous les modules.

## Profils

Les rôles sont super administrateur, administrateur, directeur, secrétaire, comptable, professeur, élève et parent. Les comptes se créent dans **Utilisateurs** (administrateurs uniquement). Les restrictions d’interface de la version locale ne constituent **pas** une protection serveur pour une publication multi-utilisateur.

## Synchronisation et hébergement

L’application statique peut être hébergée sur un serveur HTTPS (Cloudflare Pages, par exemple) sans commande de compilation. **Héberger l’interface ne transforme pas le stockage local en base partagée**. La synchronisation Supabase expérimentale nécessite un projet Supabase, un schéma compatible, des politiques RLS strictes et une authentification serveur par établissement. **Ne configurez pas une clé `service_role` ni une base contenant de vraies données d’élèves dans la version statique actuelle.** Aucun déploiement distant n’a été effectué.

## Dépannage

- Si la page ne charge pas, servez le dossier avec `python -m http.server 8765` puis visitez `http://localhost:8765`.
- Si un navigateur est en mode privé, ses données locales peuvent disparaître à la fermeture.
- Si la synchronisation échoue, l’application continue en local ; téléchargez une sauvegarde JSON.
- Si l’impression ne s’ouvre pas, autorisez les fenêtres contextuelles pour le site.
