docs(ui): document phase 1.6 navigation

This commit is contained in:
root 2026-08-23 00:02:50 +00:00
parent 2080f01aa1
commit afb9e8de26
6 changed files with 197 additions and 0 deletions

View file

@ -527,3 +527,13 @@ lookback hors périmètre et son erreur de teardown.
créneaux connus. créneaux connus.
- Responsive/accessibilité visuels restent à confirmer avec un navigateur - Responsive/accessibilité visuels restent à confirmer avec un navigateur
instrumenté avant VM distante. 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.

View file

@ -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.

View file

@ -125,3 +125,17 @@ activement.
| Planning Pronote d'une salle | `/pronote/planning/<id>` | 200 local | Vue interne résolue, provenance et fraîcheur | | Planning Pronote d'une salle | `/pronote/planning/<id>` | 200 local | Vue interne résolue, provenance et fraîcheur |
| Import Pronote d'une semaine | `/pronote/planning/<id>/import` | Raccordé | Synchronisation contrôlée, protection/conflits | | Import Pronote d'une semaine | `/pronote/planning/<id>/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.

View file

@ -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 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 échec reste le test historique de lookback de configuration GMAO et son
teardown, hors périmètre interdit. 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é.

View file

@ -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 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 suite complète ; l'unique échec/erreur reste le lookback GMAO historique hors
périmètre. 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é.

View file

@ -337,3 +337,22 @@ présentés comme des tâches quotidiennes.
- Priorisation du dashboard et définition des indicateurs urgents. - Priorisation du dashboard et définition des indicateurs urgents.
- Granularité future des permissions métier. - 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.