feat(#135): POST /parents/:id/co-parent — ajout co-parent foyer.

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>

backend/src/routes/parents/dto/staff-add-co-parent-response.dto.ts

@@ -0,0 +1,23 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { StatutUtilisateurType } from 'src/entities/users.entity';
+
+/** Réponse 201 POST /parents/:id/co-parent (#135). */
+export class StaffAddCoParentResponseDto {
+  @ApiProperty()
+  message: string;
+
+  @ApiProperty({ example: '2026-000043' })
+  numero_dossier: string;
+
+  @ApiProperty({ format: 'uuid', description: 'UUID du parent pivot' })
+  parent_user_id: string;
+
+  @ApiProperty({ format: 'uuid', description: 'UUID du co-parent créé' })
+  co_parent_user_id: string;
+
+  @ApiProperty({
+    enum: StatutUtilisateurType,
+    example: StatutUtilisateurType.ACTIF,
+  })
+  statut: StatutUtilisateurType;
+}

backend/src/routes/parents/dto/staff-add-co-parent.dto.ts

@@ -0,0 +1,69 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import {
+  IsBoolean,
+  IsEmail,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  Matches,
+  MaxLength,
+  MinLength,
+} from 'class-validator';
+
+/**
+ * Ajout d’un co-parent sur un foyer existant (staff) — ticket #135.
+ * Corps sans préfixe `co_parent_*` (l’URL cible déjà le pivot).
+ */
+export class StaffAddCoParentDto {
+  @ApiProperty({ example: 'thomas.martin@ptits-pas.fr' })
+  @IsEmail({}, { message: 'Email invalide' })
+  @IsNotEmpty({ message: "L'email est requis" })
+  email: string;
+
+  @ApiProperty({ example: 'Thomas' })
+  @IsString()
+  @IsNotEmpty({ message: 'Le prénom est requis' })
+  @MinLength(2)
+  @MaxLength(100)
+  prenom: string;
+
+  @ApiProperty({ example: 'MARTIN' })
+  @IsString()
+  @IsNotEmpty({ message: 'Le nom est requis' })
+  @MinLength(2)
+  @MaxLength(100)
+  nom: string;
+
+  @ApiProperty({ example: '0678456789' })
+  @IsString()
+  @IsNotEmpty({ message: 'Le téléphone est requis' })
+  @Matches(/^(\+33|0)[1-9](\d{2}){4}$/, {
+    message: 'Le numéro de téléphone doit être valide (ex: 0689567890 ou +33689567890)',
+  })
+  telephone: string;
+
+  @ApiPropertyOptional({
+    example: true,
+    description: 'Si true, copie l’adresse du parent pivot',
+  })
+  @IsOptional()
+  @IsBoolean()
+  meme_adresse?: boolean;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  adresse?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  @MaxLength(10)
+  code_postal?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  @MaxLength(150)
+  ville?: string;
+}

backend/src/routes/parents/parents.controller.spec.ts

@@ -11,6 +11,7 @@ describe('ParentsController', () => {
   let controller: ParentsController;
   const authServiceMock = {
     createParentDossierStaff: jest.fn(),
+    addCoParentStaff: jest.fn(),
   };
   const parentsServiceMock = {};
   const userServiceMock = {};
@@ -77,4 +78,27 @@ describe('ParentsController', () => {
     expect(res.enfant_ids).toEqual(['e1']);
     expect(res.statut).toBe(StatutUtilisateurType.ACTIF);
   });
+
+  it('addCoParent delegates to authService.addCoParentStaff', async () => {
+    authServiceMock.addCoParentStaff.mockResolvedValue({
+      message: 'ok',
+      numero_dossier: '2026-000043',
+      parent_user_id: 'p1',
+      co_parent_user_id: 'p2',
+      statut: StatutUtilisateurType.ACTIF,
+    });
+
+    const body = {
+      email: 'coparent@test.fr',
+      prenom: 'Thomas',
+      nom: 'MARTIN',
+      telephone: '0678456789',
+      meme_adresse: true,
+    };
+
+    const res = await controller.addCoParent('p1', body as any);
+    expect(authServiceMock.addCoParentStaff).toHaveBeenCalledWith('p1', body);
+    expect(res.co_parent_user_id).toBe('p2');
+    expect(res.statut).toBe(StatutUtilisateurType.ACTIF);
+  });
 });

backend/src/routes/parents/parents.controller.ts

@@ -30,6 +30,8 @@ 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 { StaffAddCoParentDto } from './dto/staff-add-co-parent.dto';
+import { StaffAddCoParentResponseDto } from './dto/staff-add-co-parent-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';
@@ -176,6 +178,28 @@ export class ParentsController {
     return mapParentForApi(parent);
   }
 
+  @Roles(RoleType.SUPER_ADMIN, RoleType.ADMINISTRATEUR, RoleType.GESTIONNAIRE)
+  @Post(':id/co-parent')
+  @HttpCode(HttpStatus.CREATED)
+  @ApiOperation({
+    summary: 'Ajouter un co-parent à un foyer existant (staff) — ticket #135',
+    description:
+      'Foyer mono-parent uniquement. Crée le co-parent actif, liens foyer + enfants, ' +
+      'e-mail de création de mot de passe. Ne pas utiliser POST /auth/register/parent.',
+  })
+  @ApiParam({ name: 'id', description: 'UUID utilisateur du parent pivot' })
+  @ApiBody({ type: StaffAddCoParentDto })
+  @ApiResponse({ status: 201, type: StaffAddCoParentResponseDto })
+  @ApiResponse({ status: 400, description: 'Foyer déjà à 2 parents / validation' })
+  @ApiResponse({ status: 404, description: 'Parent introuvable' })
+  @ApiResponse({ status: 409, description: 'Email déjà pris' })
+  async addCoParent(
+    @Param('id') id: string,
+    @Body() dto: StaffAddCoParentDto,
+  ): Promise<StaffAddCoParentResponseDto> {
+    return this.authService.addCoParentStaff(id, dto);
+  }
+
   @Roles(RoleType.SUPER_ADMIN, RoleType.GESTIONNAIRE, RoleType.ADMINISTRATEUR)
   @Post(':id/enfants/:enfantId')
   @ApiOperation({ summary: 'Rattacher un enfant à un parent — ticket #115' })