# andrle0600/biblioteca-ia-backend architecture

> Architecture diagram of the GitHub repository andrle0600/biblioteca-ia-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/andrle0600/biblioteca-ia-backend
- Repository: https://github.com/andrle0600/biblioteca-ia-backend

## Overview

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: [`src/main/java/com/biblioteca/persistencia/repository`](https://github.com/andrle0600/biblioteca-ia-backend/tree/main/src/main/java/com/biblioteca/persistencia/repository) (Data Repositories), [`src/main/java/com/biblioteca/negocio/service/AuthService.java`](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/negocio/service/AuthService.java) (Auth Service), [`src/main/java/com/biblioteca/presentacion/web/LibroApiController.java`](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/presentacion/web/LibroApiController.java) (Catalog Endpoints), [`src/main/java/com/biblioteca/presentacion/web/EjemplarApiController.java`](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/presentacion/web/EjemplarApiController.java) (Copy Endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_auth_api["Auth Endpoints"]
  node_catalog_api["Catalog Endpoints"]
  node_copy_api["Copy Endpoints"]
  node_reservation_api["Reservation Endpoints"]
  node_location_api["Location Endpoints"]
  node_user_api["User Endpoints"]
  node_auth_dto["Auth DTOs"]
end

subgraph group_domain["Library Services"]
  node_auth_service["Auth Service<br/>[AuthService.java]"]
  node_catalog_service["Catalog Service<br/>[LibroService.java]"]
  node_copy_service["Copy Service"]
  node_reservation_service["Reservation Service"]
  node_location_service["Location Service"]
  node_user_service["User Service"]
end

subgraph group_data["Persistence"]
  node_entities["Library Records"]
  node_repositories["Data Repositories"]
  node_db[("Relational Store")]
end

subgraph group_security["Authentication"]
  node_jwt_filter["JWT Filter"]
  node_jwt_service["JWT Service<br/>[JwtService.java]"]
  node_user_details["User Details"]
  node_security_config["Security Config"]
end

node_client(("API Client"))

node_client -->|"sends requests"| node_auth_api
node_client -->|"sends requests"| node_catalog_api
node_client -->|"sends requests"| node_copy_api
node_client -->|"sends requests"| node_reservation_api
node_client -->|"sends requests"| node_location_api
node_client -->|"sends requests"| node_user_api
node_auth_api -->|"delegates to"| node_auth_service
node_catalog_api -->|"delegates to"| node_catalog_service
node_catalog_api -->|"delegates to"| node_copy_service
node_copy_api -->|"delegates to"| node_copy_service
node_copy_api -->|"delegates to"| node_catalog_service
node_reservation_api -->|"delegates to"| node_reservation_service
node_location_api -->|"delegates to"| node_location_service
node_user_api -->|"delegates to"| node_user_service
node_auth_service -->|"uses payloads"| node_auth_dto
node_auth_service -->|"issues tokens"| node_jwt_service
node_auth_service -->|"looks up users and roles"| node_repositories
node_catalog_service -->|"queries catalog"| node_repositories
node_copy_service -->|"queries copies"| node_repositories
node_reservation_service -->|"reads and saves"| node_repositories
node_location_service -->|"uses location data"| node_repositories
node_user_service -->|"uses user data"| node_repositories
node_user_details -->|"loads users"| node_repositories
node_jwt_filter -->|"validates tokens"| node_jwt_service
node_jwt_filter -->|"loads identity"| node_user_details
node_repositories -.->|"persists records"| node_db
node_repositories -.->|"maps records"| node_entities
node_security_config -.->|"registers filter"| node_jwt_filter

click node_auth_api "https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/presentacion/web/AuthApiController.java"
click node_catalog_api "https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/presentacion/web/LibroApiController.java"
click node_copy_api "https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/presentacion/web/EjemplarApiController.java"
click node_reservation_api "https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/presentacion/web/ReservasLibroApiController.java"
click node_location_api "https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/presentacion/web/UbicacionApiController.java"
click node_user_api "https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/presentacion/web/UsuarioApiController.java"
click node_auth_service "https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/negocio/service/AuthService.java"
click node_catalog_service "https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/negocio/service/LibroService.java"
click node_copy_service "https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/negocio/service/EjemplarService.java"
click node_reservation_service "https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/negocio/service/ReservaLibroService.java"
click node_location_service "https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/negocio/service/UbicacionService.java"
click node_user_service "https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/negocio/service/UsuarioService.java"
click node_auth_dto "https://github.com/andrle0600/biblioteca-ia-backend/tree/main/src/main/java/com/biblioteca/presentacion/dto"
click node_entities "https://github.com/andrle0600/biblioteca-ia-backend/tree/main/src/main/java/com/biblioteca/persistencia/entity"
click node_repositories "https://github.com/andrle0600/biblioteca-ia-backend/tree/main/src/main/java/com/biblioteca/persistencia/repository"
click node_jwt_filter "https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/seguridad/JwtAuthenticationFilter.java"
click node_jwt_service "https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/seguridad/JwtService.java"
click node_user_details "https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/seguridad/CustomUserDetailsService.java"
click node_security_config "https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/seguridad/SecurityConfig.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth_api,node_catalog_api,node_copy_api,node_reservation_api,node_location_api,node_user_api,node_auth_dto,node_client toneBlue
class node_auth_service,node_catalog_service,node_copy_service,node_reservation_service,node_location_service,node_user_service toneAmber
class node_entities,node_repositories,node_db toneMint
class node_jwt_filter,node_jwt_service,node_user_details,node_security_config toneRose
```

## Components

### REST API

- [Auth Endpoints](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/presentacion/web/AuthApiController.java): `src/main/java/com/biblioteca/presentacion/web/AuthApiController.java`
- [Catalog Endpoints](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/presentacion/web/LibroApiController.java): `src/main/java/com/biblioteca/presentacion/web/LibroApiController.java`
- [Copy Endpoints](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/presentacion/web/EjemplarApiController.java): `src/main/java/com/biblioteca/presentacion/web/EjemplarApiController.java`
- [Reservation Endpoints](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/presentacion/web/ReservasLibroApiController.java): `src/main/java/com/biblioteca/presentacion/web/ReservasLibroApiController.java`
- [Location Endpoints](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/presentacion/web/UbicacionApiController.java): `src/main/java/com/biblioteca/presentacion/web/UbicacionApiController.java`
- [User Endpoints](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/presentacion/web/UsuarioApiController.java): `src/main/java/com/biblioteca/presentacion/web/UsuarioApiController.java`
- [Auth DTOs](https://github.com/andrle0600/biblioteca-ia-backend/tree/main/src/main/java/com/biblioteca/presentacion/dto): `src/main/java/com/biblioteca/presentacion/dto`

### Library Services

- [Auth Service](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/negocio/service/AuthService.java): `src/main/java/com/biblioteca/negocio/service/AuthService.java`
- [Catalog Service](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/negocio/service/LibroService.java): `src/main/java/com/biblioteca/negocio/service/LibroService.java`
- [Copy Service](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/negocio/service/EjemplarService.java): `src/main/java/com/biblioteca/negocio/service/EjemplarService.java`
- [Reservation Service](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/negocio/service/ReservaLibroService.java): `src/main/java/com/biblioteca/negocio/service/ReservaLibroService.java`
- [Location Service](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/negocio/service/UbicacionService.java): `src/main/java/com/biblioteca/negocio/service/UbicacionService.java`
- [User Service](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/negocio/service/UsuarioService.java): `src/main/java/com/biblioteca/negocio/service/UsuarioService.java`

### Persistence

- [Library Records](https://github.com/andrle0600/biblioteca-ia-backend/tree/main/src/main/java/com/biblioteca/persistencia/entity): `src/main/java/com/biblioteca/persistencia/entity`
- [Data Repositories](https://github.com/andrle0600/biblioteca-ia-backend/tree/main/src/main/java/com/biblioteca/persistencia/repository): `src/main/java/com/biblioteca/persistencia/repository`
- **Relational Store**

### Authentication

- [JWT Filter](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/seguridad/JwtAuthenticationFilter.java): `src/main/java/com/biblioteca/seguridad/JwtAuthenticationFilter.java`
- [JWT Service](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/seguridad/JwtService.java): `src/main/java/com/biblioteca/seguridad/JwtService.java`
- [User Details](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/seguridad/CustomUserDetailsService.java): `src/main/java/com/biblioteca/seguridad/CustomUserDetailsService.java`
- [Security Config](https://github.com/andrle0600/biblioteca-ia-backend/blob/main/src/main/java/com/biblioteca/seguridad/SecurityConfig.java): `src/main/java/com/biblioteca/seguridad/SecurityConfig.java`

### Other components

- **API Client**

## Connections

- 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 (evidence: `src/main/java/com/biblioteca/presentacion/web/AuthApiController.java`)
- Catalog Endpoints → Catalog Service: delegates to (evidence: `src/main/java/com/biblioteca/presentacion/web/LibroApiController.java`)
- Catalog Endpoints → Copy Service: delegates to (evidence: `src/main/java/com/biblioteca/presentacion/web/LibroApiController.java`)
- Copy Endpoints → Copy Service: delegates to (evidence: `src/main/java/com/biblioteca/presentacion/web/EjemplarApiController.java`)
- Copy Endpoints → Catalog Service: delegates to (evidence: `src/main/java/com/biblioteca/presentacion/web/EjemplarApiController.java`)
- Reservation Endpoints → Reservation Service: delegates to (evidence: `src/main/java/com/biblioteca/presentacion/web/ReservasLibroApiController.java`)
- Location Endpoints → Location Service: delegates to (evidence: `src/main/java/com/biblioteca/presentacion/web/UbicacionApiController.java`)
- User Endpoints → User Service: delegates to (evidence: `src/main/java/com/biblioteca/presentacion/web/UsuarioApiController.java`)
- Auth Service → Auth DTOs: uses payloads (evidence: `src/main/java/com/biblioteca/negocio/service/AuthService.java`)
- Auth Service → JWT Service: issues tokens (evidence: `src/main/java/com/biblioteca/negocio/service/AuthService.java`)
- Auth Service → Data Repositories: looks up users and roles (evidence: `src/main/java/com/biblioteca/negocio/service/AuthService.java`)
- Catalog Service → Data Repositories: queries catalog (evidence: `src/main/java/com/biblioteca/negocio/service/LibroService.java`)
- Copy Service → Data Repositories: queries copies (evidence: `src/main/java/com/biblioteca/negocio/service/EjemplarService.java`)
- Reservation Service → Data Repositories: reads and saves (evidence: `src/main/java/com/biblioteca/negocio/service/ReservaLibroService.java`)
- Location Service → Data Repositories: uses location data (evidence: `src/main/java/com/biblioteca/negocio/service/UbicacionService.java`)
- User Service → Data Repositories: uses user data (evidence: `src/main/java/com/biblioteca/negocio/service/UsuarioService.java`)
- User Details → Data Repositories: loads users (evidence: `src/main/java/com/biblioteca/seguridad/CustomUserDetailsService.java`)
- JWT Filter → JWT Service: validates tokens (evidence: `src/main/java/com/biblioteca/seguridad/JwtAuthenticationFilter.java`)
- JWT Filter → User Details: loads identity (evidence: `src/main/java/com/biblioteca/seguridad/JwtAuthenticationFilter.java`)
- Data Repositories → Relational Store: persists records
- Data Repositories → Library Records: maps records (evidence: `src/main/java/com/biblioteca/persistencia/repository/UserRepository.java`)
- Security Config → JWT Filter: registers filter (evidence: `src/main/java/com/biblioteca/seguridad/SecurityConfig.java`)
