OpenAPI / Swagger en NestJS — Documentación de API HADA

Guía completa para documentar la API REST de HADA con OpenAPI 3.0 y Swagger UI usando @nestjs/swagger. Cubre configuración, decoradores en controllers y DTOs, seguridad JWT, y generación del contrato OpenAPI para el equipo de frontend móvil.

Referencias disponibles

• references/setup.md — Instalación, SwaggerModule, DocumentBuilder, entornos
• references/decorators.md — Todos los decoradores: @ApiTags, @ApiOperation, @ApiResponse, @ApiProperty
• references/dtos.md — DTOs documentados de los módulos principales de HADA
• references/security.md — @ApiBearerAuth, esquema JWT en Swagger UI

Cuándo usar cada referencia