feat(#171): API couples-garde AM (liste + courant)

Symétrique #168 : GET/PUT /assistantes-maternelles/me/couples-garde
avec parents[] pour le bandeau enfant|foyer. Colonne
id_placement_garde_courant sur assistantes_maternelles.

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

backend/src/routes/assistantes_maternelles/assistantes_maternelles.service.ts

@@ -5,14 +5,16 @@ import {
   NotFoundException,
 } from '@nestjs/common';
 import { InjectRepository } from '@nestjs/typeorm';
-import { IsNull, Repository } from 'typeorm';
+import { In, IsNull, Repository } from 'typeorm';
 import { RoleType, Users } from 'src/entities/users.entity';
 import { AssistanteMaternelle } from 'src/entities/assistantes_maternelles.entity';
 import { AmChildren } from 'src/entities/am_children.entity';
 import { Children, StatutEnfantType } from 'src/entities/children.entity';
+import { ParentsChildren } from 'src/entities/parents_children.entity';
 import { CreateAssistanteDto } from '../user/dto/create_assistante.dto';
 import { UpdateAssistanteDto } from '../user/dto/update_assistante.dto';
 import { UpdateAmFicheAdminDto } from './dto/update-am-fiche-admin.dto';
+import { CouplesGardeAmResponseDto } from './dto/couples-garde-am.dto';
 import { validateNir } from 'src/common/utils/nir.util';
 
 const AM_CHILDREN_RELATIONS = ['user', 'amChildren', 'amChildren.child'] as const;
@@ -28,6 +30,8 @@ export class AssistantesMaternellesService {
     private readonly amChildrenRepository: Repository<AmChildren>,
     @InjectRepository(Children)
     private readonly childrenRepository: Repository<Children>,
+    @InjectRepository(ParentsChildren)
+    private readonly parentsChildrenRepository: Repository<ParentsChildren>,
   ) {}
 
   async create(dto: CreateAssistanteDto): Promise<AssistanteMaternelle> {
@@ -264,4 +268,107 @@ export class AssistantesMaternellesService {
     await this.assistantesMaternelleRepository.delete(id);
     return { message: 'Assistante maternelle supprimée' };
   }
+
+  /**
+   * Liste les couples de garde (enfant ↔ parents) de l’AM connectée — ticket #171.
+   * Un couple = un placement actif dans enfants_assistantes_maternelles pour cette AM.
+   */
+  async listerCouplesGarde(amUserId: string): Promise<CouplesGardeAmResponseDto> {
+    const am = await this.assistantesMaternelleRepository.findOne({
+      where: { user_id: amUserId },
+    });
+    if (!am) {
+      throw new NotFoundException('Assistante maternelle introuvable');
+    }
+
+    const placements = await this.amChildrenRepository.find({
+      where: { amId: amUserId, date_fin: IsNull() },
+      relations: ['child'],
+      order: { date_debut: 'ASC' },
+    });
+
+    if (placements.length === 0) {
+      return { couples: [], couple_courant_id: null };
+    }
+
+    const enfantIds = placements.map((p) => p.enfantId);
+    const liens = await this.parentsChildrenRepository.find({
+      where: { enfantId: In(enfantIds) },
+      relations: ['parent', 'parent.user'],
+    });
+    const parentsByEnfant = new Map<
+      string,
+      { id: string; prenom: string | null; nom: string | null; photo_url: string | null }[]
+    >();
+    for (const l of liens) {
+      const list = parentsByEnfant.get(l.enfantId) ?? [];
+      const u = l.parent?.user;
+      list.push({
+        id: l.parentId,
+        prenom: u?.prenom ?? null,
+        nom: u?.nom ?? null,
+        photo_url: u?.photo_url ?? null,
+      });
+      parentsByEnfant.set(l.enfantId, list);
+    }
+
+    let idCourant = am.id_placement_garde_courant ?? null;
+    const idsValides = new Set(placements.map((p) => p.id));
+    if (idCourant && !idsValides.has(idCourant)) {
+      idCourant = null;
+      await this.assistantesMaternelleRepository.update(
+        { user_id: amUserId },
+        { id_placement_garde_courant: () => 'NULL' },
+      );
+    }
+    if (!idCourant && placements.length === 1) {
+      idCourant = placements[0].id;
+    }
+
+    const couples = placements.map((p) => ({
+      id: p.id,
+      enfant: {
+        id: p.child.id,
+        prenom: p.child.first_name ?? null,
+        nom: p.child.last_name ?? null,
+        photo_url: p.child.photo_url ?? null,
+      },
+      parents: parentsByEnfant.get(p.enfantId) ?? [],
+      courant: idCourant != null && p.id === idCourant,
+    }));
+
+    return {
+      couples,
+      couple_courant_id: idCourant,
+    };
+  }
+
+  /**
+   * Persiste le couple de garde actif pour l’AM — ticket #171.
+   */
+  async definirCoupleGardeCourant(
+    amUserId: string,
+    coupleId: string,
+  ): Promise<CouplesGardeAmResponseDto> {
+    const am = await this.assistantesMaternelleRepository.findOne({
+      where: { user_id: amUserId },
+    });
+    if (!am) {
+      throw new NotFoundException('Assistante maternelle introuvable');
+    }
+
+    const placement = await this.amChildrenRepository.findOne({
+      where: { id: coupleId, amId: amUserId, date_fin: IsNull() },
+    });
+    if (!placement) {
+      throw new NotFoundException('Couple de garde introuvable ou inactif pour cette AM');
+    }
+
+    await this.assistantesMaternelleRepository.update(
+      { user_id: amUserId },
+      { id_placement_garde_courant: coupleId },
+    );
+
+    return this.listerCouplesGarde(amUserId);
+  }
 }