docs(ui): document phase 1.6 navigation
This commit is contained in:
parent
2080f01aa1
commit
afb9e8de26
6 changed files with 197 additions and 0 deletions
|
|
@ -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.
|
||||||
|
|
|
||||||
127
docs/ui-audit/IMPLEMENTATION_PHASE16.md
Normal file
127
docs/ui-audit/IMPLEMENTATION_PHASE16.md
Normal 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.
|
||||||
|
|
@ -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.
|
||||||
|
|
|
||||||
|
|
@ -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é.
|
||||||
|
|
|
||||||
|
|
@ -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é.
|
||||||
|
|
|
||||||
|
|
@ -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.
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue