# devtiro/devtiro-event-ticket-app architecture

> Architecture diagram of the GitHub repository devtiro/devtiro-event-ticket-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/devtiro/devtiro-event-ticket-app
- Repository: https://github.com/devtiro/devtiro-event-ticket-app

## Overview

Devtiro Event Ticket App is a React and Spring Boot platform for organizer event management, attendee ticket purchasing, and staff ticket validation. Users enter through routed frontend pages; organizer event requests are mapped and handled by the backend service layer, while attendees browse published events and manage tickets. QR generation and validation are distinct ticket-lifecycle capabilities. The README documents Keycloak authentication and PostgreSQL persistence. Relationships for unsampled purchasing, validation, and storage implementations are not asserted beyond documented capabilities; the graph focuses on paths and calls supported by the supplied index, excerpts, and README.

Main entry points: [`frontend/src/main.tsx`](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/frontend/src/main.tsx) (React router), [`backend/src/main/java/com/devtiro/tickets/services/impl/EventServiceImpl.java`](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/services/impl/EventServiceImpl.java) (Event operations), [`backend/src/main/java/com/devtiro/tickets/controllers/TicketController.java`](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/controllers/TicketController.java) (Ticket API), [`backend/src/main/java/com/devtiro/tickets/controllers/EventController.java`](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/controllers/EventController.java) (Organizer event API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web experience"]
  node_webapp["React router<br/>[main.tsx]"]
  node_manageevent["Manage events"]
  node_eventlist["Organizer event list"]
  node_published["Published events"]
  node_purchase["Purchase ticket page"]
  node_ticketsui["Ticket dashboard"]
  node_scanui["QR validation page"]
end

subgraph group_event["Event management"]
  node_eventapi["Organizer event API"]
  node_publicapi["Published event API"]
  node_eventservice["Event operations"]
  node_eventmodel["Event and ticket types<br/>[Event.java]"]
end

subgraph group_ticket["Ticket lifecycle"]
  node_ticketapi["Ticket API"]
  node_ticketvalidation["Ticket validation API"]
  node_ticketmodel["Ticket model<br/>[Ticket.java]"]
  node_qrservice["QR code service"]
end

subgraph group_platform["Identity and persistence"]
  node_keycloak["Keycloak"]
  node_postgres[("PostgreSQL")]
end

node_organizer(("Organizer"))
node_attendee(("Attendee"))
node_staff(("Event staff"))

node_organizer -->|"uses"| node_webapp
node_attendee -->|"uses"| node_webapp
node_staff -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_manageevent
node_webapp -->|"routes to"| node_eventlist
node_webapp -->|"routes to"| node_published
node_webapp -->|"routes to"| node_purchase
node_webapp -->|"routes to"| node_ticketsui
node_webapp -->|"routes to"| node_scanui
node_organizer -->|"manages"| node_manageevent
node_attendee -->|"buys tickets"| node_purchase
node_staff -->|"scans tickets"| node_scanui
node_eventapi -->|"calls"| node_eventservice
node_publicapi -->|"calls"| node_eventservice
node_eventservice -->|"creates and updates"| node_eventmodel
node_ticketapi -->|"returns ticket data"| node_ticketmodel
node_ticketapi -->|"requests QR image"| node_qrservice
node_keycloak -->|"authenticates"| node_webapp
node_keycloak -->|"authenticates"| node_eventapi
node_postgres -.->|"stores data"| node_eventservice
node_postgres -.->|"stores data"| node_ticketmodel

click node_webapp "https://github.com/devtiro/devtiro-event-ticket-app/blob/main/frontend/src/main.tsx"
click node_manageevent "https://github.com/devtiro/devtiro-event-ticket-app/blob/main/frontend/src/pages/dashboard-manage-event-page.tsx"
click node_eventlist "https://github.com/devtiro/devtiro-event-ticket-app/blob/main/frontend/src/pages/dashboard-list-events-page.tsx"
click node_published "https://github.com/devtiro/devtiro-event-ticket-app/blob/main/frontend/src/pages/published-events-page.tsx"
click node_purchase "https://github.com/devtiro/devtiro-event-ticket-app/blob/main/frontend/src/pages/purchase-ticket-page.tsx"
click node_ticketsui "https://github.com/devtiro/devtiro-event-ticket-app/blob/main/frontend/src/pages/dashboard-list-tickets.tsx"
click node_scanui "https://github.com/devtiro/devtiro-event-ticket-app/blob/main/frontend/src/pages/dashboard-validate-qr-page.tsx"
click node_eventapi "https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/controllers/EventController.java"
click node_publicapi "https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/controllers/PublishedEventController.java"
click node_eventservice "https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/services/impl/EventServiceImpl.java"
click node_eventmodel "https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/domain/entities/Event.java"
click node_ticketapi "https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/controllers/TicketController.java"
click node_ticketvalidation "https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/controllers/TicketValidationController.java"
click node_ticketmodel "https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/domain/entities/Ticket.java"
click node_qrservice "https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/services/impl/QrCodeServiceImpl.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_manageevent,node_eventlist,node_published,node_purchase,node_ticketsui,node_scanui toneBlue
class node_eventapi,node_publicapi,node_eventservice,node_eventmodel toneAmber
class node_ticketapi,node_ticketvalidation,node_ticketmodel,node_qrservice toneMint
class node_keycloak,node_postgres toneRose
class node_organizer,node_attendee,node_staff toneIndigo
```

## Components

### Web experience

- [React router](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/frontend/src/main.tsx): `frontend/src/main.tsx`
- [Manage events](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/frontend/src/pages/dashboard-manage-event-page.tsx): `frontend/src/pages/dashboard-manage-event-page.tsx`
- [Organizer event list](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/frontend/src/pages/dashboard-list-events-page.tsx): `frontend/src/pages/dashboard-list-events-page.tsx`
- [Published events](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/frontend/src/pages/published-events-page.tsx): `frontend/src/pages/published-events-page.tsx`
- [Purchase ticket page](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/frontend/src/pages/purchase-ticket-page.tsx): `frontend/src/pages/purchase-ticket-page.tsx`
- [Ticket dashboard](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/frontend/src/pages/dashboard-list-tickets.tsx): `frontend/src/pages/dashboard-list-tickets.tsx`
- [QR validation page](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/frontend/src/pages/dashboard-validate-qr-page.tsx): `frontend/src/pages/dashboard-validate-qr-page.tsx`

### Event management

- [Organizer event API](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/controllers/EventController.java): `backend/src/main/java/com/devtiro/tickets/controllers/EventController.java`
- [Published event API](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/controllers/PublishedEventController.java): `backend/src/main/java/com/devtiro/tickets/controllers/PublishedEventController.java`
- [Event operations](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/services/impl/EventServiceImpl.java): `backend/src/main/java/com/devtiro/tickets/services/impl/EventServiceImpl.java`
- [Event and ticket types](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/domain/entities/Event.java): `backend/src/main/java/com/devtiro/tickets/domain/entities/Event.java`

### Ticket lifecycle

- [Ticket API](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/controllers/TicketController.java): `backend/src/main/java/com/devtiro/tickets/controllers/TicketController.java`
- [Ticket validation API](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/controllers/TicketValidationController.java): `backend/src/main/java/com/devtiro/tickets/controllers/TicketValidationController.java`
- [Ticket model](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/domain/entities/Ticket.java): `backend/src/main/java/com/devtiro/tickets/domain/entities/Ticket.java`
- [QR code service](https://github.com/devtiro/devtiro-event-ticket-app/blob/main/backend/src/main/java/com/devtiro/tickets/services/impl/QrCodeServiceImpl.java): `backend/src/main/java/com/devtiro/tickets/services/impl/QrCodeServiceImpl.java`

### Identity and persistence

- **Keycloak**
- **PostgreSQL**

### Other components

- **Organizer**
- **Attendee**
- **Event staff**

## Connections

- Organizer → React router: uses (evidence: `README.md`)
- Attendee → React router: uses (evidence: `README.md`)
- Event staff → React router: uses (evidence: `README.md`)
- React router → Manage events: routes to (evidence: `frontend/src/main.tsx`)
- React router → Organizer event list: routes to (evidence: `frontend/src/main.tsx`)
- React router → Published events: routes to (evidence: `frontend/src/main.tsx`)
- React router → Purchase ticket page: routes to (evidence: `frontend/src/main.tsx`)
- React router → Ticket dashboard: routes to (evidence: `frontend/src/main.tsx`)
- React router → QR validation page: routes to (evidence: `frontend/src/main.tsx`)
- Organizer → Manage events: manages (evidence: `README.md`)
- Attendee → Purchase ticket page: buys tickets (evidence: `README.md`)
- Event staff → QR validation page: scans tickets (evidence: `README.md`)
- Organizer event API → Event operations: calls (evidence: `backend/src/main/java/com/devtiro/tickets/controllers/EventController.java`)
- Published event API → Event operations: calls (evidence: `backend/src/main/java/com/devtiro/tickets/controllers/PublishedEventController.java`)
- Event operations → Event and ticket types: creates and updates (evidence: `backend/src/main/java/com/devtiro/tickets/services/impl/EventServiceImpl.java`)
- Ticket API → Ticket model: returns ticket data (evidence: `backend/src/main/java/com/devtiro/tickets/controllers/TicketController.java`)
- Ticket API → QR code service: requests QR image (evidence: `backend/src/main/java/com/devtiro/tickets/controllers/TicketController.java`)
- Keycloak → React router: authenticates (evidence: `README.md`)
- Keycloak → Organizer event API: authenticates (evidence: `README.md`)
- PostgreSQL → Event operations: stores data
- PostgreSQL → Ticket model: stores data
