Casos de uso por desarrollar

[lgzarturo]

Capítulo 1: Configuración inicial y kit del desarrollador

Como desarrollador de sistemas hoteleros
Quiero configurar un entorno de desarrollo moderno con Spring Boot y Kotlin
Para poder construir una API de reservas de hotel robusta y escalable

Criterios de aceptación:

• Proyecto de Spring Boot generado con Spring Initializr
• JDK 17+ instalado y configurado en IntelliJ IDEA
• Kotlin configurado como lenguaje principal con características de seguridad nula
• Estructura básica del proyecto lista para desarrollo
• Entorno verificado con un endpoint simple de “Hello World”

Requisitos técnicos:

• Usar Spring Initializr para generar el proyecto base
• Configurar IntelliJ IDEA como IDE principal
• Asegurar que Kotlin esté correctamente integrado con Spring Boot
• Configurar las dependencias necesarias para el desarrollo futuro

Puntos de historia: 3
Prioridad: Alta

---

Capítulo 2: Rutas mágicas y conceptos básicos de Spring Boot

Como usuario del sistema de gestión hotelera
Quiero acceder a una API REST que brinde información básica sobre habitaciones tipo agua
Para poder ver y administrar la disponibilidad de habitaciones para Pokémon tipo Squirtle

Criterios de aceptación:

• Controlador REST creado con la anotación @RestController
• Endpoint GET para obtener información de habitaciones
• Endpoint POST para crear nuevas habitaciones
• Archivo application.yml configurado para los entornos
• Respuestas correctamente formateadas en las llamadas a la API

Requisitos técnicos:

• Implementar @RestController para manejar solicitudes HTTP
• Usar las anotaciones @GetMapping y @PostMapping
• Configurar application.yml con las propiedades de la aplicación
• Aplicar principios de inyección de dependencias para bajo acoplamiento

Puntos de historia: 5
Prioridad: Alta

---

Capítulo 3: Minas de datos y persistencia

Como administrador del hotel
Quiero almacenar y recuperar datos de entrenadores y reservas en una base de datos confiable
Para poder gestionar eficazmente la ocupación del hotel y la información de los huéspedes

Criterios de aceptación:

• Base de datos en memoria H2 configurada para desarrollo
• Entidades Trainer y Reservation creadas con la anotación @entity
• Interfaces JpaRepository implementadas para operaciones CRUD
• Relación uno a muchos entre entrenadores y reservas
• Problemas de rendimiento N+1 resueltos

Requisitos técnicos:

• Implementar entidades JPA con las anotaciones adecuadas
• Crear interfaces de repositorio que extiendan JpaRepository
• Configurar relaciones entre entidades (@onetomany, @manytoone)
• Optimizar consultas para evitar cuellos de botella
• Manejar la persistencia de datos de forma eficiente

Puntos de historia: 8
Prioridad: Alta

---

Capítulo 4: Dojo de validación y manejo de errores

Como usuario del sistema de registro hotelero
Quiero que el sistema valide la información de los entrenadores y maneje los errores adecuadamente
Para asegurar que solo se almacenen datos válidos y que los usuarios reciban mensajes de error útiles

Criterios de aceptación:

• Validación de entrada implementada en el formulario de registro de entrenadores
• Respuestas de error apropiadas para datos inválidos (400 Bad Request)
• Manejo global de excepciones con @ControllerAdvice
• Protección contra intentos de entrada maliciosa
• Mensajes de error amigables para fallos comunes de validación

Requisitos técnicos:

• Implementar la anotación @Valid con restricciones de Jakarta Validation
• Crear reglas de validación personalizadas según los requisitos del negocio
• Implementar un manejador global de excepciones con @ControllerAdvice
• Devolver respuestas de error estructuradas con mensajes claros
• Prevenir vulnerabilidades comunes mediante validación de entradas

Puntos de historia: 5
Prioridad: Alta

---

Capítulo 5: Fortaleza de seguridad y guardián JWT

Como encargado de seguridad del hotel
Quiero proteger la API del hotel con autenticación y autorización adecuadas
Para que solo los usuarios autorizados accedan a datos sensibles de reservas

Criterios de aceptación:

• Autenticación basada en JWT implementada
• Roles de usuario definidos (ADMIN y USER)
• Endpoints protegidos con control de acceso basado en roles
• Medidas de prevención contra ataques de fuerza bruta
• Manejo seguro de contraseñas con cifrado adecuado

Requisitos técnicos:

• Implementar Spring Security con autenticación JWT
• Crear sistema de roles y permisos
• Usar la anotación @PreAuthorize para proteger endpoints
• Implementar cifrado y almacenamiento seguro de contraseñas
• Agregar limitación de tasa para evitar ataques de fuerza bruta

Puntos de historia: 8
Prioridad: Crítica

---

Capítulo 6: Oráculo de pruebas en la Torre Pokémon

Como ingeniero de aseguramiento de calidad
Quiero una cobertura de pruebas completa para el sistema de reservas
Para garantizar la confiabilidad del sistema incluso bajo alta carga

Criterios de aceptación:

• Pruebas unitarias implementadas con JUnit 5 para toda la lógica de negocio
• Pruebas de integración usando la anotación @SpringBootTest
• Servicios simulados con Mockito para pruebas aisladas
• Pruebas de capa web usando @WebMvcTest
• Suite de pruebas confiable que maneje escenarios inestables

Requisitos técnicos:

• Implementar pruebas unitarias para todos los métodos de servicio
• Crear pruebas de integración para flujos completos
• Usar Mockito para simular dependencias externas
• Implementar @WebMvcTest para probar controladores
• Asegurar reproducibilidad y confiabilidad en las pruebas

Puntos de historia: 8
Prioridad: Alta

---

Capítulo 7: Mapa del viajero: documentación con Swagger

Como desarrollador y colaborador de la API
Quiero generar documentación automática y completa de la API
Para que otros desarrolladores puedan entender e integrar fácilmente el sistema hotelero

Criterios de aceptación:

• Documentación interactiva generada con SpringDoc OpenAPI
• Descripciones detalladas de endpoints usando @operation
• Ejemplos de respuesta y escenarios de error documentados
• Documentación actualizada y consistente con el código
• Interfaz amigable para explorar las capacidades de la API

Requisitos técnicos:

• Integrar SpringDoc OpenAPI para generación automática de documentación
• Agregar anotaciones @operation para describir los endpoints
• Documentar todas las respuestas posibles con @apiresponse
• Mantener sincronía entre la documentación y el código
• Proveer una interfaz interactiva para probar endpoints

Puntos de historia: 3
Prioridad: Media

---

Capítulo 8: Portal a la nube - despliegue y monitoreo

Como ingeniero DevOps
Quiero desplegar la API del hotel en producción con monitoreo adecuado
Para poder rastrear la salud y el rendimiento del sistema en tiempo real

Criterios de aceptación:

• Aplicación empaquetada como archivo JAR ejecutable
• Despliegue configurado para una plataforma en la nube (Heroku)
• Endpoints de monitoreo disponibles (/health)
• Métricas de rendimiento accesibles (/metrics)
• Autoescalado configurado para manejar picos de carga

Requisitos técnicos:

• Empaquetar la aplicación como JAR ejecutable con todas las dependencias
• Configurar el entorno de producción adecuadamente
• Implementar Spring Actuator para monitoreo de salud y métricas
• Establecer endpoints para ver el estado del sistema
• Configurar autoescalado basado en métricas del sistema

Puntos de historia: 5
Prioridad: Alta

---

Capítulo 9: Liga de maestros: temas avanzados

Como arquitecto del sistema
Quiero implementar funciones avanzadas como procesamiento asíncrono y caché
Para que el sistema hotelero maneje grandes cargas con alto rendimiento

Criterios de aceptación:

• Sistema de notificaciones asíncrono implementado con @async
• Caché en Redis configurado para datos de acceso frecuente
• Sistema de mensajería integrado (Kafka o RabbitMQ)
• Mejoras de rendimiento medidas y validadas
• Capacidad del sistema para manejar congestión de mensajes

Requisitos técnicos:

• Implementar @async para tareas en segundo plano
• Configurar Redis para almacenamiento en caché
• Integrar un broker de mensajería para comunicación entre servicios
• Optimizar el rendimiento mediante estrategias de caché
• Manejar escenarios de alto tráfico con colas de mensajes

Puntos de historia: 13
Prioridad: Media

---

Capítulo 10: El legado cumplido - proyecto final

Como propietario del hotel
Quiero una API completa de gestión hotelera para entrenadores Pokémon
Para ofrecer servicios y alojamiento de clase mundial a mis huéspedes

Criterios de aceptación:

• Sistema completo de gestión de usuarios con registro y perfiles
• Catálogo completo de habitaciones con temáticas especiales
• Sistema robusto de reservas con creación, modificación y cancelación
• Seguridad total con control de acceso basado en roles
• Documentación y monitoreo completos de la API
• Sistema preparado para soportar demanda global

Requisitos técnicos:

• Implementar todas las funciones de gestión de usuarios con seguridad
• Crear sistema de administración de habitaciones con diversas temáticas
• Desarrollar flujo completo de reservas con validaciones
• Integrar características de seguridad y autenticación
• Garantizar documentación y monitoreo integrales
• Optimizar el sistema para alto rendimiento y escalabilidad

Puntos de historia: 21
Prioridad: Crítica