petitspas/docs/tmp/154-mini-spec-front-suppression.md

Mini-spec front — Suppressions dashboard

Ticket front : #160 — #160
Ticket back : #159 — #159
Epic : #154 (complète #133)
Branche back : feature/159-suppressions-backend
Doc matrice : 154-matrice-suppression.md

Travail en parallèle : ce contrat est la source de vérité UI ↔ API.

---

UX commune

Sur chaque ligne / carte des listes :

• Icône poubelle en bout de ligne
• Clic → dialog de confirmation (texte d’impact) → DELETE → refresh liste
• Pending = mêmes règles que validés
• Pas d’email

Liste	Poubelle visible si
Dossiers, Parents, Enfants, AM	gestionnaire ou admin
Gestionnaires	admin only
Administrateurs	admin+ ; pas sur sa propre ligne ; dernier admin : UI warning + réservé super_admin

---

Contrat API

Base : auth Bearer. Erreurs : 400 / 403 / 404 / 409 avec message FR.

1. DELETE /dossiers/:numeroDossier

• Famille → supprime tous parents + enfants du n° ; clos placements AM des enfants.
• AM → compte AM + dossier AM ; enfants gardés ; placements clos.

Réponse 200 (exemple) :

{
  "type": "famille",
  "numero_dossier": "2026-000043",
  "deleted_user_ids": ["…"],
  "deleted_enfant_ids": ["…"],
  "message": "Dossier famille supprimé."
}

ou

{
  "type": "assistante_maternelle",
  "numero_dossier": "2026-000015",
  "deleted_user_ids": ["…"],
  "deleted_enfant_ids": [],
  "message": "Dossier assistante maternelle supprimé."
}

Dialog UI : lister libellé + n° + « X parent(s), Y enfant(s) » (ou « compte AM, enfants conservés »).

---

2. DELETE /users/:id

Comportement selon le rôle de la cible :

Cible	Effet
Parent co-parent	Delete ce user seul
Parent dernier du dossier	Delete user + enfants du foyer
AM	Delete user AM + dossier AM ; enfants conservés ; placements clos
Gestionnaire	Admin only ; self → 403
Administrateur	Self → 403 ; dernier admin → super_admin only sinon 403 ; super_admin → 403

Réponse 200 :

{
  "deleted_user_ids": ["…"],
  "deleted_enfant_ids": ["…"],
  "message": "…"
}

Dialogs :

• Co-parent : « Ce parent sera retiré / supprimé du dossier {n°}. Les enfants restent avec le co-parent. »
• Dernier parent : « Dernier parent du dossier {n°}. Les enfants rattachés seront aussi supprimés. »
• AM : « Le compte et le dossier AM seront supprimés. Les enfants accueillis ne seront pas supprimés. »

Optionnel (si exposé) : GET /users/:id/suppression-impact — sinon calculer depuis données déjà en liste / détail dossier.

---

3. DELETE /enfants/:id?deleteDossier=true|false

• Pas dernier enfant → delete enfant (deleteDossier ignoré ou false).
• Dernier enfant + deleteDossier=false → delete enfant ; dossier famille peut passer sans_enfant.
• Dernier enfant + deleteDossier=true → cascade dossier famille (parents + enfants).

Réponse 200 :

{
  "deleted_enfant_ids": ["…"],
  "deleted_user_ids": ["…"],
  "dossier_supprime": false,
  "message": "…"
}

Dialog :

• Standard : « L’enfant sera supprimé du dossier de {famille} ({n°}). »
• Dernier : proposer deux actions :
  1. Supprimer l’enfant seulement (deleteDossier=false)
  2. Supprimer aussi le dossier / parents (deleteDossier=true)

Pour savoir si dernier : compter enfants du numero_dossier (détail dossier ou champ impact API).

---

4. GET /dossiers — flag sans_enfant

Chaque item famille peut exposer :

"sans_enfant": true

• true si dossier famille sans enfant lié.
• AM : false ou omis.

UI : badge / warning vigilance (comme sans_responsable / alertes AM).

---

UserService (Flutter) — signatures cibles

Future<void> deleteDossier(String numeroDossier);
Future<Map<String, dynamic>> deleteUser(String userId);
Future<Map<String, dynamic>> deleteEnfant(String enfantId, {bool deleteDossier = false});

(Adapter le parsing au JSON réel une fois le back mergé ; en parallèle, stubber sur ce contrat.)

---

Fichiers front probables

• Cartes listes : admin_user_card.dart, admin_enfant_user_card.dart, cartes dossiers
• Listes : dossiers_management_widget.dart, parent_managmant_widget.dart, enfant_management_widget.dart, assistante_maternelle_management_widget.dart, gestionnaire_management_widget.dart, admin_management_widget.dart
• user_service.dart

---

Critères front (#160)

• Poubelle selon droits
• Confirmations avec impact
• Refresh après succès
• Dernier enfant : choix dossier oui/non
• Warning sans_enfant
• Self-admin / dernier admin gérés côté UI (masquer ou message 403)