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

Mini-spec — Déplacer les panels widgets/admin/ → widgets/dashboard/

Ticket : #155 (phase 2 — même ticket que le rename Admin*)
Phase 1 : widgets Admin* → widgets/dashboard/ (déjà sur feature/155-rename-admin-prefix-dashboard)
Branche : poursuivre / rebaser feature/155-rename-admin-prefix-dashboard (ou nouvelle branche depuis develop après merge phase 1)
Nature : rename / move mécanique — zéro changement UX / métier

---

Contexte

Après la phase 1 (#155), la situation est hybride :

Emplacement	Contenu
widgets/dashboard/	Composants partagés sans préfixe Admin* (modales, cartes, selects, sub-bar…)
widgets/admin/	Panels du dashboard staff (listes, wizards, validation, shell UserManagementPanel…) + AdminManagementWidget

Le dossier admin/ laisse encore croire « réservé administrateur », alors que gestionnaire consomme les mêmes panels (GestionnaireDashboardScreen → UserManagementPanel).

Ce ticket termine l’option C au niveau dossier : tout le dashboard staff vit sous widgets/dashboard/, sauf ce qui est vraiment rôle admin.

---

Objectif

frontend/lib/widgets/admin/<panels & common partagés>
        ↓  git mv + update imports
frontend/lib/widgets/dashboard/…

Critère : un nouveau dev ne doit plus ouvrir widgets/admin/ pour du code partagé admin+gestionnaire.

---

Cible d’arborescence (proposée)

widgets/dashboard/
  ├── (déjà là #155) child_detail_modal.dart, am_edit_modal.dart, user_card.dart, …
  ├── user_management_panel.dart          ← shell onglets
  ├── user_management_sub_bar.dart        ← déjà déplacé #155
  ├── dossiers_management_widget.dart
  ├── dossier_list_card.dart
  ├── parent_management_widget.dart       ← corriger le typo managmant au passage ?
  ├── enfant_management_widget.dart
  ├── assistante_maternelle_management_widget.dart
  ├── gestionnaire_management_widget.dart
  ├── pending_validation_widget.dart
  ├── parent_dossier_create_modal.dart
  ├── parent_dossier_wizard.dart
  ├── am_dossier_create_modal.dart
  ├── am_dossier_wizard.dart
  ├── validation_*.dart                   ← family/am wizards, refus, theme, confirm
  ├── parametres_panel.dart               ← utilisé par écran admin (OK dans dashboard)
  ├── relais_management_panel.dart
  ├── common/                             ← sous-dossier optionnel
  │     ├── suppression_confirm_dialog.dart
  │     ├── user_list.dart
  │     └── validation_detail_section.dart
  └── …

widgets/admin/                            ← mince, rôle admin seulement
  └── admin_management_widget.dart        ← onglet Administrateurs

Variante B (plus stricte)

AdminManagementWidget + éventuels helpers purement admin →
screens/administrateurs/widgets/
et suppression du dossier widgets/admin/.

Reco : variante A (garder widgets/admin/ minimal avec seulement AdminManagementWidget) — moins de churn screens, clair.

---

Inventaire à déplacer (état actuel)

Racine widgets/admin/ → widgets/dashboard/

Fichier actuel	Notes
user_management_panel.dart	Shell partagé admin + gestionnaire
dossiers_management_widget.dart
dossier_list_card.dart
parent_managmant_widget.dart	Typo historique managmant — option : renommer → parent_management_widget.dart dans le même ticket ou ticket typo séparé
enfant_management_widget.dart
assistante_maternelle_management_widget.dart
gestionnaire_management_widget.dart
pending_validation_widget.dart
parent_dossier_create_modal.dart
parent_dossier_wizard.dart
am_dossier_create_modal.dart
am_dossier_wizard.dart
validation_am_wizard.dart
validation_family_wizard.dart
validation_dossier_modal.dart
validation_modal_theme.dart
validation_refus_form.dart
validation_valider_confirm_dialog.dart
parametres_panel.dart	Écran admin seulement, mais pas préfixé Admin — OK dashboard
relais_management_panel.dart

widgets/admin/common/ → widgets/dashboard/common/ (ou plat)

Fichier	Notes
suppression_confirm_dialog.dart	Partagé (y compris screens/administrateurs/creation/*)
user_list.dart
validation_detail_section.dart

Ne pas déplacer

Fichier	Destination
admin_management_widget.dart	Reste widgets/admin/ (ou variante B → screens)

Déjà fait (#155) — ne pas retraiter

Tout ce qui est déjà sous widgets/dashboard/ (child_detail_modal, am_edit_modal, user_card, select_*, user_management_sub_bar, …).

---

Consommateurs d’imports (à mettre à jour)

Screens

• screens/administrateurs/admin_dashboardScreen.dart — UserManagementPanel, ParametresPanel
• screens/gestionnaire/gestionnaire_dashboard_screen.dart — UserManagementPanel
• screens/administrateurs/creation/admin_create.dart — suppression_confirm_dialog
• screens/administrateurs/creation/gestionnaires_create.dart — idem

Widgets déjà en dashboard/

• am_edit_modal, child_detail_modal, parent_edit_modal, select_* — imports vers widgets/admin/common/* ou panels

Divers

• widgets/common/identity_block.dart (si import admin)
• Tous les fichiers déplacés entre eux (imports relatifs / package)

Hors scope rename classes

Sauf décision explicite sur le typo parent_managmant_widget → pas de rename de classes métier dans ce ticket (seulement chemins de fichiers + imports).
AdminManagementWidget conserve son nom.

---

Plan d’exécution

1. Partir de feature/155-rename-admin-prefix-dashboard (phase 1) ou develop si phase 1 déjà mergée
2. git mv fichiers selon inventaire
3. Remplacer globalement
   package:p_tits_pas/widgets/admin/ → package:p_tits_pas/widgets/dashboard/
   sauf …/widgets/admin/admin_management_widget.dart
4. Corriger imports relatifs cassés
5. Grep de contrôle (ci-dessous)
6. Build Flutter web (Docker) + smoke dashboard admin et gestionnaire
7. Merge → squash master si flux habituel

---

Vérifs

# Plus de panels partagés sous admin (seul AdminManagement attendu)
find frontend/lib/widgets/admin -name '*.dart'

# Plus d’imports panels vers l’ancien chemin (sauf AdminManagement)
rg -n "widgets/admin/(user_management|dossiers_|parent_|enfant_|assistante|gestionnaire|pending|validation_|parametres|relais|am_dossier|parent_dossier|dossier_list|common/)" frontend/lib

# Screens OK
rg -n "widgets/admin/" frontend/lib/screens

Attendu screens : 0 hit vers panels ; éventuellement plus aucun hit widgets/admin/ sauf si import explicite AdminManagementWidget depuis user_management_panel (chemin widgets/admin/admin_management_widget.dart).

---

Hors scope

• Refonte UX des modales / panels (ticket dédié annoncé)
• Rename EnfantAdminModel
• Rename screens/administrateurs/
• Rename AdminUserFormDialog / AdminCreateDialog
• Changement API / back
• #152 (est_multiple) — autre branche

---

Critères d’acceptation

• Inventaire déplacé selon tableau
• widgets/admin/ ne contient plus que admin_management_widget.dart (variante A)
• Imports screens + widgets à jour
• Build Flutter OK
• Recette : dashboard administrateur et gestionnaire (listes, ouverture fiches, validation, création dossier) sans régression
• Aucun changement comportemental volontaire

---

Risques / notes

• Conflits de merge si d’autres features touchent les panels → faire ce ticket quand la surface dashboard est calme (fin 0.1.0 OK)
• Typo parent_managmant_widget : soit inclus (bonus), soit ticket cleanup 1-ligne séparé
• Docs d’archive citant widgets/admin/… : pas obligatoire de mettre à jour ; docs/27_BRIEFING-FRONTEND.md oui si encore listé