Aplicación web de gestión de clientes y facturación desarrollada con Spring Boot 4, Thymeleaf y Spring Security. Permite realizar operaciones CRUD sobre clientes, gestionar facturas con líneas de detalle (productos) y controlar el acceso mediante autenticación con roles.

• CRUD de clientes con subida y gestión de imágenes de perfil (UUID como nombre único, límite 10 MB).
• Sistema de facturación con búsqueda de productos por autocompletado (AJAX + jQuery UI Autocomplete) y cálculo automático de importes con BigDecimal.
• Autenticación y autorización basada en roles (ROLE_USER, ROLE_ADMIN) con Spring Security y encriptación BCrypt.
• Paginación de resultados con componente reutilizable (PageRender).
• Migraciones de base de datos con Flyway (V1 crea tablas, V2 inserta datos de prueba).
• Separación de capas: Entidades JPA ↔ DTOs especializados (formulario, listado, detalle) mapeados con MapStruct.
• Manejo global de errores con @ControllerAdvice (404, 500, 403).
• Tests unitarios e integración: servicios con Mockito, repositorios con @DataJpaTest sobre H2, y mappers.

• Java 21 (o superior)
• Docker y Docker Compose (para la base de datos MySQL)
• No es necesario instalar Maven — el proyecto incluye el wrapper (mvnw).

1. Clonar el repositorio:

git clone https://github.com/nicovilab/springboot-datajpa.git
cd springboot-datajpa

2. Levantar MySQL con Docker:

docker compose up -d

3. Ejecutar la aplicación:

.\mvnw spring-boot:run "-Dspring-boot.run.arguments=--DB_USERNAME=user --DB_PASSWORD=password"

Flyway ejecutará las migraciones automáticamente en el primer arranque, creando las tablas e insertando datos de prueba.

4. Acceder a http://localhost:8080

ROLE_USER puede ver el listado de clientes, ver detalles de un cliente y visualizar sus fotos. ROLE_ADMIN además puede crear, editar y eliminar clientes, y gestionar facturas.

.\mvnw test