# stivencr7/backend-desplieguerobotech architecture

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

- Interactive diagram: https://gitdiagram.com/stivencr7/backend-desplieguerobotech
- Repository: https://github.com/stivencr7/backend-desplieguerobotech

## Overview

This is a Spring web backend for managing a robotics tournament: users register clubs, competitors, and robots, organize tournament categories and encounters, and record match outcomes. The clearest sampled workflow is encounter management: controllers hand requests to services, which create brackets and advance winners using encounter and robot-match repositories. Other controllers expose related management capabilities, including news and staff administration. JWT-based security and Azure Blob image uploads are visible, but the README is empty and many controller/service implementations were not sampled, so some branches are shown without speculative call links.

Main entry points: [`src/main/java/com/spring/web/repository`](https://github.com/stivencr7/backend-desplieguerobotech/tree/main/src/main/java/com/spring/web/repository) (Data repositories), [`src/main/java/com/spring/web/controller/RobotsController.java`](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/RobotsController.java) (Robot endpoints), [`src/main/java/com/spring/web/controller/CompetidorController.java`](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/CompetidorController.java) (Competitor endpoints), [`src/main/java/com/spring/web/services/EncuentrosService.java`](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/services/EncuentrosService.java) (Bracket management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Web API"]
  node_robot_api["Robot endpoints"]
  node_competitor_api["Competitor endpoints"]
  node_encounter_api["Encounter endpoints"]
  node_participation_api["Participation endpoints"]
  node_tournament_api["Tournament endpoints"]
  node_club_api["Club endpoints"]
  node_news_api["News endpoints"]
  node_staff_api["Staff endpoints"]
end

subgraph group_competition["Competition Domain"]
  node_robot_service["Robot management<br/>[RobotServices.java]"]
  node_encounter_service["Bracket management"]
  node_participation_service["Participation management"]
  node_match_service["Match assignments"]
  node_match_view["Encounter robot view"]
  node_domain_models["Tournament entities"]
end

subgraph group_operations["Administration"]
  node_admin_services["Administration services"]
end

subgraph group_platform["Platform Services"]
  node_repositories["Data repositories"]
  node_database[("Relational database")]
  node_security["JWT security"]
  node_image_upload["Image storage"]
end

node_users(("API clients"))
node_azure[("Azure Blob Storage")]

node_users -->|"requests"| node_robot_api
node_users -->|"requests"| node_competitor_api
node_users -->|"requests"| node_encounter_api
node_users -->|"requests"| node_participation_api
node_users -.->|"requests"| node_tournament_api
node_users -.->|"requests"| node_club_api
node_users -.->|"requests"| node_news_api
node_users -.->|"requests"| node_staff_api
node_robot_api -->|"delegates to"| node_robot_service
node_robot_api -->|"uploads image"| node_image_upload
node_competitor_api -->|"creates competitor"| node_domain_models
node_competitor_api -->|"validates JWT"| node_security
node_encounter_api -->|"delegates to"| node_encounter_service
node_participation_api -->|"delegates to"| node_participation_service
node_tournament_api -.->|"uses services"| node_admin_services
node_club_api -->|"uses services"| node_admin_services
node_news_api -->|"uploads image"| node_image_upload
node_staff_api -->|"uses services"| node_admin_services
node_robot_service -->|"queries robots"| node_repositories
node_encounter_service -->|"reads and writes"| node_repositories
node_encounter_service -->|"builds brackets"| node_domain_models
node_match_service -->|"uses repository"| node_repositories
node_match_view -->|"reads view"| node_repositories
node_repositories -.->|"persists entities"| node_database
node_image_upload -->|"stores blobs"| node_azure

click node_robot_api "https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/RobotsController.java"
click node_competitor_api "https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/CompetidorController.java"
click node_encounter_api "https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/EncuentroController.java"
click node_participation_api "https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/ParticipacionesController.java"
click node_tournament_api "https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/TorneoController.java"
click node_club_api "https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/ClubesController.java"
click node_news_api "https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/NoticiaController.java"
click node_staff_api "https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/TrabajadoresController.java"
click node_robot_service "https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/services/RobotServices.java"
click node_encounter_service "https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/services/EncuentrosService.java"
click node_participation_service "https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/services/ParticipacionesService.java"
click node_match_service "https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/services/RobotsEncuentrosService.java"
click node_match_view "https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/services/VistaEncuentrosRobotsService.java"
click node_domain_models "https://github.com/stivencr7/backend-desplieguerobotech/tree/main/src/main/java/com/spring/web/model"
click node_repositories "https://github.com/stivencr7/backend-desplieguerobotech/tree/main/src/main/java/com/spring/web/repository"
click node_security "https://github.com/stivencr7/backend-desplieguerobotech/tree/main/src/main/java/com/spring/web/security"
click node_image_upload "https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/services/UploadFileService.java"
click node_admin_services "https://github.com/stivencr7/backend-desplieguerobotech/tree/main/src/main/java/com/spring/web/services"

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_robot_api,node_competitor_api,node_encounter_api,node_participation_api,node_tournament_api,node_club_api,node_news_api,node_staff_api,node_users toneBlue
class node_robot_service,node_encounter_service,node_participation_service,node_match_service,node_match_view,node_domain_models,node_azure toneAmber
class node_admin_services toneMint
class node_repositories,node_database,node_security,node_image_upload toneRose
```

## Components

### Web API

- [Robot endpoints](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/RobotsController.java): `src/main/java/com/spring/web/controller/RobotsController.java`
- [Competitor endpoints](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/CompetidorController.java): `src/main/java/com/spring/web/controller/CompetidorController.java`
- [Encounter endpoints](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/EncuentroController.java): `src/main/java/com/spring/web/controller/EncuentroController.java`
- [Participation endpoints](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/ParticipacionesController.java): `src/main/java/com/spring/web/controller/ParticipacionesController.java`
- [Tournament endpoints](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/TorneoController.java): `src/main/java/com/spring/web/controller/TorneoController.java`
- [Club endpoints](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/ClubesController.java): `src/main/java/com/spring/web/controller/ClubesController.java`
- [News endpoints](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/NoticiaController.java): `src/main/java/com/spring/web/controller/NoticiaController.java`
- [Staff endpoints](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/controller/TrabajadoresController.java): `src/main/java/com/spring/web/controller/TrabajadoresController.java`

### Competition Domain

- [Robot management](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/services/RobotServices.java): `src/main/java/com/spring/web/services/RobotServices.java`
- [Bracket management](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/services/EncuentrosService.java): `src/main/java/com/spring/web/services/EncuentrosService.java`
- [Participation management](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/services/ParticipacionesService.java): `src/main/java/com/spring/web/services/ParticipacionesService.java`
- [Match assignments](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/services/RobotsEncuentrosService.java): `src/main/java/com/spring/web/services/RobotsEncuentrosService.java`
- [Encounter robot view](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/services/VistaEncuentrosRobotsService.java): `src/main/java/com/spring/web/services/VistaEncuentrosRobotsService.java`
- [Tournament entities](https://github.com/stivencr7/backend-desplieguerobotech/tree/main/src/main/java/com/spring/web/model): `src/main/java/com/spring/web/model`

### Administration

- [Administration services](https://github.com/stivencr7/backend-desplieguerobotech/tree/main/src/main/java/com/spring/web/services): `src/main/java/com/spring/web/services`

### Platform Services

- [Data repositories](https://github.com/stivencr7/backend-desplieguerobotech/tree/main/src/main/java/com/spring/web/repository): `src/main/java/com/spring/web/repository`
- **Relational database**
- [JWT security](https://github.com/stivencr7/backend-desplieguerobotech/tree/main/src/main/java/com/spring/web/security): `src/main/java/com/spring/web/security`
- [Image storage](https://github.com/stivencr7/backend-desplieguerobotech/blob/main/src/main/java/com/spring/web/services/UploadFileService.java): `src/main/java/com/spring/web/services/UploadFileService.java`

### Other components

- **API clients**
- **Azure Blob Storage**

## Connections

- API clients → Robot endpoints: requests (evidence: `src/main/java/com/spring/web/controller/RobotsController.java`)
- API clients → Competitor endpoints: requests (evidence: `src/main/java/com/spring/web/controller/CompetidorController.java`)
- API clients → Encounter endpoints: requests (evidence: `src/main/java/com/spring/web/controller/EncuentroController.java`)
- API clients → Participation endpoints: requests (evidence: `src/main/java/com/spring/web/controller/ParticipacionesController.java`)
- API clients → Tournament endpoints: requests
- API clients → Club endpoints: requests
- API clients → News endpoints: requests
- API clients → Staff endpoints: requests
- Robot endpoints → Robot management: delegates to (evidence: `src/main/java/com/spring/web/controller/RobotsController.java`)
- Robot endpoints → Image storage: uploads image (evidence: `src/main/java/com/spring/web/controller/RobotsController.java`)
- Competitor endpoints → Tournament entities: creates competitor (evidence: `src/main/java/com/spring/web/controller/CompetidorController.java`)
- Competitor endpoints → JWT security: validates JWT (evidence: `src/main/java/com/spring/web/controller/CompetidorController.java`)
- Encounter endpoints → Bracket management: delegates to (evidence: `src/main/java/com/spring/web/controller/EncuentroController.java`)
- Participation endpoints → Participation management: delegates to (evidence: `src/main/java/com/spring/web/controller/ParticipacionesController.java`)
- Tournament endpoints → Administration services: uses services (evidence: `src/main/java/com/spring/web/controller/TorneoController.java`)
- Club endpoints → Administration services: uses services (evidence: `src/main/java/com/spring/web/controller/ClubesController.java`)
- News endpoints → Image storage: uploads image (evidence: `src/main/java/com/spring/web/controller/NoticiaController.java`)
- Staff endpoints → Administration services: uses services (evidence: `src/main/java/com/spring/web/controller/TrabajadoresController.java`)
- Robot management → Data repositories: queries robots (evidence: `src/main/java/com/spring/web/services/RobotServices.java`)
- Bracket management → Data repositories: reads and writes (evidence: `src/main/java/com/spring/web/services/EncuentrosService.java`)
- Bracket management → Tournament entities: builds brackets (evidence: `src/main/java/com/spring/web/services/EncuentrosService.java`)
- Match assignments → Data repositories: uses repository (evidence: `src/main/java/com/spring/web/services/RobotsEncuentrosService.java`)
- Encounter robot view → Data repositories: reads view (evidence: `src/main/java/com/spring/web/services/VistaEncuentrosRobotsService.java`)
- Data repositories → Relational database: persists entities
- Image storage → Azure Blob Storage: stores blobs (evidence: `src/main/java/com/spring/web/services/UploadFileService.java`)
