# sokolovandr/tickets-module architecture

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

- Interactive diagram: https://gitdiagram.com/sokolovandr/tickets-module
- Repository: https://github.com/sokolovandr/tickets-module

## Overview

Tickets-module is a Spring Boot ticketing application for managing routes, carriers, and tickets, with both REST APIs and an HTML-form UI. Users authenticate and browse routes or manage tickets; the README documents the module boundaries but does not expose implementation excerpts, so detailed request-to-service calls are not verifiable. The graph preserves documented domain capabilities, persistence, caching, PDF tickets, and observability; dashed edges indicate relationships implied by the documented architecture or capabilities but not traced in source.

Main entry points: [`tickets-module-api/resources/api.yaml`](https://github.com/sokolovandr/tickets-module/blob/master/tickets-module-api/resources/api.yaml) (REST API), [`tickets-module-web/src/main/java/com/example/ticketsmodule/web`](https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-web/src/main/java/com/example/ticketsmodule/web) (HTML Web UI), [`tickets-module-domain/src/main/java/com/example/ticketsmodule/domain`](https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-domain/src/main/java/com/example/ticketsmodule/domain) (Domain Models), [`tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/tickets`](https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/tickets) (Tickets)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["User Access"]
  node_app["Application<br/>[Application.java]"]
  node_webui["HTML Web UI"]
  node_login["Login Forms"]
  node_rest["REST API<br/>[api.yaml]"]
  node_auth["Authentication"]
end

subgraph group_domain["Ticketing Domain"]
  node_routes["Routes"]
  node_carriers["Carriers"]
  node_tickets["Tickets"]
  node_users["User Profiles"]
  node_domainmodel["Domain Models"]
  node_pdf["Ticket PDF"]
end

subgraph group_platform["Persistence and Platform"]
  node_dbmigrations["DB Migrations"]
  node_postgres[("PostgreSQL")]
  node_cache["Ticket Cache"]
  node_redis[("Redis")]
end

subgraph group_ops["Operations"]
  node_metrics["Metrics<br/>[prometheus.yml]"]
  node_grafana["Grafana Dashboards"]
end

node_user(("User"))

node_user -.->|"uses forms"| node_webui
node_user -.->|"uses API"| node_rest
node_app -->|"depends on"| node_webui
node_webui -.->|"uses sessions"| node_auth
node_webui -->|"depends on"| node_rest
node_webui -->|"depends on"| node_domainmodel
node_rest -.->|"serves ticketing"| node_tickets
node_rest -.->|"serves routes"| node_routes
node_rest -.->|"serves carriers"| node_carriers
node_rest -.->|"serves profiles"| node_users
node_tickets -.->|"uses models"| node_domainmodel
node_routes -.->|"uses models"| node_domainmodel
node_carriers -.->|"uses models"| node_domainmodel
node_users -.->|"uses models"| node_domainmodel
node_tickets -.->|"generates PDF"| node_pdf
node_tickets -.->|"caches purchases"| node_cache
node_cache -.->|"stores cache"| node_redis
node_dbmigrations -.->|"defines schema"| node_postgres
node_app -.->|"includes migrations"| node_dbmigrations
node_app -.->|"exports metrics"| node_metrics
node_metrics -.->|"visualized by"| node_grafana

click node_app "https://github.com/sokolovandr/tickets-module/blob/master/tickets-module-app/src/main/java/com/example/ticketsmodule/Application.java"
click node_webui "https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-web/src/main/java/com/example/ticketsmodule/web"
click node_login "https://github.com/sokolovandr/tickets-module/blob/master/tickets-module-web/src/main/java/com/example/ticketsmodule/web/login/controller/LoginController.java"
click node_rest "https://github.com/sokolovandr/tickets-module/blob/master/tickets-module-api/resources/api.yaml"
click node_auth "https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/oauth"
click node_routes "https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/routes"
click node_carriers "https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/carriers"
click node_tickets "https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/tickets"
click node_users "https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/users"
click node_domainmodel "https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-domain/src/main/java/com/example/ticketsmodule/domain"
click node_pdf "https://github.com/sokolovandr/tickets-module/blob/master/tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/tickets/pdf/TicketPdfGenerator.java"
click node_dbmigrations "https://github.com/sokolovandr/tickets-module/blob/master/tickets-module-db/src/main/resources/db.changelog-master.xml"
click node_cache "https://github.com/sokolovandr/tickets-module/blob/master/tickets-module-app/src/main/java/com/example/ticketsmodule/config/CacheConfiguration.java"
click node_metrics "https://github.com/sokolovandr/tickets-module/blob/master/docker/prometheus/prometheus.yml"
click node_grafana "https://github.com/sokolovandr/tickets-module/blob/master/docker/grafana/dashboards/spring-boot-observability.json"

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_app,node_webui,node_login,node_rest,node_auth,node_user toneBlue
class node_routes,node_carriers,node_tickets,node_users,node_domainmodel,node_pdf toneAmber
class node_dbmigrations,node_postgres,node_cache,node_redis toneMint
class node_metrics,node_grafana toneRose
```

## Components

### User Access

- [Application](https://github.com/sokolovandr/tickets-module/blob/master/tickets-module-app/src/main/java/com/example/ticketsmodule/Application.java): `tickets-module-app/src/main/java/com/example/ticketsmodule/Application.java`
- [HTML Web UI](https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-web/src/main/java/com/example/ticketsmodule/web): `tickets-module-web/src/main/java/com/example/ticketsmodule/web`
- [Login Forms](https://github.com/sokolovandr/tickets-module/blob/master/tickets-module-web/src/main/java/com/example/ticketsmodule/web/login/controller/LoginController.java): `tickets-module-web/src/main/java/com/example/ticketsmodule/web/login/controller/LoginController.java`
- [REST API](https://github.com/sokolovandr/tickets-module/blob/master/tickets-module-api/resources/api.yaml): `tickets-module-api/resources/api.yaml`
- [Authentication](https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/oauth): `tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/oauth`

### Ticketing Domain

- [Routes](https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/routes): `tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/routes`
- [Carriers](https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/carriers): `tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/carriers`
- [Tickets](https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/tickets): `tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/tickets`
- [User Profiles](https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/users): `tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/users`
- [Domain Models](https://github.com/sokolovandr/tickets-module/tree/master/tickets-module-domain/src/main/java/com/example/ticketsmodule/domain): `tickets-module-domain/src/main/java/com/example/ticketsmodule/domain`
- [Ticket PDF](https://github.com/sokolovandr/tickets-module/blob/master/tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/tickets/pdf/TicketPdfGenerator.java): `tickets-module-impl/src/main/java/com/example/ticketsmodule/impl/tickets/pdf/TicketPdfGenerator.java`

### Persistence and Platform

- [DB Migrations](https://github.com/sokolovandr/tickets-module/blob/master/tickets-module-db/src/main/resources/db.changelog-master.xml): `tickets-module-db/src/main/resources/db.changelog-master.xml`
- **PostgreSQL**
- [Ticket Cache](https://github.com/sokolovandr/tickets-module/blob/master/tickets-module-app/src/main/java/com/example/ticketsmodule/config/CacheConfiguration.java): `tickets-module-app/src/main/java/com/example/ticketsmodule/config/CacheConfiguration.java`
- **Redis**

### Operations

- [Metrics](https://github.com/sokolovandr/tickets-module/blob/master/docker/prometheus/prometheus.yml): `docker/prometheus/prometheus.yml`
- [Grafana Dashboards](https://github.com/sokolovandr/tickets-module/blob/master/docker/grafana/dashboards/spring-boot-observability.json): `docker/grafana/dashboards/spring-boot-observability.json`

### Other components

- **User**

## Connections

- User → HTML Web UI: uses forms (evidence: `README.md`)
- User → REST API: uses API (evidence: `README.md`)
- Application → HTML Web UI: depends on (evidence: `README.md`)
- HTML Web UI → Authentication: uses sessions (evidence: `README.md`)
- HTML Web UI → REST API: depends on (evidence: `README.md`)
- HTML Web UI → Domain Models: depends on (evidence: `README.md`)
- REST API → Tickets: serves ticketing (evidence: `README.md`)
- REST API → Routes: serves routes (evidence: `README.md`)
- REST API → Carriers: serves carriers (evidence: `README.md`)
- REST API → User Profiles: serves profiles (evidence: `README.md`)
- Tickets → Domain Models: uses models (evidence: `README.md`)
- Routes → Domain Models: uses models (evidence: `README.md`)
- Carriers → Domain Models: uses models (evidence: `README.md`)
- User Profiles → Domain Models: uses models (evidence: `README.md`)
- Tickets → Ticket PDF: generates PDF (evidence: `README.md`)
- Tickets → Ticket Cache: caches purchases (evidence: `README.md`)
- Ticket Cache → Redis: stores cache (evidence: `README.md`)
- DB Migrations → PostgreSQL: defines schema (evidence: `README.md`)
- Application → DB Migrations: includes migrations (evidence: `README.md`)
- Application → Metrics: exports metrics (evidence: `README.md`)
- Metrics → Grafana Dashboards: visualized by (evidence: `README.md`)
