import { Body, Controller, Delete, Get, HttpCode, HttpStatus, Param, Patch, Post, UseGuards, } 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 { 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 { 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'; import { User } from 'src/common/decorators/user.decorator'; import { PendingFamilyDto } from './dto/pending-family.dto'; 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 { 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)' }) @ApiResponse({ status: 200, description: 'Liste des familles (libellé, parentIds, numero_dossier, date_soumission, nombre_enfants, emails, parents)', type: [PendingFamilyDto], }) @ApiResponse({ status: 403, description: 'Accès refusé' }) getPendingFamilies(): Promise { return this.parentsService.getPendingFamilies(); } @Get('dossier-famille/:numeroDossier') @Roles(RoleType.SUPER_ADMIN, RoleType.ADMINISTRATEUR, RoleType.GESTIONNAIRE) @ApiOperation({ summary: 'Dossier famille complet par numéro de dossier (Ticket #119)' }) @ApiParam({ name: 'numeroDossier', description: 'Numéro de dossier (ex: 2026-000001)' }) @ApiResponse({ status: 200, description: 'Dossier famille (numero_dossier, parents, enfants, presentation)', type: DossierFamilleCompletDto }) @ApiResponse({ status: 404, description: 'Aucun dossier pour ce numéro' }) @ApiResponse({ status: 403, description: 'Accès refusé' }) getDossierFamille(@Param('numeroDossier') numeroDossier: string): Promise { return this.parentsService.getDossierFamilleByNumero(numeroDossier); } @Post(':parentId/valider-dossier') @Roles(RoleType.SUPER_ADMIN, RoleType.ADMINISTRATEUR, RoleType.GESTIONNAIRE) @ApiOperation({ summary: 'Valider tout le dossier famille (les 2 parents en une fois)' }) @ApiParam({ name: 'parentId', description: "UUID d'un des parents (user_id)" }) @ApiResponse({ status: 200, description: 'Utilisateurs validés (famille)' }) @ApiResponse({ status: 404, description: 'Parent introuvable' }) @ApiResponse({ status: 403, description: 'Accès refusé' }) async validerDossierFamille( @Param('parentId') parentId: string, @User() currentUser: Users, @Body('comment') comment?: string, ): Promise { const familyIds = await this.parentsService.getFamilyUserIds(parentId); const validated: Users[] = []; for (const userId of familyIds) { const user = await this.userService.findOne(userId); if (user.statut !== StatutUtilisateurType.EN_ATTENTE && user.statut !== StatutUtilisateurType.REFUSE) continue; const saved = await this.userService.validateUser(userId, currentUser, comment); validated.push(saved); } return validated; } @Get() @Roles(RoleType.SUPER_ADMIN, RoleType.GESTIONNAIRE, RoleType.ADMINISTRATEUR) @ApiOperation({ summary: 'Liste des parents (user, co_parent, parentChildren) — ticket #131' }) @ApiResponse({ status: 200, type: [Parents], description: 'Liste des parents' }) @ApiResponse({ status: 403, description: 'Accès refusé !' }) async getAll(): Promise { const parents = await this.parentsService.findAll(); return mapParentsForApi(parents); } @Roles(RoleType.SUPER_ADMIN, RoleType.GESTIONNAIRE, RoleType.ADMINISTRATEUR) @Get(':id') @ApiOperation({ summary: 'Détail parent par user_id (inclut co_parent si id_co_parent renseigné) — ticket #131' }) @ApiResponse({ status: 200, type: Parents, description: 'Détails du parent par ID utilisateur' }) @ApiResponse({ status: 404, description: 'Parent non trouvé' }) @ApiResponse({ status: 403, description: 'Accès refusé !' }) async getOne(@Param('id') user_id: string): Promise { const parent = await this.parentsService.findOne(user_id); return mapParentForApi(parent); } @Roles(RoleType.SUPER_ADMIN, RoleType.GESTIONNAIRE) @Post() @ApiBody({ type: CreateParentDto }) @ApiResponse({ status: 201, type: Parents, description: 'Parent créé avec succès' }) @ApiResponse({ status: 403, description: 'Accès refusé !' }) async create(@Body() dto: CreateParentDto): Promise { const parent = await this.parentsService.create(dto); return mapParentForApi(parent); } @Roles(RoleType.SUPER_ADMIN, RoleType.GESTIONNAIRE, RoleType.ADMINISTRATEUR) @Patch(':id/fiche') @ApiOperation({ summary: 'Mettre à jour la fiche parent (admin/gestionnaire) — ticket #131' }) @ApiParam({ name: 'id', description: "UUID utilisateur du parent" }) @ApiBody({ type: UpdateParentFicheAdminDto }) @ApiResponse({ status: 200, type: Parents, description: 'Fiche parent mise à jour' }) async updateFicheAdmin( @Param('id') id: string, @Body() dto: UpdateParentFicheAdminDto, ): Promise { const parent = await this.parentsService.updateFicheAdmin(id, dto); 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 { 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' }) @ApiParam({ name: 'id', description: "UUID utilisateur du parent" }) @ApiParam({ name: 'enfantId', description: "UUID de l'enfant" }) @ApiResponse({ status: 200, type: Parents, description: 'Parent avec enfants mis à jour' }) async attachEnfant( @Param('id') id: string, @Param('enfantId') enfantId: string, ): Promise { const parent = await this.parentsService.attachEnfant(id, enfantId); return mapParentForApi(parent); } @Roles(RoleType.SUPER_ADMIN, RoleType.GESTIONNAIRE, RoleType.ADMINISTRATEUR) @Delete(':id/enfants/:enfantId') @ApiOperation({ summary: "Détacher un enfant d'un parent — ticket #115" }) @ApiParam({ name: 'id', description: "UUID utilisateur du parent" }) @ApiParam({ name: 'enfantId', description: "UUID de l'enfant" }) @ApiResponse({ status: 200, type: Parents, description: 'Parent avec enfants mis à jour' }) async detachEnfant( @Param('id') id: string, @Param('enfantId') enfantId: string, ): Promise { const parent = await this.parentsService.detachEnfant(id, enfantId); return mapParentForApi(parent); } @Roles(RoleType.SUPER_ADMIN, RoleType.GESTIONNAIRE) @Patch(':id') @ApiBody({ type: UpdateParentsDto }) @ApiResponse({ status: 200, type: Parents, description: 'Parent mis à jour avec succès' }) @ApiResponse({ status: 404, description: 'Parent introuvable' }) @ApiResponse({ status: 403, description: 'Accès refusé !' }) async update(@Param('id') id: string, @Body() dto: UpdateParentsDto): Promise { const parent = await this.parentsService.update(id, dto); return mapParentForApi(parent); } }