Flux — Présence (Attendance)

Guide pratique : qui fait quoi, dans quel ordre. Pas de détail technique ici — voir la documentation technique du site si besoin.

1. Scan à l'entrée par un agent/chaperon

Qui : Agent de sécurité ou chaperon (accès par code PIN, pas un compte admin)

1. L'agent se connecte avec son code PIN sur l'écran de scan.
2. Scanne le badge (QR code) de l'étudiant.
3. L'écran affiche Autorisé (vert) ou Refusé (rouge, avec le motif) + la photo de l'étudiant.
4. L'agent compare la photo à la personne devant lui — un scan vert garantit seulement que le badge est authentique, pas que la personne est la bonne.
5. Si la photo ne correspond pas → flux 3 (annulation).

2. Scan depuis le tableau de bord admin

Qui : Admin autorisé à scanner

Même écran que le flux 1, mais accessible depuis un compte admin classique plutôt qu'un code PIN.

3. Annulation d'un scan (erreur de badge)

Qui : Agent, chaperon ou admin

1. Sur un scan qui vient d'afficher "Autorisé", clique sur « Ce n'est pas la bonne personne ? »
2. Indique un motif obligatoire → confirme.
3. Le scan passe en statut "Annulé" — il ne compte plus dans les statistiques de présence, mais reste visible dans l'historique (rien n'est effacé).

sequenceDiagram
    participant Agent
    Agent->>Agent: Scanne le badge
    Agent->>Agent: Badge vert + photo affichée
    Agent->>Agent: Remarque un décalage → "Annuler ce scan"
    Agent->>Agent: Indique un motif, confirme
    Agent->>Agent: Le scan passe en "Annulé"

4. Envoi de badges (QR codes) aux étudiants

Qui : Admin

Trois façons de choisir les destinataires :

1. Par classe (avec filtres campus/année optionnels).
2. Liste précise d'étudiants — via un fichier, en collant une liste, ou en recherchant chaque étudiant par son nom.
3. Un seul étudiant — recherche par nom, aperçu du badge, puis envoi (au mail habituel de l'étudiant, ou à une adresse personnelle) ou téléchargement direct.

Dans tous les cas, un aperçu des destinataires est obligatoire avant de confirmer l'envoi, pour éviter d'envoyer à la mauvaise liste. L'envoi se fait en arrière-plan — la confirmation affichée signifie "l'envoi a été lancé", pas "le mail est arrivé".

Par défaut, les étudiants diplômés ou suspendus sont exclus de l'envoi (suite à un incident où des diplômés continuaient à recevoir des badges). Deux cases à cocher permettent de les inclure quand même si c'est vraiment nécessaire (ex. renvoyer un badge juste après avoir annulé un diplôme par erreur).

5. Gestion des agents et chaperons

Qui : Admin

1. Création : nom + campus (optionnel) + rôle (agent ou chaperon) → un code PIN est affiché une seule fois, à communiquer immédiatement à la personne concernée.
2. Révocation (réversible) ou suppression définitive (l'historique des scans déjà faits par cette personne est conservé).
3. Réinitialisation du code PIN si perdu ou compromis.

6. Suivi et historique

Qui : Admin

• Vue d'ensemble des statistiques de présence sur une période (taux de présence, refus, tendances).
• Suivi par personne : qui a scanné quoi, avec possibilité de descendre jusqu'au détail d'un étudiant précis.

7. Import des photos étudiants

Qui : Admin (import par fichier) ou uniquement le superadmin (import depuis l'intranet Epitech)

• Par fichier : un fichier photo par étudiant, import en masse.
• Depuis l'intranet Epitech (superadmin uniquement) : colle temporairement un identifiant de session personnel pour récupérer automatiquement la photo de tous les étudiants qui n'en ont pas encore. Cet identifiant n'est jamais conservé, à ressaisir à chaque import.