Hotel Booking API

API REST para la gestión de reservas de hoteles desarrollada con Spring Boot. El proyecto implementa autenticación mediante JWT, control de acceso por roles y operaciones CRUD para hoteles, habitaciones, clientes y reservas, siguiendo buenas prácticas de desarrollo de APIs REST.

Características

• Autenticación y autorización con JWT.
• Control de acceso basado en roles.
• Gestión de hoteles.
• Gestión de tipos de habitación.
• Gestión de habitaciones.
• Gestión de clientes.
• Gestión de reservas.
• Validación de datos.
• Manejo global de excepciones.
• Documentación de la API con Swagger / OpenAPI.
• Persistencia de datos con MySQL.

Tecnologías

• Java 21
• Spring Boot
• Spring Security
• JWT (JSON Web Token)
• Spring Data JPA (Hibernate)
• MySQL
• Maven
• Lombok
• Bean Validation

Estructura del proyecto

src
├── config
├── domain
│   ├── auth
│   ├── customer
│   ├── hotel
│   ├── reservation
│   ├── room
│   ├── roomtype
│   └── user
├── security
├── shared
└── resources

Instalación

Requisitos

• Java 21 o superior
• Maven 3.9 o superior
• MySQL 8 o superior

Configuración

Configura las siguientes variables de entorno o agrégalas en tu archivo application.properties:

DB_URL=
DB_USERNAME=
DB_PASSWORD=

JWT_SECRET=
JWT_EXPIRATION=

Ejecutar el proyecto

Con Maven:

mvn spring-boot:run

O generar el archivo JAR:

mvn clean package

Ejemplo de respuesta de error

{
  "status": 404,
  "code": "RESOURCE_NOT_FOUND",
  "message": "El recurso solicitado no fue encontrado.",
  "timestamp": "2026-07-15T14:30:15"
}

Mejoras futuras

• Implementar Refresh Tokens.
• Consolidar el proceso actual e aumentar mas casos de uso.
• Pruebas unitarias e integración.
• Seguimiento de pagos en las reservas.