# codeforge-dosw/techcup-futbol-backend-springboot architecture

> Architecture diagram of the GitHub repository codeforge-dosw/techcup-futbol-backend-springboot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/codeforge-dosw/techcup-futbol-backend-springboot
- Repository: https://github.com/codeforge-dosw/techcup-futbol-backend-springboot

## Overview

TechCup Fútbol is a Spring Boot REST backend for managing football tournaments, teams, players and users, protected by JWT authentication. The main workflow is a client request entering a controller, passing through a domain service for validation and operations, and reaching repositories for persistence; mappers translate between persistence entities and API/domain models. The README also describes match, lineup, invitation and related football-domain capabilities, but their runtime implementation is not shown in the excerpts. Edges reflect the README or SOURCE INDEX references; unsampled behavior is not inferred.

Main entry points: [`src/main/java/edu/eci/dosw/tech_cup/service/TeamService.java`](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/service/TeamService.java) (Team service), [`src/main/java/edu/eci/dosw/tech_cup/service/UserService.java`](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/service/UserService.java) (User service), [`src/main/java/edu/eci/dosw/tech_cup/service/TournamentService.java`](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/service/TournamentService.java) (Tournament service), [`src/main/java/edu/eci/dosw/tech_cup/mapper/UserMapper.java`](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/mapper/UserMapper.java) (User mapper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_auth_api["Authentication API"]
  node_team_api["Team API"]
  node_tournament_api["Tournament API"]
  node_user_api["User API"]
  node_swagger["API documentation<br/>[SwaggerConfig.java]"]
end

subgraph group_security["Identity and access"]
  node_security_config["Security configuration"]
  node_jwt_filter["JWT request filter"]
  node_jwt_service["JWT service<br/>[JwtService.java]"]
end

subgraph group_operations["Tournament operations"]
  node_user_service["User service<br/>[UserService.java]"]
  node_team_service["Team service<br/>[TeamService.java]"]
  node_tournament_service["Tournament service"]
end

subgraph group_domain["Football domain and persistence"]
  node_user_repo["User repository"]
  node_team_repo["Team repository"]
  node_team_player_repo["Team-player repository"]
  node_tournament_repo["Tournament repository"]
  node_user_mapper["User mapper<br/>[UserMapper.java]"]
  node_team_mapper["Team mapper<br/>[TeamMapper.java]"]
  node_tournament_mapper["Tournament mapper"]
  node_user_entity["User and role records<br/>[UserEntity.java]"]
  node_team_entity["Team records<br/>[TeamEntity.java]"]
  node_team_player_entity["Team-player records"]
  node_tournament_entity["Tournament records"]
  node_football_models["Football domain models"]
end

node_client(("API client"))

node_client -->|"submits login"| node_auth_api
node_client -->|"calls endpoints"| node_team_api
node_client -->|"calls endpoints"| node_tournament_api
node_client -->|"calls endpoints"| node_user_api
node_auth_api -->|"uses tokens"| node_jwt_service
node_security_config -->|"configures filter"| node_jwt_filter
node_jwt_filter -->|"validates tokens"| node_jwt_service
node_team_api -->|"delegates to"| node_team_service
node_tournament_api -->|"delegates to"| node_tournament_service
node_user_api -->|"delegates to"| node_user_service
node_user_service -->|"reads and writes"| node_user_repo
node_user_service -->|"maps users"| node_user_mapper
node_team_service -->|"reads and writes"| node_team_repo
node_team_service -->|"records roster"| node_team_player_repo
node_team_service -->|"checks tournament"| node_tournament_repo
node_team_service -->|"checks captain"| node_user_repo
node_team_service -->|"maps teams"| node_team_mapper
node_tournament_service -->|"reads and writes"| node_tournament_repo
node_tournament_service -->|"maps tournaments"| node_tournament_mapper
node_user_repo -->|"persists"| node_user_entity
node_team_repo -->|"persists"| node_team_entity
node_team_player_repo -->|"persists"| node_team_player_entity
node_tournament_repo -->|"persists"| node_tournament_entity
node_user_mapper -->|"maps from"| node_user_entity
node_user_mapper -->|"maps to"| node_football_models
node_team_mapper -->|"maps from"| node_team_entity
node_team_mapper -->|"maps to"| node_football_models
node_tournament_mapper -->|"maps from"| node_tournament_entity
node_tournament_mapper -->|"maps to"| node_football_models

click node_auth_api "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/controller/AuthController.java"
click node_team_api "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/controller/TeamController.java"
click node_tournament_api "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/controller/TournamentController.java"
click node_user_api "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/controller/UserController.java"
click node_swagger "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/config/SwaggerConfig.java"
click node_security_config "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/security/SecurityConfig.java"
click node_jwt_filter "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/security/JwtAuthenticationFilter.java"
click node_jwt_service "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/service/JwtService.java"
click node_user_service "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/service/UserService.java"
click node_team_service "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/service/TeamService.java"
click node_tournament_service "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/service/TournamentService.java"
click node_user_repo "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/repository/UserRepository.java"
click node_team_repo "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/repository/TeamRepository.java"
click node_team_player_repo "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/repository/TeamPlayerRepository.java"
click node_tournament_repo "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/repository/TournamentRepository.java"
click node_user_mapper "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/mapper/UserMapper.java"
click node_team_mapper "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/mapper/TeamMapper.java"
click node_tournament_mapper "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/mapper/TournamentMapper.java"
click node_user_entity "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/entity/UserEntity.java"
click node_team_entity "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/entity/TeamEntity.java"
click node_team_player_entity "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/entity/TeamPlayerEntity.java"
click node_tournament_entity "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/entity/TournamentEntity.java"
click node_football_models "https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/tree/main/src/main/java/edu/eci/dosw/tech_cup/model"

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_team_api,node_tournament_api,node_user_api,node_swagger,node_client toneBlue
class node_security_config,node_jwt_filter,node_jwt_service toneAmber
class node_user_service,node_team_service,node_tournament_service toneMint
class node_user_repo,node_team_repo,node_team_player_repo,node_tournament_repo,node_user_mapper,node_team_mapper,node_tournament_mapper,node_user_entity,node_team_entity,node_team_player_entity,node_tournament_entity,node_football_models toneRose
```

## Components

### REST API

- [Authentication API](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/controller/AuthController.java): `src/main/java/edu/eci/dosw/tech_cup/controller/AuthController.java`
- [Team API](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/controller/TeamController.java): `src/main/java/edu/eci/dosw/tech_cup/controller/TeamController.java`
- [Tournament API](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/controller/TournamentController.java): `src/main/java/edu/eci/dosw/tech_cup/controller/TournamentController.java`
- [User API](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/controller/UserController.java): `src/main/java/edu/eci/dosw/tech_cup/controller/UserController.java`
- [API documentation](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/config/SwaggerConfig.java): `src/main/java/edu/eci/dosw/tech_cup/config/SwaggerConfig.java`

### Identity and access

- [Security configuration](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/security/SecurityConfig.java): `src/main/java/edu/eci/dosw/tech_cup/security/SecurityConfig.java`
- [JWT request filter](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/security/JwtAuthenticationFilter.java): `src/main/java/edu/eci/dosw/tech_cup/security/JwtAuthenticationFilter.java`
- [JWT service](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/service/JwtService.java): `src/main/java/edu/eci/dosw/tech_cup/service/JwtService.java`

### Tournament operations

- [User service](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/service/UserService.java): `src/main/java/edu/eci/dosw/tech_cup/service/UserService.java`
- [Team service](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/service/TeamService.java): `src/main/java/edu/eci/dosw/tech_cup/service/TeamService.java`
- [Tournament service](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/service/TournamentService.java): `src/main/java/edu/eci/dosw/tech_cup/service/TournamentService.java`

### Football domain and persistence

- [User repository](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/repository/UserRepository.java): `src/main/java/edu/eci/dosw/tech_cup/repository/UserRepository.java`
- [Team repository](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/repository/TeamRepository.java): `src/main/java/edu/eci/dosw/tech_cup/repository/TeamRepository.java`
- [Team-player repository](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/repository/TeamPlayerRepository.java): `src/main/java/edu/eci/dosw/tech_cup/repository/TeamPlayerRepository.java`
- [Tournament repository](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/repository/TournamentRepository.java): `src/main/java/edu/eci/dosw/tech_cup/repository/TournamentRepository.java`
- [User mapper](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/mapper/UserMapper.java): `src/main/java/edu/eci/dosw/tech_cup/mapper/UserMapper.java`
- [Team mapper](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/mapper/TeamMapper.java): `src/main/java/edu/eci/dosw/tech_cup/mapper/TeamMapper.java`
- [Tournament mapper](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/mapper/TournamentMapper.java): `src/main/java/edu/eci/dosw/tech_cup/mapper/TournamentMapper.java`
- [User and role records](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/entity/UserEntity.java): `src/main/java/edu/eci/dosw/tech_cup/entity/UserEntity.java`
- [Team records](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/entity/TeamEntity.java): `src/main/java/edu/eci/dosw/tech_cup/entity/TeamEntity.java`
- [Team-player records](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/entity/TeamPlayerEntity.java): `src/main/java/edu/eci/dosw/tech_cup/entity/TeamPlayerEntity.java`
- [Tournament records](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/blob/main/src/main/java/edu/eci/dosw/tech_cup/entity/TournamentEntity.java): `src/main/java/edu/eci/dosw/tech_cup/entity/TournamentEntity.java`
- [Football domain models](https://github.com/codeforge-dosw/techcup-futbol-backend-springboot/tree/main/src/main/java/edu/eci/dosw/tech_cup/model): `src/main/java/edu/eci/dosw/tech_cup/model`

### Other components

- **API client**

## Connections

- API client → Authentication API: submits login (evidence: `README.md`)
- API client → Team API: calls endpoints (evidence: `README.md`)
- API client → Tournament API: calls endpoints (evidence: `README.md`)
- API client → User API: calls endpoints (evidence: `README.md`)
- Authentication API → JWT service: uses tokens (evidence: `src/main/java/edu/eci/dosw/tech_cup/controller/AuthController.java`)
- Security configuration → JWT request filter: configures filter (evidence: `src/main/java/edu/eci/dosw/tech_cup/security/SecurityConfig.java`)
- JWT request filter → JWT service: validates tokens (evidence: `src/main/java/edu/eci/dosw/tech_cup/security/JwtAuthenticationFilter.java`)
- Team API → Team service: delegates to (evidence: `src/main/java/edu/eci/dosw/tech_cup/controller/TeamController.java`)
- Tournament API → Tournament service: delegates to (evidence: `src/main/java/edu/eci/dosw/tech_cup/controller/TournamentController.java`)
- User API → User service: delegates to (evidence: `src/main/java/edu/eci/dosw/tech_cup/controller/UserController.java`)
- User service → User repository: reads and writes (evidence: `src/main/java/edu/eci/dosw/tech_cup/service/UserService.java`)
- User service → User mapper: maps users (evidence: `src/main/java/edu/eci/dosw/tech_cup/service/UserService.java`)
- Team service → Team repository: reads and writes (evidence: `src/main/java/edu/eci/dosw/tech_cup/service/TeamService.java`)
- Team service → Team-player repository: records roster (evidence: `src/main/java/edu/eci/dosw/tech_cup/service/TeamService.java`)
- Team service → Tournament repository: checks tournament (evidence: `src/main/java/edu/eci/dosw/tech_cup/service/TeamService.java`)
- Team service → User repository: checks captain (evidence: `src/main/java/edu/eci/dosw/tech_cup/service/TeamService.java`)
- Team service → Team mapper: maps teams (evidence: `src/main/java/edu/eci/dosw/tech_cup/service/TeamService.java`)
- Tournament service → Tournament repository: reads and writes (evidence: `src/main/java/edu/eci/dosw/tech_cup/service/TournamentService.java`)
- Tournament service → Tournament mapper: maps tournaments (evidence: `src/main/java/edu/eci/dosw/tech_cup/service/TournamentService.java`)
- User repository → User and role records: persists (evidence: `src/main/java/edu/eci/dosw/tech_cup/repository/UserRepository.java`)
- Team repository → Team records: persists (evidence: `src/main/java/edu/eci/dosw/tech_cup/repository/TeamRepository.java`)
- Team-player repository → Team-player records: persists (evidence: `src/main/java/edu/eci/dosw/tech_cup/repository/TeamPlayerRepository.java`)
- Tournament repository → Tournament records: persists (evidence: `src/main/java/edu/eci/dosw/tech_cup/repository/TournamentRepository.java`)
- User mapper → User and role records: maps from (evidence: `src/main/java/edu/eci/dosw/tech_cup/mapper/UserMapper.java`)
- User mapper → Football domain models: maps to (evidence: `src/main/java/edu/eci/dosw/tech_cup/mapper/UserMapper.java`)
- Team mapper → Team records: maps from (evidence: `src/main/java/edu/eci/dosw/tech_cup/mapper/TeamMapper.java`)
- Team mapper → Football domain models: maps to (evidence: `src/main/java/edu/eci/dosw/tech_cup/mapper/TeamMapper.java`)
- Tournament mapper → Tournament records: maps from (evidence: `src/main/java/edu/eci/dosw/tech_cup/mapper/TournamentMapper.java`)
- Tournament mapper → Football domain models: maps to (evidence: `src/main/java/edu/eci/dosw/tech_cup/mapper/TournamentMapper.java`)
