# joaquin571/eventos-uy architecture

> Architecture diagram of the GitHub repository joaquin571/eventos-uy, 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/joaquin571/eventos-uy
- Repository: https://github.com/joaquin571/eventos-uy

## Overview

eventos.uy manages events, editions, users, registrations, sponsorships and images through a shared business-logic JAR, with a Swing administrator client and a role-aware servlet web client. The main workflow is a visitor or signed-in user submitting web actions, which servlets pass to the system API for validation and persistence; administrators can also review and accept or reject editions in Swing. The graph preserves the documented product areas, but servlet coverage is only partly sampled, so some web-to-feature links are documented rather than traced through each route.

Main entry points: [`logica/src/main/java/implementacion/Sistema.java`](https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/implementacion/Sistema.java) (System API), [`webapp/src/main/java/web`](https://github.com/joaquin571/eventos-uy/tree/dev/webapp/src/main/java/web) (Servlet workflows), [`logica/src/main/java/persistencia/BaseDeDatos.java`](https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/persistencia/BaseDeDatos.java) (JPA persistence), [`webapp/src/main/java/web/ContextoListener.java`](https://github.com/joaquin571/eventos-uy/blob/dev/webapp/src/main/java/web/ContextoListener.java) (Web context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User interfaces"]
  node_swing["Swing administrator<br/>[principal.java]"]
  node_swing_panels["Swing workflows"]
end

subgraph group_web["Web application"]
  node_web_routes["Servlet workflows"]
  node_access["Role access filter<br/>[FiltroAcceso.java]"]
  node_web_context["Web context"]
end

subgraph group_logic["Business logic"]
  node_system["System API<br/>[Sistema.java]"]
  node_api["ISistema contract<br/>[ISistema.java]"]
  node_event_manager["Event manager"]
  node_registration_manager["Registration manager"]
  node_other_managers["Other domain managers"]
  node_image_service["Image validation and handling"]
end

subgraph group_domain["Domain and persistence"]
  node_users["User accounts<br/>[Usuario.java]"]
  node_event_model["Events and editions<br/>[Evento.java]"]
  node_edition_model["Edition state<br/>[Edicion.java]"]
  node_registrations["Registrations<br/>[Registro.java]"]
  node_sponsorships["Sponsorships<br/>[Patrocinio.java]"]
  node_transfer_types["Transfer data types"]
  node_persistence[("JPA persistence<br/>[BaseDeDatos.java]")]
end

node_visitor(("Visitor / user"))
node_admin(("Administrator"))
node_postgres[("PostgreSQL")]

node_visitor -->|"uses"| node_web_routes
node_web_routes -.->|"subject to"| node_access
node_web_routes -->|"gets system"| node_web_context
node_web_context -->|"creates"| node_system
node_web_context -->|"initializes"| node_persistence
node_web_routes -->|"calls"| node_api
node_admin -->|"uses"| node_swing
node_swing -->|"opens"| node_swing_panels
node_swing_panels -->|"calls"| node_api
node_system -->|"implements"| node_api
node_system -->|"delegates to"| node_event_manager
node_system -->|"delegates to"| node_registration_manager
node_system -->|"delegates to"| node_other_managers
node_system -->|"maps data"| node_transfer_types
node_event_manager -->|"uses"| node_persistence
node_registration_manager -->|"uses"| node_persistence
node_persistence -->|"stores data"| node_postgres
node_system -.->|"validates images"| node_image_service
node_system -.->|"manages"| node_users
node_system -.->|"manages"| node_event_model
node_system -.->|"manages"| node_edition_model
node_system -.->|"manages"| node_registrations
node_system -.->|"manages"| node_sponsorships

click node_swing "https://github.com/joaquin571/eventos-uy/blob/dev/estacion-trabajo/src/main/java/swing/principal.java"
click node_swing_panels "https://github.com/joaquin571/eventos-uy/tree/dev/estacion-trabajo/src/main/java/swing"
click node_web_routes "https://github.com/joaquin571/eventos-uy/tree/dev/webapp/src/main/java/web"
click node_access "https://github.com/joaquin571/eventos-uy/blob/dev/webapp/src/main/java/web/FiltroAcceso.java"
click node_web_context "https://github.com/joaquin571/eventos-uy/blob/dev/webapp/src/main/java/web/ContextoListener.java"
click node_system "https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/implementacion/Sistema.java"
click node_api "https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/interfaces/ISistema.java"
click node_users "https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/clases/Usuario.java"
click node_event_model "https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/clases/Evento.java"
click node_edition_model "https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/clases/Edicion.java"
click node_registrations "https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/clases/Registro.java"
click node_sponsorships "https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/clases/Patrocinio.java"
click node_transfer_types "https://github.com/joaquin571/eventos-uy/tree/dev/logica/src/main/java/datatypes"
click node_event_manager "https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/manejadores/ManejadorEventos.java"
click node_registration_manager "https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/manejadores/ManejadorRegistros.java"
click node_other_managers "https://github.com/joaquin571/eventos-uy/tree/dev/logica/src/main/java/manejadores"
click node_image_service "https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/implementacion/ValidadorImagen.java"
click node_persistence "https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/persistencia/BaseDeDatos.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_swing,node_swing_panels,node_visitor toneBlue
class node_web_routes,node_access,node_web_context,node_postgres toneAmber
class node_system,node_api,node_event_manager,node_registration_manager,node_other_managers,node_image_service toneMint
class node_users,node_event_model,node_edition_model,node_registrations,node_sponsorships,node_transfer_types,node_persistence toneRose
class node_admin toneIndigo
```

## Components

### User interfaces

- [Swing administrator](https://github.com/joaquin571/eventos-uy/blob/dev/estacion-trabajo/src/main/java/swing/principal.java): `estacion-trabajo/src/main/java/swing/principal.java`
- [Swing workflows](https://github.com/joaquin571/eventos-uy/tree/dev/estacion-trabajo/src/main/java/swing): `estacion-trabajo/src/main/java/swing`

### Web application

- [Servlet workflows](https://github.com/joaquin571/eventos-uy/tree/dev/webapp/src/main/java/web): `webapp/src/main/java/web`
- [Role access filter](https://github.com/joaquin571/eventos-uy/blob/dev/webapp/src/main/java/web/FiltroAcceso.java): `webapp/src/main/java/web/FiltroAcceso.java`
- [Web context](https://github.com/joaquin571/eventos-uy/blob/dev/webapp/src/main/java/web/ContextoListener.java): `webapp/src/main/java/web/ContextoListener.java`

### Business logic

- [System API](https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/implementacion/Sistema.java): `logica/src/main/java/implementacion/Sistema.java`
- [ISistema contract](https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/interfaces/ISistema.java): `logica/src/main/java/interfaces/ISistema.java`
- [Event manager](https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/manejadores/ManejadorEventos.java): `logica/src/main/java/manejadores/ManejadorEventos.java`
- [Registration manager](https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/manejadores/ManejadorRegistros.java): `logica/src/main/java/manejadores/ManejadorRegistros.java`
- [Other domain managers](https://github.com/joaquin571/eventos-uy/tree/dev/logica/src/main/java/manejadores): `logica/src/main/java/manejadores`
- [Image validation and handling](https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/implementacion/ValidadorImagen.java): `logica/src/main/java/implementacion/ValidadorImagen.java`

### Domain and persistence

- [User accounts](https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/clases/Usuario.java): `logica/src/main/java/clases/Usuario.java`
- [Events and editions](https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/clases/Evento.java): `logica/src/main/java/clases/Evento.java`
- [Edition state](https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/clases/Edicion.java): `logica/src/main/java/clases/Edicion.java`
- [Registrations](https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/clases/Registro.java): `logica/src/main/java/clases/Registro.java`
- [Sponsorships](https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/clases/Patrocinio.java): `logica/src/main/java/clases/Patrocinio.java`
- [Transfer data types](https://github.com/joaquin571/eventos-uy/tree/dev/logica/src/main/java/datatypes): `logica/src/main/java/datatypes`
- [JPA persistence](https://github.com/joaquin571/eventos-uy/blob/dev/logica/src/main/java/persistencia/BaseDeDatos.java): `logica/src/main/java/persistencia/BaseDeDatos.java`

### Other components

- **Visitor / user**
- **Administrator**
- **PostgreSQL**

## Connections

- Visitor / user → Servlet workflows: uses
- Servlet workflows → Role access filter: subject to
- Servlet workflows → Web context: gets system (evidence: `webapp/src/main/java/web/ContextoListener.java`)
- Web context → System API: creates (evidence: `webapp/src/main/java/web/ContextoListener.java`)
- Web context → JPA persistence: initializes (evidence: `webapp/src/main/java/web/ContextoListener.java`)
- Servlet workflows → ISistema contract: calls (evidence: `webapp/src/main/java/web/RegistroEdicionServlet.java`)
- Administrator → Swing administrator: uses
- Swing administrator → Swing workflows: opens (evidence: `estacion-trabajo/src/main/java/swing/principal.java`)
- Swing workflows → ISistema contract: calls (evidence: `estacion-trabajo/src/main/java/swing/AltaUsuarioPanel.java`)
- System API → ISistema contract: implements (evidence: `logica/src/main/java/implementacion/Sistema.java`)
- System API → Event manager: delegates to (evidence: `logica/src/main/java/implementacion/Sistema.java`)
- System API → Registration manager: delegates to (evidence: `logica/src/main/java/implementacion/Sistema.java`)
- System API → Other domain managers: delegates to (evidence: `logica/src/main/java/implementacion/Sistema.java`)
- System API → Transfer data types: maps data (evidence: `logica/src/main/java/implementacion/Sistema.java`)
- Event manager → JPA persistence: uses (evidence: `logica/src/main/java/manejadores/ManejadorEventos.java`)
- Registration manager → JPA persistence: uses (evidence: `logica/src/main/java/manejadores/ManejadorRegistros.java`)
- JPA persistence → PostgreSQL: stores data
- System API → Image validation and handling: validates images (evidence: `logica/src/main/java/implementacion/Sistema.java`)
- System API → User accounts: manages (evidence: `logica/src/main/java/implementacion/Sistema.java`)
- System API → Events and editions: manages (evidence: `logica/src/main/java/implementacion/Sistema.java`)
- System API → Edition state: manages (evidence: `logica/src/main/java/implementacion/Sistema.java`)
- System API → Registrations: manages (evidence: `logica/src/main/java/implementacion/Sistema.java`)
- System API → Sponsorships: manages (evidence: `logica/src/main/java/implementacion/Sistema.java`)
