petitspas/docs/tmp/156-contrat-api-staff-am.md
Julien Martin ae610733cc feat(#156): création dossier AM staff — API + wizard dashboard.
Squash depuis develop : POST /assistantes-maternelles/dossier (actif +
mail MDP), AmDossierWizard create/review, validations inscription.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-23 16:53:18 +02:00

2.2 KiB
Raw Blame History

Mini-spec API — POST /assistantes-maternelles/dossier (#156)

Contrat pour le plan front (wizard création AM staff).

Endpoint

Méthode POST
URL {base}/assistantes-maternelles/dossier
Auth Bearer JWT
Rôles gestionnaire, administrateur, super_admin
Content-Type application/json

Ne pas appeler POST /auth/register/am depuis le dashboard.

Body (JSON)

Aligné inscription AM publique, sans CGU/privacy obligatoires (acceptées serveur).

Champ Type Obligatoire Notes
email string oui unique
prenom string oui
nom string oui
telephone string oui 0X… ou +33…
adresse string non
code_postal string non
ville string non
photo_base64 string non data-URL data:image/…;base64,…
photo_filename string non hint nom fichier
consentement_photo bool oui
date_naissance date ISO non YYYY-MM-DD
lieu_naissance_ville string oui
lieu_naissance_pays string oui
nir string oui 15 car. (Corse 2A/2B OK)
numero_agrement string oui unique
date_agrement date ISO non
capacite_accueil int oui 110
places_disponibles int oui 010, ≤ capacité
biographie string non max 2000

Réponses

201 Created

{
  "message": "Dossier AM créé et validé. Un e-mail de création de mot de passe a été envoyé.",
  "user_id": "uuid",
  "statut": "actif",
  "numero_dossier": "2026-000042"
}

Effets serveur : user AM actif, fiche assistantes_maternelles, n° dossier, e-mail création MDP (pas daccusé « en attente »).

Erreurs

Code Cas
400 Validation / NIR / places > capacité
403 Rôle non staff
409 Email, NIR ou agrément déjà pris
401 Token manquant / invalide

Front

  • UserService.createAmDossier(body) → cet endpoint
  • Après 201 : refresh liste AM ; snackbar OK
  • Wizard create : ne pas envoyer acceptation_cgu / acceptation_privacy (optionnels)

Branche

feature/156-creation-dossier-am