gmao/docs/ui-audit/UX_PROPOSALS.md
root d7c011238c
Some checks are pending
CI - Tests et Syntax / lint-and-test (push) Waiting to run
docs(audit): finaliser audit UX et version locale
2026-08-22 21:17:03 +00:00

9 KiB

Propositions UX — phase finale

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)

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.