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

swagger doc added

Browse Source
This commit is contained in:
sdraris 2025-09-03 13:47:32 +02:00
parent 7cc9071454
commit 78934384f4
1 changed files with 16 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
src/routes/user/user.controller.ts
View File

@ -1,18 +1,24 @@
import { Body, Controller, Delete, Get, Param, Patch, Post } from '@nestjs/common'; import { Body, Controller, Delete, Get, Param, Patch, Post, UseGuards } from '@nestjs/common';
import { UserService } from './user.service'; import { UserService } from './user.service';
import { Roles } from 'src/common/decorators/roles.decorator'; import { Roles } from 'src/common/decorators/roles.decorator';
import { RoleType, Users } from 'src/entities/users.entity'; import { RoleType, Users } from 'src/entities/users.entity';
import { CreateUserDto } from './dto/create_user.dto'; import { CreateUserDto } from './dto/create_user.dto';
import { User } from 'src/common/decorators/user.decorator'; import { User } from 'src/common/decorators/user.decorator';
import { UpdateUserDto } from './dto/update_user.dto'; import { UpdateUserDto } from './dto/update_user.dto';
import { ApiBearerAuth, ApiOperation, ApiParam, ApiTags } from '@nestjs/swagger';
import { AuthGuard } from 'src/common/guards/auth.guard';
@ApiTags('Utilisateurs')
@ApiBearerAuth('access-token')
@UseGuards(AuthGuard)
@Controller('users') @Controller('users')
export class UserController { export class UserController {
constructor(private readonly userService: UserService) {} constructor(private readonly userService: UserService) { }
// Création d'un utilisateur (réservée aux super admins) // Création d'un utilisateur (réservée aux super admins)
@Post() @Post()
@Roles(RoleType.SUPER_ADMIN) @Roles(RoleType.SUPER_ADMIN)
@ApiOperation({ summary: 'Creer un nouvel utilisateur (pour super admin seulement)' })
create( create(
@Body() dto: CreateUserDto, @Body() dto: CreateUserDto,
@User() currentUser: Users @User() currentUser: Users
@ -22,13 +28,16 @@ export class UserController {
// Lister tous les utilisateurs (super_admin et gestionnaire) // Lister tous les utilisateurs (super_admin et gestionnaire)
@Get() @Get()
@Roles(RoleType.SUPER_ADMIN, RoleType.GESTIONNAIRE) @ApiOperation({ summary: 'Lister tous les utilisateurs' })
@Roles(RoleType.SUPER_ADMIN)
findAll() { findAll() {
return this.userService.findAll(); return this.userService.findAll();
} }
// Récupérer un utilisateur par son ID // Récupérer un utilisateur par son ID
@Get(':id') @Get(':id')
@ApiOperation({ summary: 'Trouver un utilisateur par son id' })
@ApiParam({ name: 'id', description: "UUID de l'utilisateur" })
@Roles(RoleType.SUPER_ADMIN, RoleType.GESTIONNAIRE) @Roles(RoleType.SUPER_ADMIN, RoleType.GESTIONNAIRE)
findOne(@Param('id') id: string) { findOne(@Param('id') id: string) {
return this.userService.findOne(id); return this.userService.findOne(id);
@ -37,6 +46,8 @@ export class UserController {
// Modifier un utilisateur (réservé super_admin) // Modifier un utilisateur (réservé super_admin)
@Patch(':id') @Patch(':id')
@Roles(RoleType.SUPER_ADMIN) @Roles(RoleType.SUPER_ADMIN)
@ApiOperation({summary: 'Trouver un utilisateur par son id'})
@ApiParam({name: 'id', description: "UUID de l'utilisateur"})
update( update(
@Param('id') id: string, @Param('id') id: string,
@Body() dto: UpdateUserDto, @Body() dto: UpdateUserDto,
@ -46,6 +57,8 @@ export class UserController {
} }
// Supprimer un utilisateur (super_admin et gestionnaire) // Supprimer un utilisateur (super_admin et gestionnaire)
@ApiOperation({summary: 'Supprimer un utilisateur'})
@ApiParam({name: 'id', description: "UUID de l'utilisateur"})
@Delete(':id') @Delete(':id')
@Roles(RoleType.SUPER_ADMIN, RoleType.GESTIONNAIRE) @Roles(RoleType.SUPER_ADMIN, RoleType.GESTIONNAIRE)
remove(@Param('id') id: string) { remove(@Param('id') id: string) {