API REST construida con Spring Boot para gestionar un catálogo de libros y autores. Incluye lógica de negocio para validar datos editoriales, evita inconsistencias al eliminar autores con libros asociados y expone operaciones CRUD completas para ambos dominios.

• Dominio rico: modelos Author, Book, Edition y ContactInfo con reglas de validación expresivas.
• Arquitectura hexagonal ligera: controladores REST → servicios de dominio → adaptadores JPA, todo desacoplado mediante interfaces.
• Validaciones exhaustivas: ISBN, fechas, copias vendidas, pseudónimos y datos de contacto se validan antes de persistir.
• Manejo centralizado de errores: ExceptionHandlerRegistry traduce excepciones de dominio a respuestas HTTP claras.
• Listo para producción: perfiles configurables, Dockerfile y docker-compose con MySQL 8 y healthcheck.

graph TD
  Client[Cliente REST] -->|HTTP| Controllers[Adapters / Controller]
  Controllers --> Services[Domain Services]
  Services --> Facade[AuthorFacade]
  Services --> Repositories[Ports / Repository]
  Repositories --> Adapters[Adapters / JPA]
  Adapters --> DB[(MySQL 8)]

graph TD
  A[src/main/java/com/dataspartan/catalog]
  A --> B[CatalogApplication.java]
  A --> C[adapter]
  C --> C1[controller]
  C1 --> C11[AuthorController.java]
  C1 --> C12[BookController.java]
  C --> C2[persistence]
  C2 --> C21[entity]
  C2 --> C22[jpa]
  C22 --> C23[adapter / repository]
  C2 --> C24[mapper]
  A --> D[domain]
  D --> D1[author / book / facade]
  D --> D2[exception]
  A --> E[resources]
  E --> E1[application.properties]

• Java 21 (Temurin recomendado).
• Maven 3.9+ o el wrapper ./mvnw.
• MySQL 8.0 (o Docker para usar el docker-compose incluido).
• Docker 24+ y Docker Compose v2 (opcional para despliegue en contenedores).

./mvnw clean package ./mvnw spring-boot:run

La aplicación escucha en http://localhost:8080.

docker compose up --build

• API: http://localhost:8080
• MySQL: localhost:3306 (usuario y contraseña)

Parámetros por defecto (src/main/resources/application.properties):

spring.datasource.url=jdbc:mysql://localhost:3306/catalog spring.datasource.username=luis.gf spring.datasource.password=provisional spring.jpa.hibernate.ddl-auto=update spring.jackson.date-format=yyyy-MM-dd spring.profiles.active=local

Ajusta credenciales o perfiles mediante variables de entorno SPRING_DATASOURCE_* y SPRING_PROFILES_ACTIVE.

POST /book Content-Type: application/json

{ "title": "El Nombre del Viento", "authorIds": [1], "publicationYear": 2007, "authorPseudonyms": { "1": "Patrick Rothfuss" }, "editions": [ { "isbn": "9780765311788", "publisher": "DAW Books", "publishedDate": "2007-03-27", "language": "es", "pages": 662, "totalCopies": 10000, "soldCopies": 8500 } ] }

Respuestas de error coherentes:

{ "status": 412, "error": "Precondition Failed", "message": "Cannot delete author: author has associated books", "path": "/author/1", "timestamp": "2025-02-05T22:15:34.123" }

• Un autor no puede eliminarse si existen libros que lo referencian (AuthorFacadeImpl).
• Fechas futuras o inconsistentes (nacimiento > fallecimiento, publicación futura, etc.) disparan InvalidArgumentsException.
• Validación de ISBN (10/13 dígitos), copias totales vs vendidas y páginas > 0.
• Contactos y ediciones se gestionan como colecciones embebidas (element collections) en JPA.

1. Haz un fork del repositorio.
2. Crea una rama feature: git checkout -b feature/nueva-funcionalidad que cuelgue de la rama develop.
3. Asegúrate de pasar los tests y respeta el estilo del proyecto.
4. Envía un pull request explicando claramente el cambio.