# gabriel6144/seminario-integrador-viajesazo architecture

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

- Interactive diagram: https://gitdiagram.com/gabriel6144/seminario-integrador-viajesazo
- Repository: https://github.com/gabriel6144/seminario-integrador-viajesazo

## Overview

Viajesazo is a tourism-information API and web client for Córdoba. The main journey is to browse events and the tourism agenda, create a trip draft, complete its dates and preferences, then generate and select a circuit with scheduled stops and estimated transfers. Separate branches cover event/publisher management and trip lifecycle. The README documents these capabilities; edges are included only where the README or shown source references support them, so unsampled frontend and backend routes are not expanded into inferred call chains.

Main entry points: [`turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/CircuitoService.java`](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/CircuitoService.java) (Circuit planning), [`turismo-backend/src/main/java/com/viajesazo/turismo_backend/TurismoBackendApplication.java`](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/TurismoBackendApplication.java) (REST API), [`turismo-frontend/src/api`](https://github.com/gabriel6144/seminario-integrador-viajesazo/tree/main/turismo-frontend/src/api) (API client modules), [`turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/PropuestaService.java`](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/PropuestaService.java) (Event management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web client"]
  node_webapp["Tourism web app<br/>[main.tsx]"]
  node_tripwizard["Trip planner"]
  node_catalogui["Events and agenda<br/>[eventos-page.tsx]"]
  node_clientapi["API client modules"]
end

subgraph group_catalog["Tourism catalog"]
  node_api["REST API"]
  node_eventmanagement["Event management"]
  node_publishers["Publisher management"]
  node_catalogdata[("Tourism proposals")]
  node_agenda["Search and agenda"]
  node_geo["Geocoding"]
  node_errors["Error handling"]
end

subgraph group_trips["Trip planning"]
  node_tripapi["Trip endpoints"]
  node_tripservice["Trip lifecycle<br/>[ViajeService.java]"]
  node_tripstore[("Trip records")]
  node_scheduler["Trip state scheduler"]
end

subgraph group_circuits["Circuit generation"]
  node_circuitapi["Circuit endpoints"]
  node_circuitservice["Circuit planning"]
  node_generator["Itinerary generator"]
  node_distance["Distance estimates"]
  node_circuitstore[("Circuit snapshots")]
end

node_traveler(("Traveler"))

node_traveler -->|"uses"| node_webapp
node_webapp -.->|"uses"| node_clientapi
node_clientapi -->|"calls"| node_api
node_catalogui -.->|"loads catalog"| node_clientapi
node_tripwizard -.->|"submits trip"| node_clientapi
node_api -.->|"routes events"| node_eventmanagement
node_eventmanagement -->|"geocodes location"| node_geo
node_eventmanagement -->|"persists events"| node_catalogdata
node_api -.->|"routes agenda"| node_agenda
node_agenda -->|"queries proposals"| node_catalogdata
node_api -->|"routes trips"| node_tripapi
node_tripapi -->|"delegates"| node_tripservice
node_tripservice -->|"reads and writes"| node_tripstore
node_tripservice -->|"loads circuit"| node_circuitservice
node_scheduler -.->|"finds transitions"| node_tripstore
node_api -->|"routes circuits"| node_circuitapi
node_circuitapi -->|"delegates"| node_circuitservice
node_circuitservice -->|"generates alternatives"| node_generator
node_circuitservice -->|"estimates transfers"| node_distance
node_circuitservice -->|"saves snapshots"| node_circuitstore
node_circuitservice -->|"checks availability"| node_catalogdata

click node_webapp "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-frontend/src/main.tsx"
click node_tripwizard "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-frontend/src/pages/planificador-page.tsx"
click node_catalogui "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-frontend/src/pages/eventos-page.tsx"
click node_clientapi "https://github.com/gabriel6144/seminario-integrador-viajesazo/tree/main/turismo-frontend/src/api"
click node_api "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/TurismoBackendApplication.java"
click node_eventmanagement "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/PropuestaService.java"
click node_publishers "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/PublicadorService.java"
click node_catalogdata "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/model/PropuestaTuristica.java"
click node_agenda "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/PropuestaQueryService.java"
click node_geo "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/GeocodingService.java"
click node_tripapi "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/controller/ViajeController.java"
click node_tripservice "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/ViajeService.java"
click node_tripstore "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/repository/ViajeRepository.java"
click node_scheduler "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/ViajeEstadoScheduler.java"
click node_circuitapi "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/controller/CircuitoController.java"
click node_circuitservice "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/CircuitoService.java"
click node_generator "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/circuit/CircuitGenerator.java"
click node_distance "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/circuit/HaversineDistanceProvider.java"
click node_circuitstore "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/repository/CircuitoRepository.java"
click node_errors "https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/exception/GlobalExceptionHandler.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,node_tripwizard,node_catalogui,node_clientapi toneBlue
class node_api,node_eventmanagement,node_publishers,node_catalogdata,node_agenda,node_geo,node_errors toneAmber
class node_tripapi,node_tripservice,node_tripstore,node_scheduler toneMint
class node_circuitapi,node_circuitservice,node_generator,node_distance,node_circuitstore toneRose
class node_traveler toneIndigo
```

## Components

### Web client

- [Tourism web app](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-frontend/src/main.tsx): `turismo-frontend/src/main.tsx`
- [Trip planner](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-frontend/src/pages/planificador-page.tsx): `turismo-frontend/src/pages/planificador-page.tsx`
- [Events and agenda](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-frontend/src/pages/eventos-page.tsx): `turismo-frontend/src/pages/eventos-page.tsx`
- [API client modules](https://github.com/gabriel6144/seminario-integrador-viajesazo/tree/main/turismo-frontend/src/api): `turismo-frontend/src/api`

### Tourism catalog

- [REST API](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/TurismoBackendApplication.java): `turismo-backend/src/main/java/com/viajesazo/turismo_backend/TurismoBackendApplication.java`
- [Event management](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/PropuestaService.java): `turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/PropuestaService.java`
- [Publisher management](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/PublicadorService.java): `turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/PublicadorService.java`
- [Tourism proposals](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/model/PropuestaTuristica.java): `turismo-backend/src/main/java/com/viajesazo/turismo_backend/model/PropuestaTuristica.java`
- [Search and agenda](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/PropuestaQueryService.java): `turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/PropuestaQueryService.java`
- [Geocoding](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/GeocodingService.java): `turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/GeocodingService.java`
- [Error handling](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/exception/GlobalExceptionHandler.java): `turismo-backend/src/main/java/com/viajesazo/turismo_backend/exception/GlobalExceptionHandler.java`

### Trip planning

- [Trip endpoints](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/controller/ViajeController.java): `turismo-backend/src/main/java/com/viajesazo/turismo_backend/controller/ViajeController.java`
- [Trip lifecycle](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/ViajeService.java): `turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/ViajeService.java`
- [Trip records](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/repository/ViajeRepository.java): `turismo-backend/src/main/java/com/viajesazo/turismo_backend/repository/ViajeRepository.java`
- [Trip state scheduler](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/ViajeEstadoScheduler.java): `turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/ViajeEstadoScheduler.java`

### Circuit generation

- [Circuit endpoints](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/controller/CircuitoController.java): `turismo-backend/src/main/java/com/viajesazo/turismo_backend/controller/CircuitoController.java`
- [Circuit planning](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/CircuitoService.java): `turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/CircuitoService.java`
- [Itinerary generator](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/circuit/CircuitGenerator.java): `turismo-backend/src/main/java/com/viajesazo/turismo_backend/circuit/CircuitGenerator.java`
- [Distance estimates](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/circuit/HaversineDistanceProvider.java): `turismo-backend/src/main/java/com/viajesazo/turismo_backend/circuit/HaversineDistanceProvider.java`
- [Circuit snapshots](https://github.com/gabriel6144/seminario-integrador-viajesazo/blob/main/turismo-backend/src/main/java/com/viajesazo/turismo_backend/repository/CircuitoRepository.java): `turismo-backend/src/main/java/com/viajesazo/turismo_backend/repository/CircuitoRepository.java`

### Other components

- **Traveler**

## Connections

- Traveler → Tourism web app: uses (evidence: `README.md`)
- Tourism web app → API client modules: uses
- API client modules → REST API: calls (evidence: `README.md`)
- Events and agenda → API client modules: loads catalog
- Trip planner → API client modules: submits trip
- REST API → Event management: routes events
- Event management → Geocoding: geocodes location (evidence: `turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/PropuestaService.java`)
- Event management → Tourism proposals: persists events (evidence: `turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/PropuestaService.java`)
- REST API → Search and agenda: routes agenda
- Search and agenda → Tourism proposals: queries proposals (evidence: `turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/PropuestaQueryService.java`)
- REST API → Trip endpoints: routes trips (evidence: `turismo-backend/src/main/java/com/viajesazo/turismo_backend/controller/ViajeController.java`)
- Trip endpoints → Trip lifecycle: delegates (evidence: `turismo-backend/src/main/java/com/viajesazo/turismo_backend/controller/ViajeController.java`)
- Trip lifecycle → Trip records: reads and writes (evidence: `turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/ViajeService.java`)
- Trip lifecycle → Circuit planning: loads circuit (evidence: `turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/ViajeService.java`)
- Trip state scheduler → Trip records: finds transitions
- REST API → Circuit endpoints: routes circuits (evidence: `turismo-backend/src/main/java/com/viajesazo/turismo_backend/controller/CircuitoController.java`)
- Circuit endpoints → Circuit planning: delegates (evidence: `turismo-backend/src/main/java/com/viajesazo/turismo_backend/controller/CircuitoController.java`)
- Circuit planning → Itinerary generator: generates alternatives (evidence: `turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/CircuitoService.java`)
- Circuit planning → Distance estimates: estimates transfers (evidence: `turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/CircuitoService.java`)
- Circuit planning → Circuit snapshots: saves snapshots (evidence: `turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/CircuitoService.java`)
- Circuit planning → Tourism proposals: checks availability (evidence: `turismo-backend/src/main/java/com/viajesazo/turismo_backend/service/CircuitoService.java`)
