API staff pour foyer mono-parent : compte actif, liens + enfants, mail création MDP. Mini-specs front/back dans docs/tmp. Co-authored-by: Cursor <cursoragent@cursor.com>
2.0 KiB
2.0 KiB
Mini-spec API — POST /parents/:id/co-parent (#135)
Contrat back pour l’ajout d’un 2ᵉ parent sur un foyer mono-parent (staff).
Endpoint
| Méthode | POST |
| URL | {base}/api/v1/parents/{parentUserId}/co-parent |
| Auth | Bearer JWT |
| Rôles | gestionnaire, administrateur, super_admin |
| Succès | 201 |
parentUserId = UUID du parent pivot (déjà dans le dossier).
Ne pas appeler POST /auth/register/parent ni POST /parents/dossier.
Body (JSON)
| Champ | Type | Obligatoire | Notes |
|---|---|---|---|
email |
string | oui | unique |
prenom |
string | oui | |
nom |
string | oui | |
telephone |
string | oui | 0X… ou +33… |
meme_adresse |
bool | non | défaut true → copie adresse du pivot |
adresse |
string | si meme_adresse=false |
|
code_postal |
string | si meme_adresse=false |
|
ville |
string | si meme_adresse=false |
Comportement 201
- User co-parent actif + token création MDP
- Fiche
parents+ liens pivot ↔ co-parent + mêmenumero_dossier - Enfants du foyer rattachés au co-parent
- E-mail création MDP (pas mail « en attente »)
{
"message": "Co-parent ajouté au foyer. Un e-mail de création de mot de passe a été envoyé.",
"numero_dossier": "2026-000043",
"parent_user_id": "uuid-pivot",
"co_parent_user_id": "uuid-co",
"statut": "actif"
}
Erreurs
| Code | Cas |
|---|---|
| 400 | Déjà un co-parent / 2 responsables / validation adresse |
| 401 | Token invalide |
| 403 | Rôle non staff |
| 404 | Pivot introuvable |
| 409 | Email déjà pris |
Réemploi édition identité
| Endpoint | Usage |
|---|---|
GET /dossiers/:numero |
Préremplir wizard edit |
PATCH /parents/:id/fiche |
Sauver identité pivot / co-parent existant |
PATCH /assistantes-maternelles/:id/fiche |
Édition AM |
Branche
feature/135-edition-dossier