9 Commits

Author SHA1 Message Date
SaidSoighiri94 1b6f859074 merge: responsable table scrollbars 2026-07-24 16:43:32 +02:00
SaidSoighiri94 d02d47fb87 fix(responsable): show horizontal table scrollbars 2026-07-24 16:40:08 +02:00
SaidSoighiri94 c03df5e810 merge: responsable supervision tables 2026-07-24 16:13:27 +02:00
SaidSoighiri94 368cd633c5 fix(responsable): refresh after discrepancy decision 2026-07-24 16:02:20 +02:00
SaidSoighiri94 38efe6a873 feat(responsable): add anomaly and history tables 2026-07-24 15:47:48 +02:00
SaidSoighiri94 ec36349bad feat(responsable): add material stock table 2026-07-24 15:22:58 +02:00
SaidSoighiri94 5121cac657 feat(responsable): improve loan supervision table 2026-07-24 15:00:16 +02:00
SaidSoighiri94 4ee593c8d4 feat(frontend): improve application feedback messages 2026-07-24 14:08:55 +02:00
SaidSoighiri94 a562b3248f feat(loans): confirm declared material state changes 2026-07-24 13:41:40 +02:00
31 changed files with 5125 additions and 445 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. 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 ## Stack
@@ -158,19 +158,21 @@ Application :
http://localhost:5000 http://localhost:5000
``` ```
## Parcours de démo V1 ## Parcours cible V1
1. Ouvrir `http://localhost:5000`. 1. Ouvrir `http://localhost:5000`.
2. S'identifier avec l'option mail ENSUP ou carte étudiante. 2. S'identifier avec l'option mail ENSUP ou carte étudiante.
3. Cliquer sur `Emprunter`. 3. Cliquer sur `Emprunter`.
4. Sélectionner un matériel disponible. 4. Sélectionner un matériel disponible.
5. Valider la checklist de départ. 5. Vérifier la checklist de départ préremplie avec l'état de référence.
6. Vérifier la confirmation de l'emprunt. 6. Sans modification, l'emprunt démarre automatiquement.
7. Revenir à l'accueil. 7. Si un élément est modifié, le responsable est alerté et confirme ou refuse cet écart avant le départ.
8. Cliquer sur `Restituer`. 8. Au retour, vérifier la checklist automatiquement préremplie avec l'état de départ validé.
9. Sélectionner un emprunt en cours. 9. Sans modification, la restitution est clôturée automatiquement.
10. Valider un retour conforme ou indiquer un élément absent/détérioré. 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. Vérifier le résultat conforme ou non conforme. 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 ## Endpoints principaux
@@ -212,20 +214,22 @@ Note : dans l'environnement Codex, `flutter analyze` et `dart format` ont déjà
## État V1 ## État V1
Terminé pour la V1 étudiant : Déjà implémenté :
- catalogue matériel ; - catalogue et détail matériel ;
- détail matériel ; - checklists de départ et de retour ;
- emprunt avec checklist de départ ; - espaces étudiant et responsable ;
- restitution avec checklist de retour ; - supervision, notifications, anomalies et historique ;
- détection automatique de retour non conforme ; - SSO Microsoft Entra ID prêt à configurer, avec mode démo sécurisé ;
- fixtures de démonstration ; - fixtures de démonstration.
- tests runtime manuels du parcours étudiant.
Reste à faire : Reste à faire :
- authentification Azure AD réelle ; - préremplir la restitution avec l'état validé au départ ;
- parcours responsable matériel ; - 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 ; - OpenAPI / Swagger ;
- tests automatisés ; - tests automatisés ;
- documentation utilisateur complète ; - documentation utilisateur complète ;
+50
View File
@@ -0,0 +1,50 @@
# Parcours utilisateur validé
Ce diagramme remplace le PNG historique `parcour_utilisateur.png`, qui décrit
partiellement l'ancien workflow automatique.
```mermaid
flowchart TD
A[Identification étudiant] --> B{Action}
B -->|Emprunter| C[Sélection du matériel]
C --> D{Même catégorie déjà bloquée ?}
D -->|Oui| E[Demande refusée]
D -->|Non| F[Checklist de départ<br/>préremplie avec l'état de référence]
F --> G{État modifié ?}
G -->|Non| H[Matériel EMPRUNTE<br/>Emprunt EN_COURS]
G -->|Oui| I[Matériel RESERVE<br/>Emprunt EN_ATTENTE_VALIDATION_DEPART]
I --> J[Alerte responsable du campus]
J --> K{Confirmation de l'écart}
K -->|Confirmé| L[Anomalie créée<br/>État de départ authentifié]
K -->|Refusé| M[Modification non appliquée]
L --> H
M --> H
B -->|Restituer| N[Sélection d'un emprunt personnel]
N --> O[Checklist de retour préremplie<br/>avec l'état de départ validé]
O --> P{État modifié ?}
P -->|Non| Q[Emprunt CLOTURE<br/>Matériel DISPONIBLE]
P -->|Oui| R[Emprunt EN_ATTENTE_VALIDATION_RETOUR<br/>Alerte responsable]
R --> S{Confirmation du changement}
S -->|Confirmé| T[Anomalie créée<br/>RETOUR_NON_CONFORME et état final]
S -->|Refusé| Q
Q --> U[Catégorie débloquée]
T --> U
```
## Règles structurantes
- Le départ et le retour sont automatiques lorsque la checklist préremplie
reste inchangée.
- Au retour, l'état validé au départ est automatiquement repris.
- Dès que l'étudiant modifie une valeur, le responsable est alerté et doit
confirmer ou refuser le changement.
- Une anomalie et un changement d'état officiel ne sont appliqués qu'après
confirmation du responsable.
- Une catégorie reste bloquée pour l'étudiant tant que le retour précédent
n'a pas été clôturé.
- Il n'existe pas de limite d'une fois par jour après clôture du retour.
- Chaque tentative de modification, décision, anomalie et changement de
statut matériel est tracé.
+10 -3
View File
@@ -96,9 +96,13 @@ classDiagram
+ModeIdentification modeIdentificationRetour +ModeIdentification modeIdentificationRetour
+String commentaireDepart +String commentaireDepart
+String commentaireRetour +String commentaireRetour
+creer() +confirmerDepartInchange()
+enregistrerRetour() +soumettreEcartDepart()
+cloturer() +confirmerEcartDepart()
+initialiserRetourDepuisDepart()
+confirmerRetourInchange()
+soumettreEcartRetour()
+confirmerEcartRetour()
+marquerEnRetard() +marquerEnRetard()
} }
@@ -152,6 +156,7 @@ classDiagram
class StatutMateriel { class StatutMateriel {
<<enumeration>> <<enumeration>>
DISPONIBLE DISPONIBLE
RESERVE
EMPRUNTE EMPRUNTE
NON_CONFORME NON_CONFORME
DETERIORE DETERIORE
@@ -161,8 +166,10 @@ classDiagram
class StatutEmprunt { class StatutEmprunt {
<<enumeration>> <<enumeration>>
EN_ATTENTE_VALIDATION_DEPART
EN_COURS EN_COURS
EN_RETARD EN_RETARD
EN_ATTENTE_VALIDATION_RETOUR
CLOTURE CLOTURE
RETOUR_NON_CONFORME RETOUR_NON_CONFORME
ANNULE ANNULE
+31 -24
View File
@@ -1,5 +1,5 @@
# Règles métier — EME # Règles métier — EME
## Nouveau workflow d'emprunt et de restitution autonome ## Workflow automatique avec confirmation responsable des écarts
Les règles métier définissent les contraintes fonctionnelles que l'application EME — Emprunt Matériel ENSUP doit respecter dans le cadre du nouveau workflow validé. Les règles métier définissent les contraintes fonctionnelles que l'application EME — Emprunt Matériel ENSUP doit respecter dans le cadre du nouveau workflow validé.
@@ -36,7 +36,7 @@ Chaque emprunt et restitution doit être associé au poste dédié, à la salle
Chaque matériel doit être identifié de manière unique par une référence, un numéro d'inventaire ou un numéro de série, et rattaché à une catégorie, un campus et un statut. Chaque matériel doit être identifié de manière unique par une référence, un numéro d'inventaire ou un numéro de série, et rattaché à une catégorie, un campus et un statut.
**RG07 — Disponibilité du matériel** **RG07 — Disponibilité du matériel**
Seuls les matériels ayant le statut `DISPONIBLE` peuvent être empruntés. Un matériel emprunté, non conforme, détérioré, en maintenance ou indisponible ne peut pas faire l'objet d'un nouvel emprunt. Seuls les matériels ayant le statut `DISPONIBLE` peuvent faire l'objet d'un emprunt. Sans écart déclaré au départ, le matériel passe directement à `EMPRUNTE`. Si l'étudiant modifie l'état prérempli d'un élément, le matériel passe à `RESERVE` jusqu'à la décision du responsable. Un matériel réservé, emprunté, non conforme, détérioré, en maintenance ou indisponible ne peut pas faire l'objet d'un autre emprunt.
**RG08 — Accessoires attendus** **RG08 — Accessoires attendus**
Chaque matériel peut être associé à une liste d'accessoires attendus (chargeur, souris, câble, housse, etc.). Chaque matériel peut être associé à une liste d'accessoires attendus (chargeur, souris, câble, housse, etc.).
@@ -51,11 +51,17 @@ L'étudiant doit choisir l'action `Emprunter` depuis l'écran d'accueil, puis s'
**RG10 — Affichage des matériels disponibles** **RG10 — Affichage des matériels disponibles**
Après identification, le système affiche uniquement les matériels disponibles du campus concerné. Après identification, le système affiche uniquement les matériels disponibles du campus concerné.
**RG11Checklist de départ obligatoire** **RG10AUnicité d'emprunt actif par catégorie**
Une checklist de départ doit être obligatoirement renseignée avant la création de l'emprunt. Elle reprend les accessoires attendus du matériel sélectionné. L'étudiant indique pour chaque élément son état : `PRESENT`, `ABSENT` ou `DETERIORE`. Un étudiant ne peut pas demander un matériel d'une catégorie s'il possède déjà un emprunt bloquant de cette même catégorie. Sont bloquants les emprunts `EN_ATTENTE_VALIDATION_DEPART`, `EN_COURS`, `EN_RETARD` et `EN_ATTENTE_VALIDATION_RETOUR`. La catégorie redevient empruntable après la clôture automatique d'un retour sans écart ou après la décision du responsable sur un retour modifié. Il n'existe pas de limite calendaire : l'étudiant peut emprunter à nouveau la catégorie le même jour après cette clôture.
**RG12 — Création automatique de l'emprunt** **RG11 — Checklist de départ obligatoire**
Après validation de la checklist de départ, le système crée automatiquement l'emprunt, enregistre la date et l'heure, et fait passer le matériel au statut `EMPRUNTE`. Une checklist de départ doit être obligatoirement vérifiée avant la création de l'emprunt. Elle reprend les accessoires attendus du matériel sélectionné et initialise automatiquement chaque élément dans son état de référence, normalement `PRESENT`. L'étudiant contrôle physiquement le matériel et ne modifie une valeur en `ABSENT` ou `DETERIORE` que s'il constate réellement un écart.
**RG12 — Départ automatique sans écart**
Si l'étudiant confirme la checklist de départ préremplie sans la modifier, l'emprunt passe directement à `EN_COURS` et le matériel à `EMPRUNTE`. Aucune validation du responsable n'est requise pour ce départ normal.
**RG12A — Confirmation d'un écart au départ**
Dès que l'étudiant modifie l'état prérempli d'un élément, le système place le départ en `EN_ATTENTE_VALIDATION_DEPART`, réserve le matériel et alerte les responsables du campus. La modification reste provisoire et ne change pas l'état officiel du matériel. Le responsable contrôle l'écart et le confirme ou le refuse. Une confirmation authentifie le nouvel état de départ, crée l'anomalie correspondante, puis permet le passage à `EN_COURS` et `EMPRUNTE`. Un refus n'applique pas l'état déclaré par l'étudiant. La décision, son auteur, sa date et son observation éventuelle sont historisés.
**RG13 — Détection automatique des emprunts en retard** **RG13 — Détection automatique des emprunts en retard**
Lorsqu'un emprunt dépasse sa date de retour prévue sans avoir été restitué, son statut passe automatiquement à `EN_RETARD` et il apparaît dans le tableau de bord du responsable matériel. Lorsqu'un emprunt dépasse sa date de retour prévue sans avoir été restitué, son statut passe automatiquement à `EN_RETARD` et il apparaît dans le tableau de bord du responsable matériel.
@@ -71,23 +77,26 @@ L'étudiant doit choisir l'action `Restituer` depuis l'écran d'accueil, puis s'
Après identification, le système affiche uniquement les emprunts en cours de l'étudiant identifié. Un étudiant ne peut restituer que ses propres emprunts. Après identification, le système affiche uniquement les emprunts en cours de l'étudiant identifié. Un étudiant ne peut restituer que ses propres emprunts.
**RG16 — Checklist de retour obligatoire** **RG16 — Checklist de retour obligatoire**
Une checklist de retour doit obligatoirement être renseignée. Elle reprend les mêmes éléments que la checklist de départ pour permettre la comparaison. Une checklist de retour doit être obligatoirement vérifiée. Elle est automatiquement préremplie avec l'état de départ validé de chaque élément. L'étudiant ne modifie une valeur que s'il constate une différence au moment de la restitution.
**RG17 — Comparaison automatique des checklists** **RG17 — Comparaison automatique des checklists**
Le système compare automatiquement la checklist de départ avec la checklist de retour pour déterminer la conformité de la restitution. Le système compare automatiquement la checklist de retour avec l'état de départ validé. Une checklist inchangée constitue un retour conforme. Toute modification constitue une déclaration d'écart provisoire soumise à la confirmation du responsable.
**RG18 — Retour conforme** **RG18 — Retour automatique sans écart**
Si la checklist de retour correspond à celle de départ, l'emprunt est clôturé et le matériel repasse au statut `DISPONIBLE`. Si l'étudiant confirme la checklist de retour préremplie sans la modifier, le retour est clôturé automatiquement : l'emprunt passe à `CLOTURE` et le matériel à `DISPONIBLE`. Aucune validation du responsable n'est requise.
**RG19 — Retour non conforme** **RG19 — Confirmation d'un changement au retour**
Si une différence est détectée, l'emprunt passe au statut `RETOUR_NON_CONFORME` et le matériel peut passer à `NON_CONFORME`, `DETERIORE`, `MAINTENANCE` ou `INDISPONIBLE` selon le problème détecté. Dès que l'étudiant tente de modifier une valeur préremplie, l'emprunt passe à `EN_ATTENTE_VALIDATION_RETOUR`, le matériel reste indisponible et une alerte est envoyée aux responsables du campus. Le changement reste provisoire : il ne modifie ni l'état officiel du matériel ni l'état de départ conservé. Après contrôle, le responsable confirme ou refuse la différence. Une confirmation crée l'anomalie et applique l'état final approprié avec le statut `RETOUR_NON_CONFORME`. Un refus conserve l'état validé au départ et permet une clôture conforme. La décision est historisée.
**RG19A — Déblocage de la catégorie**
La catégorie est débloquée immédiatement après un retour automatique sans écart. Lorsqu'une différence est déclarée, elle reste bloquée jusqu'à la décision du responsable, puis est débloquée que la différence soit confirmée ou refusée.
--- ---
## 6. Anomalies ## 6. Anomalies
**RG20 — Création automatique d'une anomalie** **RG20 — Création d'une anomalie confirmée**
Une anomalie est créée automatiquement si un élément présent au départ est absent au retour, ou si un élément est déclaré détérioré au retour. Une anomalie est créée uniquement si le responsable confirme une différence ou une dégradation déclarée au départ ou au retour. La tentative de modification déclenche l'alerte et la demande de confirmation, mais elle ne crée pas encore une anomalie authentifiée et ne change pas l'état officiel du matériel.
**RG21 — Association de l'anomalie** **RG21 — Association de l'anomalie**
Chaque anomalie doit être associée à l'étudiant concerné, au matériel, à l'emprunt et aux éléments de checklist concernés. Chaque anomalie doit être associée à l'étudiant concerné, au matériel, à l'emprunt et aux éléments de checklist concernés.
@@ -103,7 +112,7 @@ Le responsable matériel peut consulter une anomalie, ajouter une observation et
## 7. Notifications ## 7. Notifications
**RG24 — Création automatique d'une notification** **RG24 — Création automatique d'une notification**
Lors de la création d'une anomalie, une notification est créée automatiquement et adressée au responsable matériel concerné. Une notification est créée pour les responsables du campus dès la première modification d'une checklist préremplie au départ ou au retour. Les confirmations d'anomalie et les changements d'état officiel du matériel sont également signalés et historisés. Une seule demande active doit regrouper les modifications d'une même checklist afin d'éviter les alertes en double.
**RG25 — Persistance et lecture des notifications** **RG25 — Persistance et lecture des notifications**
Les notifications sont enregistrées en base, consultables a posteriori, et peuvent être marquées comme lues par leur destinataire. Les notifications sont enregistrées en base, consultables a posteriori, et peuvent être marquées comme lues par leur destinataire.
@@ -113,19 +122,19 @@ Les notifications sont enregistrées en base, consultables a posteriori, et peuv
## 8. Supervision par le responsable matériel ## 8. Supervision par le responsable matériel
**RG26 — Périmètre de supervision** **RG26 — Périmètre de supervision**
Le responsable matériel agit a posteriori et n'intervient pas en temps réel dans le parcours étudiant. Son rôle est la supervision, la gestion du stock et le traitement des anomalies. Le responsable matériel intervient lorsqu'un étudiant déclare un écart par rapport à une checklist préremplie. Il confirme ou refuse ce changement avant toute modification de l'état officiel du matériel. Il assure également la supervision, la gestion du stock et le traitement des anomalies.
**RG27 — Filtrage par campus** **RG27 — Filtrage par campus**
Un responsable matériel ne peut consulter que les données (matériels, emprunts, anomalies, historique) du campus auquel il est rattaché. Un responsable matériel ne peut consulter que les données (matériels, emprunts, anomalies, historique) du campus auquel il est rattaché.
**RG28 — Consultation des emprunts** **RG28 — Consultation des emprunts**
Le responsable matériel peut consulter les emprunts en cours, en retard, clôturés et les retours non conformes. Le responsable matériel peut consulter les écarts en attente de confirmation au départ ou au retour, les emprunts en cours, en retard, clôturés, annulés et les retours non conformes.
**RG29 — Consultation du stock** **RG29 — Consultation du stock**
Le responsable matériel peut consulter l'état du stock et les statuts des matériels. Le responsable matériel peut consulter l'état du stock et les statuts des matériels.
**RG30 — Gestion du matériel et des accessoires** **RG30 — Gestion du matériel et des accessoires**
Le responsable matériel peut gérer les matériels, les accessoires associés, les checklists liées et faire évoluer les statuts. Le responsable matériel peut gérer les matériels, les accessoires associés, confirmer les écarts de checklist et faire évoluer les statuts. Une différence déclarée par un étudiant ne peut modifier l'état officiel du matériel que dans le cadre des confirmations prévues par RG12A et RG19.
**RG31 — Consultation de l'historique** **RG31 — Consultation de l'historique**
Le responsable matériel peut consulter l'historique des emprunts, restitutions, anomalies et changements de statut. Le responsable matériel peut consulter l'historique des emprunts, restitutions, anomalies et changements de statut.
@@ -135,7 +144,7 @@ Le responsable matériel peut consulter l'historique des emprunts, restitutions,
## 9. Historique et traçabilité ## 9. Historique et traçabilité
**RG32 — Historisation des actions importantes** **RG32 — Historisation des actions importantes**
Toute opération importante doit être enregistrée dans l'historique : identification d'un étudiant, création d'un emprunt, validation des checklists, restitution, comparaison, création d'une anomalie, changement de statut d'un matériel et traitement d'une anomalie. Toute opération importante doit être enregistrée dans l'historique : identification d'un étudiant, confirmation automatique d'une checklist inchangée, tentative de modification, validation ou refus du responsable, restitution, création d'une anomalie, changement de statut d'un matériel et traitement d'une anomalie.
**RG33 — Informations conservées dans l'historique** **RG33 — Informations conservées dans l'historique**
L'historique doit conserver la date, l'heure, l'utilisateur concerné, le matériel concerné, le poste utilisé, la salle de prêt, le campus et l'action réalisée. L'historique doit conserver la date, l'heure, l'utilisateur concerné, le matériel concerné, le poste utilisé, la salle de prêt, le campus et l'action réalisée.
@@ -144,10 +153,8 @@ L'historique doit conserver la date, l'heure, l'utilisateur concerné, le matér
## Résumé ## Résumé
Les règles métier du nouveau workflow EME reposent sur un principe d'**autonomie de l'étudiant**. Les règles métier du workflow EME reposent sur un **parcours automatique tant que l'étudiant ne déclare aucun écart**.
L'étudiant emprunte ou restitue son matériel depuis un poste dédié, s'identifie par QR code ou mail ENSUP, complète une checklist au départ et au retour, puis le système compare automatiquement les informations saisies. Au départ, la checklist est préremplie avec l'état de référence du matériel. Une confirmation sans modification active automatiquement l'emprunt. Toute différence déclarée réserve le matériel, alerte le responsable et reste provisoire jusqu'à sa décision.
En cas de différence, une anomalie est créée automatiquement et une notification est envoyée au responsable matériel. L'ensemble des opérations est historisé afin de garantir la traçabilité. Au retour, la checklist reprend automatiquement l'état validé au départ. Une restitution inchangée est clôturée automatiquement. Dès que l'étudiant tente de modifier cet état, le responsable est alerté et doit confirmer le changement avant la création de l'anomalie et la mise à jour de l'état officiel. La catégorie reste bloquée tant que l'emprunt précédent n'est pas clôturé.
Le responsable matériel agit **a posteriori** : il consulte, traite les anomalies, gère le stock et l'historique de son campus, sans intervenir en temps réel dans le parcours étudiant.
+21 -14
View File
@@ -554,8 +554,8 @@ html,body{height:100%;font-family:var(--body);background:#f8fafc;color:var(--tex
</div> </div>
<div class="cl-row"> <div class="cl-row">
<span>Câble HDMI</span> <span>Câble HDMI</span>
<div class="cb-wrap"><div class="cb" id="cd-4-p" onclick="toggleCb('cd-4','p')"></div></div> <div class="cb-wrap"><div class="cb ok" id="cd-4-p" onclick="toggleCb('cd-4','p')"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="var(--green)" stroke-width="3"><polyline points="20 6 9 17 4 12"/></svg></div></div>
<div class="cb-wrap"><div class="cb no" id="cd-4-a" onclick="toggleCb('cd-4','a')"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="var(--red)" stroke-width="3"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg></div></div> <div class="cb-wrap"><div class="cb" id="cd-4-a" onclick="toggleCb('cd-4','a')"></div></div>
<div class="cb-wrap"><div class="cb" id="cd-4-d" onclick="toggleCb('cd-4','d')"></div></div> <div class="cb-wrap"><div class="cb" id="cd-4-d" onclick="toggleCb('cd-4','d')"></div></div>
</div> </div>
</div> </div>
@@ -563,12 +563,12 @@ html,body{height:100%;font-family:var(--body);background:#f8fafc;color:var(--tex
<div style="display:flex;flex-direction:column;gap:14px;"> <div style="display:flex;flex-direction:column;gap:14px;">
<div class="instr-box"> <div class="instr-box">
<div class="lbl" style="margin-bottom:8px;">Instructions</div> <div class="lbl" style="margin-bottom:8px;">Instructions</div>
<p>Vérifiez physiquement chaque élément présent dans le kit. Cliquez sur <strong>Présent</strong>, <strong>Absent</strong> ou <strong>Détérioré</strong> pour chaque élément. Signalez tout élément manquant ou endommagé pour éviter tout litige au retour.</p> <p>La checklist est préremplie avec l'état de référence. Vérifiez physiquement chaque élément et ne modifiez une valeur que si vous constatez un élément manquant ou endommagé. Toute modification alertera un responsable.</p>
</div> </div>
<textarea class="textarea" placeholder="Commentaire ou observation optionnelle..." rows="4"></textarea> <textarea class="textarea" placeholder="Commentaire ou observation optionnelle..." rows="4"></textarea>
<button class="btn btn-dark btn-lg full" onclick="goTo('s-confirmation')"> <button class="btn btn-dark btn-lg full" onclick="goTo('s-confirmation')">
<svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><path d="M9 11l3 3L22 4"/></svg> <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><path d="M9 11l3 3L22 4"/></svg>
Valider la checklist et confirmer l'emprunt Confirmer l'état de départ
</button> </button>
</div> </div>
</div> </div>
@@ -590,7 +590,7 @@ html,body{height:100%;font-family:var(--body);background:#f8fafc;color:var(--tex
<svg width="34" height="34" viewBox="0 0 24 24" fill="none" stroke="white" stroke-width="2.5"><path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"/><polyline points="22 4 12 14.01 9 11.01"/></svg> <svg width="34" height="34" viewBox="0 0 24 24" fill="none" stroke="white" stroke-width="2.5"><path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"/><polyline points="22 4 12 14.01 9 11.01"/></svg>
</div> </div>
<div class="success-title">Emprunt enregistré !</div> <div class="success-title">Emprunt enregistré !</div>
<div class="success-sub">Votre emprunt a bien été enregistré. Vous pouvez récupérer le matériel.</div> <div class="success-sub">La checklist n'a pas été modifiée. L'emprunt est actif et vous pouvez récupérer le matériel.</div>
</div> </div>
<div class="recap-card"> <div class="recap-card">
<div class="recap-label">Récapitulatif de l'emprunt</div> <div class="recap-label">Récapitulatif de l'emprunt</div>
@@ -600,7 +600,8 @@ html,body{height:100%;font-family:var(--body);background:#f8fafc;color:var(--tex
<div class="rrow"><span class="rk">Date d'emprunt</span><span class="rv">28/05/2026</span></div> <div class="rrow"><span class="rk">Date d'emprunt</span><span class="rv">28/05/2026</span></div>
<div class="rrow"><span class="rk">Heure</span><span class="rv">09:15</span></div> <div class="rrow"><span class="rk">Heure</span><span class="rv">09:15</span></div>
<div class="rrow"><span class="rk">Campus</span><span class="rv">Paris · Ensitech</span></div> <div class="rrow"><span class="rk">Campus</span><span class="rv">Paris · Ensitech</span></div>
<div class="rrow"><span class="rk">Note</span><span class="rv" style="color:var(--orange);">Câble HDMI absent au départ</span></div> <div class="rrow"><span class="rk">Statut</span><span class="rv">En cours</span></div>
<div class="rrow"><span class="rk">État de départ</span><span class="rv" style="color:var(--green);">Conforme à l'état de référence</span></div>
</div> </div>
<button class="btn btn-primary full btn-lg" onclick="goTo('s-home-student')"> <button class="btn btn-primary full btn-lg" onclick="goTo('s-home-student')">
<svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><path d="M3 9l9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/></svg> <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><path d="M3 9l9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/></svg>
@@ -692,17 +693,23 @@ html,body{height:100%;font-family:var(--body);background:#f8fafc;color:var(--tex
<div class="cb-wrap"><div class="cb" id="cr-3-a" onclick="toggleCb('cr-3','a')"></div></div> <div class="cb-wrap"><div class="cb" id="cr-3-a" onclick="toggleCb('cr-3','a')"></div></div>
<div class="cb-wrap"><div class="cb" id="cr-3-d" onclick="toggleCb('cr-3','d')"></div></div> <div class="cb-wrap"><div class="cb" id="cr-3-d" onclick="toggleCb('cr-3','d')"></div></div>
</div> </div>
<div class="cl-row">
<span>Câble HDMI</span>
<div class="cb-wrap"><div class="cb ok" id="cr-4-p" onclick="toggleCb('cr-4','p')"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="var(--green)" stroke-width="3"><polyline points="20 6 9 17 4 12"/></svg></div></div>
<div class="cb-wrap"><div class="cb" id="cr-4-a" onclick="toggleCb('cr-4','a')"></div></div>
<div class="cb-wrap"><div class="cb" id="cr-4-d" onclick="toggleCb('cr-4','d')"></div></div>
</div>
</div> </div>
</div> </div>
<div style="display:flex;flex-direction:column;gap:14px;"> <div style="display:flex;flex-direction:column;gap:14px;">
<div class="instr-box"> <div class="instr-box">
<div class="lbl" style="margin-bottom:8px;">Rappel checklist de départ</div> <div class="lbl" style="margin-bottom:8px;">État validé au départ</div>
<p>Au départ : Chargeur ✗ absent · Souris présente · Housse présente · Câble HDMI ✗ absent</p> <p>La checklist de retour est préremplie automatiquement : Chargeur présent · Souris présente · Housse présente · Câble HDMI présent. Modifiez uniquement l'élément dont l'état a changé.</p>
</div> </div>
<textarea class="textarea" placeholder="Commentaire optionnel..." rows="4"></textarea> <textarea class="textarea" placeholder="Commentaire optionnel..." rows="4"></textarea>
<button class="btn btn-dark btn-lg full" onclick="goTo('s-anomalie')"> <button class="btn btn-dark btn-lg full" onclick="goTo('s-anomalie')">
<svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><path d="M9 11l3 3L22 4"/></svg> <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><path d="M9 11l3 3L22 4"/></svg>
Valider le retour Signaler le changement et restituer
</button> </button>
</div> </div>
</div> </div>
@@ -725,20 +732,20 @@ html,body{height:100%;font-family:var(--body);background:#f8fafc;color:var(--tex
<svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="var(--red)" stroke-width="2.5"><path d="M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z"/><line x1="12" y1="9" x2="12" y2="13"/><line x1="12" y1="17" x2="12.01" y2="17"/></svg> <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="var(--red)" stroke-width="2.5"><path d="M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z"/><line x1="12" y1="9" x2="12" y2="13"/><line x1="12" y1="17" x2="12.01" y2="17"/></svg>
</div> </div>
<div class="alert-body"> <div class="alert-body">
<strong>Retour non conforme — Anomalie détectée</strong> <strong>Retour en attente de contrôle</strong>
<p>Une différence a été constatée avec la checklist de départ. Une anomalie a été créée automatiquement et le responsable matériel a été notifié.</p> <p>Le chargeur a été modifié de « Présent » à « Absent ». Le responsable matériel a été alerté et doit confirmer ou refuser ce changement avant toute mise à jour de l'état officiel.</p>
</div> </div>
</div> </div>
<div class="detail-box"> <div class="detail-box">
<div class="lbl" style="margin-bottom:12px;">Détail de l'anomalie</div> <div class="lbl" style="margin-bottom:12px;">Changement en attente de confirmation</div>
<div class="drow"><span class="dk">Élément concerné</span><span class="dv" style="color:var(--red);">Chargeur 65W</span></div> <div class="drow"><span class="dk">Élément concerné</span><span class="dv" style="color:var(--red);">Chargeur 65W</span></div>
<div class="drow"><span class="dk">Statut au départ</span><span class="dv"><span class="pill p-closed">Non renseigné (absent au départ)</span></span></div> <div class="drow"><span class="dk">Statut au départ</span><span class="dv"><span class="pill p-closed">Présent</span></span></div>
<div class="drow"><span class="dk">Statut au retour</span><span class="dv"><span class="pill p-no">Absent</span></span></div> <div class="drow"><span class="dk">Statut au retour</span><span class="dv"><span class="pill p-no">Absent</span></span></div>
<div class="drow"><span class="dk">Matériel</span><span class="dv">PC Dell Latitude 5420 · ENS-PC-001</span></div> <div class="drow"><span class="dk">Matériel</span><span class="dv">PC Dell Latitude 5420 · ENS-PC-001</span></div>
<div class="drow"><span class="dk">Emprunteur</span><span class="dv">Lucas Martin</span></div> <div class="drow"><span class="dk">Emprunteur</span><span class="dv">Lucas Martin</span></div>
<div class="drow"><span class="dk">Date détection</span><span class="dv">28/05/2026 · 10:30</span></div> <div class="drow"><span class="dk">Date détection</span><span class="dv">28/05/2026 · 10:30</span></div>
</div> </div>
<div style="font-size:13px;color:var(--muted);text-align:center;line-height:1.6;padding:0 16px;">Le responsable matériel traitera cette anomalie. Vous pouvez retourner à l'accueil.</div> <div style="font-size:13px;color:var(--muted);text-align:center;line-height:1.6;padding:0 16px;">L'anomalie et le nouvel état du matériel ne seront enregistrés qu'après confirmation du responsable. La catégorie reste bloquée jusque-là.</div>
<button class="btn btn-primary full btn-lg" onclick="goTo('s-home-student')"> <button class="btn btn-primary full btn-lg" onclick="goTo('s-home-student')">
<svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><path d="M3 9l9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/></svg> <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><path d="M3 9l9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/></svg>
Retour à l'accueil Retour à l'accueil
@@ -4,10 +4,12 @@ import {
creerEmprunt, creerEmprunt,
listerMesEmpruntsEnCours, listerMesEmpruntsEnCours,
restituerEmprunt, restituerEmprunt,
signalerTentativeModificationRetour,
} from '../services/emprunt.service'; } from '../services/emprunt.service';
import { import {
parseCreerEmpruntRequest, parseCreerEmpruntRequest,
parseRestituerEmpruntRequest, parseRestituerEmpruntRequest,
parseSignalerTentativeRetourRequest,
toEmpruntResponse, toEmpruntResponse,
} from '../dtos/emprunt.dto'; } from '../dtos/emprunt.dto';
@@ -47,3 +49,19 @@ export async function postRestitution(req: Request, res: Response): Promise<void
const emprunt = await restituerEmprunt(user.id, empruntId, request); const emprunt = await restituerEmprunt(user.id, empruntId, request);
res.json({ data: toEmpruntResponse(emprunt) }); res.json({ data: toEmpruntResponse(emprunt) });
} }
export async function postAlerteChangementRetour(req: Request, res: Response): Promise<void> {
const user = req.user;
if (!user) {
throw new AppError(401, 'Authentification requise');
}
const empruntId = Number(req.params.id);
if (!Number.isInteger(empruntId) || empruntId <= 0) {
throw new AppError(400, 'Identifiant emprunt invalide');
}
const request = parseSignalerTentativeRetourRequest(req.body);
const alerteCreee = await signalerTentativeModificationRetour(user.id, empruntId, request);
res.json({ data: { alerteCreee } });
}
@@ -2,28 +2,38 @@ import { Request, Response } from 'express';
import { AppError } from '../errors/app-error'; import { AppError } from '../errors/app-error';
import { import {
changerStatutAnomalieResponsableService, changerStatutAnomalieResponsableService,
deciderEcartResponsableService,
getDashboardResponsable, getDashboardResponsable,
listerAnomaliesResponsable, listerAnomaliesResponsable,
listerHistoriqueResponsable, listerHistoriqueResponsable,
listerNotificationsResponsable, listerNotificationsResponsable,
listerMaterielsResponsable, listerMaterielsResponsable,
listerEmpruntsResponsable, listerEmpruntsResponsable,
listerEcartsResponsable,
marquerNotificationResponsableLue, marquerNotificationResponsableLue,
marquerToutesNotificationsResponsableLues, marquerToutesNotificationsResponsableLues,
parseAnomalieId, parseAnomalieId,
parseAnneeEmprunt,
parseEmpruntId,
parseCategorieId, parseCategorieId,
parseLu, parseLu,
parseNotificationId, parseNotificationId,
parseOrdreTri,
parseDateQuery, parseDateQuery,
parsePositiveIntQuery, parsePositiveIntQuery,
parseStatutAnomalie, parseStatutAnomalie,
parseStatutMateriel, parseStatutMateriel,
parseStatutEmprunt, parseStatutEmprunt,
parseTriAnomalie,
parseTriEmprunt,
parseTriHistorique,
parseTriMateriel,
} from '../services/responsable.service'; } from '../services/responsable.service';
import { import {
toAnomalieResponsableResponse, toAnomalieResponsableResponse,
toDashboardResponsableResponse, toDashboardResponsableResponse,
toEmpruntResponsableResponse, toEmpruntResponsableResponse,
toEcartResponsableResponse,
toHistoriqueResponsableResponse, toHistoriqueResponsableResponse,
toMaterielResponsableResponse, toMaterielResponsableResponse,
toNotificationResponsableResponse, toNotificationResponsableResponse,
@@ -45,6 +55,9 @@ function getHistoriqueFiltres(req: Request) {
empruntId: parsePositiveIntQuery(req.query.empruntId, 'empruntId'), empruntId: parsePositiveIntQuery(req.query.empruntId, 'empruntId'),
dateDebut: parseDateQuery(req.query.dateDebut, 'dateDebut'), dateDebut: parseDateQuery(req.query.dateDebut, 'dateDebut'),
dateFin: parseDateQuery(req.query.dateFin, 'dateFin'), dateFin: parseDateQuery(req.query.dateFin, 'dateFin'),
recherche: typeof req.query.q === 'string' ? req.query.q : undefined,
tri: parseTriHistorique(req.query.tri),
ordre: parseOrdreTri(req.query.ordre),
}; };
} }
@@ -73,10 +86,58 @@ export async function getEmprunts(req: Request, res: Response): Promise<void> {
} }
const statut = parseStatutEmprunt(req.query.statut); const statut = parseStatutEmprunt(req.query.statut);
const emprunts = await listerEmpruntsResponsable(user.roleCode, user.campusId, { statut }); const annee = parseAnneeEmprunt(req.query.annee);
const recherche = typeof req.query.q === 'string' ? req.query.q.trim() : undefined;
const tri = parseTriEmprunt(req.query.tri);
const ordre = parseOrdreTri(req.query.ordre);
const emprunts = await listerEmpruntsResponsable(user.roleCode, user.campusId, {
statut,
annee,
recherche: recherche || undefined,
tri,
ordre,
});
res.json({ data: emprunts.map(toEmpruntResponsableResponse) }); res.json({ data: emprunts.map(toEmpruntResponsableResponse) });
} }
export async function getEcarts(req: Request, res: Response): Promise<void> {
const user = req.user;
if (!user) {
throw new AppError(401, 'Authentification requise');
}
const ecarts = await listerEcartsResponsable(user.roleCode, user.campusId);
res.json({ data: ecarts.map(toEcartResponsableResponse) });
}
export async function patchEcartDecision(req: Request, res: Response): Promise<void> {
const user = req.user;
if (!user) {
throw new AppError(401, 'Authentification requise');
}
const empruntId = parseEmpruntId(req.params.id);
const body = asBodyObject(req.body);
if (body.decision !== 'CONFIRMER' && body.decision !== 'REFUSER') {
throw new AppError(400, 'decision invalide');
}
const observation = typeof body.observation === 'string' ? body.observation : undefined;
const statutMateriel = parseStatutMateriel(body.statutMateriel);
const ecart = await deciderEcartResponsableService(
user.id,
user.roleCode,
user.campusId,
empruntId,
{
decision: body.decision,
observation,
statutMateriel,
},
);
res.json({ data: toEcartResponsableResponse(ecart) });
}
export async function getMateriels(req: Request, res: Response): Promise<void> { export async function getMateriels(req: Request, res: Response): Promise<void> {
const user = req.user; const user = req.user;
if (!user) { if (!user) {
@@ -86,11 +147,15 @@ export async function getMateriels(req: Request, res: Response): Promise<void> {
const statut = parseStatutMateriel(req.query.statut); const statut = parseStatutMateriel(req.query.statut);
const categorieId = parseCategorieId(req.query.categorieId); const categorieId = parseCategorieId(req.query.categorieId);
const recherche = typeof req.query.q === 'string' ? req.query.q : undefined; const recherche = typeof req.query.q === 'string' ? req.query.q : undefined;
const tri = parseTriMateriel(req.query.tri);
const ordre = parseOrdreTri(req.query.ordre);
const materiels = await listerMaterielsResponsable(user.roleCode, user.campusId, { const materiels = await listerMaterielsResponsable(user.roleCode, user.campusId, {
statut, statut,
categorieId, categorieId,
recherche, recherche,
tri,
ordre,
}); });
res.json({ data: materiels.map(toMaterielResponsableResponse) }); res.json({ data: materiels.map(toMaterielResponsableResponse) });
} }
@@ -103,10 +168,16 @@ export async function getAnomalies(req: Request, res: Response): Promise<void> {
const statut = parseStatutAnomalie(req.query.statut); const statut = parseStatutAnomalie(req.query.statut);
const type = typeof req.query.type === 'string' ? req.query.type : undefined; const type = typeof req.query.type === 'string' ? req.query.type : undefined;
const recherche = typeof req.query.q === 'string' ? req.query.q : undefined;
const tri = parseTriAnomalie(req.query.tri);
const ordre = parseOrdreTri(req.query.ordre);
const anomalies = await listerAnomaliesResponsable(user.roleCode, user.campusId, { const anomalies = await listerAnomaliesResponsable(user.roleCode, user.campusId, {
statut, statut,
type, type,
recherche,
tri,
ordre,
}); });
res.json({ data: anomalies.map(toAnomalieResponsableResponse) }); res.json({ data: anomalies.map(toAnomalieResponsableResponse) });
} }
+36
View File
@@ -10,9 +10,19 @@ export interface EmpruntResponse {
dateRetourReelle: Date | null; dateRetourReelle: Date | null;
statut: string; statut: string;
materiel: MaterielResponse; materiel: MaterielResponse;
checklistDepart: ChecklistElementResponse[];
}
export interface ChecklistElementResponse {
accessoireId: number | null;
nomElement: string;
etat: string;
quantiteConstatee: number;
} }
export function toEmpruntResponse(emprunt: EmpruntAvecMateriel): EmpruntResponse { export function toEmpruntResponse(emprunt: EmpruntAvecMateriel): EmpruntResponse {
const checklistDepart = emprunt.checklists.find((checklist) => checklist.type === 'DEPART');
return { return {
id: emprunt.id, id: emprunt.id,
dateEmprunt: emprunt.dateEmprunt, dateEmprunt: emprunt.dateEmprunt,
@@ -20,6 +30,13 @@ export function toEmpruntResponse(emprunt: EmpruntAvecMateriel): EmpruntResponse
dateRetourReelle: emprunt.dateRetourReelle, dateRetourReelle: emprunt.dateRetourReelle,
statut: emprunt.statut, statut: emprunt.statut,
materiel: toMaterielResponse(emprunt.materiel), materiel: toMaterielResponse(emprunt.materiel),
checklistDepart:
checklistDepart?.elements.map((element) => ({
accessoireId: element.accessoireId,
nomElement: element.nomElement,
etat: element.etat,
quantiteConstatee: element.quantiteConstatee,
})) ?? [],
}; };
} }
@@ -123,6 +140,25 @@ export interface RestituerEmpruntRequest {
elements: ChecklistElementRequest[]; elements: ChecklistElementRequest[];
} }
export interface SignalerTentativeRetourRequest {
nomElement: string;
etatInitial: string;
etatDemande: string;
}
export function parseSignalerTentativeRetourRequest(body: unknown): SignalerTentativeRetourRequest {
const obj = asObject(body, 'Corps de requete invalide');
if (typeof obj.nomElement !== 'string' || obj.nomElement.trim() === '') {
throw new AppError(400, 'nomElement requis');
}
return {
nomElement: obj.nomElement.trim(),
etatInitial: asEnum(obj.etatInitial, ETAT_CHECKLIST_ELEMENT, 'etatInitial'),
etatDemande: asEnum(obj.etatDemande, ETAT_CHECKLIST_ELEMENT, 'etatDemande'),
};
}
export function parseRestituerEmpruntRequest(body: unknown): RestituerEmpruntRequest { export function parseRestituerEmpruntRequest(body: unknown): RestituerEmpruntRequest {
const obj = asObject(body, 'Corps de requete invalide'); const obj = asObject(body, 'Corps de requete invalide');
+36
View File
@@ -2,6 +2,7 @@ import {
ActiviteResponsable, ActiviteResponsable,
AnomalieResponsable, AnomalieResponsable,
EmpruntResponsable, EmpruntResponsable,
EcartResponsable,
HistoriqueResponsable, HistoriqueResponsable,
MaterielResponsable, MaterielResponsable,
NotificationResponsable, NotificationResponsable,
@@ -67,6 +68,21 @@ export interface EmpruntResponsableResponse {
}; };
} }
export interface EcartResponsableResponse extends EmpruntResponsableResponse {
typeEcart: 'DEPART' | 'RETOUR';
checklists: Array<{
type: string;
elements: Array<{
id: number;
accessoireId: number | null;
nomElement: string;
etat: string;
quantiteConstatee: number;
commentaire: string | null;
}>;
}>;
}
export interface MaterielResponsableResponse { export interface MaterielResponsableResponse {
id: number; id: number;
nom: string; nom: string;
@@ -251,6 +267,26 @@ export function toEmpruntResponsableResponse(
}; };
} }
export function toEcartResponsableResponse(emprunt: EcartResponsable): EcartResponsableResponse {
return {
...toEmpruntResponsableResponse(emprunt),
typeEcart: emprunt.checklists.some((checklist) => checklist.type === 'RETOUR')
? 'RETOUR'
: 'DEPART',
checklists: emprunt.checklists.map((checklist) => ({
type: checklist.type,
elements: checklist.elements.map((element) => ({
id: element.id,
accessoireId: element.accessoireId,
nomElement: element.nomElement,
etat: element.etat,
quantiteConstatee: element.quantiteConstatee,
commentaire: element.commentaire,
})),
})),
};
}
export function toMaterielResponsableResponse( export function toMaterielResponsableResponse(
materiel: MaterielResponsable, materiel: MaterielResponsable,
): MaterielResponsableResponse { ): MaterielResponsableResponse {
+3
View File
@@ -1,5 +1,6 @@
export const STATUT_MATERIEL = [ export const STATUT_MATERIEL = [
'DISPONIBLE', 'DISPONIBLE',
'RESERVE',
'EMPRUNTE', 'EMPRUNTE',
'NON_CONFORME', 'NON_CONFORME',
'DETERIORE', 'DETERIORE',
@@ -10,8 +11,10 @@ export const STATUT_MATERIEL = [
export type StatutMateriel = (typeof STATUT_MATERIEL)[number]; export type StatutMateriel = (typeof STATUT_MATERIEL)[number];
export const STATUT_EMPRUNT = [ export const STATUT_EMPRUNT = [
'EN_ATTENTE_VALIDATION_DEPART',
'EN_COURS', 'EN_COURS',
'EN_RETARD', 'EN_RETARD',
'EN_ATTENTE_VALIDATION_RETOUR',
'CLOTURE', 'CLOTURE',
'RETOUR_NON_CONFORME', 'RETOUR_NON_CONFORME',
'ANNULE', 'ANNULE',
@@ -4,7 +4,10 @@ import { StatutEmprunt } from '../models/enums';
import { AppError } from '../errors/app-error'; import { AppError } from '../errors/app-error';
export type EmpruntAvecMateriel = Prisma.EmpruntGetPayload<{ export type EmpruntAvecMateriel = Prisma.EmpruntGetPayload<{
include: { materiel: { include: { categorie: true } } }; include: {
materiel: { include: { categorie: true } };
checklists: { include: { elements: true } };
};
}>; }>;
export type EmpruntAvecChecklists = Prisma.EmpruntGetPayload<{ export type EmpruntAvecChecklists = Prisma.EmpruntGetPayload<{
@@ -12,6 +15,12 @@ export type EmpruntAvecChecklists = Prisma.EmpruntGetPayload<{
}>; }>;
const STATUTS_EN_COURS: StatutEmprunt[] = ['EN_COURS', 'EN_RETARD']; const STATUTS_EN_COURS: StatutEmprunt[] = ['EN_COURS', 'EN_RETARD'];
const STATUTS_BLOQUANTS: StatutEmprunt[] = [
'EN_ATTENTE_VALIDATION_DEPART',
'EN_COURS',
'EN_RETARD',
'EN_ATTENTE_VALIDATION_RETOUR',
];
export function findEnCoursParUtilisateur(utilisateurId: number): Promise<EmpruntAvecMateriel[]> { export function findEnCoursParUtilisateur(utilisateurId: number): Promise<EmpruntAvecMateriel[]> {
return prisma.emprunt.findMany({ return prisma.emprunt.findMany({
@@ -19,7 +28,10 @@ export function findEnCoursParUtilisateur(utilisateurId: number): Promise<Emprun
utilisateurId, utilisateurId,
statut: { in: STATUTS_EN_COURS }, statut: { in: STATUTS_EN_COURS },
}, },
include: { materiel: { include: { categorie: true } } }, include: {
materiel: { include: { categorie: true } },
checklists: { include: { elements: true } },
},
orderBy: { dateRetourPrevue: 'asc' }, orderBy: { dateRetourPrevue: 'asc' },
}); });
} }
@@ -31,6 +43,71 @@ export function findByIdAvecChecklists(id: number): Promise<EmpruntAvecChecklist
}); });
} }
export interface SignalerTentativeRetourData {
empruntId: number;
utilisateurId: number;
materielId: number;
campusId: number;
sallePretId: number;
posteEmpruntId: number;
responsablesIds: number[];
description: string;
}
export function signalerTentativeRetour(data: SignalerTentativeRetourData): Promise<boolean> {
return prisma.$transaction(async (tx) => {
const emprunt = await tx.emprunt.findFirst({
where: {
id: data.empruntId,
utilisateurId: data.utilisateurId,
statut: { in: STATUTS_EN_COURS },
},
select: { id: true },
});
if (!emprunt) {
throw new AppError(409, 'Emprunt non restituable');
}
const dejaSignalee = await tx.historique.findFirst({
where: {
empruntId: data.empruntId,
action: 'TENTATIVE_MODIFICATION_RETOUR',
},
select: { id: true },
});
if (dejaSignalee) {
return false;
}
if (data.responsablesIds.length > 0) {
await tx.notification.createMany({
data: data.responsablesIds.map((responsableId) => ({
utilisateurId: responsableId,
titre: 'Tentative de modification au retour',
message: data.description,
type: 'TENTATIVE_MODIFICATION_RETOUR',
})),
});
}
await tx.historique.create({
data: {
utilisateurId: data.utilisateurId,
empruntId: data.empruntId,
materielId: data.materielId,
campusId: data.campusId,
sallePretId: data.sallePretId,
posteEmpruntId: data.posteEmpruntId,
action: 'TENTATIVE_MODIFICATION_RETOUR',
description: data.description,
dateAction: new Date(),
},
});
return true;
});
}
interface ChecklistElementData { interface ChecklistElementData {
accessoireId?: number; accessoireId?: number;
nomElement: string; nomElement: string;
@@ -42,6 +119,7 @@ interface ChecklistElementData {
export interface CreerEmpruntData { export interface CreerEmpruntData {
utilisateurId: number; utilisateurId: number;
materielId: number; materielId: number;
categorieId: number;
campusId: number; campusId: number;
sallePretId: number; sallePretId: number;
posteEmpruntId: number; posteEmpruntId: number;
@@ -49,59 +127,122 @@ export interface CreerEmpruntData {
modeIdentification: string; modeIdentification: string;
commentaireDepart?: string; commentaireDepart?: string;
elements: ChecklistElementData[]; elements: ChecklistElementData[];
statutEmprunt: StatutEmprunt;
statutMateriel: string;
responsablesIds: number[];
descriptionEcart?: string;
} }
/* Création atomique : réservation du matériel (DISPONIBLE -> EMPRUNTE), emprunt,
checklist de départ et ses éléments. Si une étape échoue, tout est annulé. */
export function creerEmpruntComplet(data: CreerEmpruntData): Promise<EmpruntAvecMateriel> { export function creerEmpruntComplet(data: CreerEmpruntData): Promise<EmpruntAvecMateriel> {
return prisma.$transaction(async (tx) => { return prisma.$transaction(
// Réservation atomique : empêche un double emprunt du même matériel (RG07). async (tx) => {
const reservation = await tx.materiel.updateMany({ const empruntBloquant = await tx.emprunt.findFirst({
where: { id: data.materielId, statut: 'DISPONIBLE' }, where: {
data: { statut: 'EMPRUNTE' }, utilisateurId: data.utilisateurId,
}); statut: { in: STATUTS_BLOQUANTS },
if (reservation.count === 0) { materiel: { categorieId: data.categorieId },
throw new AppError(409, 'Materiel non disponible');
}
const emprunt = await tx.emprunt.create({
data: {
utilisateurId: data.utilisateurId,
materielId: data.materielId,
campusId: data.campusId,
sallePretId: data.sallePretId,
posteEmpruntId: data.posteEmpruntId,
dateEmprunt: new Date(),
dateRetourPrevue: data.dateRetourPrevue,
statut: 'EN_COURS',
modeIdentificationEmprunt: data.modeIdentification,
commentaireDepart: data.commentaireDepart ?? null,
},
});
await tx.checklist.create({
data: {
empruntId: emprunt.id,
utilisateurId: data.utilisateurId,
type: 'DEPART',
dateVerification: new Date(),
elements: {
create: data.elements.map((element) => ({
accessoireId: element.accessoireId ?? null,
nomElement: element.nomElement,
etat: element.etat,
quantiteConstatee: element.quantiteConstatee,
commentaire: element.commentaire ?? null,
})),
}, },
}, select: { id: true },
}); });
if (empruntBloquant) {
throw new AppError(
409,
'Un materiel de cette categorie est deja emprunte ou en attente de confirmation',
);
}
return tx.emprunt.findUniqueOrThrow({ const reservation = await tx.materiel.updateMany({
where: { id: emprunt.id }, where: { id: data.materielId, statut: 'DISPONIBLE' },
include: { materiel: { include: { categorie: true } } }, data: { statut: data.statutMateriel },
}); });
}); if (reservation.count === 0) {
throw new AppError(409, 'Materiel non disponible');
}
const maintenant = new Date();
const emprunt = await tx.emprunt.create({
data: {
utilisateurId: data.utilisateurId,
materielId: data.materielId,
campusId: data.campusId,
sallePretId: data.sallePretId,
posteEmpruntId: data.posteEmpruntId,
dateEmprunt: maintenant,
dateRetourPrevue: data.dateRetourPrevue,
statut: data.statutEmprunt,
modeIdentificationEmprunt: data.modeIdentification,
commentaireDepart: data.commentaireDepart ?? null,
},
});
await tx.checklist.create({
data: {
empruntId: emprunt.id,
utilisateurId: data.utilisateurId,
type: 'DEPART',
dateVerification: maintenant,
elements: {
create: data.elements.map((element) => ({
accessoireId: element.accessoireId ?? null,
nomElement: element.nomElement,
etat: element.etat,
quantiteConstatee: element.quantiteConstatee,
commentaire: element.commentaire ?? null,
})),
},
},
});
if (data.descriptionEcart) {
if (data.responsablesIds.length > 0) {
await tx.notification.createMany({
data: data.responsablesIds.map((responsableId) => ({
utilisateurId: responsableId,
titre: 'Ecart signale au depart',
message: data.descriptionEcart as string,
type: 'ECART_DEPART',
})),
});
}
await tx.historique.create({
data: {
utilisateurId: data.utilisateurId,
empruntId: emprunt.id,
materielId: data.materielId,
campusId: data.campusId,
sallePretId: data.sallePretId,
posteEmpruntId: data.posteEmpruntId,
action: 'ECART_DEPART_SIGNALE',
description: data.descriptionEcart,
dateAction: maintenant,
},
});
} else {
await tx.historique.create({
data: {
utilisateurId: data.utilisateurId,
empruntId: emprunt.id,
materielId: data.materielId,
campusId: data.campusId,
sallePretId: data.sallePretId,
posteEmpruntId: data.posteEmpruntId,
action: 'EMPRUNT_AUTOMATIQUE',
description: `Emprunt #${emprunt.id} active avec une checklist de depart inchangee`,
dateAction: maintenant,
},
});
}
return tx.emprunt.findUniqueOrThrow({
where: { id: emprunt.id },
include: {
materiel: { include: { categorie: true } },
checklists: { include: { elements: true } },
},
});
},
{ isolationLevel: Prisma.TransactionIsolationLevel.Serializable },
);
} }
export interface RestituerEmpruntData { export interface RestituerEmpruntData {
@@ -113,19 +254,34 @@ export interface RestituerEmpruntData {
modeIdentification: string; modeIdentification: string;
commentaireRetour?: string; commentaireRetour?: string;
elements: ChecklistElementData[]; elements: ChecklistElementData[];
anomalie?: { campusId: number;
type: string; sallePretId: number;
description: string; posteEmpruntId: number;
responsablesIds: number[]; responsablesIds: number[];
}; descriptionEcart?: string;
} }
/* Restitution atomique : checklist de retour, mise à jour de l'emprunt et du
matériel, et si non conforme création de l'anomalie et des notifications. */
export function restituerEmpruntComplet(data: RestituerEmpruntData): Promise<EmpruntAvecMateriel> { export function restituerEmpruntComplet(data: RestituerEmpruntData): Promise<EmpruntAvecMateriel> {
return prisma.$transaction(async (tx) => { return prisma.$transaction(async (tx) => {
const maintenant = new Date(); const maintenant = new Date();
const transition = await tx.emprunt.updateMany({
where: {
id: data.empruntId,
utilisateurId: data.utilisateurId,
statut: { in: STATUTS_EN_COURS },
},
data: {
statut: data.statutEmprunt,
...(data.statutEmprunt === 'CLOTURE' ? { dateRetourReelle: maintenant } : {}),
modeIdentificationRetour: data.modeIdentification,
commentaireRetour: data.commentaireRetour ?? null,
},
});
if (transition.count === 0) {
throw new AppError(409, 'Emprunt non restituable');
}
await tx.checklist.create({ await tx.checklist.create({
data: { data: {
empruntId: data.empruntId, empruntId: data.empruntId,
@@ -144,52 +300,64 @@ export function restituerEmpruntComplet(data: RestituerEmpruntData): Promise<Emp
}, },
}); });
await tx.emprunt.update({
where: { id: data.empruntId },
data: {
statut: data.statutEmprunt,
dateRetourReelle: maintenant,
modeIdentificationRetour: data.modeIdentification,
commentaireRetour: data.commentaireRetour ?? null,
},
});
await tx.materiel.update({ await tx.materiel.update({
where: { id: data.materielId }, where: { id: data.materielId },
data: { statut: data.statutMateriel }, data: { statut: data.statutMateriel },
}); });
if (data.anomalie) { if (data.descriptionEcart) {
const infoAnomalie = data.anomalie; const tentativeDejaSignalee = await tx.historique.findFirst({
const anomalie = await tx.anomalie.create({ where: {
data: {
empruntId: data.empruntId, empruntId: data.empruntId,
materielId: data.materielId, action: 'TENTATIVE_MODIFICATION_RETOUR',
utilisateurId: data.utilisateurId,
type: infoAnomalie.type,
description: infoAnomalie.description,
statut: 'DETECTEE',
detecteeAutomatiquement: true,
dateDetection: maintenant,
}, },
select: { id: true },
}); });
if (!tentativeDejaSignalee && data.responsablesIds.length > 0) {
if (infoAnomalie.responsablesIds.length > 0) {
await tx.notification.createMany({ await tx.notification.createMany({
data: infoAnomalie.responsablesIds.map((responsableId) => ({ data: data.responsablesIds.map((responsableId) => ({
utilisateurId: responsableId, utilisateurId: responsableId,
anomalieId: anomalie.id, titre: 'Changement signale au retour',
titre: 'Nouvelle anomalie detectee', message: data.descriptionEcart as string,
message: infoAnomalie.description, type: 'ECART_RETOUR',
type: 'ANOMALIE',
})), })),
}); });
} }
await tx.historique.create({
data: {
utilisateurId: data.utilisateurId,
empruntId: data.empruntId,
materielId: data.materielId,
campusId: data.campusId,
sallePretId: data.sallePretId,
posteEmpruntId: data.posteEmpruntId,
action: 'ECART_RETOUR_SIGNALE',
description: data.descriptionEcart,
dateAction: maintenant,
},
});
} else {
await tx.historique.create({
data: {
utilisateurId: data.utilisateurId,
empruntId: data.empruntId,
materielId: data.materielId,
campusId: data.campusId,
sallePretId: data.sallePretId,
posteEmpruntId: data.posteEmpruntId,
action: 'RESTITUTION_AUTOMATIQUE',
description: `Emprunt #${data.empruntId} cloture avec une checklist de retour inchangee`,
dateAction: maintenant,
},
});
} }
return tx.emprunt.findUniqueOrThrow({ return tx.emprunt.findUniqueOrThrow({
where: { id: data.empruntId }, where: { id: data.empruntId },
include: { materiel: { include: { categorie: true } } }, include: {
materiel: { include: { categorie: true } },
checklists: { include: { elements: true } },
},
}); });
}); });
} }
@@ -21,6 +21,19 @@ export type EmpruntResponsable = Prisma.EmpruntGetPayload<{
}; };
}>; }>;
export type EcartResponsable = Prisma.EmpruntGetPayload<{
include: {
utilisateur: true;
materiel: {
include: {
categorie: true;
accessoires: { include: { accessoire: true } };
};
};
checklists: { include: { elements: true } };
};
}>;
export type MaterielResponsable = Prisma.MaterielGetPayload<{ export type MaterielResponsable = Prisma.MaterielGetPayload<{
include: { include: {
categorie: true; categorie: true;
@@ -60,17 +73,32 @@ export type HistoriqueResponsable = Prisma.HistoriqueGetPayload<{
export interface EmpruntResponsableFiltres { export interface EmpruntResponsableFiltres {
statut?: string; statut?: string;
annee?: number;
recherche?: string;
tri?:
| 'dateEmprunt'
| 'dateRetourPrevue'
| 'dateRetourReelle'
| 'materiel'
| 'etudiant'
| 'statut';
ordre?: 'asc' | 'desc';
} }
export interface MaterielResponsableFiltres { export interface MaterielResponsableFiltres {
statut?: string; statut?: string;
categorieId?: number; categorieId?: number;
recherche?: string; recherche?: string;
tri?: 'nom' | 'reference' | 'categorie' | 'marque' | 'etatGeneral' | 'statut';
ordre?: 'asc' | 'desc';
} }
export interface AnomalieResponsableFiltres { export interface AnomalieResponsableFiltres {
statut?: string; statut?: string;
type?: string; type?: string;
recherche?: string;
tri?: 'dateDetection' | 'type' | 'materiel' | 'etudiant' | 'statut';
ordre?: 'asc' | 'desc';
} }
export interface NotificationResponsableFiltres { export interface NotificationResponsableFiltres {
@@ -84,6 +112,9 @@ export interface HistoriqueResponsableFiltres {
empruntId?: number; empruntId?: number;
dateDebut?: Date; dateDebut?: Date;
dateFin?: Date; dateFin?: Date;
recherche?: string;
tri?: 'dateAction' | 'action' | 'utilisateur' | 'materiel' | 'emprunt';
ordre?: 'asc' | 'desc';
} }
export interface ChangerStatutAnomalieData { export interface ChangerStatutAnomalieData {
@@ -94,6 +125,23 @@ export interface ChangerStatutAnomalieData {
observation?: string; observation?: string;
} }
export interface DeciderEcartResponsableData {
empruntId: number;
campusId: number;
responsableId: number;
statutAttendu: string;
statutEmpruntFinal: string;
statutMaterielFinal: string;
typeEcart: 'DEPART' | 'RETOUR';
decision: 'CONFIRMER' | 'REFUSER';
description: string;
observation?: string;
elementsDepartCorriges?: Array<{
id: number;
quantiteConstatee: number;
}>;
}
function mapStatutCounts(rows: Array<{ statut: string; _count: { _all: number } }>): StatutCount[] { function mapStatutCounts(rows: Array<{ statut: string; _count: { _all: number } }>): StatutCount[] {
return rows.map((row) => ({ statut: row.statut, count: row._count._all })); return rows.map((row) => ({ statut: row.statut, count: row._count._all }));
} }
@@ -154,16 +202,177 @@ export function findEmpruntsResponsable(
campusId: number, campusId: number,
filtres: EmpruntResponsableFiltres, filtres: EmpruntResponsableFiltres,
): Promise<EmpruntResponsable[]> { ): Promise<EmpruntResponsable[]> {
const ordre = filtres.ordre ?? 'desc';
const periode = filtres.annee
? {
gte: new Date(Date.UTC(filtres.annee, 0, 1)),
lt: new Date(Date.UTC(filtres.annee + 1, 0, 1)),
}
: undefined;
const orderBy: Prisma.EmpruntOrderByWithRelationInput[] = (() => {
switch (filtres.tri) {
case 'dateRetourPrevue':
return [{ dateRetourPrevue: ordre }, { id: 'desc' }];
case 'dateRetourReelle':
return [{ dateRetourReelle: ordre }, { id: 'desc' }];
case 'materiel':
return [{ materiel: { nom: ordre } }, { id: 'desc' }];
case 'etudiant':
return [{ utilisateur: { nom: ordre } }, { id: 'desc' }];
case 'statut':
return [{ statut: ordre }, { id: 'desc' }];
default:
return [{ dateEmprunt: ordre }, { id: 'desc' }];
}
})();
return prisma.emprunt.findMany({ return prisma.emprunt.findMany({
where: { where: {
campusId, campusId,
...(filtres.statut ? { statut: filtres.statut } : {}), ...(filtres.statut ? { statut: filtres.statut } : {}),
...(periode ? { dateEmprunt: periode } : {}),
...(filtres.recherche
? {
OR: [
{ materiel: { nom: { contains: filtres.recherche } } },
{ materiel: { reference: { contains: filtres.recherche } } },
{ materiel: { marque: { contains: filtres.recherche } } },
{ materiel: { modele: { contains: filtres.recherche } } },
{ utilisateur: { nom: { contains: filtres.recherche } } },
{ utilisateur: { prenom: { contains: filtres.recherche } } },
{ utilisateur: { email: { contains: filtres.recherche } } },
{ utilisateur: { classe: { contains: filtres.recherche } } },
],
}
: {}),
}, },
include: { include: {
utilisateur: true, utilisateur: true,
materiel: { include: { categorie: true } }, materiel: { include: { categorie: true } },
}, },
orderBy: { dateEmprunt: 'desc' }, orderBy,
});
}
const INCLUDE_ECART = {
utilisateur: true,
materiel: {
include: {
categorie: true,
accessoires: { include: { accessoire: true } },
},
},
checklists: { include: { elements: true } },
} satisfies Prisma.EmpruntInclude;
export function findEcartsResponsable(campusId: number): Promise<EcartResponsable[]> {
return prisma.emprunt.findMany({
where: {
campusId,
statut: {
in: ['EN_ATTENTE_VALIDATION_DEPART', 'EN_ATTENTE_VALIDATION_RETOUR'],
},
},
include: INCLUDE_ECART,
orderBy: { updatedAt: 'asc' },
});
}
export function findEcartResponsableById(
campusId: number,
empruntId: number,
): Promise<EcartResponsable | null> {
return prisma.emprunt.findFirst({
where: {
id: empruntId,
campusId,
statut: {
in: ['EN_ATTENTE_VALIDATION_DEPART', 'EN_ATTENTE_VALIDATION_RETOUR'],
},
},
include: INCLUDE_ECART,
});
}
export function deciderEcartResponsable(
data: DeciderEcartResponsableData,
): Promise<EcartResponsable> {
return prisma.$transaction(async (tx) => {
const maintenant = new Date();
const transition = await tx.emprunt.updateMany({
where: {
id: data.empruntId,
campusId: data.campusId,
statut: data.statutAttendu,
},
data: {
statut: data.statutEmpruntFinal,
...(data.typeEcart === 'RETOUR' ? { dateRetourReelle: maintenant } : {}),
},
});
if (transition.count === 0) {
throw new Error('ECART_DEJA_TRAITE');
}
await tx.materiel.update({
where: {
id: (await tx.emprunt.findUniqueOrThrow({ where: { id: data.empruntId } })).materielId,
},
data: { statut: data.statutMaterielFinal },
});
if (data.elementsDepartCorriges) {
await Promise.all(
data.elementsDepartCorriges.map((element) =>
tx.checklistElement.update({
where: { id: element.id },
data: {
etat: 'PRESENT',
quantiteConstatee: element.quantiteConstatee,
commentaire: null,
},
}),
),
);
}
if (data.decision === 'CONFIRMER') {
const emprunt = await tx.emprunt.findUniqueOrThrow({ where: { id: data.empruntId } });
await tx.anomalie.create({
data: {
empruntId: data.empruntId,
materielId: emprunt.materielId,
utilisateurId: emprunt.utilisateurId,
traiteeParId: data.responsableId,
type: data.typeEcart === 'DEPART' ? 'ECART_DEPART' : 'RETOUR_NON_CONFORME',
description: data.description,
statut: 'DETECTEE',
detecteeAutomatiquement: false,
observation: data.observation ?? null,
dateDetection: maintenant,
},
});
}
const emprunt = await tx.emprunt.findUniqueOrThrow({ where: { id: data.empruntId } });
await tx.historique.create({
data: {
utilisateurId: data.responsableId,
empruntId: data.empruntId,
materielId: emprunt.materielId,
campusId: data.campusId,
sallePretId: emprunt.sallePretId,
posteEmpruntId: emprunt.posteEmpruntId,
action: `ECART_${data.typeEcart}_${data.decision}`,
description: data.description,
dateAction: maintenant,
},
});
return tx.emprunt.findUniqueOrThrow({
where: { id: data.empruntId },
include: INCLUDE_ECART,
});
}); });
} }
@@ -171,6 +380,24 @@ export function findMaterielsResponsable(
campusId: number, campusId: number,
filtres: MaterielResponsableFiltres, filtres: MaterielResponsableFiltres,
): Promise<MaterielResponsable[]> { ): Promise<MaterielResponsable[]> {
const ordre = filtres.ordre ?? 'asc';
const orderBy: Prisma.MaterielOrderByWithRelationInput[] = (() => {
switch (filtres.tri) {
case 'reference':
return [{ reference: ordre }, { id: 'asc' }];
case 'categorie':
return [{ categorie: { nom: ordre } }, { nom: 'asc' }, { id: 'asc' }];
case 'marque':
return [{ marque: ordre }, { modele: ordre }, { nom: 'asc' }, { id: 'asc' }];
case 'etatGeneral':
return [{ etatGeneral: ordre }, { nom: 'asc' }, { id: 'asc' }];
case 'statut':
return [{ statut: ordre }, { nom: 'asc' }, { id: 'asc' }];
default:
return [{ nom: ordre }, { id: 'asc' }];
}
})();
return prisma.materiel.findMany({ return prisma.materiel.findMany({
where: { where: {
campusId, campusId,
@@ -192,7 +419,7 @@ export function findMaterielsResponsable(
categorie: true, categorie: true,
accessoires: { include: { accessoire: true } }, accessoires: { include: { accessoire: true } },
}, },
orderBy: { nom: 'asc' }, orderBy,
}); });
} }
@@ -200,11 +427,40 @@ export function findAnomaliesResponsable(
campusId: number, campusId: number,
filtres: AnomalieResponsableFiltres, filtres: AnomalieResponsableFiltres,
): Promise<AnomalieResponsable[]> { ): Promise<AnomalieResponsable[]> {
const ordre = filtres.ordre ?? 'desc';
const orderBy: Prisma.AnomalieOrderByWithRelationInput[] = (() => {
switch (filtres.tri) {
case 'type':
return [{ type: ordre }, { dateDetection: 'desc' }, { id: 'desc' }];
case 'materiel':
return [{ materiel: { nom: ordre } }, { dateDetection: 'desc' }, { id: 'desc' }];
case 'etudiant':
return [{ etudiant: { nom: ordre } }, { dateDetection: 'desc' }, { id: 'desc' }];
case 'statut':
return [{ statut: ordre }, { dateDetection: 'desc' }, { id: 'desc' }];
default:
return [{ dateDetection: ordre }, { id: 'desc' }];
}
})();
return prisma.anomalie.findMany({ return prisma.anomalie.findMany({
where: { where: {
emprunt: { campusId }, emprunt: { campusId },
...(filtres.statut ? { statut: filtres.statut } : {}), ...(filtres.statut ? { statut: filtres.statut } : {}),
...(filtres.type ? { type: filtres.type } : {}), ...(filtres.type ? { type: filtres.type } : {}),
...(filtres.recherche
? {
OR: [
{ description: { contains: filtres.recherche } },
{ type: { contains: filtres.recherche } },
{ materiel: { nom: { contains: filtres.recherche } } },
{ materiel: { reference: { contains: filtres.recherche } } },
{ etudiant: { nom: { contains: filtres.recherche } } },
{ etudiant: { prenom: { contains: filtres.recherche } } },
{ etudiant: { email: { contains: filtres.recherche } } },
],
}
: {}),
}, },
include: { include: {
emprunt: true, emprunt: true,
@@ -212,7 +468,7 @@ export function findAnomaliesResponsable(
materiel: { include: { categorie: true } }, materiel: { include: { categorie: true } },
traitePar: true, traitePar: true,
}, },
orderBy: { dateDetection: 'desc' }, orderBy,
}); });
} }
@@ -327,6 +583,22 @@ export function findHistoriqueResponsable(
campusId: number, campusId: number,
filtres: HistoriqueResponsableFiltres, filtres: HistoriqueResponsableFiltres,
): Promise<HistoriqueResponsable[]> { ): Promise<HistoriqueResponsable[]> {
const ordre = filtres.ordre ?? 'desc';
const orderBy: Prisma.HistoriqueOrderByWithRelationInput[] = (() => {
switch (filtres.tri) {
case 'action':
return [{ action: ordre }, { dateAction: 'desc' }, { id: 'desc' }];
case 'utilisateur':
return [{ utilisateur: { nom: ordre } }, { dateAction: 'desc' }, { id: 'desc' }];
case 'materiel':
return [{ materiel: { nom: ordre } }, { dateAction: 'desc' }, { id: 'desc' }];
case 'emprunt':
return [{ empruntId: ordre }, { dateAction: 'desc' }, { id: 'desc' }];
default:
return [{ dateAction: ordre }, { id: 'desc' }];
}
})();
return prisma.historique.findMany({ return prisma.historique.findMany({
where: { where: {
campusId, campusId,
@@ -342,6 +614,19 @@ export function findHistoriqueResponsable(
}, },
} }
: {}), : {}),
...(filtres.recherche
? {
OR: [
{ action: { contains: filtres.recherche } },
{ description: { contains: filtres.recherche } },
{ utilisateur: { nom: { contains: filtres.recherche } } },
{ utilisateur: { prenom: { contains: filtres.recherche } } },
{ utilisateur: { email: { contains: filtres.recherche } } },
{ materiel: { nom: { contains: filtres.recherche } } },
{ materiel: { reference: { contains: filtres.recherche } } },
],
}
: {}),
}, },
include: { include: {
utilisateur: true, utilisateur: true,
@@ -350,6 +635,6 @@ export function findHistoriqueResponsable(
sallePret: true, sallePret: true,
posteEmprunt: true, posteEmprunt: true,
}, },
orderBy: { dateAction: 'desc' }, orderBy,
}); });
} }
+7 -1
View File
@@ -1,8 +1,14 @@
import { Router } from 'express'; import { Router } from 'express';
import { getMesEmprunts, postEmprunt, postRestitution } from '../controllers/emprunt.controller'; import {
getMesEmprunts,
postAlerteChangementRetour,
postEmprunt,
postRestitution,
} from '../controllers/emprunt.controller';
export const empruntRoutes: Router = Router(); export const empruntRoutes: Router = Router();
empruntRoutes.post('/', postEmprunt); empruntRoutes.post('/', postEmprunt);
empruntRoutes.post('/:id/alerte-changement-retour', postAlerteChangementRetour);
empruntRoutes.post('/:id/restitution', postRestitution); empruntRoutes.post('/:id/restitution', postRestitution);
export const mesEmpruntsRoutes: Router = Router(); export const mesEmpruntsRoutes: Router = Router();
@@ -3,11 +3,13 @@ import {
getAnomalies, getAnomalies,
getDashboard, getDashboard,
getEmprunts, getEmprunts,
getEcarts,
getHistorique, getHistorique,
getHistoriqueCsv, getHistoriqueCsv,
getMateriels, getMateriels,
getNotifications, getNotifications,
patchAnomalieStatut, patchAnomalieStatut,
patchEcartDecision,
patchNotificationLue, patchNotificationLue,
patchNotificationsLues, patchNotificationsLues,
} from '../controllers/responsable.controller'; } from '../controllers/responsable.controller';
@@ -16,6 +18,8 @@ export const responsableRoutes: Router = Router();
responsableRoutes.get('/dashboard', getDashboard); responsableRoutes.get('/dashboard', getDashboard);
responsableRoutes.get('/emprunts', getEmprunts); responsableRoutes.get('/emprunts', getEmprunts);
responsableRoutes.get('/ecarts', getEcarts);
responsableRoutes.patch('/ecarts/:id/decision', patchEcartDecision);
responsableRoutes.get('/materiels', getMateriels); responsableRoutes.get('/materiels', getMateriels);
responsableRoutes.get('/anomalies', getAnomalies); responsableRoutes.get('/anomalies', getAnomalies);
responsableRoutes.patch('/anomalies/:id/statut', patchAnomalieStatut); responsableRoutes.patch('/anomalies/:id/statut', patchAnomalieStatut);
+158 -65
View File
@@ -11,11 +11,13 @@ import {
restituerEmpruntComplet, restituerEmpruntComplet,
EmpruntAvecMateriel, EmpruntAvecMateriel,
RestituerEmpruntData, RestituerEmpruntData,
signalerTentativeRetour,
} from '../repositories/emprunt.repository'; } from '../repositories/emprunt.repository';
import { findById as findMaterielById } from '../repositories/materiel.repository'; import { findDetailParCampus } from '../repositories/materiel.repository';
import { findById as findPosteById } from '../repositories/poste-emprunt.repository'; import { findById as findPosteById } from '../repositories/poste-emprunt.repository';
import { findResponsablesParCampus } from '../repositories/utilisateur.repository'; import { findResponsablesParCampus } from '../repositories/utilisateur.repository';
import { StatutEmprunt } from '../models/enums'; import { StatutEmprunt } from '../models/enums';
import { SignalerTentativeRetourRequest } from '../dtos/emprunt.dto';
const DUREE_EMPRUNT_JOURS = 14; const DUREE_EMPRUNT_JOURS = 14;
const STATUTS_RESTITUABLES: readonly string[] = ['EN_COURS', 'EN_RETARD']; const STATUTS_RESTITUABLES: readonly string[] = ['EN_COURS', 'EN_RETARD'];
@@ -25,6 +27,51 @@ export function listerMesEmpruntsEnCours(utilisateurId: number): Promise<Emprunt
return findEnCoursParUtilisateur(utilisateurId); return findEnCoursParUtilisateur(utilisateurId);
} }
export async function signalerTentativeModificationRetour(
utilisateurId: number,
empruntId: number,
request: SignalerTentativeRetourRequest,
): Promise<boolean> {
const emprunt = await findByIdAvecChecklists(empruntId);
if (!emprunt) {
throw new AppError(404, 'Emprunt introuvable');
}
if (emprunt.utilisateurId !== utilisateurId) {
throw new AppError(403, 'Cet emprunt ne vous appartient pas');
}
if (!STATUTS_RESTITUABLES.includes(emprunt.statut)) {
throw new AppError(409, 'Emprunt non restituable');
}
const checklistDepart = emprunt.checklists.find((checklist) => checklist.type === 'DEPART');
const elementDepart = checklistDepart?.elements.find(
(element) => element.nomElement.toLocaleLowerCase() === request.nomElement.toLocaleLowerCase(),
);
if (!elementDepart) {
throw new AppError(400, 'Element absent de la checklist de depart');
}
if (elementDepart.etat !== request.etatInitial) {
throw new AppError(400, "L'etat initial ne correspond pas au depart valide");
}
if (request.etatInitial === request.etatDemande) {
throw new AppError(400, 'Aucun changement a signaler');
}
const responsables = await findResponsablesParCampus(emprunt.campusId);
return signalerTentativeRetour({
empruntId,
utilisateurId,
materielId: emprunt.materielId,
campusId: emprunt.campusId,
sallePretId: emprunt.sallePretId,
posteEmpruntId: emprunt.posteEmpruntId,
responsablesIds: responsables.map((responsable) => responsable.id),
description:
`Tentative de modification au retour de l'emprunt #${emprunt.id} : ` +
`${elementDepart.nomElement} ${request.etatInitial} -> ${request.etatDemande}.`,
});
}
/* RG07/RG10/RG11/RG12 : création d'un emprunt avec sa checklist de départ. /* RG07/RG10/RG11/RG12 : création d'un emprunt avec sa checklist de départ.
Les contrôles d'éligibilité (campus, disponibilité) sont faits ici ; l'écriture Les contrôles d'éligibilité (campus, disponibilité) sont faits ici ; l'écriture
atomique est déléguée au repository. */ atomique est déléguée au repository. */
@@ -33,13 +80,10 @@ export async function creerEmprunt(
campusId: number, campusId: number,
request: CreerEmpruntRequest, request: CreerEmpruntRequest,
): Promise<EmpruntAvecMateriel> { ): Promise<EmpruntAvecMateriel> {
const materiel = await findMaterielById(request.materielId); const materiel = await findDetailParCampus(request.materielId, campusId);
if (!materiel) { if (!materiel) {
throw new AppError(404, 'Materiel introuvable'); throw new AppError(404, 'Materiel introuvable');
} }
if (materiel.campusId !== campusId) {
throw new AppError(403, 'Materiel rattache a un autre campus');
}
if (materiel.statut !== 'DISPONIBLE') { if (materiel.statut !== 'DISPONIBLE') {
throw new AppError(409, 'Materiel non disponible'); throw new AppError(409, 'Materiel non disponible');
} }
@@ -55,72 +99,124 @@ export async function creerEmprunt(
const dateRetourPrevue = new Date(); const dateRetourPrevue = new Date();
dateRetourPrevue.setDate(dateRetourPrevue.getDate() + DUREE_EMPRUNT_JOURS); dateRetourPrevue.setDate(dateRetourPrevue.getDate() + DUREE_EMPRUNT_JOURS);
const references: ElementReference[] =
materiel.accessoires.length > 0
? materiel.accessoires.map((liaison) => ({
accessoireId: liaison.accessoireId,
nomElement: liaison.accessoire.nom,
etat: 'PRESENT',
quantiteConstatee: liaison.quantiteAttendue,
}))
: [
{
accessoireId: null,
nomElement: materiel.nom,
etat: 'PRESENT',
quantiteConstatee: 1,
},
];
const elements = normaliserChecklist(references, request.elements, 'depart');
const differences = comparerEtats(references, elements);
const responsables = differences.length > 0 ? await findResponsablesParCampus(campusId) : [];
const descriptionEcart =
differences.length > 0
? `Ecart au depart pour ${materiel.nom} : ${differences.join(', ')}.`
: undefined;
return creerEmpruntComplet({ return creerEmpruntComplet({
utilisateurId, utilisateurId,
materielId: request.materielId, materielId: request.materielId,
categorieId: materiel.categorieId,
campusId, campusId,
sallePretId: poste.sallePretId, sallePretId: poste.sallePretId,
posteEmpruntId: request.posteEmpruntId, posteEmpruntId: request.posteEmpruntId,
dateRetourPrevue, dateRetourPrevue,
modeIdentification: request.modeIdentification, modeIdentification: request.modeIdentification,
commentaireDepart: request.commentaireDepart, commentaireDepart: request.commentaireDepart,
elements: request.elements, elements,
statutEmprunt: differences.length > 0 ? 'EN_ATTENTE_VALIDATION_DEPART' : 'EN_COURS',
statutMateriel: differences.length > 0 ? 'RESERVE' : 'EMPRUNTE',
responsablesIds: responsables.map((responsable) => responsable.id),
descriptionEcart,
}); });
} }
interface ElementDepart { interface ElementReference {
accessoireId: number | null; accessoireId: number | null;
nomElement: string; nomElement: string;
etat: string; etat: string;
quantiteConstatee: number;
} }
interface ResultatComparaison { function trouverElement(
conforme: boolean; reference: ElementReference,
auMoinsUnDeteriore: boolean; elements: ChecklistElementRequest[],
details: string[];
}
function trouverRetour(
depart: ElementDepart,
retour: ChecklistElementRequest[],
): ChecklistElementRequest | undefined { ): ChecklistElementRequest | undefined {
if (depart.accessoireId !== null) { if (reference.accessoireId !== null) {
const parId = retour.find((element) => element.accessoireId === depart.accessoireId); const parId = elements.find((element) => element.accessoireId === reference.accessoireId);
if (parId) { if (parId) {
return parId; return parId;
} }
} }
return retour.find((element) => element.nomElement === depart.nomElement); return elements.find(
(element) =>
element.nomElement.trim().toLocaleLowerCase() === reference.nomElement.toLocaleLowerCase(),
);
} }
/* RG17 : compare la checklist de départ à celle de retour. Un élément présent au function normaliserChecklist(
départ mais absent ou détérioré au retour rend la restitution non conforme (RG20). */ references: ElementReference[],
function comparerChecklists( elements: ChecklistElementRequest[],
depart: ElementDepart[], type: 'depart' | 'retour',
retour: ChecklistElementRequest[], ): ChecklistElementRequest[] {
): ResultatComparaison { if (elements.length !== references.length) {
const details: string[] = []; throw new AppError(400, `La checklist de ${type} doit contenir tous les elements attendus`);
let auMoinsUnDeteriore = false; }
for (const elementDepart of depart) { const utilises = new Set<ChecklistElementRequest>();
if (elementDepart.etat !== 'PRESENT') { return references.map((reference) => {
continue; const element = trouverElement(reference, elements);
if (!element || utilises.has(element)) {
throw new AppError(400, `Element de checklist manquant : ${reference.nomElement}`);
} }
utilises.add(element);
return {
accessoireId: reference.accessoireId ?? undefined,
nomElement: reference.nomElement,
etat: element.etat,
quantiteConstatee:
type === 'depart' && element.etat === 'PRESENT'
? reference.quantiteConstatee
: element.quantiteConstatee,
commentaire: element.commentaire,
};
});
}
const elementRetour = trouverRetour(elementDepart, retour); function comparerEtats(
if (!elementRetour || elementRetour.etat === 'ABSENT') { references: ElementReference[],
details.push(`${elementDepart.nomElement} manquant au retour`); elements: ChecklistElementRequest[],
} else if (elementRetour.etat === 'DETERIORE') { ): string[] {
details.push(`${elementDepart.nomElement} deteriore au retour`); const details: string[] = [];
auMoinsUnDeteriore = true;
for (const reference of references) {
const element = trouverElement(reference, elements);
if (
!element ||
element.etat !== reference.etat ||
element.quantiteConstatee !== reference.quantiteConstatee
) {
details.push(
`${reference.nomElement} : ${reference.etat}/${reference.quantiteConstatee} -> ${
element?.etat ?? 'ABSENT'
}/${element?.quantiteConstatee ?? 0}`,
);
} }
} }
return { conforme: details.length === 0, auMoinsUnDeteriore, details }; return details;
} }
/* RG14-RG20 : restitution d'un emprunt avec comparaison des checklists, clôture
ou passage en non conforme, et création automatique d'anomalie + notifications. */
export async function restituerEmprunt( export async function restituerEmprunt(
utilisateurId: number, utilisateurId: number,
empruntId: number, empruntId: number,
@@ -142,41 +238,38 @@ export async function restituerEmprunt(
throw new AppError(409, 'Checklist de depart introuvable'); throw new AppError(409, 'Checklist de depart introuvable');
} }
const comparaison = comparerChecklists( const references = checklistDepart.elements.map((element) => ({
checklistDepart.elements.map((element) => ({ accessoireId: element.accessoireId,
accessoireId: element.accessoireId, nomElement: element.nomElement,
nomElement: element.nomElement, etat: element.etat,
etat: element.etat, quantiteConstatee: element.quantiteConstatee,
})), }));
request.elements, const elements = normaliserChecklist(references, request.elements, 'retour');
); const differences = comparerEtats(references, elements);
const statutEmprunt: StatutEmprunt =
const statutEmprunt: StatutEmprunt = comparaison.conforme ? 'CLOTURE' : 'RETOUR_NON_CONFORME'; differences.length === 0 ? 'CLOTURE' : 'EN_ATTENTE_VALIDATION_RETOUR';
const responsables =
let statutMateriel = 'DISPONIBLE'; differences.length > 0 ? await findResponsablesParCampus(emprunt.campusId) : [];
if (!comparaison.conforme) { const descriptionEcart =
statutMateriel = comparaison.auMoinsUnDeteriore ? 'DETERIORE' : 'NON_CONFORME'; differences.length > 0
} ? `Changement au retour pour l'emprunt #${emprunt.id} : ${differences.join(', ')}.`
: undefined;
const donnees: RestituerEmpruntData = { const donnees: RestituerEmpruntData = {
empruntId, empruntId,
utilisateurId, utilisateurId,
materielId: emprunt.materielId, materielId: emprunt.materielId,
statutEmprunt, statutEmprunt,
statutMateriel, statutMateriel: differences.length === 0 ? 'DISPONIBLE' : 'EMPRUNTE',
modeIdentification: request.modeIdentification, modeIdentification: request.modeIdentification,
commentaireRetour: request.commentaireRetour, commentaireRetour: request.commentaireRetour,
elements: request.elements, elements,
campusId: emprunt.campusId,
sallePretId: emprunt.sallePretId,
posteEmpruntId: emprunt.posteEmpruntId,
responsablesIds: responsables.map((responsable) => responsable.id),
descriptionEcart,
}; };
if (!comparaison.conforme) {
const responsables = await findResponsablesParCampus(emprunt.campusId);
donnees.anomalie = {
type: 'RETOUR_NON_CONFORME',
description: `Retour non conforme : ${comparaison.details.join(', ')}.`,
responsablesIds: responsables.map((responsable) => responsable.id),
};
}
return restituerEmpruntComplet(donnees); return restituerEmpruntComplet(donnees);
} }
@@ -5,7 +5,10 @@ import {
countEmpruntsParStatut, countEmpruntsParStatut,
countMaterielsParStatut, countMaterielsParStatut,
countNotificationsNonLues, countNotificationsNonLues,
deciderEcartResponsable,
findActiviteRecente, findActiviteRecente,
findEcartResponsableById,
findEcartsResponsable,
findAnomalieResponsableById, findAnomalieResponsableById,
findAnomaliesResponsable, findAnomaliesResponsable,
findEmpruntsResponsable, findEmpruntsResponsable,
@@ -21,6 +24,7 @@ import {
HistoriqueResponsable, HistoriqueResponsable,
MaterielResponsable, MaterielResponsable,
NotificationResponsable, NotificationResponsable,
EcartResponsable,
} from '../repositories/responsable.repository'; } from '../repositories/responsable.repository';
import { import {
STATUT_ANOMALIE, STATUT_ANOMALIE,
@@ -41,19 +45,53 @@ export interface DashboardResponsableData {
export interface ListerEmpruntsResponsableFiltres { export interface ListerEmpruntsResponsableFiltres {
statut?: StatutEmprunt; statut?: StatutEmprunt;
annee?: number;
recherche?: string;
tri?: TriEmpruntResponsable;
ordre?: OrdreTri;
} }
export type TriEmpruntResponsable =
| 'dateEmprunt'
| 'dateRetourPrevue'
| 'dateRetourReelle'
| 'materiel'
| 'etudiant'
| 'statut';
export type OrdreTri = 'asc' | 'desc';
export interface ListerMaterielsResponsableFiltres { export interface ListerMaterielsResponsableFiltres {
statut?: StatutMateriel; statut?: StatutMateriel;
categorieId?: number; categorieId?: number;
recherche?: string; recherche?: string;
tri?: TriMaterielResponsable;
ordre?: OrdreTri;
} }
export type TriMaterielResponsable =
| 'nom'
| 'reference'
| 'categorie'
| 'marque'
| 'etatGeneral'
| 'statut';
export interface ListerAnomaliesResponsableFiltres { export interface ListerAnomaliesResponsableFiltres {
statut?: StatutAnomalie; statut?: StatutAnomalie;
type?: string; type?: string;
recherche?: string;
tri?: TriAnomalieResponsable;
ordre?: OrdreTri;
} }
export type TriAnomalieResponsable =
| 'dateDetection'
| 'type'
| 'materiel'
| 'etudiant'
| 'statut';
export interface ListerNotificationsResponsableFiltres { export interface ListerNotificationsResponsableFiltres {
lu?: boolean; lu?: boolean;
} }
@@ -65,13 +103,37 @@ export interface ListerHistoriqueResponsableFiltres {
empruntId?: number; empruntId?: number;
dateDebut?: Date; dateDebut?: Date;
dateFin?: Date; dateFin?: Date;
recherche?: string;
tri?: TriHistoriqueResponsable;
ordre?: OrdreTri;
} }
export type TriHistoriqueResponsable =
| 'dateAction'
| 'action'
| 'utilisateur'
| 'materiel'
| 'emprunt';
export interface ChangerStatutAnomalieResponsableRequest { export interface ChangerStatutAnomalieResponsableRequest {
statut: StatutAnomalie; statut: StatutAnomalie;
observation?: string; observation?: string;
} }
export interface DeciderEcartResponsableRequest {
decision: 'CONFIRMER' | 'REFUSER';
observation?: string;
statutMateriel?: StatutMateriel;
}
const STATUTS_MATERIEL_RETOUR_CONFIRMES: readonly StatutMateriel[] = [
'DISPONIBLE',
'NON_CONFORME',
'DETERIORE',
'MAINTENANCE',
'INDISPONIBLE',
];
const TRANSITIONS_ANOMALIE: Record<StatutAnomalie, StatutAnomalie[]> = { const TRANSITIONS_ANOMALIE: Record<StatutAnomalie, StatutAnomalie[]> = {
DETECTEE: ['EN_COURS_TRAITEMENT'], DETECTEE: ['EN_COURS_TRAITEMENT'],
EN_COURS_TRAITEMENT: ['RESOLUE'], EN_COURS_TRAITEMENT: ['RESOLUE'],
@@ -121,6 +183,49 @@ export function parseStatutEmprunt(value: unknown): StatutEmprunt | undefined {
return value as StatutEmprunt; return value as StatutEmprunt;
} }
export function parseAnneeEmprunt(value: unknown): number | undefined {
if (value === undefined) {
return undefined;
}
if (typeof value !== 'string') {
throw new AppError(400, 'annee invalide');
}
const annee = Number(value);
if (!Number.isInteger(annee) || annee < 2000 || annee > 2100) {
throw new AppError(400, 'annee invalide');
}
return annee;
}
export function parseTriEmprunt(value: unknown): TriEmpruntResponsable | undefined {
if (value === undefined) {
return undefined;
}
const valeurs: readonly TriEmpruntResponsable[] = [
'dateEmprunt',
'dateRetourPrevue',
'dateRetourReelle',
'materiel',
'etudiant',
'statut',
];
if (typeof value !== 'string' || !valeurs.includes(value as TriEmpruntResponsable)) {
throw new AppError(400, 'tri invalide');
}
return value as TriEmpruntResponsable;
}
export function parseOrdreTri(value: unknown): OrdreTri | undefined {
if (value === undefined) {
return undefined;
}
if (value !== 'asc' && value !== 'desc') {
throw new AppError(400, 'ordre invalide');
}
return value;
}
export function parseStatutMateriel(value: unknown): StatutMateriel | undefined { export function parseStatutMateriel(value: unknown): StatutMateriel | undefined {
if (value === undefined) { if (value === undefined) {
return undefined; return undefined;
@@ -131,6 +236,24 @@ export function parseStatutMateriel(value: unknown): StatutMateriel | undefined
return value as StatutMateriel; return value as StatutMateriel;
} }
export function parseTriMateriel(value: unknown): TriMaterielResponsable | undefined {
if (value === undefined) {
return undefined;
}
const valeurs: readonly TriMaterielResponsable[] = [
'nom',
'reference',
'categorie',
'marque',
'etatGeneral',
'statut',
];
if (typeof value !== 'string' || !valeurs.includes(value as TriMaterielResponsable)) {
throw new AppError(400, 'tri invalide');
}
return value as TriMaterielResponsable;
}
export function parseStatutAnomalie(value: unknown): StatutAnomalie | undefined { export function parseStatutAnomalie(value: unknown): StatutAnomalie | undefined {
if (value === undefined) { if (value === undefined) {
return undefined; return undefined;
@@ -141,6 +264,23 @@ export function parseStatutAnomalie(value: unknown): StatutAnomalie | undefined
return value as StatutAnomalie; return value as StatutAnomalie;
} }
export function parseTriAnomalie(value: unknown): TriAnomalieResponsable | undefined {
if (value === undefined) {
return undefined;
}
const valeurs: readonly TriAnomalieResponsable[] = [
'dateDetection',
'type',
'materiel',
'etudiant',
'statut',
];
if (typeof value !== 'string' || !valeurs.includes(value as TriAnomalieResponsable)) {
throw new AppError(400, 'tri invalide');
}
return value as TriAnomalieResponsable;
}
export function parseCategorieId(value: unknown): number | undefined { export function parseCategorieId(value: unknown): number | undefined {
if (value === undefined) { if (value === undefined) {
return undefined; return undefined;
@@ -180,6 +320,19 @@ export function parseAnomalieId(value: unknown): number {
return parsed; return parsed;
} }
export function parseEmpruntId(value: unknown): number {
if (typeof value !== 'string') {
throw new AppError(400, 'empruntId invalide');
}
const parsed = Number(value);
if (!Number.isInteger(parsed) || parsed <= 0) {
throw new AppError(400, 'empruntId invalide');
}
return parsed;
}
export function parsePositiveIntQuery(value: unknown, champ: string): number | undefined { export function parsePositiveIntQuery(value: unknown, champ: string): number | undefined {
if (value === undefined) { if (value === undefined) {
return undefined; return undefined;
@@ -212,6 +365,23 @@ export function parseDateQuery(value: unknown, champ: string): Date | undefined
return parsed; return parsed;
} }
export function parseTriHistorique(value: unknown): TriHistoriqueResponsable | undefined {
if (value === undefined) {
return undefined;
}
const valeurs: readonly TriHistoriqueResponsable[] = [
'dateAction',
'action',
'utilisateur',
'materiel',
'emprunt',
];
if (typeof value !== 'string' || !valeurs.includes(value as TriHistoriqueResponsable)) {
throw new AppError(400, 'tri invalide');
}
return value as TriHistoriqueResponsable;
}
export function parseLu(value: unknown): boolean | undefined { export function parseLu(value: unknown): boolean | undefined {
if (value === undefined) { if (value === undefined) {
return undefined; return undefined;
@@ -234,6 +404,101 @@ export function listerEmpruntsResponsable(
return findEmpruntsResponsable(campusId, filtres); return findEmpruntsResponsable(campusId, filtres);
} }
export function listerEcartsResponsable(
roleCode: string,
campusId: number,
): Promise<EcartResponsable[]> {
verifierResponsable(roleCode);
return findEcartsResponsable(campusId);
}
function decrireChecklist(ecart: EcartResponsable, type: 'DEPART' | 'RETOUR'): string {
const checklist = ecart.checklists.find((item) => item.type === type);
if (!checklist) {
throw new AppError(409, `Checklist de ${type.toLocaleLowerCase()} introuvable`);
}
return checklist.elements
.map((element) => `${element.nomElement}=${element.etat}/${element.quantiteConstatee}`)
.join(', ');
}
export async function deciderEcartResponsableService(
responsableId: number,
roleCode: string,
campusId: number,
empruntId: number,
request: DeciderEcartResponsableRequest,
): Promise<EcartResponsable> {
verifierResponsable(roleCode);
const ecart = await findEcartResponsableById(campusId, empruntId);
if (!ecart) {
throw new AppError(404, 'Ecart en attente introuvable');
}
const typeEcart = ecart.statut === 'EN_ATTENTE_VALIDATION_DEPART' ? 'DEPART' : 'RETOUR';
if (
typeEcart === 'RETOUR' &&
request.decision === 'CONFIRMER' &&
(!request.statutMateriel || !STATUTS_MATERIEL_RETOUR_CONFIRMES.includes(request.statutMateriel))
) {
throw new AppError(400, 'statutMateriel final requis pour confirmer le retour');
}
const description =
`Ecart ${typeEcart.toLocaleLowerCase()} ${request.decision.toLocaleLowerCase()} ` +
`pour l'emprunt #${ecart.id} : ${decrireChecklist(ecart, typeEcart)}.`;
let elementsDepartCorriges: Array<{ id: number; quantiteConstatee: number }> | undefined;
if (typeEcart === 'DEPART' && request.decision === 'REFUSER') {
const checklistDepart = ecart.checklists.find((checklist) => checklist.type === 'DEPART');
if (!checklistDepart) {
throw new AppError(409, 'Checklist de depart introuvable');
}
elementsDepartCorriges = checklistDepart.elements.map((element) => {
const accessoire = ecart.materiel.accessoires.find(
(liaison) => liaison.accessoireId === element.accessoireId,
);
return {
id: element.id,
quantiteConstatee: accessoire?.quantiteAttendue ?? 1,
};
});
}
try {
return await deciderEcartResponsable({
empruntId,
campusId,
responsableId,
statutAttendu: ecart.statut,
statutEmpruntFinal:
typeEcart === 'DEPART'
? 'EN_COURS'
: request.decision === 'CONFIRMER'
? 'RETOUR_NON_CONFORME'
: 'CLOTURE',
statutMaterielFinal:
typeEcart === 'DEPART'
? 'EMPRUNTE'
: request.decision === 'CONFIRMER'
? (request.statutMateriel as StatutMateriel)
: 'DISPONIBLE',
typeEcart,
decision: request.decision,
description,
observation: request.observation,
elementsDepartCorriges,
});
} catch (error) {
if (error instanceof Error && error.message === 'ECART_DEJA_TRAITE') {
throw new AppError(409, 'Cet ecart a deja ete traite');
}
throw error;
}
}
export function listerMaterielsResponsable( export function listerMaterielsResponsable(
roleCode: string, roleCode: string,
campusId: number, campusId: number,
@@ -0,0 +1,22 @@
class ChecklistElementItem {
const ChecklistElementItem({
required this.accessoireId,
required this.nom,
required this.etat,
required this.quantite,
});
factory ChecklistElementItem.fromJson(Map<String, dynamic> json) {
return ChecklistElementItem(
accessoireId: json["accessoireId"] as int?,
nom: json["nomElement"] as String,
etat: json["etat"] as String,
quantite: json["quantiteConstatee"] as int,
);
}
final int? accessoireId;
final String nom;
final String etat;
final int quantite;
}
+11
View File
@@ -1,4 +1,5 @@
import "materiel_item.dart"; import "materiel_item.dart";
import "checklist_element_item.dart";
/// Un emprunt en cours de l'étudiant, affiché dans le parcours de restitution /// Un emprunt en cours de l'étudiant, affiché dans le parcours de restitution
/// et renvoyé par l'API. /// et renvoyé par l'API.
@@ -9,6 +10,7 @@ class EmpruntItem {
required this.dateEmprunt, required this.dateEmprunt,
required this.retourPrevu, required this.retourPrevu,
required this.statut, required this.statut,
required this.checklistDepart,
}); });
factory EmpruntItem.fromJson(Map<String, dynamic> json) { factory EmpruntItem.fromJson(Map<String, dynamic> json) {
@@ -21,6 +23,13 @@ class EmpruntItem {
dateEmprunt: _dateHeure(dateEmprunt), dateEmprunt: _dateHeure(dateEmprunt),
retourPrevu: _date(retourPrevu), retourPrevu: _date(retourPrevu),
statut: json["statut"] as String, statut: json["statut"] as String,
checklistDepart: (json["checklistDepart"] as List<dynamic>? ?? const [])
.map(
(element) => ChecklistElementItem.fromJson(
Map<String, dynamic>.from(element as Map),
),
)
.toList(),
); );
} }
@@ -29,6 +38,7 @@ class EmpruntItem {
final String dateEmprunt; final String dateEmprunt;
final String retourPrevu; final String retourPrevu;
final String statut; final String statut;
final List<ChecklistElementItem> checklistDepart;
EmpruntItem copyWith({MaterielItem? materiel, String? statut}) { EmpruntItem copyWith({MaterielItem? materiel, String? statut}) {
return EmpruntItem( return EmpruntItem(
@@ -37,6 +47,7 @@ class EmpruntItem {
dateEmprunt: dateEmprunt, dateEmprunt: dateEmprunt,
retourPrevu: retourPrevu, retourPrevu: retourPrevu,
statut: statut ?? this.statut, statut: statut ?? this.statut,
checklistDepart: checklistDepart,
); );
} }
@@ -6,6 +6,7 @@ import "../models/materiel_item.dart";
import "../services/materiel_service.dart"; import "../services/materiel_service.dart";
import "../widgets/ensup_top_bar.dart"; import "../widgets/ensup_top_bar.dart";
import "../widgets/brand_corners.dart"; import "../widgets/brand_corners.dart";
import "../widgets/app_message.dart";
import "../widgets/materiel_card.dart"; import "../widgets/materiel_card.dart";
import "detail_screen.dart"; import "detail_screen.dart";
@@ -65,9 +66,7 @@ class _CatalogueScreenState extends State<CatalogueScreen> {
if (!mounted) { if (!mounted) {
return; return;
} }
ScaffoldMessenger.of( AppMessage.erreur(context, error);
context,
).showSnackBar(SnackBar(content: Text(error.toString())));
} finally { } finally {
if (mounted) { if (mounted) {
setState(() => _selectionEnCoursId = null); setState(() => _selectionEnCoursId = null);
@@ -7,10 +7,9 @@ import "../services/emprunt_service.dart";
import "../widgets/ensup_top_bar.dart"; import "../widgets/ensup_top_bar.dart";
import "../widgets/brand_corners.dart"; import "../widgets/brand_corners.dart";
import "../widgets/etat_checklist.dart"; import "../widgets/etat_checklist.dart";
import "../widgets/app_message.dart";
import "confirmation_screen.dart"; import "confirmation_screen.dart";
/// Checklist de départ (RG11) : l'étudiant indique l'état de chaque accessoire
/// attendu avant de confirmer l'emprunt.
class ChecklistDepartScreen extends StatefulWidget { class ChecklistDepartScreen extends StatefulWidget {
const ChecklistDepartScreen({super.key, required this.item}); const ChecklistDepartScreen({super.key, required this.item});
@@ -31,6 +30,8 @@ class _ChecklistDepartScreenState extends State<ChecklistDepartScreen> {
final TextEditingController _commentaireController = TextEditingController(); final TextEditingController _commentaireController = TextEditingController();
bool _envoiEnCours = false; bool _envoiEnCours = false;
bool get _ecartDeclare => _etats.any((etat) => etat != EtatChecklist.present);
@override @override
void dispose() { void dispose() {
_commentaireController.dispose(); _commentaireController.dispose();
@@ -77,9 +78,7 @@ class _ChecklistDepartScreenState extends State<ChecklistDepartScreen> {
if (!mounted) { if (!mounted) {
return; return;
} }
ScaffoldMessenger.of( AppMessage.erreur(context, error);
context,
).showSnackBar(SnackBar(content: Text(error.toString())));
} finally { } finally {
if (mounted) { if (mounted) {
setState(() => _envoiEnCours = false); setState(() => _envoiEnCours = false);
@@ -240,12 +239,45 @@ class _ChecklistDepartScreenState extends State<ChecklistDepartScreen> {
crossAxisAlignment: CrossAxisAlignment.start, crossAxisAlignment: CrossAxisAlignment.start,
children: [ children: [
ChecklistInstructions( ChecklistInstructions(
titre: "Instructions", titre: "État de référence",
texte: texte:
"Vérifiez physiquement chaque élément du kit et indiquez son état : " "Tous les éléments sont préremplis comme présents. Vérifiez-les "
"Présent, Absent ou Détérioré. Signalez tout élément manquant ou " "physiquement et modifiez uniquement ceux qui sont absents ou détériorés.",
"endommagé pour éviter tout litige au retour.",
), ),
if (_ecartDeclare) ...[
const SizedBox(height: 14),
Container(
width: double.infinity,
padding: const EdgeInsets.all(14),
decoration: BoxDecoration(
color: const Color(0xFFFFF7ED),
borderRadius: BorderRadius.circular(8),
border: Border.all(color: const Color(0xFFFED7AA)),
),
child: Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
const Icon(
Icons.warning_amber_rounded,
color: Color(0xFFD97706),
size: 20,
),
const SizedBox(width: 10),
Expanded(
child: Text(
"Cet écart sera transmis au responsable. L'emprunt restera "
"en attente jusqu'à sa confirmation.",
style: GoogleFonts.titilliumWeb(
fontSize: 13,
color: EnsupColors.text2,
height: 1.4,
),
),
),
],
),
),
],
const SizedBox(height: 14), const SizedBox(height: 14),
ChecklistCommentaire(controller: _commentaireController), ChecklistCommentaire(controller: _commentaireController),
const SizedBox(height: 14), const SizedBox(height: 14),
@@ -266,7 +298,9 @@ class _ChecklistDepartScreenState extends State<ChecklistDepartScreen> {
label: Text( label: Text(
_envoiEnCours _envoiEnCours
? "Enregistrement..." ? "Enregistrement..."
: "Valider la checklist et confirmer l'emprunt", : _ecartDeclare
? "Signaler l'écart"
: "Confirmer l'emprunt",
textAlign: TextAlign.center, textAlign: TextAlign.center,
style: GoogleFonts.darkerGrotesque( style: GoogleFonts.darkerGrotesque(
fontWeight: FontWeight.w700, fontWeight: FontWeight.w700,
@@ -4,14 +4,14 @@ import "../demo_identity.dart";
import "../theme/ensup_colors.dart"; import "../theme/ensup_colors.dart";
import "../models/emprunt_item.dart"; import "../models/emprunt_item.dart";
import "../models/anomalie_retour.dart"; import "../models/anomalie_retour.dart";
import "../models/checklist_element_item.dart";
import "../services/emprunt_service.dart"; import "../services/emprunt_service.dart";
import "../widgets/ensup_top_bar.dart"; import "../widgets/ensup_top_bar.dart";
import "../widgets/brand_corners.dart"; import "../widgets/brand_corners.dart";
import "../widgets/etat_checklist.dart"; import "../widgets/etat_checklist.dart";
import "../widgets/app_message.dart";
import "resultat_retour_screen.dart"; import "resultat_retour_screen.dart";
/// Checklist de retour (RG16) : l'étudiant indique l'état de chaque accessoire
/// au retour, en vue de la comparaison avec la checklist de départ.
class ChecklistRetourScreen extends StatefulWidget { class ChecklistRetourScreen extends StatefulWidget {
const ChecklistRetourScreen({super.key, required this.emprunt}); const ChecklistRetourScreen({super.key, required this.emprunt});
@@ -22,16 +22,41 @@ class ChecklistRetourScreen extends StatefulWidget {
} }
class _ChecklistRetourScreenState extends State<ChecklistRetourScreen> { class _ChecklistRetourScreenState extends State<ChecklistRetourScreen> {
late final List<String> _elements = late final List<ChecklistElementItem> _checklistDepart =
widget.emprunt.materiel.accessoires.isEmpty widget.emprunt.checklistDepart.isNotEmpty
? <String>[widget.emprunt.materiel.nom] ? widget.emprunt.checklistDepart
: widget.emprunt.materiel.accessoires; : (widget.emprunt.materiel.accessoires.isEmpty
late final List<EtatChecklist> _etats = List<EtatChecklist>.filled( ? [
_elements.length, ChecklistElementItem(
EtatChecklist.present, accessoireId: null,
nom: widget.emprunt.materiel.nom,
etat: "PRESENT",
quantite: 1,
),
]
: widget.emprunt.materiel.accessoires
.map(
(nom) => ChecklistElementItem(
accessoireId: null,
nom: nom,
etat: "PRESENT",
quantite: 1,
),
)
.toList());
late final List<String> _elements = _checklistDepart
.map((element) => element.nom)
.toList();
late final List<EtatChecklist> _etatsInitiales = _checklistDepart
.map((element) => _etatDepuisApi(element.etat))
.toList();
late final List<EtatChecklist> _etats = List<EtatChecklist>.from(
_etatsInitiales,
); );
final TextEditingController _commentaireController = TextEditingController(); final TextEditingController _commentaireController = TextEditingController();
bool _envoiEnCours = false; bool _envoiEnCours = false;
bool _alerteEnCours = false;
bool _alerteEnvoyee = false;
@override @override
void dispose() { void dispose() {
@@ -44,15 +69,12 @@ class _ChecklistRetourScreenState extends State<ChecklistRetourScreen> {
final anomalies = <AnomalieRetour>[]; final anomalies = <AnomalieRetour>[];
for (var i = 0; i < _etats.length; i++) { for (var i = 0; i < _etats.length; i++) {
if (_etats[i] == EtatChecklist.absent) { if (_etats[i] != _etatsInitiales[i]) {
anomalies.add(
AnomalieRetour(element: _elements[i], etatRetour: "Absent au retour"),
);
} else if (_etats[i] == EtatChecklist.deteriore) {
anomalies.add( anomalies.add(
AnomalieRetour( AnomalieRetour(
element: _elements[i], element: _elements[i],
etatRetour: "Détérioré au retour", etatRetour:
"${_etatLabel(_etatsInitiales[i])}${_etatLabel(_etats[i])}",
), ),
); );
} }
@@ -63,12 +85,13 @@ class _ChecklistRetourScreenState extends State<ChecklistRetourScreen> {
empruntId: widget.emprunt.id, empruntId: widget.emprunt.id,
commentaireRetour: _commentaireController.text, commentaireRetour: _commentaireController.text,
elements: _elements.asMap().entries.map((entry) { elements: _elements.asMap().entries.map((entry) {
final elementDepart = _checklistDepart[entry.key];
return { return {
if (elementDepart.accessoireId != null)
"accessoireId": elementDepart.accessoireId,
"nomElement": entry.value, "nomElement": entry.value,
"etat": _etatApi(_etats[entry.key]), "etat": _etatApi(_etats[entry.key]),
"quantiteConstatee": _etats[entry.key] == EtatChecklist.absent "quantiteConstatee": _quantiteConstatee(entry.key),
? 0
: 1,
}; };
}).toList(), }).toList(),
); );
@@ -92,9 +115,7 @@ class _ChecklistRetourScreenState extends State<ChecklistRetourScreen> {
if (!mounted) { if (!mounted) {
return; return;
} }
ScaffoldMessenger.of( AppMessage.erreur(context, error);
context,
).showSnackBar(SnackBar(content: Text(error.toString())));
} finally { } finally {
if (mounted) { if (mounted) {
setState(() => _envoiEnCours = false); setState(() => _envoiEnCours = false);
@@ -102,6 +123,56 @@ class _ChecklistRetourScreenState extends State<ChecklistRetourScreen> {
} }
} }
Future<void> _changerEtat(int index, EtatChecklist etat) async {
setState(() => _etats[index] = etat);
if (_alerteEnvoyee || etat == _etatsInitiales[index]) {
return;
}
setState(() {
_alerteEnvoyee = true;
_alerteEnCours = true;
});
try {
await EmpruntService.signalerTentativeRetour(
empruntId: widget.emprunt.id,
nomElement: _elements[index],
etatInitial: _etatApi(_etatsInitiales[index]),
etatDemande: _etatApi(etat),
);
if (!mounted) return;
AppMessage.alerte(
context,
"Le responsable a été alerté de cette tentative de modification.",
titre: "Changement signalé",
);
} catch (error) {
if (!mounted) return;
setState(() => _alerteEnvoyee = false);
AppMessage.erreur(context, error);
} finally {
if (mounted) {
setState(() => _alerteEnCours = false);
}
}
}
int _quantiteConstatee(int index) {
if (_etats[index] == EtatChecklist.absent) {
return 0;
}
final quantiteDepart = _checklistDepart[index].quantite;
return quantiteDepart > 0 ? quantiteDepart : 1;
}
static EtatChecklist _etatDepuisApi(String etat) {
return switch (etat) {
"ABSENT" => EtatChecklist.absent,
"DETERIORE" => EtatChecklist.deteriore,
_ => EtatChecklist.present,
};
}
String _etatApi(EtatChecklist etat) { String _etatApi(EtatChecklist etat) {
switch (etat) { switch (etat) {
case EtatChecklist.present: case EtatChecklist.present:
@@ -113,6 +184,14 @@ class _ChecklistRetourScreenState extends State<ChecklistRetourScreen> {
} }
} }
String _etatLabel(EtatChecklist etat) {
return switch (etat) {
EtatChecklist.present => "Présent",
EtatChecklist.absent => "Absent",
EtatChecklist.deteriore => "Détérioré",
};
}
@override @override
Widget build(BuildContext context) { Widget build(BuildContext context) {
return Scaffold( return Scaffold(
@@ -242,7 +321,7 @@ class _ChecklistRetourScreenState extends State<ChecklistRetourScreen> {
ChecklistTableau( ChecklistTableau(
accessoires: _elements, accessoires: _elements,
etats: _etats, etats: _etats,
onChanged: (index, etat) => setState(() => _etats[index] = etat), onChanged: _changerEtat,
), ),
], ],
); );
@@ -252,11 +331,12 @@ class _ChecklistRetourScreenState extends State<ChecklistRetourScreen> {
return Column( return Column(
crossAxisAlignment: CrossAxisAlignment.start, crossAxisAlignment: CrossAxisAlignment.start,
children: [ children: [
const ChecklistInstructions( ChecklistInstructions(
titre: "Rappel checklist de départ", titre: "État validé au départ",
texte: texte:
"Au départ, tous les accessoires du kit étaient présents. " "La restitution reprend automatiquement l'état validé au départ : "
"Indiquez leur état au retour ; toute différence sera signalée.", "${_checklistDepart.map((element) => "${element.nom} ${_etatLabel(_etatDepuisApi(element.etat)).toLowerCase()}").join(" · ")}. "
"Toute modification alerte immédiatement un responsable.",
), ),
const SizedBox(height: 14), const SizedBox(height: 14),
ChecklistCommentaire( ChecklistCommentaire(
@@ -267,8 +347,8 @@ class _ChecklistRetourScreenState extends State<ChecklistRetourScreen> {
SizedBox( SizedBox(
width: double.infinity, width: double.infinity,
child: FilledButton.icon( child: FilledButton.icon(
onPressed: _envoiEnCours ? null : _valider, onPressed: _envoiEnCours || _alerteEnCours ? null : _valider,
icon: _envoiEnCours icon: _envoiEnCours || _alerteEnCours
? const SizedBox( ? const SizedBox(
width: 18, width: 18,
height: 18, height: 18,
@@ -279,7 +359,11 @@ class _ChecklistRetourScreenState extends State<ChecklistRetourScreen> {
) )
: const Icon(Icons.check, size: 18), : const Icon(Icons.check, size: 18),
label: Text( label: Text(
_envoiEnCours ? "Enregistrement..." : "Valider le retour", _alerteEnCours
? "Alerte en cours..."
: _envoiEnCours
? "Enregistrement..."
: "Valider le retour",
style: GoogleFonts.darkerGrotesque( style: GoogleFonts.darkerGrotesque(
fontWeight: FontWeight.w700, fontWeight: FontWeight.w700,
fontSize: 16, fontSize: 16,
@@ -7,7 +7,6 @@ import "../models/materiel_item.dart";
import "../widgets/ensup_top_bar.dart"; import "../widgets/ensup_top_bar.dart";
import "../widgets/brand_corners.dart"; import "../widgets/brand_corners.dart";
/// Écran de succès clôturant l'emprunt : confirmation + récapitulatif.
class ConfirmationScreen extends StatelessWidget { class ConfirmationScreen extends StatelessWidget {
const ConfirmationScreen({super.key, required this.emprunt, this.note}); const ConfirmationScreen({super.key, required this.emprunt, this.note});
@@ -15,6 +14,7 @@ class ConfirmationScreen extends StatelessWidget {
final String? note; final String? note;
MaterielItem get item => emprunt.materiel; MaterielItem get item => emprunt.materiel;
bool get _enAttente => emprunt.statut == "EN_ATTENTE_VALIDATION_DEPART";
static String _deuxChiffres(int valeur) => valeur.toString().padLeft(2, "0"); static String _deuxChiffres(int valeur) => valeur.toString().padLeft(2, "0");
@@ -127,15 +127,23 @@ class ConfirmationScreen extends StatelessWidget {
} }
Widget _boiteSucces() { Widget _boiteSucces() {
final couleur = _enAttente
? const Color(0xFFD97706)
: const Color(0xFF15803D);
return Container( return Container(
width: double.infinity, width: double.infinity,
padding: const EdgeInsets.all(36), padding: const EdgeInsets.all(36),
decoration: BoxDecoration( decoration: BoxDecoration(
gradient: const LinearGradient( gradient: LinearGradient(
colors: [Color(0xFFF0FDF4), Color(0xFFECFDF5)], colors: _enAttente
? const [Color(0xFFFFF7ED), Color(0xFFFFFBEB)]
: const [Color(0xFFF0FDF4), Color(0xFFECFDF5)],
), ),
borderRadius: BorderRadius.circular(16), borderRadius: BorderRadius.circular(16),
border: Border.all(color: const Color(0xFFBBF7D0), width: 2), border: Border.all(
color: _enAttente ? const Color(0xFFFED7AA) : const Color(0xFFBBF7D0),
width: 2,
),
), ),
child: Column( child: Column(
children: [ children: [
@@ -144,12 +152,14 @@ class ConfirmationScreen extends StatelessWidget {
height: 72, height: 72,
decoration: BoxDecoration( decoration: BoxDecoration(
shape: BoxShape.circle, shape: BoxShape.circle,
gradient: const LinearGradient( gradient: LinearGradient(
colors: [Color(0xFF16A34A), Color(0xFF22C55E)], colors: _enAttente
? const [Color(0xFFD97706), Color(0xFFF59E0B)]
: const [Color(0xFF16A34A), Color(0xFF22C55E)],
), ),
boxShadow: [ boxShadow: [
BoxShadow( BoxShadow(
color: const Color(0xFF16A34A).withValues(alpha: 0.3), color: couleur.withValues(alpha: 0.3),
blurRadius: 20, blurRadius: 20,
offset: const Offset(0, 6), offset: const Offset(0, 6),
), ),
@@ -159,20 +169,24 @@ class ConfirmationScreen extends StatelessWidget {
), ),
const SizedBox(height: 18), const SizedBox(height: 18),
Text( Text(
"Emprunt enregistré !", _enAttente ? "Écart transmis" : "Emprunt enregistré !",
style: GoogleFonts.darkerGrotesque( style: GoogleFonts.darkerGrotesque(
fontSize: 28, fontSize: 28,
fontWeight: FontWeight.w900, fontWeight: FontWeight.w900,
color: const Color(0xFF15803D), color: couleur,
), ),
), ),
const SizedBox(height: 8), const SizedBox(height: 8),
Text( Text(
"Votre emprunt a bien été enregistré. Vous pouvez récupérer le matériel.", _enAttente
? "Le matériel est réservé. Attendez la confirmation du responsable avant de le récupérer."
: "Votre emprunt est actif. Vous pouvez récupérer le matériel.",
textAlign: TextAlign.center, textAlign: TextAlign.center,
style: GoogleFonts.titilliumWeb( style: GoogleFonts.titilliumWeb(
fontSize: 14, fontSize: 14,
color: const Color(0xFF166534), color: _enAttente
? const Color(0xFF9A3412)
: const Color(0xFF166534),
), ),
), ),
], ],
@@ -211,6 +225,11 @@ class ConfirmationScreen extends StatelessWidget {
_rrow("Date d'emprunt", date), _rrow("Date d'emprunt", date),
_rrow("Heure", heure), _rrow("Heure", heure),
_rrow("Campus", item.campus), _rrow("Campus", item.campus),
_rrow(
"Statut",
_enAttente ? "En attente de confirmation" : "En cours",
valueColor: _enAttente ? const Color(0xFFD97706) : null,
),
if (note != null) if (note != null)
_rrow("Note", note, valueColor: const Color(0xFFD97706)), _rrow("Note", note, valueColor: const Color(0xFFD97706)),
], ],
+2 -3
View File
@@ -3,6 +3,7 @@ import "package:google_fonts/google_fonts.dart";
import "../demo_identity.dart"; import "../demo_identity.dart";
import "../services/auth_service.dart"; import "../services/auth_service.dart";
import "../theme/ensup_colors.dart"; import "../theme/ensup_colors.dart";
import "../widgets/app_message.dart";
import "../widgets/ensup_top_bar.dart"; import "../widgets/ensup_top_bar.dart";
import "../widgets/profile_card.dart"; import "../widgets/profile_card.dart";
import "../widgets/action_card.dart"; import "../widgets/action_card.dart";
@@ -22,9 +23,7 @@ class HomeScreen extends StatelessWidget {
} }
} catch (error) { } catch (error) {
if (!context.mounted) return; if (!context.mounted) return;
ScaffoldMessenger.of( AppMessage.erreur(context, error);
context,
).showSnackBar(SnackBar(content: Text(error.toString())));
} }
} }
+10 -13
View File
@@ -4,6 +4,7 @@ import "../demo_identity.dart";
import "../services/api_client.dart"; import "../services/api_client.dart";
import "../services/auth_service.dart"; import "../services/auth_service.dart";
import "../theme/ensup_colors.dart"; import "../theme/ensup_colors.dart";
import "../widgets/app_message.dart";
import "../widgets/ensup_top_bar.dart"; import "../widgets/ensup_top_bar.dart";
import "../widgets/identification_option.dart"; import "../widgets/identification_option.dart";
import "../widgets/brand_corners.dart"; import "../widgets/brand_corners.dart";
@@ -72,10 +73,10 @@ class _LoginScreenState extends State<LoginScreen> {
} }
} catch (_) { } catch (_) {
if (!mounted) return; if (!mounted) return;
ScaffoldMessenger.of(context).showSnackBar( AppMessage.alerte(
const SnackBar( context,
content: Text("La session Microsoft doit etre renouvelee."), "La session Microsoft doit être renouvelée.",
), titre: "Session expirée",
); );
} finally { } finally {
if (mounted) { if (mounted) {
@@ -87,12 +88,10 @@ class _LoginScreenState extends State<LoginScreen> {
Future<void> _identifierParQr() async { Future<void> _identifierParQr() async {
if (_connexionEnCours) return; if (_connexionEnCours) return;
if (AuthService.mode == AuthenticationMode.azure) { if (AuthService.mode == AuthenticationMode.azure) {
ScaffoldMessenger.of(context).showSnackBar( AppMessage.information(
const SnackBar( context,
content: Text( "L'identification QR sécurisée n'est pas encore configurée.",
"L'identification QR securisee n'est pas encore configuree.", titre: "QR code indisponible",
),
),
); );
return; return;
} }
@@ -121,9 +120,7 @@ class _LoginScreenState extends State<LoginScreen> {
_ouvrirPourRole(profile.roleCode); _ouvrirPourRole(profile.roleCode);
} catch (error) { } catch (error) {
if (!mounted) return; if (!mounted) return;
ScaffoldMessenger.of( AppMessage.erreur(context, error, titre: "Connexion impossible");
context,
).showSnackBar(SnackBar(content: Text(error.toString())));
} finally { } finally {
if (mounted) { if (mounted) {
setState(() => _connexionEnCours = false); setState(() => _connexionEnCours = false);
File diff suppressed because it is too large Load Diff
@@ -7,6 +7,7 @@ import "../services/emprunt_service.dart";
import "../services/materiel_service.dart"; import "../services/materiel_service.dart";
import "../widgets/ensup_top_bar.dart"; import "../widgets/ensup_top_bar.dart";
import "../widgets/brand_corners.dart"; import "../widgets/brand_corners.dart";
import "../widgets/app_message.dart";
import "checklist_retour_screen.dart"; import "checklist_retour_screen.dart";
/// Sélection de l'emprunt en cours à restituer (RG15 : ses propres emprunts). /// Sélection de l'emprunt en cours à restituer (RG15 : ses propres emprunts).
@@ -50,9 +51,7 @@ class _RestitutionSelectScreenState extends State<RestitutionSelectScreen> {
if (!mounted) { if (!mounted) {
return; return;
} }
ScaffoldMessenger.of( AppMessage.erreur(context, error);
context,
).showSnackBar(SnackBar(content: Text(error.toString())));
} finally { } finally {
if (mounted) { if (mounted) {
setState(() => _chargementId = null); setState(() => _chargementId = null);
@@ -7,8 +7,6 @@ import "../models/anomalie_retour.dart";
import "../widgets/ensup_top_bar.dart"; import "../widgets/ensup_top_bar.dart";
import "../widgets/brand_corners.dart"; import "../widgets/brand_corners.dart";
/// Résultat de la restitution (RG17-RG20) : conforme (succès) ou non conforme
/// (anomalie détectée + notification au responsable).
class ResultatRetourScreen extends StatelessWidget { class ResultatRetourScreen extends StatelessWidget {
const ResultatRetourScreen({ const ResultatRetourScreen({
super.key, super.key,
@@ -19,7 +17,8 @@ class ResultatRetourScreen extends StatelessWidget {
final EmpruntItem emprunt; final EmpruntItem emprunt;
final List<AnomalieRetour> anomalies; final List<AnomalieRetour> anomalies;
bool get _conforme => anomalies.isEmpty; bool get _conforme => emprunt.statut == "CLOTURE";
bool get _enAttente => emprunt.statut == "EN_ATTENTE_VALIDATION_RETOUR";
static String _deux(int valeur) => valeur.toString().padLeft(2, "0"); static String _deux(int valeur) => valeur.toString().padLeft(2, "0");
@@ -27,6 +26,8 @@ class ResultatRetourScreen extends StatelessWidget {
Widget build(BuildContext context) { Widget build(BuildContext context) {
final fond = _conforme final fond = _conforme
? const [Color(0xFFF0FDF4), Color(0xFFF8FAFC)] ? const [Color(0xFFF0FDF4), Color(0xFFF8FAFC)]
: _enAttente
? const [Color(0xFFFFF7ED), Color(0xFFF8FAFC)]
: const [Color(0xFFFFF5F5), Color(0xFFF8FAFC)]; : const [Color(0xFFFFF5F5), Color(0xFFF8FAFC)];
return Scaffold( return Scaffold(
@@ -75,7 +76,12 @@ class ResultatRetourScreen extends StatelessWidget {
constraints: const BoxConstraints(maxWidth: 560), constraints: const BoxConstraints(maxWidth: 560),
child: Column( child: Column(
children: [ children: [
if (_conforme) _succes() else _anomalie(), if (_conforme)
_succes()
else if (_enAttente)
_attente()
else
_anomalie(),
const SizedBox(height: 16), const SizedBox(height: 16),
SizedBox( SizedBox(
width: double.infinity, width: double.infinity,
@@ -280,6 +286,81 @@ class ResultatRetourScreen extends StatelessWidget {
); );
} }
Widget _attente() {
return Column(
children: [
Container(
width: double.infinity,
padding: const EdgeInsets.all(22),
decoration: BoxDecoration(
color: const Color(0xFFFFF7ED),
borderRadius: BorderRadius.circular(12),
border: Border.all(color: const Color(0xFFFED7AA), width: 1.5),
),
child: Column(
children: [
const Icon(
Icons.pending_actions_outlined,
color: Color(0xFFD97706),
size: 42,
),
const SizedBox(height: 12),
Text(
"Changement en attente",
style: GoogleFonts.darkerGrotesque(
fontSize: 26,
fontWeight: FontWeight.w900,
color: const Color(0xFF9A3412),
),
),
const SizedBox(height: 8),
Text(
"Le responsable a été alerté. Le changement reste provisoire "
"et aucune anomalie n'est créée avant sa confirmation.",
textAlign: TextAlign.center,
style: GoogleFonts.titilliumWeb(
fontSize: 14,
color: EnsupColors.text2,
height: 1.5,
),
),
],
),
),
const SizedBox(height: 16),
Container(
width: double.infinity,
padding: const EdgeInsets.all(18),
decoration: BoxDecoration(
color: Colors.white,
borderRadius: BorderRadius.circular(8),
border: Border.all(color: EnsupColors.line),
),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
"MODIFICATIONS DÉCLARÉES",
style: GoogleFonts.darkerGrotesque(
fontSize: 12,
fontWeight: FontWeight.w700,
color: EnsupColors.muted,
),
),
const SizedBox(height: 8),
for (final anomalie in anomalies)
_drow(
anomalie.element,
anomalie.etatRetour,
valeurCouleur: const Color(0xFFD97706),
),
],
),
),
],
);
}
Widget _drow(String cle, String valeur, {Color? valeurCouleur}) { Widget _drow(String cle, String valeur, {Color? valeurCouleur}) {
return Padding( return Padding(
padding: const EdgeInsets.symmetric(vertical: 7), padding: const EdgeInsets.symmetric(vertical: 7),
+29 -5
View File
@@ -17,18 +17,22 @@ class EmpruntService {
"materielId": materielId, "materielId": materielId,
"posteEmpruntId": posteEmpruntId, "posteEmpruntId": posteEmpruntId,
"modeIdentification": "MAIL_ENSUP", "modeIdentification": "MAIL_ENSUP",
if (commentaireDepart.trim().isNotEmpty) "commentaireDepart": commentaireDepart.trim(), if (commentaireDepart.trim().isNotEmpty)
"commentaireDepart": commentaireDepart.trim(),
"elements": elements, "elements": elements,
}); });
final data = (reponse as Map<String, dynamic>)["data"] as Map<String, dynamic>; final data =
(reponse as Map<String, dynamic>)["data"] as Map<String, dynamic>;
return EmpruntResponse.fromJson(data); return EmpruntResponse.fromJson(data);
} }
static Future<List<EmpruntItem>> getMesEmprunts() async { static Future<List<EmpruntItem>> getMesEmprunts() async {
final reponse = await ApiClient.get("/mes-emprunts"); final reponse = await ApiClient.get("/mes-emprunts");
final data = (reponse as Map<String, dynamic>)["data"] as List<dynamic>; final data = (reponse as Map<String, dynamic>)["data"] as List<dynamic>;
return data.map((json) => EmpruntItem.fromJson(json as Map<String, dynamic>)).toList(); return data
.map((json) => EmpruntItem.fromJson(json as Map<String, dynamic>))
.toList();
} }
static Future<EmpruntResponse> restituerEmprunt({ static Future<EmpruntResponse> restituerEmprunt({
@@ -38,11 +42,31 @@ class EmpruntService {
}) async { }) async {
final reponse = await ApiClient.post("/emprunts/$empruntId/restitution", { final reponse = await ApiClient.post("/emprunts/$empruntId/restitution", {
"modeIdentification": "MAIL_ENSUP", "modeIdentification": "MAIL_ENSUP",
if (commentaireRetour.trim().isNotEmpty) "commentaireRetour": commentaireRetour.trim(), if (commentaireRetour.trim().isNotEmpty)
"commentaireRetour": commentaireRetour.trim(),
"elements": elements, "elements": elements,
}); });
final data = (reponse as Map<String, dynamic>)["data"] as Map<String, dynamic>; final data =
(reponse as Map<String, dynamic>)["data"] as Map<String, dynamic>;
return EmpruntResponse.fromJson(data); return EmpruntResponse.fromJson(data);
} }
static Future<bool> signalerTentativeRetour({
required int empruntId,
required String nomElement,
required String etatInitial,
required String etatDemande,
}) async {
final reponse = await ApiClient.post(
"/emprunts/$empruntId/alerte-changement-retour",
{
"nomElement": nomElement,
"etatInitial": etatInitial,
"etatDemande": etatDemande,
},
);
final data = Map<String, dynamic>.from(reponse["data"] as Map);
return data["alerteCreee"] as bool;
}
} }
@@ -9,25 +9,127 @@ class ResponsableService {
return Map<String, dynamic>.from(reponse["data"] as Map); return Map<String, dynamic>.from(reponse["data"] as Map);
} }
static Future<List<Map<String, dynamic>>> emprunts() => static Future<List<Map<String, dynamic>>> emprunts({
_liste("/responsable/emprunts"); String? statut,
int? annee,
String? recherche,
String tri = "dateEmprunt",
String ordre = "desc",
}) {
final parametres = <String, String>{
"tri": tri,
"ordre": ordre,
"statut": ?statut,
if (annee != null) "annee": "$annee",
if (recherche != null && recherche.trim().isNotEmpty)
"q": recherche.trim(),
};
final query = Uri(queryParameters: parametres).query;
return _liste("/responsable/emprunts?$query");
}
static Future<List<Map<String, dynamic>>> materiels() => static Future<List<Map<String, dynamic>>> ecarts() =>
_liste("/responsable/materiels"); _liste("/responsable/ecarts");
static Future<List<Map<String, dynamic>>> anomalies() => static Future<List<Map<String, dynamic>>> materiels({
_liste("/responsable/anomalies"); String? statut,
int? categorieId,
String? recherche,
String tri = "nom",
String ordre = "asc",
}) {
final parametres = <String, String>{
"tri": tri,
"ordre": ordre,
"statut": ?statut,
if (categorieId != null) "categorieId": "$categorieId",
if (recherche != null && recherche.trim().isNotEmpty)
"q": recherche.trim(),
};
final query = Uri(queryParameters: parametres).query;
return _liste("/responsable/materiels?$query");
}
static Future<List<Map<String, dynamic>>> anomalies({
String? statut,
String? type,
String? recherche,
String tri = "dateDetection",
String ordre = "desc",
}) {
final parametres = <String, String>{
"tri": tri,
"ordre": ordre,
"statut": ?statut,
"type": ?type,
if (recherche != null && recherche.trim().isNotEmpty)
"q": recherche.trim(),
};
final query = Uri(queryParameters: parametres).query;
return _liste("/responsable/anomalies?$query");
}
static Future<List<Map<String, dynamic>>> notifications() => static Future<List<Map<String, dynamic>>> notifications() =>
_liste("/responsable/notifications"); _liste("/responsable/notifications");
static Future<List<Map<String, dynamic>>> historique() => static Future<List<Map<String, dynamic>>> historique({
_liste("/responsable/historique"); String? action,
DateTime? dateDebut,
DateTime? dateFin,
String? recherche,
String tri = "dateAction",
String ordre = "desc",
}) {
return _liste(
"/responsable/historique?${_historiqueQuery(action: action, dateDebut: dateDebut, dateFin: dateFin, recherche: recherche, tri: tri, ordre: ordre)}",
);
}
static Future<ApiFile> exporterHistorique() => ApiClient.getFile( static Future<ApiFile> exporterHistorique({
"/responsable/historique/export.csv", String? action,
fallbackFileName: "historique-responsable.csv", DateTime? dateDebut,
); DateTime? dateFin,
String? recherche,
String tri = "dateAction",
String ordre = "desc",
}) {
final query = _historiqueQuery(
action: action,
dateDebut: dateDebut,
dateFin: dateFin,
recherche: recherche,
tri: tri,
ordre: ordre,
);
return ApiClient.getFile(
"/responsable/historique/export.csv?$query",
fallbackFileName: "historique-responsable.csv",
);
}
static String _historiqueQuery({
String? action,
DateTime? dateDebut,
DateTime? dateFin,
String? recherche,
required String tri,
required String ordre,
}) {
final finIncluse = dateFin == null
? null
: DateTime(dateFin.year, dateFin.month, dateFin.day, 23, 59, 59, 999);
return Uri(
queryParameters: {
"tri": tri,
"ordre": ordre,
"action": ?action,
if (dateDebut != null) "dateDebut": dateDebut.toUtc().toIso8601String(),
if (finIncluse != null) "dateFin": finIncluse.toUtc().toIso8601String(),
if (recherche != null && recherche.trim().isNotEmpty)
"q": recherche.trim(),
},
).query;
}
static Future<int> marquerNotificationsLues() async { static Future<int> marquerNotificationsLues() async {
final reponse = await ApiClient.patch( final reponse = await ApiClient.patch(
@@ -49,6 +151,22 @@ class ResponsableService {
return Map<String, dynamic>.from(reponse["data"] as Map); return Map<String, dynamic>.from(reponse["data"] as Map);
} }
static Future<Map<String, dynamic>> deciderEcart({
required int empruntId,
required String decision,
String? observation,
String? statutMateriel,
}) async {
final reponse =
await ApiClient.patch("/responsable/ecarts/$empruntId/decision", {
"decision": decision,
if (observation != null && observation.trim().isNotEmpty)
"observation": observation.trim(),
"statutMateriel": ?statutMateriel,
});
return Map<String, dynamic>.from(reponse["data"] as Map);
}
static Future<List<Map<String, dynamic>>> _liste(String chemin) async { static Future<List<Map<String, dynamic>>> _liste(String chemin) async {
final reponse = await ApiClient.get(chemin); final reponse = await ApiClient.get(chemin);
final data = reponse["data"] as List; final data = reponse["data"] as List;
+189
View File
@@ -0,0 +1,189 @@
import "package:flutter/material.dart";
import "package:google_fonts/google_fonts.dart";
import "../theme/ensup_colors.dart";
enum AppMessageType { information, succes, alerte, erreur }
class AppMessage {
AppMessage._();
static int _messageActif = 0;
static void information(
BuildContext context,
String message, {
String titre = "Information",
}) {
_afficher(
context,
type: AppMessageType.information,
titre: titre,
message: message,
);
}
static void succes(
BuildContext context,
String message, {
String titre = "Action réussie",
}) {
_afficher(
context,
type: AppMessageType.succes,
titre: titre,
message: message,
);
}
static void alerte(
BuildContext context,
String message, {
String titre = "Attention",
}) {
_afficher(
context,
type: AppMessageType.alerte,
titre: titre,
message: message,
);
}
static void erreur(
BuildContext context,
Object erreur, {
String titre = "Une erreur est survenue",
}) {
_afficher(
context,
type: AppMessageType.erreur,
titre: titre,
message: _nettoyerErreur(erreur),
duree: const Duration(seconds: 8),
);
}
static void _afficher(
BuildContext context, {
required AppMessageType type,
required String titre,
required String message,
Duration duree = const Duration(seconds: 6),
}) {
final messenger = ScaffoldMessenger.of(context);
final identifiant = ++_messageActif;
final style = _style(type);
messenger
..clearSnackBars()
..hideCurrentMaterialBanner()
..showMaterialBanner(
MaterialBanner(
backgroundColor: style.fond,
surfaceTintColor: Colors.transparent,
elevation: 6,
shadowColor: EnsupColors.text.withValues(alpha: 0.18),
padding: const EdgeInsets.fromLTRB(20, 14, 8, 14),
leadingPadding: const EdgeInsets.only(right: 14),
leading: Container(
width: 40,
height: 40,
decoration: BoxDecoration(
color: style.couleur,
borderRadius: BorderRadius.circular(8),
),
child: Icon(style.icone, color: Colors.white, size: 22),
),
content: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
Text(
titre,
style: GoogleFonts.darkerGrotesque(
fontSize: 16,
fontWeight: FontWeight.w800,
color: style.texte,
),
),
const SizedBox(height: 2),
Text(
message,
style: GoogleFonts.titilliumWeb(
fontSize: 13,
color: EnsupColors.text2,
height: 1.35,
),
),
],
),
actions: [
IconButton(
tooltip: "Fermer le message",
onPressed: () {
_messageActif++;
messenger.hideCurrentMaterialBanner();
},
icon: Icon(Icons.close, color: style.texte),
),
],
),
);
Future<void>.delayed(duree, () {
if (_messageActif == identifiant && messenger.mounted) {
messenger.hideCurrentMaterialBanner();
}
});
}
static String _nettoyerErreur(Object erreur) {
return erreur
.toString()
.replaceFirst(RegExp(r"^(Exception|Error):\s*"), "")
.trim();
}
static _AppMessageStyle _style(AppMessageType type) {
return switch (type) {
AppMessageType.information => const _AppMessageStyle(
fond: Color(0xFFEFF8FC),
couleur: EnsupColors.cyan,
texte: EnsupColors.blue3,
icone: Icons.info_outline,
),
AppMessageType.succes => const _AppMessageStyle(
fond: Color(0xFFF0FDF4),
couleur: EnsupColors.green,
texte: Color(0xFF166534),
icone: Icons.check_circle_outline,
),
AppMessageType.alerte => const _AppMessageStyle(
fond: Color(0xFFFFF7ED),
couleur: Color(0xFFD97706),
texte: Color(0xFF9A3412),
icone: Icons.warning_amber_rounded,
),
AppMessageType.erreur => const _AppMessageStyle(
fond: Color(0xFFFFF1F2),
couleur: EnsupColors.red,
texte: Color(0xFF9F1239),
icone: Icons.error_outline,
),
};
}
}
class _AppMessageStyle {
const _AppMessageStyle({
required this.fond,
required this.couleur,
required this.texte,
required this.icone,
});
final Color fond;
final Color couleur;
final Color texte;
final IconData icone;
}
+82 -7
View File
@@ -23,6 +23,8 @@ Ces décisions s'appliquent à tout le projet, sauf mention contraire.
| Workflow Git : `develop` comme branche d'intégration + branches dédiées `feat/...`, `fix/...`, `docs/...` | `master` reste figé ; chaque changement logique est isolé sur une branche puis mergé dans `develop`, conformément à `CLAUDE.md`. | | Workflow Git : `develop` comme branche d'intégration + branches dédiées `feat/...`, `fix/...`, `docs/...` | `master` reste figé ; chaque changement logique est isolé sur une branche puis mergé dans `develop`, conformément à `CLAUDE.md`. |
| Process avant chaque migration : `prisma format` -> `prisma validate` -> `npm run build` -> migration | Détecter toute erreur de schéma/typage avant de toucher la base. | | Process avant chaque migration : `prisma format` -> `prisma validate` -> `npm run build` -> migration | Détecter toute erreur de schéma/typage avant de toucher la base. |
| DTO nommés `XxxResponse` (sortie) et `XxxRequest` (entrée) | Le sens est explicite dans le nom. Sortie = mapping (`toXxxResponse`), entrée = validation. | | DTO nommés `XxxResponse` (sortie) et `XxxRequest` (entrée) | Le sens est explicite dans le nom. Sortie = mapping (`toXxxResponse`), entrée = validation. |
| Confirmation responsable uniquement en cas d'écart | Les checklists sont préremplies. Sans modification, le départ ou le retour est automatique ; une différence déclarée reste provisoire jusqu'à la décision du responsable. |
| Un seul emprunt bloquant par catégorie et par étudiant | La catégorie reste bloquée jusqu'à la clôture du retour, sans limite calendaire après clôture. |
--- ---
@@ -35,11 +37,11 @@ l'historique complet, y compris des étapes devenues obsolètes après brancheme
|---|---|---| |---|---|---|
| Infrastructure | Terminé | Docker Compose SQL Server + Adminer, monorepo, backend Node/TS, frontend Flutter Web. | | Infrastructure | Terminé | Docker Compose SQL Server + Adminer, monorepo, backend Node/TS, frontend Flutter Web. |
| Base de données | Terminé pour la V1 | Schéma Prisma 16 entités, migrations, seeds et fixtures de démonstration. | | Base de données | Terminé pour la V1 | Schéma Prisma 16 entités, migrations, seeds et fixtures de démonstration. |
| API étudiant | Terminé pour la V1 | Catalogue, détail matériel, création d'emprunt, mes emprunts, restitution, anomalie automatique. | | API étudiant | À adapter au nouveau workflow | Les parcours automatiques restent valides ; le retour doit être prérempli depuis le départ et les seules différences doivent être mises en attente. |
| Frontend étudiant | Fonctionnel pour la V1 | Parcours API complet, ordre identification puis choix validé, interface premium et responsive fidèle à la maquette. | | Frontend étudiant | À adapter au nouveau workflow | Interface premium conservée ; préremplissage et écran d'attente à ajouter lorsqu'une valeur est modifiée. |
| Authentification | Prête pour Azure, démo active | Double mode sécurisé : `x-user-email` seulement en développement, MSAL/OIDC + Bearer JWT en mode Azure. Validation réelle en attente des identifiants Entra ID. | | Authentification | Prête pour Azure, démo active | Double mode sécurisé : `x-user-email` seulement en développement, MSAL/OIDC + Bearer JWT en mode Azure. Validation réelle en attente des identifiants Entra ID. |
| API responsable | Terminé pour la V1 | Dashboard, emprunts, stock, anomalies, notifications, historique et export CSV, avec contrôle du rôle et du campus. | | API responsable | Partielle pour le nouveau workflow | Supervision existante ; confirmation des écarts de départ et de retour à ajouter avec alertes et transitions atomiques. |
| Frontend responsable | Fonctionnel pour la V1 | Espace de supervision responsive avec navigation dédiée, dashboard métier, vues API et export CSV opérationnel. | | Frontend responsable | Partiel pour le nouveau workflow | Dashboard existant ; file des écarts, contrôle des checklists et décisions à ajouter. |
| Tests automatisés | Non démarré | Tests backend/frontend/E2E à ajouter ; tests runtime manuels effectués. | | Tests automatisés | Non démarré | Tests backend/frontend/E2E à ajouter ; tests runtime manuels effectués. |
| Documentation | Partielle | README principal et documents de conception présents ; OpenAPI, guides utilisateur et captures restent à produire. | | Documentation | Partielle | README principal et documents de conception présents ; OpenAPI, guides utilisateur et captures restent à produire. |
@@ -68,7 +70,9 @@ Notes :
- le wrapper `flutter` peut rester bloqué dans l'environnement Codex ; l'analyse directe avec l'exécutable Dart fonctionne et ne signale aucune erreur ; - le wrapper `flutter` peut rester bloqué dans l'environnement Codex ; l'analyse directe avec l'exécutable Dart fonctionne et ne signale aucune erreur ;
- la compilation Web complète a été validée avec l'exécutable Dart du SDK Flutter et produit `build/web`. - la compilation Web complète a été validée avec l'exécutable Dart du SDK Flutter et produit `build/web`.
## Scénario de démo validé ## Scénario de démo historique
> Ce scénario valide toujours les parcours automatiques sans écart. Les branches avec modification de checklist et confirmation responsable restent à implémenter et à tester.
Scénario étudiant validé avec SQL Server Docker et backend compilé : Scénario étudiant validé avec SQL Server Docker et backend compilé :
@@ -272,7 +276,8 @@ En terminal interactif (VS Code), `migrate dev` fonctionne normalement (taper `y
| Tailles de colonnes `@db.NVarChar(n)` | À cadrer | Faible V1, important pour qualité BDD. | | Tailles de colonnes `@db.NVarChar(n)` | À cadrer | Faible V1, important pour qualité BDD. |
| Swagger/OpenAPI | À faire | Moyen : utile pour tester/documenter l'API. | | Swagger/OpenAPI | À faire | Moyen : utile pour tester/documenter l'API. |
| Validation réelle Azure AD | En attente des identifiants Entra ID | Fort : le code OIDC/MSAL/JWT est prêt, mais une connexion Microsoft réelle doit encore être testée sur le tenant ENSUP. | | Validation réelle Azure AD | En attente des identifiants Entra ID | Fort : le code OIDC/MSAL/JWT est prêt, mais une connexion Microsoft réelle doit encore être testée sur le tenant ENSUP. |
| Limite d'emprunts actifs par étudiant | À valider métier | Non bloquant V1 ; décision métier non présente dans les règles actuelles. | | Blocage d'une catégorie jusqu'à la clôture du retour | Décidé, à implémenter | Fort : contrôle à appliquer atomiquement lors de toute demande d'emprunt. |
| Confirmation responsable des écarts déclarés | Décidée, à implémenter | Fort : nécessite des statuts conditionnels, alertes, endpoints et écrans de décision. |
--- ---
@@ -458,6 +463,76 @@ En terminal interactif (VS Code), `migrate dev` fonctionne normalement (taper `y
- Limite actuelle : faute d'identifiants Entra ID, le flux Microsoft réel n'a pas encore pu être exécuté. Le QR sécurisé reste un sous-bloc séparé à développer après le SSO. - Limite actuelle : faute d'identifiants Entra ID, le flux Microsoft réel n'a pas encore pu être exécuté. Le QR sécurisé reste un sous-bloc séparé à développer après le SSO.
- Commits : `313bb1c`, `530bd52`, `ef31e2a`, `dc208fa`, `36224f3`. - Commits : `313bb1c`, `530bd52`, `ef31e2a`, `dc208fa`, `36224f3`.
### Étape 48 — Changement métier : confirmation responsable des écarts
- Décision corrigée après précision métier : le responsable ne valide pas systématiquement chaque départ et chaque retour.
- Au départ, la checklist est préremplie avec l'état de référence, normalement tous les éléments présents. Sans modification, l'emprunt démarre automatiquement.
- Si l'étudiant modifie une valeur au départ, le matériel est réservé, le responsable est alerté et l'état déclaré reste provisoire jusqu'à sa confirmation.
- Au retour, la checklist est automatiquement préremplie avec l'état de départ réellement validé.
- Sans modification au retour, la restitution est clôturée automatiquement.
- Dès que l'étudiant tente de modifier une valeur au retour, le responsable est alerté. Aucun changement de l'état officiel du matériel n'est appliqué avant sa décision.
- La confirmation du responsable authentifie le changement et crée l'anomalie ; un refus conserve l'état précédemment validé.
- Un étudiant ne peut avoir qu'un emprunt bloquant d'une même catégorie. La catégorie est débloquée après la clôture automatique ou la décision du responsable sur un retour modifié.
- Chaque tentative de modification, décision, anomalie et changement d'état officiel est historisé.
- `CLAUDE.md`, `CONTEXT.md`, les règles métier, `TODO.md`, le README et la maquette textuelle sont synchronisés avant toute modification du code.
- Un diagramme Mermaid devient la source de vérité du parcours ; le PNG contradictoire est conservé uniquement comme historique.
### Étape 49 — Messages applicatifs visibles
- Les `SnackBar` Flutter noir et blanc sont remplacés par un composant global affiché en haut de l'écran.
- Quatre niveaux visuels sont distingués : information, succès, alerte et erreur.
- Chaque message dispose d'une icône, d'un titre, d'un texte explicite, d'une fermeture manuelle et d'une disparition automatique.
- Le composant est utilisé dans les parcours étudiant, la connexion et l'espace responsable.
- Vérification réussie avec `dart analyze`.
- Commit : `4ee593c`.
### Étape 50 — Tableau des emprunts responsable
- La liste des emprunts responsable devient un tableau opérationnel sur ordinateur avec une colonne par information : numéro, matériel, étudiant, dates et statut.
- Les en-têtes permettent de trier par matériel, étudiant, date d'emprunt, retour prévu, retour réel et statut.
- Des filtres serveur sont ajoutés pour l'année, le statut et la recherche par matériel, référence ou étudiant.
- Le tableau devient une liste compacte sur petit écran afin d'éviter tout débordement horizontal.
- Les menus déroulants contraignent les libellés longs afin d'éviter les débordements Flutter.
- Les requêtes restent filtrées par campus côté API.
- Vérifications réussies : build et lint backend, analyse Dart, tris et recherches testés sur SQL Server.
### Étape 51 — Tableau du stock matériel responsable
- La liste du stock devient un tableau opérationnel sur ordinateur et conserve une vue compacte sur petit écran.
- Les colonnes présentent la référence, le matériel, la catégorie, la marque et le modèle, l'état général et le statut.
- La recherche et les filtres serveur permettent de cibler un statut ou une catégorie du campus.
- Le tri serveur accepte le matériel, la référence, la catégorie, la marque, l'état général et le statut, dans les deux ordres.
- Les menus de filtres restent sur une ligne et tronquent les libellés trop longs pour prévenir tout débordement.
- Vérifications réussies : build et lint backend, analyse Dart, tris et filtres combinés testés sur SQL Server.
### Étape 52 — Tableau des anomalies responsable
- La liste des anomalies devient un tableau opérationnel sur ordinateur et une liste compacte sur petit écran.
- Les colonnes présentent la date de détection, le type et la description, le matériel, l'étudiant, le statut et l'action suivante.
- La recherche serveur couvre la description, le type, le matériel, la référence et l'identité de l'étudiant.
- Les anomalies peuvent être filtrées par statut et type, puis triées par date, type, matériel, étudiant ou statut.
- Le changement de statut existant reste disponible dans chaque ligne et conserve les transitions métier autorisées.
- Vérifications réussies : build et lint backend, analyse Dart, tris et filtres combinés testés sur SQL Server.
### Étape 53 — Tableau et export filtré de l'historique responsable
- L'historique devient un tableau d'audit sur ordinateur et une liste compacte sur petit écran.
- Les colonnes présentent la date et l'heure, l'action et sa description, l'utilisateur, le matériel, l'emprunt et le point d'opération.
- La recherche serveur couvre l'action, la description, l'utilisateur et le matériel.
- Les événements peuvent être filtrés par action et période, puis triés par date, action, utilisateur, matériel ou emprunt.
- L'export CSV reprend désormais les filtres, la période et l'ordre actifs dans l'interface.
- Vérifications réussies : build et lint backend, analyse Dart, filtre combiné sur 22 événements et export CSV filtré testés sur SQL Server.
### Étape 54 — Correction du rafraîchissement après décision sur un écart
- La décision du responsable était correctement enregistrée en base, mais l'interface affichait ensuite l'erreur Flutter `setState() callback argument returned a Future`.
- La méthode `_rafraichir()` utilisait une fonction fléchée dont l'affectation de `_charger()` retournait accidentellement un `Future` depuis `setState()`.
- Le message de succès était déclenché, puis l'exception du rafraîchissement était interceptée par le même `catch`, qui affichait un faux message d'erreur à sa place.
- Le callback de `setState()` utilise maintenant un bloc synchrone qui affecte le nouveau chargement sans retourner le `Future`.
- La confirmation reste enregistrée, le message de succès reste visible et les données de supervision sont rechargées normalement.
- Vérifications réussies : `dart analyze` sans erreur et serveur Flutter opérationnel sur le port 5000.
### Étape 55 — Défilement horizontal visible des tableaux responsable
- Les tableaux Emprunts, Stock matériel, Anomalies et Historique restent accessibles sur les écrans de largeur intermédiaire.
- Un composant partagé gère le défilement horizontal avec son propre contrôleur Flutter.
- La barre horizontale est visible, interactive et positionnée sous le contenu de chaque tableau.
- Les dernières colonnes, notamment les statuts et les actions, peuvent être atteintes sans modifier la disposition sur grand écran.
- Les listes compactes mobiles existantes sont conservées sous leurs seuils responsifs.
- Vérifications réussies : les quatre tableaux utilisent le composant partagé, `dart analyze` est sans erreur et le serveur Flutter répond sur le port 5000.
--- ---
*Dernière mise à jour : 2026-07-23SSO Microsoft Entra ID prêt à configurer, mode démo sécurisé actif.* *Dernière mise à jour : 2026-07-24Défilement horizontal des tableaux responsable ajouté.*