feat(loans): confirm declared material state changes

This commit is contained in:
SaidSoighiri94
2026-07-24 13:41:40 +02:00
parent 3739e9b0a0
commit a562b3248f
26 changed files with 1832 additions and 282 deletions
+23 -19
View File
@@ -2,7 +2,7 @@
EME est une application web de gestion des emprunts de matériel pédagogique pour ENSUP / Ensitech.
La V1 couvre le parcours étudiant : consulter le catalogue, emprunter un matériel, restituer un emprunt et détecter automatiquement les retours non conformes.
La V1 cible un parcours contrôlé : les checklists sont préremplies et les opérations sans écart restent automatiques. Toute modification déclarée par l'étudiant alerte un responsable, qui doit la confirmer avant la création d'une anomalie ou la mise à jour de l'état officiel du matériel.
## Stack
@@ -158,19 +158,21 @@ Application :
http://localhost:5000
```
## Parcours de démo V1
## Parcours cible V1
1. Ouvrir `http://localhost:5000`.
2. S'identifier avec l'option mail ENSUP ou carte étudiante.
3. Cliquer sur `Emprunter`.
4. Sélectionner un matériel disponible.
5. Valider la checklist de départ.
6. Vérifier la confirmation de l'emprunt.
7. Revenir à l'accueil.
8. Cliquer sur `Restituer`.
9. Sélectionner un emprunt en cours.
10. Valider un retour conforme ou indiquer un élément absent/détérioré.
11. Vérifier le résultat conforme ou non conforme.
5. Vérifier la checklist de départ préremplie avec l'état de référence.
6. Sans modification, l'emprunt démarre automatiquement.
7. Si un élément est modifié, le responsable est alerté et confirme ou refuse cet écart avant le départ.
8. Au retour, vérifier la checklist automatiquement préremplie avec l'état de départ validé.
9. Sans modification, la restitution est clôturée automatiquement.
10. Dès qu'un état est modifié, le responsable est alerté et doit confirmer le changement avant l'anomalie et l'état final du matériel.
11. La catégorie redevient empruntable après la clôture automatique ou la décision du responsable sur un retour modifié.
Le code actuel gère déjà les parcours automatiques. Il doit encore être adapté au préremplissage de la restitution, à la détection des modifications et à leur confirmation par le responsable ; les tâches sont détaillées dans `TODO.md`.
## Endpoints principaux
@@ -212,20 +214,22 @@ Note : dans l'environnement Codex, `flutter analyze` et `dart format` ont déjà
## État V1
Terminé pour la V1 étudiant :
Déjà implémenté :
- catalogue matériel ;
- détail matériel ;
- emprunt avec checklist de départ ;
- restitution avec checklist de retour ;
- détection automatique de retour non conforme ;
- fixtures de démonstration ;
- tests runtime manuels du parcours étudiant.
- catalogue et détail matériel ;
- checklists de départ et de retour ;
- espaces étudiant et responsable ;
- supervision, notifications, anomalies et historique ;
- SSO Microsoft Entra ID prêt à configurer, avec mode démo sécurisé ;
- fixtures de démonstration.
Reste à faire :
- authentification Azure AD réelle ;
- parcours responsable matériel ;
- préremplir la restitution avec l'état validé au départ ;
- bloquer les emprunts de même catégorie jusqu'à la clôture du retour ;
- mettre en attente uniquement les checklists modifiées et alerter le responsable ;
- ajouter les écrans responsable de confirmation des écarts ;
- valider le SSO avec les identifiants réels du tenant ENSUP ;
- OpenAPI / Swagger ;
- tests automatisés ;
- documentation utilisateur complète ;