Vue d'ensemble

EPTM Dashboard est une application de gestion des absences, notes, bulletins, avis (retenue / sanction) et notices pour l'École professionnelle technique et des métiers (EPTM Sion). Elle se synchronise avec Escadaweb (le système de notation cantonal) pour récupérer et pousser les données.

À quoi sert l'application

Visualiser les absences, BN, notes d'examen, notices et fiches personnelles par apprenti ou par classe.
Excuser ou modifier les absences manuellement (les changements sont mis en file d'attente avant d'être renvoyés à Escada).
Créer des avis de retenue et de sanction au format PDF (templates AcroForm pré-remplis) — l'avis est aussi envoyé en notice vers Escada.
Récupérer / pousser les notices Escada (création, lecture, statut).
Automatiser les imports/exports via des tâches planifiées (cron) avec notifications Telegram.
Envoyer par email un récap d'absences (+ bulletin + notes) à l'apprenti, au formateur ou à une adresse libre.
Tracer qui a modifié quoi (audit log complet + champ updated_by sur chaque entité).
Collecter du feedback in-app via un widget chat (admin reçoit un email + dialogue de réponse).
Gérer les droits utilisateur : restriction d'accès par classe, self-service via identifiants Escada de l'utilisateur.

Modèle de données simplifié

Apprenti ── Absence (statut : a_traiter, excusee, ...)
        ├── ApprentiFiche (adresse, entreprise, formateur, représentant
        │                  légal, compensation des désavantages, majeur/mineur)
        ├── NotesBulletin (BN par semestre)
        ├── NotesMatu (Matu pro)
        ├── NotesExamen (notes d'examen)
        ├── ApprentiNotice (notices importées depuis Escada)
        └── Notice (notices locales, file de push vers Escada)

EscadaPending : file d'attente des modifications d'absences locales à
                pousser vers Escada (action ∈ {"E", "N", "clear"})

Import / ImportBN / ImportMatu : trace des imports PDF effectués

CronJob : tâches planifiées (push, sync, push+sync) — schedules
          daily_multi (plusieurs heures/jour) ou weekly

FeedbackMessage : feedback in-app (bug / proposition) — statut new /
                  in_progress / resolved + réponse admin

Architecture technique

Frontend : Reflex 0.9.2 (Python full-stack, Radix Themes, lucide-react icons)
DB : SQLite mode WAL, à data/absences.db
Scraping Escada : Playwright (sync API), dans scripts/sync_esacada.py, scripts/push_to_escada.py, scripts/push_notices.py, scripts/pull_notices.py, scripts/fetch_user_classes.py
Parsing PDF : src/parser.py (absences), src/parser_bn.py (bulletins), src/parser_matu.py (matu)
Génération avis PDF : src/sanction_pdf.py, src/retenue_pdf.py (templates AcroForm dans data/templates/)
Conteneurisation : Docker Compose, derrière nginx-proxy-manager (NPM, containerisé depuis mai 2026)
Cron : OS cron déclenche scripts/cron_tick.py toutes les minutes, qui consulte la table CronJob
Emails : SMTP (Brevo en prod), templates configurables depuis /params

Pages disponibles

Page	Route	user	admin
Tableau de bord	`/accueil`	✅	✅
Classes	`/classe`	✅*	✅
Apprentis	`/fiche`	✅*	✅
Documentation	`/doc`	✅	✅
Mon profil	`/profile`	✅	✅
Escada (sync / push)	`/escada`	❌	✅
Tâches planifiées	`/cron`	❌	✅
Logs	`/logs`	❌	✅
Utilisateurs	`/users`	❌	✅
Paramètres	`/params`	❌	✅
Feedback	`/feedback`	❌	✅
Purger classe	`/purge`	❌	✅

✅* : restriction par allowed_classes (l'utilisateur ne voit que ses classes autorisées). Si la liste est vide, un dialogue d'enrôlement obligatoire s'affiche à chaque navigation (cf. doc « Authentification »).

Sidebar — version & profil

La version (dernier tag git ou contenu de data/VERSION) s'affiche au-dessus du widget profil. À mettre à jour manuellement après un nouveau tag : éditer data/VERSION puis docker restart eptm-dashboard-app-1.
Le widget profil ouvre un popover avec « Mon profil » + « Déconnexion ».
Le bouton feedback flotte en bas-droite de l'écran (FAB) : ouvre la modale chat pour signaler un bug ou proposer une idée.

4.7 KiB Raw Blame History