feat(#129): POST /parents/dossier — création dossier famille staff.

Factorise createParentDossier (actif + mail MDP) depuis l’inscription
publique qui reste en_attente + mail pending. Miroir #156 AM.

Co-authored-by: Cursor <cursoragent@cursor.com>

backend/src/routes/auth/auth.module.ts

@@ -29,7 +29,7 @@ import { ParentsChildren } from 'src/entities/parents_children.entity';
       ParentsChildren,
     ]),
     forwardRef(() => UserModule),
-    ParentsModule,
+    forwardRef(() => ParentsModule),
     DossiersModule,
     AppConfigModule,
     MailModule,

backend/src/routes/auth/auth.service.ts

@@ -416,11 +416,20 @@ export class AuthService {
     }
 
     /**
-     * Inscription Parent COMPLÈTE - Workflow CDC 6 étapes en 1 transaction
-     * Gère : Parent 1 + Parent 2 (opt) + Enfants + Présentation + CGU
+     * Cœur partagé création dossier parent (#129).
+     * - public : statut en_attente + mails pending
+     * - staff : statut actif + mails création MDP (pas de mail « dossier en attente »)
      */
-    async inscrireParentComplet(dto: RegisterParentCompletDto) {
-        if (!dto.acceptation_cgu || !dto.acceptation_privacy) {
+    async createParentDossier(
+        dto: RegisterParentCompletDto,
+        options: {
+            statut: StatutUtilisateurType;
+            sendPendingEmail: boolean;
+            sendPasswordSetupEmail: boolean;
+            requireCgu: boolean;
+        },
+    ) {
+        if (options.requireCgu && (!dto.acceptation_cgu || !dto.acceptation_privacy)) {
             throw new BadRequestException('L\'acceptation des CGU et de la politique de confidentialité est obligatoire');
         }
 
@@ -471,7 +480,7 @@ export class AuthService {
                 prenom: dto.prenom,
                 nom: dto.nom,
                 role: RoleType.PARENT,
-                statut: StatutUtilisateurType.EN_ATTENTE,
+                statut: options.statut,
                 telephone: dto.telephone,
                 adresse: dto.adresse,
                 code_postal: dto.code_postal,
@@ -496,7 +505,7 @@ export class AuthService {
                     prenom: dto.co_parent_prenom,
                     nom: dto.co_parent_nom,
                     role: RoleType.PARENT,
-                    statut: StatutUtilisateurType.EN_ATTENTE,
+                    statut: options.statut,
                     telephone: dto.co_parent_telephone,
                     adresse: dto.co_parent_meme_adresse ? dto.adresse : dto.co_parent_adresse,
                     code_postal: dto.co_parent_meme_adresse ? dto.code_postal : dto.co_parent_code_postal,
@@ -612,38 +621,103 @@ export class AuthService {
 
         const numeroDossier = resultat.parent1.numero_dossier ?? '';
 
-        try {
-            await this.mailService.sendRegistrationPendingEmail(
-                resultat.parent1.email,
-                resultat.parent1.prenom ?? '',
-                resultat.parent1.nom ?? '',
-                numeroDossier,
-            );
-            if (resultat.parent2) {
+        if (options.sendPendingEmail) {
+            try {
                 await this.mailService.sendRegistrationPendingEmail(
-                    resultat.parent2.email,
-                    resultat.parent2.prenom ?? '',
-                    resultat.parent2.nom ?? '',
+                    resultat.parent1.email,
+                    resultat.parent1.prenom ?? '',
+                    resultat.parent1.nom ?? '',
                     numeroDossier,
                 );
+                if (resultat.parent2) {
+                    await this.mailService.sendRegistrationPendingEmail(
+                        resultat.parent2.email,
+                        resultat.parent2.prenom ?? '',
+                        resultat.parent2.nom ?? '',
+                        numeroDossier,
+                    );
+                }
+            } catch (err) {
+                this.logger.error(
+                    "[createParentDossier] Échec envoi email d'accusé de réception (inscription conservée)",
+                    err instanceof Error ? err.stack : String(err),
+                );
             }
-        } catch (err) {
-            this.logger.error(
-                "[inscrireParentComplet] Échec envoi email d'accusé de réception (inscription conservée)",
-                err instanceof Error ? err.stack : String(err),
-            );
         }
 
+        if (options.sendPasswordSetupEmail) {
+            try {
+                await this.mailService.sendValidatedAccountPasswordSetupEmail(
+                    {
+                        email: resultat.parent1.email,
+                        prenom: resultat.parent1.prenom ?? '',
+                        nom: resultat.parent1.nom ?? '',
+                        token: resultat.tokenCreationMdp,
+                        numeroDossier,
+                    },
+                    'parent',
+                );
+                if (resultat.parent2 && resultat.tokenCoParent) {
+                    await this.mailService.sendValidatedAccountPasswordSetupEmail(
+                        {
+                            email: resultat.parent2.email,
+                            prenom: resultat.parent2.prenom ?? '',
+                            nom: resultat.parent2.nom ?? '',
+                            token: resultat.tokenCoParent,
+                            numeroDossier,
+                        },
+                        'parent',
+                    );
+                }
+            } catch (err) {
+                this.logger.error(
+                    '[createParentDossier] Échec envoi email création MDP (dossier conservé)',
+                    err instanceof Error ? err.stack : String(err),
+                );
+            }
+        }
+
+        const message = options.sendPasswordSetupEmail
+            ? 'Dossier famille créé et validé. Un e-mail de création de mot de passe a été envoyé.'
+            : 'Inscription réussie. Votre dossier est en attente de validation par un gestionnaire.';
+
         return {
-            message: 'Inscription réussie. Votre dossier est en attente de validation par un gestionnaire.',
+            message,
             parent_id: resultat.parent1.id,
-            co_parent_id: resultat.parent2?.id,
+            parent_user_id: resultat.parent1.id,
+            co_parent_id: resultat.parent2?.id ?? null,
+            co_parent_user_id: resultat.parent2?.id ?? null,
             enfants_ids: resultat.enfants.map(e => e.id),
-            statut: StatutUtilisateurType.EN_ATTENTE,
+            enfant_ids: resultat.enfants.map(e => e.id),
+            statut: options.statut,
             numero_dossier: numeroDossier,
         };
     }
 
+    /**
+     * Inscription Parent publique — CDC (statut en_attente + mail pending).
+     */
+    async inscrireParentComplet(dto: RegisterParentCompletDto) {
+        return this.createParentDossier(dto, {
+            statut: StatutUtilisateurType.EN_ATTENTE,
+            sendPendingEmail: true,
+            sendPasswordSetupEmail: false,
+            requireCgu: true,
+        });
+    }
+
+    /**
+     * Création dossier parent par le staff (#129) — actif + mail création MDP.
+     */
+    async createParentDossierStaff(dto: RegisterParentCompletDto) {
+        return this.createParentDossier(dto, {
+            statut: StatutUtilisateurType.ACTIF,
+            sendPendingEmail: false,
+            sendPasswordSetupEmail: true,
+            requireCgu: false,
+        });
+    }
+
     /**
      * Cœur partagé création dossier AM (#156).
      * - public : statut en_attente + mail pending