# antoniogalvan/intro-spring architecture

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

- Interactive diagram: https://gitdiagram.com/antoniogalvan/intro-spring
- Repository: https://github.com/antoniogalvan/intro-spring

## Overview

The tree indicates a Spring MVC music-catalog API with artist and song operations, user authentication, role-based request protection, and persistence. The principal workflow appears to be client requests handled by controllers and services, with catalog or user state persisted and authentication supported by JWTs. Source excerpts and README content were unavailable, so links below are dashed and unverified; they reflect the apparent architecture from names and layout, not inspected call sites.

Main entry points: [`src/main/java/com/example/introspring/services/AuthService.java`](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/services/AuthService.java) (Authentication service), [`src/main/java/com/example/introspring/security/AuthInterceptor.java`](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/security/AuthInterceptor.java) (Request interceptor), [`src/main/java/com/example/introspring/repositories/UsuarioRepository.java`](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/repositories/UsuarioRepository.java) (User repository), [`src/main/java/com/example/introspring/controllers/ArtistController.java`](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/controllers/ArtistController.java) (Artist endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and requests"]
  node_artist_api["Artist endpoints"]
  node_song_api["Song endpoints"]
  node_health_api["Health endpoint"]
  node_request_dtos["Request and response DTOs"]
  node_error_handler["Error handling"]
end

subgraph group_auth["Authentication and access"]
  node_auth_api["Authentication endpoints"]
  node_auth_service["Authentication service<br/>[AuthService.java]"]
  node_jwt_service["JWT service<br/>[JwtService.java]"]
  node_auth_interceptor["Request interceptor"]
  node_role_rules["Role rules<br/>[RequiereRol.java]"]
  node_web_config["Web security config<br/>[WebConfig.java]"]
  node_roles["Role definitions<br/>[Roles.java]"]
  node_user_model["User model<br/>[Usuario.java]"]
end

subgraph group_catalog["Music catalog"]
  node_artist_service["Artist service<br/>[ArtistService.java]"]
  node_song_service["Song service<br/>[SongService.java]"]
  node_artist_model["Artist model<br/>[Artist.java]"]
  node_song_model["Song model<br/>[Song.java]"]
end

subgraph group_persistence["Persistence and structures"]
  node_user_repository["User repository"]
  node_linked_list["Linked list<br/>[LinkedList.java]"]
  node_list_node["List node<br/>[Node.java]"]
  node_database[("PostgreSQL database")]
end

node_client(("API client"))

node_client -.->|"requests"| node_artist_api
node_client -.->|"requests"| node_song_api
node_client -.->|"authenticates"| node_auth_api
node_client -.->|"checks health"| node_health_api
node_artist_api -.->|"delegates to"| node_artist_service
node_song_api -.->|"delegates to"| node_song_service
node_auth_api -.->|"delegates to"| node_auth_service
node_auth_service -.->|"accesses users"| node_user_repository
node_auth_service -.->|"uses tokens"| node_jwt_service
node_auth_interceptor -.->|"validates tokens"| node_jwt_service
node_web_config -.->|"registers"| node_auth_interceptor
node_auth_interceptor -.->|"checks roles"| node_role_rules
node_role_rules -.->|"uses definitions"| node_roles
node_artist_service -.->|"uses model"| node_artist_model
node_song_service -.->|"uses model"| node_song_model
node_user_repository -.->|"loads users"| node_user_model
node_user_repository -.->|"reads and writes"| node_database
node_linked_list -.->|"uses nodes"| node_list_node

click node_artist_api "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/controllers/ArtistController.java"
click node_song_api "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/controllers/SongController.java"
click node_health_api "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/controllers/HealthController.java"
click node_request_dtos "https://github.com/antoniogalvan/intro-spring/tree/main/src/main/java/com/example/introspring/dto"
click node_error_handler "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/errors/ManejadorErrores.java"
click node_auth_api "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/controllers/AuthController.java"
click node_auth_service "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/services/AuthService.java"
click node_jwt_service "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/services/JwtService.java"
click node_auth_interceptor "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/security/AuthInterceptor.java"
click node_role_rules "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/security/RequiereRol.java"
click node_web_config "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/security/WebConfig.java"
click node_roles "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/security/Roles.java"
click node_artist_service "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/services/ArtistService.java"
click node_song_service "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/services/SongService.java"
click node_artist_model "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/models/Artist.java"
click node_song_model "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/models/Song.java"
click node_user_model "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/models/Usuario.java"
click node_user_repository "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/repositories/UsuarioRepository.java"
click node_linked_list "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/structures/LinkedList.java"
click node_list_node "https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/structures/Node.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_artist_api,node_song_api,node_health_api,node_request_dtos,node_error_handler,node_client toneBlue
class node_auth_api,node_auth_service,node_jwt_service,node_auth_interceptor,node_role_rules,node_web_config,node_roles,node_user_model toneAmber
class node_artist_service,node_song_service,node_artist_model,node_song_model toneMint
class node_user_repository,node_linked_list,node_list_node,node_database toneRose
```

## Components

### API and requests

- [Artist endpoints](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/controllers/ArtistController.java): `src/main/java/com/example/introspring/controllers/ArtistController.java`
- [Song endpoints](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/controllers/SongController.java): `src/main/java/com/example/introspring/controllers/SongController.java`
- [Health endpoint](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/controllers/HealthController.java): `src/main/java/com/example/introspring/controllers/HealthController.java`
- [Request and response DTOs](https://github.com/antoniogalvan/intro-spring/tree/main/src/main/java/com/example/introspring/dto): `src/main/java/com/example/introspring/dto`
- [Error handling](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/errors/ManejadorErrores.java): `src/main/java/com/example/introspring/errors/ManejadorErrores.java`

### Authentication and access

- [Authentication endpoints](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/controllers/AuthController.java): `src/main/java/com/example/introspring/controllers/AuthController.java`
- [Authentication service](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/services/AuthService.java): `src/main/java/com/example/introspring/services/AuthService.java`
- [JWT service](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/services/JwtService.java): `src/main/java/com/example/introspring/services/JwtService.java`
- [Request interceptor](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/security/AuthInterceptor.java): `src/main/java/com/example/introspring/security/AuthInterceptor.java`
- [Role rules](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/security/RequiereRol.java): `src/main/java/com/example/introspring/security/RequiereRol.java`
- [Web security config](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/security/WebConfig.java): `src/main/java/com/example/introspring/security/WebConfig.java`
- [Role definitions](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/security/Roles.java): `src/main/java/com/example/introspring/security/Roles.java`
- [User model](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/models/Usuario.java): `src/main/java/com/example/introspring/models/Usuario.java`

### Music catalog

- [Artist service](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/services/ArtistService.java): `src/main/java/com/example/introspring/services/ArtistService.java`
- [Song service](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/services/SongService.java): `src/main/java/com/example/introspring/services/SongService.java`
- [Artist model](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/models/Artist.java): `src/main/java/com/example/introspring/models/Artist.java`
- [Song model](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/models/Song.java): `src/main/java/com/example/introspring/models/Song.java`

### Persistence and structures

- [User repository](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/repositories/UsuarioRepository.java): `src/main/java/com/example/introspring/repositories/UsuarioRepository.java`
- [Linked list](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/structures/LinkedList.java): `src/main/java/com/example/introspring/structures/LinkedList.java`
- [List node](https://github.com/antoniogalvan/intro-spring/blob/main/src/main/java/com/example/introspring/structures/Node.java): `src/main/java/com/example/introspring/structures/Node.java`
- **PostgreSQL database**

### Other components

- **API client**

## Connections

- API client → Artist endpoints: requests
- API client → Song endpoints: requests
- API client → Authentication endpoints: authenticates
- API client → Health endpoint: checks health
- Artist endpoints → Artist service: delegates to
- Song endpoints → Song service: delegates to
- Authentication endpoints → Authentication service: delegates to
- Authentication service → User repository: accesses users
- Authentication service → JWT service: uses tokens
- Request interceptor → JWT service: validates tokens
- Web security config → Request interceptor: registers
- Request interceptor → Role rules: checks roles
- Role rules → Role definitions: uses definitions
- Artist service → Artist model: uses model
- Song service → Song model: uses model
- User repository → User model: loads users
- User repository → PostgreSQL database: reads and writes
- Linked list → List node: uses nodes
