# Propositions UX — phase finale

## Requalification Phase 2.1 — UX-P1

Les horaires, lots, équipements et tâches préventives doivent être créables
depuis un parcours métier explicite. `Ma journée` propose maintenant des liens
vers les horaires et le planning des salles ; la liste des lots indique
l'assistant de création. Le parcours complet doit encore être validé avec un
compte administrateur de test.

## UX appliquée — Phase 2.1

La timeline de `Ma journée` affiche un résumé compact des tâches, urgences,
conflits et éléments à replanifier. Les conflits de rendez-vous fixes sont
expliqués en langage métier et la replanification propose des créneaux sans
afficher de détails techniques.

Document de propositions, sans refonte implémentée. Les observations
proviennent de la navigation locale sur copie de la base VM et des contrôles
statiques des menus et formulaires. Les intégrations interdites (watchdogs,
Pronote, ENT, Outlook et configuration IA) n'ont pas été déclenchées.

## Proposition UX-P1 — parcours « premiers pas »

### Problème observé

La dépendance Site/Bâtiment → Zone → Salle → Équipement est réelle, mais le
menu n'explique pas cet ordre. Une liste vide indique souvent seulement qu'il
n'y a aucun résultat.

### Exemple concret

Pour créer 30 chaises, un débutant doit deviner qu'il faut d'abord ouvrir le
menu « Équipements », puis créer le bâtiment, la zone, la salle et enfin
l'équipement groupé.

### Utilisateur concerné

Gestionnaire de collège débutant.

### Solution proposée

Ajouter une checklist légère et dismissible : « 1. Créer un bâtiment → 2.
Créer une zone → 3. Créer une salle → 4. Ajouter un équipement ». Dans chaque
état vide, afficher le prérequis manquant et un bouton d'action direct.

### Bénéfice

Réduit les erreurs de navigation et le besoin de formation initiale.

### Risque

Faible si la checklist est informative et n'impose aucun parcours.

### Effort estimé

Moyen (états vides, permissions et liens contextuels).

### Priorité

UX-P1

## Proposition UX-P1 — menu métier resserré

### Problème observé

Le menu « Équipements » mélange patrimoine, entreprises, contrats, stock,
prévisions et cycle de vie. Le menu « Interventions » mélange interventions,
planning, exports, compteurs et tâches administratives. Le même vocabulaire
n'est pas toujours utilisé dans les titres et les URLs.

### Exemple concret

Pour trouver une FDS, l'utilisateur doit ouvrir « Équipements », puis
« Matériel & Entretien », puis « FDS / fiches techniques ».

### Utilisateur concerné

Gestionnaire patrimoine, agent d'entretien et responsable maintenance.

### Solution proposée

Regrouper les entrées par tâches métier (voir l'arborescence proposée plus
bas), conserver les URLs existantes et masquer les entrées selon la
permission effective.

### Bénéfice

Les actions quotidiennes sont repérables sans connaître l'architecture Flask.

### Risque

Risque de régression de navigation et de permissions si réalisé en une seule
refonte.

### Effort estimé

Élevé.

### Priorité

UX-P1 — validation produit nécessaire avant implémentation.

## Proposition UX-P2 — états vides actionnables

### Problème observé

Les messages « Aucun résultat » ne distinguent pas une recherche infructueuse
d'une base non configurée.

### Exemple concret

Une salle sans zone ou un stock sans emplacement ne donne pas toujours le
prochain geste à effectuer.

### Utilisateur concerné

Tout nouvel administrateur fonctionnel.

### Solution proposée

Afficher « Aucun élément pour le moment », le prérequis éventuel, un exemple
de donnée attendue et un bouton « Créer … » lorsque la permission le permet.

### Bénéfice

Moins d'abandons et moins de tickets de support.

### Risque

Un bouton affiché sans permission doit rester masqué.

### Effort estimé

Faible à moyen.

### Priorité

UX-P2

## Proposition UX-P2 — formulaires guidés et unités

### Problème observé

Plusieurs formulaires utilisent des champs génériques (quantité, durée,
stock-minimum) dont l'unité ou l'effet n'est pas toujours visible au premier
coup d'œil.

### Exemple concret

Une quantité de stock doit préciser s'il s'agit de litres, kilogrammes,
flacons ou unités ; une intervention doit expliquer les relations
optionnelles salle/équipement.

### Utilisateur concerné

Agents d'entretien et responsables de stock.

### Solution proposée

Ajouter unités dans le label et une aide courte sous le champ. Conserver les
valeurs après erreur et indiquer le premier champ invalide.

### Bénéfice

Réduit les erreurs de stock et les saisies incomplètes.

### Risque

Les unités doivent provenir du modèle métier, pas être inventées dans le
template.

### Effort estimé

Moyen.

### Priorité

UX-P2

## Proposition UX-P1 — confirmations dangereuses explicites

### Problème observé

Certaines actions utilisent une confirmation courte (« Êtes-vous sûr ? »)
qui n'explicite pas les conséquences.

### Exemple concret

Un rebut doit distinguer la sortie définitive du patrimoine d'une mise en
réparation temporaire ; une sortie de stock doit afficher la quantité et le
lot concerné.

### Utilisateur concerné

Responsable maintenance et stock.

### Solution proposée

Afficher l'objet, la quantité, la destination et l'effet sur l'inventaire,
avec un bouton d'annulation clairement secondaire.

### Bénéfice

Évite les pertes de stock et les suppressions involontaires.

### Risque

Une confirmation trop fréquente ralentit les opérations répétitives.

### Effort estimé

Faible à moyen.

### Priorité

UX-P1

## Proposition UX-P2 — page Documents cohérente

### Problème observé

`/documents/` répond 404 (UI-011), alors que les documents sont répartis dans
les fiches équipement, intervention et produits d'entretien.

### Exemple concret

Un utilisateur qui cherche une FDS peut essayer une page globale Documents et
obtenir une erreur.

### Utilisateur concerné

Agent cherchant une FDS ou une pièce jointe.

### Solution proposée

Décider explicitement entre (a) une page globale de recherche documentaire ou
(b) supprimer tout lien global et renvoyer vers les trois contextes métier.
Ne pas créer une nouvelle hiérarchie avant décision fonctionnelle.

### Bénéfice

Élimine un lien mort et rend les documents retrouvables.

### Risque

Une page globale implique recherche, permissions et règles de conservation.

### Effort estimé

Moyen à élevé selon l'option retenue.

### Priorité

UX-P2

## Arborescence de menu proposée (non implémentée)

```text
Accueil
  Tableau de bord
  Alertes

Patrimoine
  Sites / bâtiments
  Zones
  Salles
  Équipements
  Cycle de vie
  Équipements sortis

Maintenance
  Interventions
  Planning
  Tâches préventives
  Compteurs
  Entreprises et contrats
  Exports

Produits et stocks
  Produits génériques
  Références et conditionnements
  État du stock
  Réceptions
  Sorties agents
  Transferts et inventaires
  FDS et fiches techniques
  Fiches papier
  Prévisions

Prévention
  DUERP et risques
  Actions
  Formations
  Habilitations

Administration
  Utilisateurs
  Rôles et permissions
  Journaux
  Statut système
```

Les intégrations et paramètres sensibles doivent rester dans un espace
« Configuration technique » réservé aux administrateurs autorisés, sans être
présentés comme des tâches quotidiennes.

## Aide contextuelle proposée

- Équipement groupé : expliquer « quantité totale » et « individualisation ».
- Équipement fixe/mobile : préciser si un déplacement est autorisé.
- Personnel/utilisateur : distinguer la personne affectée d'un compte de
  connexion.
- Lot/DLU/FEFO : expliquer que le lot expirant le plus tôt est consommé en
  premier.
- Fiche papier : expliquer `request_enabled` avec un libellé métier (« Peut
  être demandé par un agent »), jamais le nom technique.
- Permissions : afficher une phrase d'effet (« consulter », « créer et
  modifier », « administrer »).

## TOP 10 DES AMÉLIORATIONS UX

| Rang | Amélioration | Impact | Effort | Risque | Priorité |
|---:|---|---|---|---|---|
| 1 | Checklist des premiers pas | Très fort | Moyen | Faible | UX-P1 |
| 2 | États vides avec action suivante | Fort | Faible | Faible | UX-P1 |
| 3 | Corriger ou décider `/documents/` | Fort | Moyen | Moyen | UX-P2 |
| 4 | Menu par tâches métier | Très fort | Élevé | Élevé | UX-P1 |
| 5 | Unités et aides des formulaires stock | Fort | Moyen | Faible | UX-P2 |
| 6 | Confirmations de rebut/transfert explicites | Fort | Faible | Faible | UX-P1 |
| 7 | Libellés métier des permissions | Fort | Moyen | Moyen | UX-P2 |
| 8 | Indiquer les relations optionnelles d'une intervention | Moyen | Faible | Faible | UX-P2 |
| 9 | Recherche documentaire contextuelle | Moyen | Moyen | Moyen | UX-P2 |
| 10 | Résumé « à faire aujourd'hui » au dashboard | Très fort | Élevé | Moyen | UX-P1 |

## QUICK WINS

1. Remplacer les noms techniques de champs visibles par des libellés métier.
2. Ajouter l'unité directement dans les labels de quantité.
3. Ajouter un bouton de création dans les principaux états vides.
4. Décrire les conséquences dans les confirmations de rebut et sortie.
5. Afficher une explication utilisateur sur les refus 403.
6. Ajouter un test de liens internes empêchant le retour accidentel de `/documents/`.

## Éléments soumis à validation avant implémentation

- Arborescence de menu et déplacement des entrées.
- Checklist/onboarding et persistance de son état.
- Décision d'une page documentaire globale.
- Vocabulaire officiel « salle/local », « agent/personnel » et
  « entreprise/fournisseur ».
- Priorisation du dashboard et définition des indicateurs urgents.
- Granularité future des permissions métier.

## Suivi Phase 1.6 — améliorations appliquées

Les changements simples et réversibles suivants ont été appliqués :

- navigation regroupée par tâches métier (Accueil, Mon travail, Patrimoine,
  Produits & stocks, Entreprises, Documents, Administration) en conservant
  les URLs et le RBAC existants ;
- bloc **Administration → Ancien menu**, complet et transitoire, réservé aux
  administrateurs afin de comparer les deux organisations ;
- états vides du Centre documentaire et de la vue FDS rendus actionnables et
  explicites ;
- provenance et protection des créneaux affichées avec des libellés métier ;
- description d'accueil du tableau de bord et explication du rôle des droits
  dans la page d'administration RBAC ;
- tableau de planning avec légende de colonnes et caption accessible.

Les évolutions nécessitant un choix métier (checklist d'onboarding,
refonte complète du tableau de bord, nouvelle taxonomie RBAC et optimisation
de la journée) restent des propositions et ne sont pas implémentées.
## UX appliquée — Phase 2

La première tranche ajoute `Ma journée` dans `Mon travail` et sur le tableau
de bord. La timeline affiche heure, durée, localisation, type, contrainte,
statut et une explication en français. Une alerte indique explicitement quand
les horaires du technicien ne sont pas configurés ; aucune plage par défaut
n'est inventée.
### Phase 2.1c

Présenter les locaux comme « Local / emplacement », proposer un profil sans imposer les équipements, et privilégier une création multi-locaux. Sur Ma journée, afficher le temps réalisé/restant et les actions Démarrer, Mettre en pause, Reprendre, Terminer uniquement lorsqu'elles sont supportées.
