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/parents/parents.controller.ts

@@ -3,6 +3,8 @@ import {
   Controller,
   Delete,
   Get,
+  HttpCode,
+  HttpStatus,
   Param,
   Patch,
   Post,
@@ -10,14 +12,25 @@ import {
 } from '@nestjs/common';
 import { ParentsService } from './parents.service';
 import { UserService } from '../user/user.service';
+import { AuthService } from '../auth/auth.service';
 import { Parents } from 'src/entities/parents.entity';
 import { Users } from 'src/entities/users.entity';
 import { Roles } from 'src/common/decorators/roles.decorator';
 import { RoleType, StatutUtilisateurType } from 'src/entities/users.entity';
-import { ApiBody, ApiOperation, ApiParam, ApiResponse, ApiTags } from '@nestjs/swagger';
+import {
+  ApiBearerAuth,
+  ApiBody,
+  ApiOperation,
+  ApiParam,
+  ApiResponse,
+  ApiTags,
+} from '@nestjs/swagger';
 import { CreateParentDto } from '../user/dto/create_parent.dto';
 import { UpdateParentsDto } from '../user/dto/update_parent.dto';
 import { UpdateParentFicheAdminDto } from './dto/update-parent-fiche-admin.dto';
+import { StaffCreateParentDossierDto } from './dto/staff-create-parent-dossier.dto';
+import { StaffCreateParentDossierResponseDto } from './dto/staff-create-parent-dossier-response.dto';
+import { RegisterParentCompletDto } from '../auth/dto/register-parent-complet.dto';
 import { AuthGuard } from 'src/common/guards/auth.guard';
 import { RolesGuard } from 'src/common/guards/roles.guard';
 import { User } from 'src/common/decorators/user.decorator';
@@ -26,14 +39,50 @@ import { DossierFamilleCompletDto } from './dto/dossier-famille-complet.dto';
 import { mapParentForApi, mapParentsForApi } from './parents.mapper';
 
 @ApiTags('Parents')
+@ApiBearerAuth('access-token')
 @Controller('parents')
 @UseGuards(AuthGuard, RolesGuard)
 export class ParentsController {
   constructor(
     private readonly parentsService: ParentsService,
     private readonly userService: UserService,
+    private readonly authService: AuthService,
   ) {}
 
+  @Roles(RoleType.SUPER_ADMIN, RoleType.ADMINISTRATEUR, RoleType.GESTIONNAIRE)
+  @Post('dossier')
+  @HttpCode(HttpStatus.CREATED)
+  @ApiOperation({
+    summary: 'Créer un dossier famille/parent complet (staff) — ticket #129',
+    description:
+      'Crée parent (+ co-parent optionnel) + enfants + n° dossier avec statut actif, ' +
+      'et envoie l’e-mail de création de mot de passe. ' +
+      'Ne pas utiliser POST /auth/register/parent depuis le dashboard.',
+  })
+  @ApiBody({ type: StaffCreateParentDossierDto })
+  @ApiResponse({ status: 201, type: StaffCreateParentDossierResponseDto })
+  @ApiResponse({ status: 400, description: 'Validation DTO / métier' })
+  @ApiResponse({ status: 403, description: 'Rôle non autorisé' })
+  @ApiResponse({ status: 409, description: 'Email pivot et/ou co-parent déjà pris' })
+  async createDossier(
+    @Body() dto: StaffCreateParentDossierDto,
+  ): Promise<StaffCreateParentDossierResponseDto> {
+    const registerDto = {
+      ...dto,
+      acceptation_cgu: true,
+      acceptation_privacy: true,
+    } as RegisterParentCompletDto;
+    const result = await this.authService.createParentDossierStaff(registerDto);
+    return {
+      message: result.message,
+      numero_dossier: result.numero_dossier,
+      parent_user_id: result.parent_user_id,
+      co_parent_user_id: result.co_parent_user_id ?? null,
+      statut: result.statut,
+      enfant_ids: result.enfant_ids,
+    };
+  }
+
   @Get('pending-families')
   @Roles(RoleType.SUPER_ADMIN, RoleType.ADMINISTRATEUR, RoleType.GESTIONNAIRE)
   @ApiOperation({ summary: 'Liste des familles en attente (une entrée par famille)' })