Ynov/ptitspas-ynov-back
23
1
Fork 2
Code Issues 26 Pull Requests Actions Packages Projects 1 Releases Wiki Activity

gestionnaire route added Swagger

Browse Source
This commit is contained in:
sdraris 2025-09-15 10:36:58 +02:00
parent a9af96e403
commit 51ae2eb984
1 changed files with 32 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
src/routes/gestionnaires/gestionnaires.controller.ts
View File

@ -6,36 +6,62 @@ import {
Patch, Patch,
Param, Param,
Delete, Delete,
UseGuards,
} from '@nestjs/common'; } from '@nestjs/common';
import { GestionnairesService } from './gestionnaires.service'; import { GestionnairesService } from './gestionnaires.service';
import { RoleType, Users } from 'src/entities/users.entity'; import { RoleType, Users } from 'src/entities/users.entity';
import { Roles } from 'src/common/decorators/roles.decorator'; import { Roles } from 'src/common/decorators/roles.decorator';
import { UpdateGestionnaireDto } from '../user/dto/update_gestionnaire.dto'; import { UpdateGestionnaireDto } from '../user/dto/update_gestionnaire.dto';
import { CreateGestionnaireDto } from '../user/dto/create_gestionnaire.dto'; import { CreateGestionnaireDto } from '../user/dto/create_gestionnaire.dto';
import { RolesGuard } from 'src/common/guards/roles.guard';
import { ApiBearerAuth, ApiOperation, ApiParam, ApiResponse, ApiTags } from '@nestjs/swagger';
import { AuthGuard } from 'src/common/guards/auth.guard';
@ApiTags('Gestionnaires')
@ApiBearerAuth('access-token')
@UseGuards(AuthGuard, RolesGuard)
@Controller('gestionnaires') @Controller('gestionnaires')
export class GestionnairesController { export class GestionnairesController {
constructor(private readonly gestionnairesService: GestionnairesService) { } constructor(private readonly gestionnairesService: GestionnairesService) { }
@Roles(RoleType.SUPER_ADMIN) @Roles(RoleType.SUPER_ADMIN)
@ApiResponse({ status: 201, description: 'Le gestionnaire a été créé avec succès.', type: Users })
@ApiResponse({ status: 409, description: 'Conflit. L\'email est déjà utilisé.' })
@ApiOperation({ summary: 'Création d\'un gestionnaire' })
@Post() @Post()
create(@Body() dto: CreateGestionnaireDto): Promise<Users> { create(@Body() dto: CreateGestionnaireDto): Promise<Users> {
return this.gestionnairesService.create(dto); return this.gestionnairesService.create(dto);
} }
@Roles(RoleType.SUPER_ADMIN, RoleType.GESTIONNAIRE) @Roles(RoleType.SUPER_ADMIN, RoleType.GESTIONNAIRE)
@ApiOperation({ summary: 'Liste des gestionnaires' })
@ApiResponse({ status: 200, description: 'Liste des gestionnaires : ', type: [Users] })
@Get() @Get()
getAll(): Promise<Users[]> { getAll(): Promise<Users[]> {
return this.gestionnairesService.findAll(); return this.gestionnairesService.findAll();
} }
@Roles(RoleType.GESTIONNAIRE, RoleType.SUPER_ADMIN) @Roles(RoleType.GESTIONNAIRE, RoleType.SUPER_ADMIN)
@ApiOperation({ summary: 'Récupérer un gestionnaire par ID' })
@ApiResponse({ status: 400, description: 'ID invalide' })
@ApiResponse({ status: 403, description: 'Accès refusé' })
@ApiResponse({ status: 401, description: 'Non authentifié' })
@ApiParam({ name: 'id', description: 'ID du gestionnaire' })
@ApiResponse({ status: 200, description: 'Gestionnaire trouvé', type: Users })
@ApiResponse({ status: 404, description: 'Gestionnaire non trouvé' })
@Get(':id') @Get(':id')
findOne(@Param('id') id: string): Promise<Users> { findOne(@Param('id') id: string): Promise<Users> {
return this.gestionnairesService.findOne(id); return this.gestionnairesService.findOne(id);
} }
@Roles(RoleType.SUPER_ADMIN) @Roles(RoleType.SUPER_ADMIN)
@ApiOperation({ summary: 'Mettre à jour un gestionnaire' })
@ApiResponse({ status: 200, description: 'Le gestionnaire a été mis à jour avec succès.', type: Users })
@ApiResponse({ status: 404, description: 'Gestionnaire non trouvé' })
@ApiResponse({ status: 403, description: 'Accès refusé' })
@ApiResponse({ status: 401, description: 'Non authentifié' })
@ApiParam({ name: 'id', description: 'ID du gestionnaire' })
@Patch(':id') @Patch(':id')
update( update(
@Param('id') id: string, @Param('id') id: string,
@ -45,6 +71,12 @@ export class GestionnairesController {
} }
@Roles(RoleType.SUPER_ADMIN) @Roles(RoleType.SUPER_ADMIN)
@ApiOperation({ summary: 'Supprimer un gestionnaire' })
@ApiResponse({ status: 200, description: 'Le gestionnaire a été supprimé avec succès.' })
@ApiResponse({ status: 404, description: 'Gestionnaire non trouvé' })
@ApiResponse({ status: 403, description: 'Accès refusé' })
@ApiResponse({ status: 401, description: 'Non authentifié' })
@ApiParam({ name: 'id', description: 'ID du gestionnaire' })
@Delete(':id') @Delete(':id')
remove(@Param('id') id: string): Promise<void> { remove(@Param('id') id: string): Promise<void> {
return this.gestionnairesService.remove(id); return this.gestionnairesService.remove(id);