From afb9e8de260db3dea1c9b60a1adede5f2a8ce9c2 Mon Sep 17 00:00:00 2001 From: root Date: Sun, 23 Aug 2026 00:02:50 +0000 Subject: [PATCH] docs(ui): document phase 1.6 navigation --- docs/ui-audit/BUGS.md | 10 ++ docs/ui-audit/IMPLEMENTATION_PHASE16.md | 127 ++++++++++++++++++++++++ docs/ui-audit/PAGES_MATRIX.md | 14 +++ docs/ui-audit/PROGRESS.md | 12 +++ docs/ui-audit/REPORT.md | 15 +++ docs/ui-audit/UX_PROPOSALS.md | 19 ++++ 6 files changed, 197 insertions(+) create mode 100644 docs/ui-audit/IMPLEMENTATION_PHASE16.md diff --git a/docs/ui-audit/BUGS.md b/docs/ui-audit/BUGS.md index 624cca3..3e9632d 100644 --- a/docs/ui-audit/BUGS.md +++ b/docs/ui-audit/BUGS.md @@ -527,3 +527,13 @@ lookback hors périmètre et son erreur de teardown. créneaux connus. - Responsive/accessibilité visuels restent à confirmer avec un navigateur instrumenté avant VM distante. + +## Phase 1.6 — navigation et UX + +- Aucun nouveau 404/500 constaté dans les destinations principales du nouveau + menu lors des tests ciblés. +- L'ancien menu est conservé volontairement ; il ne constitue pas une + nouvelle surface d'autorisation et reste visible uniquement aux comptes + disposant de `system.admin`. +- Limitation ouverte : validation visuelle responsive aux trois tailles + demandées, faute de navigateur instrumenté disponible. diff --git a/docs/ui-audit/IMPLEMENTATION_PHASE16.md b/docs/ui-audit/IMPLEMENTATION_PHASE16.md new file mode 100644 index 0000000..d474a93 --- /dev/null +++ b/docs/ui-audit/IMPLEMENTATION_PHASE16.md @@ -0,0 +1,127 @@ +# Phase 1.6 — UI, UX et navigation + +Date de reprise : 23 août 2026 +Base : copie locale MariaDB issue de la VM +Périmètre : navigation métier et améliorations UX réversibles ; aucune Phase 2. + +## Baseline + +- Commit de départ : `f78cddf`. +- Version de départ : `0.1.0-dev.5`. +- Working tree propre avant les changements Phase 1.6. +- Docker : `gmao-flask` 0.1.0-dev.5, MariaDB et Adminer sains. +- URL locale : `http://127.0.0.1:5080/`. +- `/health/` : HTTP 200, base connectée, Pronote/watchdogs désactivés. +- Baseline globale connue : 129 passed, 1 failed, 1 error ; l'échec et + l'erreur sont le test historique de lookback/contexte GMAO hors périmètre. +- Un lancement local isolé des tests avec des identifiants DB génériques a + échoué à l'initialisation (`Access denied`) ; la configuration de test + documentée reste inchangée et ce n'est pas une régression applicative. + +## Inventaire et matrice + +L'inventaire repository-wide des liens de `base.html`, y compris les entrées +conditionnelles et les liens techniques historiques, est consigné dans +[`MENU_MIGRATION_MATRIX.md`](MENU_MIGRATION_MATRIX.md). + +- Entrées uniques inventoriées : **70**. +- MIGRÉ : **25**. +- REGROUPÉ : **20**. +- ADMIN UNIQUEMENT : **25**. +- DOUBLON : **0**. +- OBSOLÈTE À CONFIRMER : **0**. +- NON MIGRÉ : **0**. +- ROUTE CASSÉE constatée dans le template : **0**. + +## Nouveau menu métier + +La navigation est désormais organisée par intention : + +```text +Accueil + Tableau de bord +Mon travail + Interventions + Planning des salles + Planning unifié + Tâches préventives / planifiées + Tâches administratives + Disponibilités + Prévention +Patrimoine + Bâtiments, Zones, Salles / locaux, Équipements + Catégories, Types de salles, Cycle de vie +Produits & stocks + Produits, Références commerciales, Stock, Emplacements + Mouvements, Réceptions, Sorties, Transvasements / dilutions + Fiches de demande, Prévisions +Entreprises + Entreprises, Contrats, Services, Pièces +Documents + Centre documentaire, FDS accessibles +Administration + Utilisateurs, Rôles et permissions, État du système, Journaux + Ancien menu (transitoire) +``` + +Les rubriques sont conditionnées par les permissions effectives. Un parent +sans enfant autorisé n'est pas rendu. Les URLs et les contrôles backend ne +sont pas remplacés par un contrôle de template. + +## Ancien menu + +**ANCIEN MENU CONSERVÉ : OUI** +**VISIBLE UNIQUEMENT ADMIN : OUI** + +L'ancien inventaire complet est accessible dans `Administration → Ancien +menu`, sous forme de référentiel temporaire. Il inclut aussi les entrées +techniques et intégrations conservées pour comparaison. Il ne possède pas de +nouveau mécanisme d'autorisation et ne doit être retiré qu'après validation +humaine. + +## UX appliquée + +- Tableau de bord : phrase d'orientation courte ajoutée sans ajouter de + nouvelles métriques ni de moteur de planning. +- Centre documentaire et FDS : états vides explicites, origine des documents, + actions textuelles de téléchargement et lien vers le produit. +- Planning des salles : caption de tableau, en-têtes accessibles, messages + d'état vide actionnables et provenance/protection déjà exprimées en français. +- Administration RBAC : libellés issus de `permission_metadata` et explication + du comportement des administrateurs ; les clés techniques restent + secondaires. +- Aucun changement de modèle, de RBAC, d'intégration ou de données métier. + +Les propositions lourdes (checklist d'onboarding, refonte graphique complète, +nouveau dashboard et Phase 2) restent documentées dans `UX_PROPOSALS.md`. + +## Responsive et accessibilité + +Les contrôles statiques montrent l'usage des composants responsive existants, +des labels associés, des boutons textuels et des captions de tableau. Aucun +navigateur instrumenté n'est disponible dans l'environnement courant : la +validation visuelle 1366×768, 768×1024 et 390×844 reste explicitement à faire +avant une livraison distante. Cette limitation n'est pas présentée comme une +validation visuelle réussie. + +## Tests Phase 1.6 + +- `tests/integration/test_phase16_navigation.py` : menu administrateur, + masquage non-administrateur et destinations principales. +- Les suites documentaires/planning Phase 1 et Phase 1.5 sont conservées. +- Résultat ciblé de navigation : 3 tests passants avec la configuration DB de + test normale. + +## Version et livraison + +La version sera incrémentée séparément en `0.1.0-dev.6` car la réorganisation +de navigation est visible et substantielle. Ce changement restera dans un +commit `chore(release)` distinct. Aucun changement n'a été fait à `alban`, aux +watchdogs, aux intégrations protégées ou aux données `TEST_UI_*`. + +## Limites restantes + +- validation visuelle réelle sans navigateur ; +- suppression de l'ancien menu après validation humaine ; +- checklist d'onboarding et enrichissement du dashboard ; +- moteur d'optimisation et replanification Phase 2 non commencés. diff --git a/docs/ui-audit/PAGES_MATRIX.md b/docs/ui-audit/PAGES_MATRIX.md index a4a0a4b..51e8d46 100644 --- a/docs/ui-audit/PAGES_MATRIX.md +++ b/docs/ui-audit/PAGES_MATRIX.md @@ -125,3 +125,17 @@ activement. | Planning Pronote d'une salle | `/pronote/planning/` | 200 local | Vue interne résolue, provenance et fraîcheur | | Import Pronote d'une semaine | `/pronote/planning//import` | Raccordé | Synchronisation contrôlée, protection/conflits | + +## Phase 1.6 — navigation et UX + +| Fonction | URL / emplacement | État local | Commentaire | +|---|---|---|---| +| Nouveau menu métier | navigation globale | Implémenté | Groupes Accueil, Mon travail, Patrimoine, Produits & stocks, Entreprises, Documents, Administration | +| Ancien menu | Administration → Ancien menu | Implémenté | Référentiel complet, transitoire, visible uniquement avec `system.admin` | +| Centre documentaire UX | `/documents/` | Implémenté | Description, filtres, état vide explicite, actions textuelles | +| FDS UX | `/documents/fds` | Implémenté | État vide explicite et lien « Voir le produit » | +| Planning salles UX | `/planning/rooms` | Implémenté | Provenance, protection, conflits et caption accessible | +| Permissions | `/admin/permissions` | Implémenté | Libellés métier et rappel du comportement administrateur | + +Le contrôle visuel réel aux trois tailles reste à effectuer lorsqu'un +navigateur instrumenté sera disponible. diff --git a/docs/ui-audit/PROGRESS.md b/docs/ui-audit/PROGRESS.md index 82db0e2..aa085bd 100644 --- a/docs/ui-audit/PROGRESS.md +++ b/docs/ui-audit/PROGRESS.md @@ -428,3 +428,15 @@ Sur la copie locale de la VM, `/health/`, `/documents/`, `/documents/fds`, Suite complète après Phase 1.5 : **129 passed, 1 failed, 1 error**. Le seul échec reste le test historique de lookback de configuration GMAO et son teardown, hors périmètre interdit. + +## Phase 1.6 — navigation métier + +Reprise le 23/08/2026 sur `http://127.0.0.1:5080/`, commit `f78cddf`, version +`0.1.0-dev.5`. Docker et `/health/` sont sains sur la copie locale de la VM. +La matrice exhaustive des 70 entrées de navigation est dans +`MENU_MIGRATION_MATRIX.md`. Le nouveau menu métier est en place et l'ancien +menu est conservé comme référentiel transitoire réservé aux administrateurs. +Les états vides Documents/FDS, le planning des salles, le dashboard et la +présentation RBAC ont reçu des améliorations ciblées. La version `.6` sera +committée séparément. Aucun test visuel réel n'est déclaré sans navigateur +instrumenté. diff --git a/docs/ui-audit/REPORT.md b/docs/ui-audit/REPORT.md index 6fff767..f1f13b8 100644 --- a/docs/ui-audit/REPORT.md +++ b/docs/ui-audit/REPORT.md @@ -312,3 +312,18 @@ visibles ; aucun nouveau système de planning n'a été créé. La couverture Phase 1.5 comprend 7 tests ciblés et **129 passed** dans la suite complète ; l'unique échec/erreur reste le lookback GMAO historique hors périmètre. + +## Phase 1.6 — synthèse UI/navigation + +La navigation a été regroupée par métier sans modifier les URLs ni le RBAC. +70 entrées historiques sont documentées : 25 migrées, 20 regroupées et 25 +réservées au référentiel administrateur. Le nouveau menu couvre Accueil, Mon +travail, Patrimoine, Produits & stocks, Entreprises, Documents et +Administration ; aucune entrée n'est perdue silencieusement. + +Le bloc `Administration → Ancien menu` est conservé, complet et transitoire. +Les pages Documents/FDS et Planning des salles disposent d'états vides, +d'actions textuelles et de libellés de provenance plus clairs. La page RBAC +présente désormais les libellés métier des permissions et explique le +comportement administrateur. La validation visuelle réelle reste à faire avec +un navigateur instrumenté. diff --git a/docs/ui-audit/UX_PROPOSALS.md b/docs/ui-audit/UX_PROPOSALS.md index 059cb9e..8cc0595 100644 --- a/docs/ui-audit/UX_PROPOSALS.md +++ b/docs/ui-audit/UX_PROPOSALS.md @@ -337,3 +337,22 @@ présentés comme des tâches quotidiennes. - 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.