# tomicaballeroutn-oss/sin-g10-vastio architecture

> Architecture diagram of the GitHub repository tomicaballeroutn-oss/sin-g10-vastio, 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/tomicaballeroutn-oss/sin-g10-vastio
- Repository: https://github.com/tomicaballeroutn-oss/sin-g10-vastio

## Overview

Vastio is a salon-event management system combining a commercial agenda with beverage inventory and event-level consumption. The main workflow is staff using the web application to manage event reservations and lifecycle, while operational teams record beverage stock movements, preparation, deliveries, and consumption. Supporting capabilities include Google Calendar synchronization, configurable catalogs, user and role management, notifications, and occupancy reporting. The graph reflects the supplied tree and source index; unsampled UI-to-API wiring and other unverified connections are shown only as dashed links or omitted.

Main entry points: [`backend/src/main/java/ar/edu/utn/vastio/bebida/aplicacion/EntregaService.java`](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/bebida/aplicacion/EntregaService.java) (Deliveries and stock), [`frontend/src`](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/tree/main/frontend/src) (Management UI), [`backend/src/main/java/ar/edu/utn/vastio/agenda/aplicacion/ConsultaEventoService.java`](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/agenda/aplicacion/ConsultaEventoService.java) (Event queries), [`backend/src/main/java/ar/edu/utn/vastio/agenda/dominio/Evento.java`](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/agenda/dominio/Evento.java) (Event record)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["Management UI"]
end

subgraph group_agenda["Event agenda"]
  node_agenda_api["Agenda endpoints"]
  node_agenda_service["Event queries"]
  node_event_state["Event lifecycle"]
  node_event_model["Event record<br/>[Evento.java]"]
  node_event_states["Event states<br/>[EstadoEvento.java]"]
  node_event_store[("Event repository")]
  node_calendar_sync["Calendar export"]
end

subgraph group_bebidas["Beverage operations"]
  node_drink_api["Beverage endpoints"]
  node_delivery_service["Deliveries and stock"]
  node_drink_model["Beverage catalog<br/>[Bebida.java]"]
  node_drink_store[("Beverage repositories")]
end

subgraph group_platform["Shared platform"]
  node_catalog_service["Salon catalogs"]
  node_user_service["Users and roles"]
  node_auth["Authentication"]
  node_token["Access tokens<br/>[TokenService.java]"]
end

subgraph group_insights["Notifications and reporting"]
  node_notifications["Notifications"]
  node_occupancy["Occupancy reports"]
end

node_staff(("Salon staff"))
node_google_calendar["Google Calendar"]

node_staff -->|"uses"| node_webapp
node_webapp -.->|"requests events"| node_agenda_api
node_webapp -.->|"requests stock"| node_drink_api
node_agenda_service -->|"queries"| node_event_store
node_agenda_service -->|"returns event data"| node_event_model
node_event_state -->|"changes state"| node_event_model
node_event_state -.->|"checks transitions"| node_event_states
node_calendar_sync -->|"loads events"| node_event_store
node_calendar_sync -->|"synchronizes"| node_google_calendar
node_delivery_service -->|"uses beverages"| node_drink_model
node_delivery_service -->|"records movements"| node_drink_store
node_delivery_service -->|"checks events"| node_agenda_service
node_delivery_service -.->|"alerts stock"| node_notifications
node_catalog_service -.->|"catalog context"| node_event_model
node_user_service -.->|"provides accounts"| node_auth
node_auth -.->|"issues tokens"| node_token
node_notifications -->|"finds recipients"| node_user_service
node_occupancy -->|"uses salon catalogs"| node_catalog_service
node_occupancy -->|"filters event states"| node_event_states

click node_webapp "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/tree/main/frontend/src"
click node_agenda_api "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/agenda/api/EventoController.java"
click node_agenda_service "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/agenda/aplicacion/ConsultaEventoService.java"
click node_event_state "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/agenda/aplicacion/MaquinaDeEstados.java"
click node_event_model "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/agenda/dominio/Evento.java"
click node_event_states "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/agenda/dominio/EstadoEvento.java"
click node_event_store "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/agenda/infraestructura/EventoRepository.java"
click node_calendar_sync "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/agenda/aplicacion/ExportacionCalendarService.java"
click node_drink_api "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/bebida/api/EntregaController.java"
click node_delivery_service "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/bebida/aplicacion/EntregaService.java"
click node_drink_model "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/bebida/dominio/Bebida.java"
click node_drink_store "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/bebida/infraestructura/MovimientoStockRepository.java"
click node_catalog_service "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/configuracion/aplicacion/CatalogoService.java"
click node_user_service "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/usuarios/aplicacion/UsuarioService.java"
click node_auth "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/usuarios/aplicacion/AutenticacionService.java"
click node_token "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/comun/seguridad/TokenService.java"
click node_notifications "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/notificaciones/aplicacion/NotificacionService.java"
click node_occupancy "https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/reportes/aplicacion/ReporteOcupacionService.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_webapp toneBlue
class node_agenda_api,node_agenda_service,node_event_state,node_event_model,node_event_states,node_event_store,node_calendar_sync toneAmber
class node_drink_api,node_delivery_service,node_drink_model,node_drink_store toneMint
class node_catalog_service,node_user_service,node_auth,node_token toneRose
class node_notifications,node_occupancy,node_staff,node_google_calendar toneIndigo
```

## Components

### Web application

- [Management UI](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/tree/main/frontend/src): `frontend/src`

### Event agenda

- [Agenda endpoints](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/agenda/api/EventoController.java): `backend/src/main/java/ar/edu/utn/vastio/agenda/api/EventoController.java`
- [Event queries](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/agenda/aplicacion/ConsultaEventoService.java): `backend/src/main/java/ar/edu/utn/vastio/agenda/aplicacion/ConsultaEventoService.java`
- [Event lifecycle](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/agenda/aplicacion/MaquinaDeEstados.java): `backend/src/main/java/ar/edu/utn/vastio/agenda/aplicacion/MaquinaDeEstados.java`
- [Event record](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/agenda/dominio/Evento.java): `backend/src/main/java/ar/edu/utn/vastio/agenda/dominio/Evento.java`
- [Event states](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/agenda/dominio/EstadoEvento.java): `backend/src/main/java/ar/edu/utn/vastio/agenda/dominio/EstadoEvento.java`
- [Event repository](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/agenda/infraestructura/EventoRepository.java): `backend/src/main/java/ar/edu/utn/vastio/agenda/infraestructura/EventoRepository.java`
- [Calendar export](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/agenda/aplicacion/ExportacionCalendarService.java): `backend/src/main/java/ar/edu/utn/vastio/agenda/aplicacion/ExportacionCalendarService.java`

### Beverage operations

- [Beverage endpoints](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/bebida/api/EntregaController.java): `backend/src/main/java/ar/edu/utn/vastio/bebida/api/EntregaController.java`
- [Deliveries and stock](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/bebida/aplicacion/EntregaService.java): `backend/src/main/java/ar/edu/utn/vastio/bebida/aplicacion/EntregaService.java`
- [Beverage catalog](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/bebida/dominio/Bebida.java): `backend/src/main/java/ar/edu/utn/vastio/bebida/dominio/Bebida.java`
- [Beverage repositories](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/bebida/infraestructura/MovimientoStockRepository.java): `backend/src/main/java/ar/edu/utn/vastio/bebida/infraestructura/MovimientoStockRepository.java`

### Shared platform

- [Salon catalogs](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/configuracion/aplicacion/CatalogoService.java): `backend/src/main/java/ar/edu/utn/vastio/configuracion/aplicacion/CatalogoService.java`
- [Users and roles](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/usuarios/aplicacion/UsuarioService.java): `backend/src/main/java/ar/edu/utn/vastio/usuarios/aplicacion/UsuarioService.java`
- [Authentication](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/usuarios/aplicacion/AutenticacionService.java): `backend/src/main/java/ar/edu/utn/vastio/usuarios/aplicacion/AutenticacionService.java`
- [Access tokens](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/comun/seguridad/TokenService.java): `backend/src/main/java/ar/edu/utn/vastio/comun/seguridad/TokenService.java`

### Notifications and reporting

- [Notifications](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/notificaciones/aplicacion/NotificacionService.java): `backend/src/main/java/ar/edu/utn/vastio/notificaciones/aplicacion/NotificacionService.java`
- [Occupancy reports](https://github.com/tomicaballeroutn-oss/sin-g10-vastio/blob/main/backend/src/main/java/ar/edu/utn/vastio/reportes/aplicacion/ReporteOcupacionService.java): `backend/src/main/java/ar/edu/utn/vastio/reportes/aplicacion/ReporteOcupacionService.java`

### Other components

- **Salon staff**
- **Google Calendar**

## Connections

- Salon staff → Management UI: uses (evidence: `README.md`)
- Management UI → Agenda endpoints: requests events
- Management UI → Beverage endpoints: requests stock
- Event queries → Event repository: queries (evidence: `backend/src/main/java/ar/edu/utn/vastio/agenda/aplicacion/ConsultaEventoService.java`)
- Event queries → Event record: returns event data (evidence: `backend/src/main/java/ar/edu/utn/vastio/agenda/aplicacion/ConsultaEventoService.java`)
- Event lifecycle → Event record: changes state (evidence: `backend/src/main/java/ar/edu/utn/vastio/agenda/dominio/Evento.java`)
- Event lifecycle → Event states: checks transitions
- Calendar export → Event repository: loads events (evidence: `backend/src/main/java/ar/edu/utn/vastio/agenda/aplicacion/ExportacionCalendarService.java`)
- Calendar export → Google Calendar: synchronizes (evidence: `backend/src/main/java/ar/edu/utn/vastio/agenda/aplicacion/ExportacionCalendarService.java`)
- Deliveries and stock → Beverage catalog: uses beverages (evidence: `backend/src/main/java/ar/edu/utn/vastio/bebida/aplicacion/EntregaService.java`)
- Deliveries and stock → Beverage repositories: records movements (evidence: `backend/src/main/java/ar/edu/utn/vastio/bebida/aplicacion/EntregaService.java`)
- Deliveries and stock → Event queries: checks events (evidence: `backend/src/main/java/ar/edu/utn/vastio/bebida/aplicacion/EntregaService.java`)
- Deliveries and stock → Notifications: alerts stock (evidence: `backend/src/main/java/ar/edu/utn/vastio/bebida/aplicacion/EntregaService.java`)
- Salon catalogs → Event record: catalog context
- Users and roles → Authentication: provides accounts
- Authentication → Access tokens: issues tokens (evidence: `backend/src/main/java/ar/edu/utn/vastio/usuarios/aplicacion/AutenticacionService.java`)
- Notifications → Users and roles: finds recipients (evidence: `backend/src/main/java/ar/edu/utn/vastio/notificaciones/aplicacion/NotificacionService.java`)
- Occupancy reports → Salon catalogs: uses salon catalogs (evidence: `backend/src/main/java/ar/edu/utn/vastio/reportes/aplicacion/ReporteOcupacionService.java`)
- Occupancy reports → Event states: filters event states (evidence: `backend/src/main/java/ar/edu/utn/vastio/reportes/aplicacion/ReporteOcupacionService.java`)
