[Cleanup] Renommer le préfixe Admin* du dashboard partagé (admin + gestionnaire) #155

Closed
opened 2026-07-17 15:55:33 +00:00 by jmartin · 3 comments
Owner

Contexte

Le panneau « Gestion des utilisateurs » est partagé admin + gestionnaire, mais une grande partie du code front est préfixée / rangée Admin* :

  • dossier frontend/lib/widgets/admin/
  • widgets : AdminChildDetailModal, AdminAmEditModal, AdminParentEditModal, AdminUserCard, AdminSelectAmModal, …
  • parfois dashboard_admin.dart

Le préfixe laisse croire que c’est réservé au rôle administrateur, alors que c’est du dashboard staff (admin et gestionnaire).

Est-ce que ça a du sens ?

Oui, pour la lisibilité et onboarding dev — mais c’est un rename mécanique large (imports partout), donc :

  • À faire quand la surface UI dashboard est un peu stabilisée (après vagues #132 / #153 / fiches), pour limiter les conflits de merge
  • Pas bloquant fonctionnellement pour la 0.1.0
  • Peut rester en 0.1.0 en fin de jalon, ou glisser en 0.2.0 si trop de churn

Proposition de naming

À trancher au kick-off du ticket :

Option Exemple
A — préfixe Staff StaffChildDetailModal
B — préfixe Dashboard / Gestion DashboardChildDetailModal
C — dossier neutre + noms sans préfixe widgets/dashboard/child_detail_modal.dartChildDetailModal

Reco : C (ou B) — évite un nouveau préfixe ambigu ; garder AdminManagementWidget seulement pour l’onglet Administrateurs.

Périmètre

  • Inventaire fichiers / classes Admin* du dashboard partagé
  • Décision naming
  • Rename + update imports
  • Vérifier routes / tests / docs qui citent les anciens chemins
  • Pas de changement comportemental

Hors scope

  • Refonte UX des modales
  • Renommage API / back (/admin s’il existe)
  • screens/administrateurs/ (écran création gestionnaire — à évaluer séparément)

Critères d'acceptation

  • Plus de préfixe Admin sur les composants partagés admin+gestionnaire
  • Build Flutter OK
  • Aucune régression fonctionnelle

Milestone

0.1.0 (cleanup — idéalement en fin de jalon)

## Contexte Le panneau « Gestion des utilisateurs » est partagé **admin + gestionnaire**, mais une grande partie du code front est préfixée / rangée `Admin*` : - dossier `frontend/lib/widgets/admin/` - widgets : `AdminChildDetailModal`, `AdminAmEditModal`, `AdminParentEditModal`, `AdminUserCard`, `AdminSelectAmModal`, … - parfois `dashboard_admin.dart` Le préfixe laisse croire que c’est réservé au rôle **administrateur**, alors que c’est du **dashboard staff** (admin *et* gestionnaire). ## Est-ce que ça a du sens ? **Oui**, pour la lisibilité et onboarding dev — mais c’est un **rename mécanique large** (imports partout), donc : - **À faire** quand la surface UI dashboard est un peu stabilisée (après vagues #132 / #153 / fiches), pour limiter les conflits de merge - **Pas bloquant** fonctionnellement pour la 0.1.0 - Peut rester en 0.1.0 en fin de jalon, ou glisser en 0.2.0 si trop de churn ## Proposition de naming À trancher au kick-off du ticket : | Option | Exemple | |--------|---------| | A — préfixe `Staff` | `StaffChildDetailModal` | | B — préfixe `Dashboard` / `Gestion` | `DashboardChildDetailModal` | | C — dossier neutre + noms sans préfixe | `widgets/dashboard/child_detail_modal.dart` → `ChildDetailModal` | Reco : **C** (ou B) — évite un nouveau préfixe ambigu ; garder `AdminManagementWidget` seulement pour l’onglet **Administrateurs**. ## Périmètre - [ ] Inventaire fichiers / classes `Admin*` du dashboard partagé - [ ] Décision naming - [ ] Rename + update imports - [ ] Vérifier routes / tests / docs qui citent les anciens chemins - [ ] Pas de changement comportemental ## Hors scope - Refonte UX des modales - Renommage API / back (`/admin` s’il existe) - `screens/administrateurs/` (écran création gestionnaire — à évaluer séparément) ## Critères d'acceptation - [ ] Plus de préfixe `Admin` sur les composants **partagés** admin+gestionnaire - [ ] Build Flutter OK - [ ] Aucune régression fonctionnelle ## Milestone **0.1.0** (cleanup — idéalement en fin de jalon)
jmartin added this to the 0.1.0 milestone 2026-07-17 15:55:33 +00:00
jmartin added the frontendcleanupgestionnaireadminphase-1v0.1.0 labels 2026-07-17 15:55:33 +00:00
Author
Owner

Livré sur feature/155-rename-admin-prefix-dashboard

Décision option C appliquée.

  • Widgets partagés Admin*widgets/dashboard/ sans préfixe (ChildDetailModal, AmEditModal, UserCard, …)
  • Conservé : AdminManagementWidget, screens/administrateurs/*
  • Mini-spec : docs/tmp/155-mini-spec-rename-admin-prefix.md

Pas de changement comportemental — à recetter (dashboard admin + gestionnaire) puis merge.

## Livré sur `feature/155-rename-admin-prefix-dashboard` Décision **option C** appliquée. - Widgets partagés `Admin*` → `widgets/dashboard/` sans préfixe (`ChildDetailModal`, `AmEditModal`, `UserCard`, …) - Conservé : `AdminManagementWidget`, `screens/administrateurs/*` - Mini-spec : `docs/tmp/155-mini-spec-rename-admin-prefix.md` Pas de changement comportemental — à recetter (dashboard admin + gestionnaire) puis merge.
Author
Owner

Phase 2 #155 — move panels (spécifié)

On reste sur ce ticket pour finir l’option C (pas de #162).

Déjà fait (phase 1)

Widgets partagés Admin*widgets/dashboard/ sans préfixe (01fb514b sur feature/155-rename-admin-prefix-dashboard).

À faire (phase 2)

Déplacer les panels encore sous widgets/admin/widgets/dashboard/.

  • AdminManagementWidget reste dans widgets/admin/ (seul fichier attendu à la fin)
  • Rename mécanique, zéro UX
  • Typo parent_managmant_widget : bonus optionnel

Mini-spec phase 2

docs/tmp/155-suite-move-admin-panels-to-dashboard.md

(Inventaire, arborescence cible, plan, grep, hors scope.)

## Phase 2 #155 — move panels (spécifié) On **reste sur ce ticket** pour finir l’option C (pas de #162). ### Déjà fait (phase 1) Widgets partagés `Admin*` → `widgets/dashboard/` sans préfixe (`01fb514b` sur `feature/155-rename-admin-prefix-dashboard`). ### À faire (phase 2) Déplacer les **panels** encore sous `widgets/admin/` → `widgets/dashboard/`. - `AdminManagementWidget` **reste** dans `widgets/admin/` (seul fichier attendu à la fin) - Rename mécanique, **zéro** UX - Typo `parent_managmant_widget` : bonus optionnel ### Mini-spec phase 2 `docs/tmp/155-suite-move-admin-panels-to-dashboard.md` (Inventaire, arborescence cible, plan, grep, hors scope.)
Author
Owner

Ferm� � merg� dans `develop`

  • Merge : merge(#155) � option C compl�te (phase 1 + phase 2)
  • Phase 1 : widgets partag�s sans pr�fixe Admin ? `widgets/dashboard/`
  • Phase 2 : panels/wizards/validation/common ? `widgets/dashboard/` ; `widgets/admin/` ne conserve que `AdminManagementWidget`
  • Recette OK (dashboard admin + gestionnaire / onglet Dossiers)
## Ferm� � merg� dans \`develop\` - Merge : merge(#155) � option C compl�te (phase 1 + phase 2) - Phase 1 : widgets partag�s sans pr�fixe Admin ? \`widgets/dashboard/\` - Phase 2 : panels/wizards/validation/common ? \`widgets/dashboard/\` ; \`widgets/admin/\` ne conserve que \`AdminManagementWidget\` - Recette OK (dashboard admin + gestionnaire / onglet Dossiers)
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: jmartin/petitspas#155