swagger

src/stylists/stylists.controller.ts

@@ -10,6 +10,7 @@ import {
   Query,
   UseGuards,
 } from '@nestjs/common';
+import { ApiBearerAuth, ApiQuery, ApiTags } from '@nestjs/swagger';
 import { CurrentUser } from '../auth/decorators/current-user.decorator';
 import { Public } from '../auth/decorators/public.decorator';
 import { Permissions } from '../auth/decorators/permissions.decorator';
@@ -22,7 +23,11 @@ import { UserRole } from '../users/enums/user-role.enum';
 import { CreateStylistDto } from './dto/create-stylist.dto';
 import { UpdateStylistDto } from './dto/update-stylist.dto';
 import { StylistsService } from './stylists.service';
+import { ApiPublicEndpoint } from '../swagger/decorators/swagger-auth.decorator';
+import { SWAGGER_JWT_AUTH } from '../swagger/swagger.setup';
 
+@ApiTags('Stylists')
+@ApiBearerAuth(SWAGGER_JWT_AUTH)
 @Controller('stylists')
 @UseGuards(RolesGuard, PermissionsGuard)
 export class StylistsController {
@@ -39,12 +44,15 @@ export class StylistsController {
   }
 
   @Public()
+  @ApiPublicEndpoint('List stylists, optionally filtered by salon')
+  @ApiQuery({ name: 'salonId', required: false, type: String, format: 'uuid' })
   @Get()
   findAll(@Query('salonId', new ParseUUIDPipe({ optional: true })) salonId?: string) {
     return this.stylistsService.findAll(salonId);
   }
 
   @Public()
+  @ApiPublicEndpoint('Get stylist by ID')
   @Get(':id')
   findOne(@Param('id', ParseUUIDPipe) id: string) {
     return this.stylistsService.findOne(id);