How andrle0600/biblioteca-ia-backend works
This is a Spring-based library-management API. The user workflow enters through REST endpoints, invokes domain services for authentication, catalog, physical copies, locations, users, and reservations, then persists library state through Spring Data repositories. Reservation creation and return also update copy availability. Authentication adds password checks, user/role lookup, JWT issuance, and JWT-based request identity. The README is empty; relationships below are limited to source-index references and shown excerpts, so unsampled wiring is not asserted.
Main entry points: repository Data Repositories · AuthService.java Auth Service · LibroApiController.java Catalog Endpoints · EjemplarApiController.java Copy Endpoints
Components 21
REST API
- Auth Endpoints
src/main/java/com/biblioteca/presentacion/web/AuthApiController.java - Catalog Endpoints
src/main/java/com/biblioteca/presentacion/web/LibroApiController.java - Copy Endpoints
src/main/java/com/biblioteca/presentacion/web/EjemplarApiController.java - Reservation Endpoints
src/main/java/com/biblioteca/presentacion/web/ReservasLibroApiController.java - Location Endpoints
src/main/java/com/biblioteca/presentacion/web/UbicacionApiController.java - User Endpoints
src/main/java/com/biblioteca/presentacion/web/UsuarioApiController.java - Auth DTOs
src/main/java/com/biblioteca/presentacion/dto
Library Services
- Auth Service
src/main/java/com/biblioteca/negocio/service/AuthService.java - Catalog Service
src/main/java/com/biblioteca/negocio/service/LibroService.java - Copy Service
src/main/java/com/biblioteca/negocio/service/EjemplarService.java - Reservation Service
src/main/java/com/biblioteca/negocio/service/ReservaLibroService.java - Location Service
src/main/java/com/biblioteca/negocio/service/UbicacionService.java - User Service
src/main/java/com/biblioteca/negocio/service/UsuarioService.java
Persistence
- Library Records
src/main/java/com/biblioteca/persistencia/entity - Data Repositories
src/main/java/com/biblioteca/persistencia/repository - Relational Store
Authentication
- JWT Filter
src/main/java/com/biblioteca/seguridad/JwtAuthenticationFilter.java - JWT Service
src/main/java/com/biblioteca/seguridad/JwtService.java - User Details
src/main/java/com/biblioteca/seguridad/CustomUserDetailsService.java - Security Config
src/main/java/com/biblioteca/seguridad/SecurityConfig.java
Other components
- API Client
Connections 28
- API Client → Auth Endpoints: sends requests
- API Client → Catalog Endpoints: sends requests
- API Client → Copy Endpoints: sends requests
- API Client → Reservation Endpoints: sends requests
- API Client → Location Endpoints: sends requests
- API Client → User Endpoints: sends requests
- Auth Endpoints → Auth Service: delegates to
src/main/java/com/biblioteca/presentacion/web/AuthApiController.java - Catalog Endpoints → Catalog Service: delegates to
src/main/java/com/biblioteca/presentacion/web/LibroApiController.java - Catalog Endpoints → Copy Service: delegates to
src/main/java/com/biblioteca/presentacion/web/LibroApiController.java - Copy Endpoints → Copy Service: delegates to
src/main/java/com/biblioteca/presentacion/web/EjemplarApiController.java - Copy Endpoints → Catalog Service: delegates to
src/main/java/com/biblioteca/presentacion/web/EjemplarApiController.java - Reservation Endpoints → Reservation Service: delegates to
src/main/java/com/biblioteca/presentacion/web/ReservasLibroApiController.java - Location Endpoints → Location Service: delegates to
src/main/java/com/biblioteca/presentacion/web/UbicacionApiController.java - User Endpoints → User Service: delegates to
src/main/java/com/biblioteca/presentacion/web/UsuarioApiController.java - Auth Service → Auth DTOs: uses payloads
src/main/java/com/biblioteca/negocio/service/AuthService.java - Auth Service → JWT Service: issues tokens
src/main/java/com/biblioteca/negocio/service/AuthService.java - Auth Service → Data Repositories: looks up users and roles
src/main/java/com/biblioteca/negocio/service/AuthService.java - Catalog Service → Data Repositories: queries catalog
src/main/java/com/biblioteca/negocio/service/LibroService.java - Copy Service → Data Repositories: queries copies
src/main/java/com/biblioteca/negocio/service/EjemplarService.java - Reservation Service → Data Repositories: reads and saves
src/main/java/com/biblioteca/negocio/service/ReservaLibroService.java - Location Service → Data Repositories: uses location data
src/main/java/com/biblioteca/negocio/service/UbicacionService.java - User Service → Data Repositories: uses user data
src/main/java/com/biblioteca/negocio/service/UsuarioService.java - User Details → Data Repositories: loads users
src/main/java/com/biblioteca/seguridad/CustomUserDetailsService.java - JWT Filter → JWT Service: validates tokens
src/main/java/com/biblioteca/seguridad/JwtAuthenticationFilter.java - JWT Filter → User Details: loads identity
src/main/java/com/biblioteca/seguridad/JwtAuthenticationFilter.java - Data Repositories → Relational Store: persists records
- Data Repositories → Library Records: maps records
src/main/java/com/biblioteca/persistencia/repository/UserRepository.java - Security Config → JWT Filter: registers filter
src/main/java/com/biblioteca/seguridad/SecurityConfig.java