# shvetgharework/ticketizer architecture

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

- Interactive diagram: https://gitdiagram.com/shvetgharework/ticketizer
- Repository: https://github.com/shvetgharework/ticketizer

## Overview

Ticketizer is a ticket discovery and booking product backed by Spring Cloud services. A user browses events, selects a show and seats, holds them, pays, then views bookings and ticket notifications. The README documents atomic Redis holds and Kafka-backed persistence plus authentication, inventory, payment, and email capabilities. Edges below are limited to relationships shown in the README or excerpts; several service internals and integrations are represented at their documented directory level.

Main entry points: [`src/api-gateway/src/main/java/com/example/Ticketizer/gateway/ApiGatewayApplication.java`](https://github.com/shvetgharework/ticketizer/blob/master/src/api-gateway/src/main/java/com/example/Ticketizer/gateway/ApiGatewayApplication.java) (API gateway), [`src/booking-service/src/main/java/com/example/Ticketizer/features/booking`](https://github.com/shvetgharework/ticketizer/tree/master/src/booking-service/src/main/java/com/example/Ticketizer/features/booking) (Booking service), [`src/auth-service/src/main/java/com/example/Ticketizer/features/auth`](https://github.com/shvetgharework/ticketizer/tree/master/src/auth-service/src/main/java/com/example/Ticketizer/features/auth) (Authentication), [`src/inventory-service/src/main/java/com/example/Ticketizer/features/inventory`](https://github.com/shvetgharework/ticketizer/tree/master/src/inventory-service/src/main/java/com/example/Ticketizer/features/inventory) (Event inventory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_webapp["Ticketizer web app<br/>[layout.tsx]"]
  node_discover["Event discovery<br/>[page.tsx]"]
  node_eventdetail["Event details<br/>[page.tsx]"]
  node_seatui["Seat selection<br/>[page.tsx]"]
  node_checkout["Checkout<br/>[page.tsx]"]
  node_bookingui["My bookings<br/>[page.tsx]"]
end

subgraph group_edge["Ingress and identity"]
  node_gateway["API gateway"]
  node_auth["Authentication"]
end

subgraph group_booking["Booking lifecycle"]
  node_booking["Booking service"]
  node_redis[("Redis seat holds")]
  node_kafka["Kafka events"]
end

subgraph group_platform["Discovery and shared core"]
  node_eureka["Eureka registry"]
  node_common["Shared security and DTOs"]
end

subgraph group_services["Domain services"]
  node_inventory["Event inventory"]
  node_postgres[("PostgreSQL")]
  node_payment["Payment service"]
  node_notifications["Notification service"]
end

node_visitor(("Ticket buyer"))
node_provider["Razorpay"]
node_email["Mail service"]

node_visitor -->|"uses"| node_webapp
node_webapp -->|"renders"| node_discover
node_visitor -->|"browses"| node_discover
node_discover -.->|"fetches events"| node_gateway
node_discover -->|"opens event"| node_eventdetail
node_eventdetail -->|"selects seats"| node_seatui
node_visitor -->|"chooses seats"| node_seatui
node_seatui -.->|"requests reservation"| node_gateway
node_gateway -->|"routes events"| node_inventory
node_gateway -->|"routes bookings"| node_booking
node_gateway -->|"routes auth"| node_auth
node_booking -->|"locks seats"| node_redis
node_booking -->|"publishes booking"| node_kafka
node_kafka -->|"delivers events"| node_booking
node_booking -->|"persists bookings"| node_postgres
node_checkout -->|"creates payment order"| node_gateway
node_gateway -->|"routes payments"| node_payment
node_payment -->|"integrates payment"| node_provider
node_payment -->|"settles booking"| node_booking
node_bookingui -->|"cancels bookings"| node_gateway
node_gateway -->|"routes notifications"| node_notifications
node_kafka -->|"streams events"| node_notifications
node_notifications -->|"sends email"| node_email
node_auth -->|"stores users"| node_postgres
node_inventory -->|"stores inventory"| node_postgres
node_inventory -->|"warms seat cache"| node_redis
node_auth -.->|"registers"| node_eureka
node_booking -.->|"registers"| node_eureka
node_inventory -.->|"registers"| node_eureka
node_auth -.->|"uses shared core"| node_common
node_booking -.->|"uses shared core"| node_common

click node_webapp "https://github.com/shvetgharework/ticketizer/blob/master/frontend/src/app/layout.tsx"
click node_discover "https://github.com/shvetgharework/ticketizer/blob/master/frontend/src/app/events/page.tsx"
click node_eventdetail "https://github.com/shvetgharework/ticketizer/blob/master/frontend/src/app/events/%5Bid%5D/page.tsx"
click node_seatui "https://github.com/shvetgharework/ticketizer/blob/master/frontend/src/app/events/%5Bid%5D/shows/%5BshowId%5D/seats/page.tsx"
click node_checkout "https://github.com/shvetgharework/ticketizer/blob/master/frontend/src/app/checkout/%5BbookingId%5D/page.tsx"
click node_bookingui "https://github.com/shvetgharework/ticketizer/blob/master/frontend/src/app/my-bookings/page.tsx"
click node_gateway "https://github.com/shvetgharework/ticketizer/blob/master/src/api-gateway/src/main/java/com/example/Ticketizer/gateway/ApiGatewayApplication.java"
click node_auth "https://github.com/shvetgharework/ticketizer/tree/master/src/auth-service/src/main/java/com/example/Ticketizer/features/auth"
click node_inventory "https://github.com/shvetgharework/ticketizer/tree/master/src/inventory-service/src/main/java/com/example/Ticketizer/features/inventory"
click node_booking "https://github.com/shvetgharework/ticketizer/tree/master/src/booking-service/src/main/java/com/example/Ticketizer/features/booking"
click node_payment "https://github.com/shvetgharework/ticketizer/tree/master/src/payment-service/src/main/java/com/example/Ticketizer/features/payment"
click node_notifications "https://github.com/shvetgharework/ticketizer/tree/master/src/notification-service/src/main/java/com/example/Ticketizer/features/notification"
click node_eureka "https://github.com/shvetgharework/ticketizer/blob/master/src/eureka-server/src/main/java/com/example/Ticketizer/EurekaServerApplication.java"
click node_common "https://github.com/shvetgharework/ticketizer/tree/master/src/ticketflow-common/src/main/java/com/example/Ticketizer"

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_discover,node_eventdetail,node_seatui,node_checkout,node_bookingui toneBlue
class node_gateway,node_auth toneAmber
class node_booking,node_redis,node_kafka toneMint
class node_eureka,node_common toneRose
class node_inventory,node_postgres,node_payment,node_notifications,node_visitor,node_provider,node_email toneIndigo
```

## Components

### Web experience

- [Ticketizer web app](https://github.com/shvetgharework/ticketizer/blob/master/frontend/src/app/layout.tsx): `frontend/src/app/layout.tsx`
- [Event discovery](https://github.com/shvetgharework/ticketizer/blob/master/frontend/src/app/events/page.tsx): `frontend/src/app/events/page.tsx`
- [Event details](https://github.com/shvetgharework/ticketizer/blob/master/frontend/src/app/events/%5Bid%5D/page.tsx): `frontend/src/app/events/[id]/page.tsx`
- [Seat selection](https://github.com/shvetgharework/ticketizer/blob/master/frontend/src/app/events/%5Bid%5D/shows/%5BshowId%5D/seats/page.tsx): `frontend/src/app/events/[id]/shows/[showId]/seats/page.tsx`
- [Checkout](https://github.com/shvetgharework/ticketizer/blob/master/frontend/src/app/checkout/%5BbookingId%5D/page.tsx): `frontend/src/app/checkout/[bookingId]/page.tsx`
- [My bookings](https://github.com/shvetgharework/ticketizer/blob/master/frontend/src/app/my-bookings/page.tsx): `frontend/src/app/my-bookings/page.tsx`

### Ingress and identity

- [API gateway](https://github.com/shvetgharework/ticketizer/blob/master/src/api-gateway/src/main/java/com/example/Ticketizer/gateway/ApiGatewayApplication.java): `src/api-gateway/src/main/java/com/example/Ticketizer/gateway/ApiGatewayApplication.java`
- [Authentication](https://github.com/shvetgharework/ticketizer/tree/master/src/auth-service/src/main/java/com/example/Ticketizer/features/auth): `src/auth-service/src/main/java/com/example/Ticketizer/features/auth`

### Booking lifecycle

- [Booking service](https://github.com/shvetgharework/ticketizer/tree/master/src/booking-service/src/main/java/com/example/Ticketizer/features/booking): `src/booking-service/src/main/java/com/example/Ticketizer/features/booking`
- **Redis seat holds**
- **Kafka events**

### Discovery and shared core

- [Eureka registry](https://github.com/shvetgharework/ticketizer/blob/master/src/eureka-server/src/main/java/com/example/Ticketizer/EurekaServerApplication.java): `src/eureka-server/src/main/java/com/example/Ticketizer/EurekaServerApplication.java`
- [Shared security and DTOs](https://github.com/shvetgharework/ticketizer/tree/master/src/ticketflow-common/src/main/java/com/example/Ticketizer): `src/ticketflow-common/src/main/java/com/example/Ticketizer`

### Domain services

- [Event inventory](https://github.com/shvetgharework/ticketizer/tree/master/src/inventory-service/src/main/java/com/example/Ticketizer/features/inventory): `src/inventory-service/src/main/java/com/example/Ticketizer/features/inventory`
- **PostgreSQL**
- [Payment service](https://github.com/shvetgharework/ticketizer/tree/master/src/payment-service/src/main/java/com/example/Ticketizer/features/payment): `src/payment-service/src/main/java/com/example/Ticketizer/features/payment`
- [Notification service](https://github.com/shvetgharework/ticketizer/tree/master/src/notification-service/src/main/java/com/example/Ticketizer/features/notification): `src/notification-service/src/main/java/com/example/Ticketizer/features/notification`

### Other components

- **Ticket buyer**
- **Razorpay**
- **Mail service**

## Connections

- Ticket buyer → Ticketizer web app: uses (evidence: `README.md`)
- Ticketizer web app → Event discovery: renders (evidence: `frontend/src/app/layout.tsx`)
- Ticket buyer → Event discovery: browses (evidence: `README.md`)
- Event discovery → API gateway: fetches events
- Event discovery → Event details: opens event (evidence: `frontend/src/app/events/page.tsx`)
- Event details → Seat selection: selects seats (evidence: `frontend/src/app/events/[id]/page.tsx`)
- Ticket buyer → Seat selection: chooses seats (evidence: `README.md`)
- Seat selection → API gateway: requests reservation
- API gateway → Event inventory: routes events (evidence: `README.md`)
- API gateway → Booking service: routes bookings (evidence: `README.md`)
- API gateway → Authentication: routes auth (evidence: `README.md`)
- Booking service → Redis seat holds: locks seats (evidence: `README.md`)
- Booking service → Kafka events: publishes booking (evidence: `README.md`)
- Kafka events → Booking service: delivers events (evidence: `README.md`)
- Booking service → PostgreSQL: persists bookings (evidence: `README.md`)
- Checkout → API gateway: creates payment order (evidence: `frontend/src/app/checkout/[bookingId]/page.tsx`)
- API gateway → Payment service: routes payments (evidence: `README.md`)
- Payment service → Razorpay: integrates payment (evidence: `README.md`)
- Payment service → Booking service: settles booking (evidence: `README.md`)
- My bookings → API gateway: cancels bookings (evidence: `frontend/src/app/my-bookings/page.tsx`)
- API gateway → Notification service: routes notifications (evidence: `README.md`)
- Kafka events → Notification service: streams events (evidence: `README.md`)
- Notification service → Mail service: sends email (evidence: `README.md`)
- Authentication → PostgreSQL: stores users (evidence: `README.md`)
- Event inventory → PostgreSQL: stores inventory (evidence: `README.md`)
- Event inventory → Redis seat holds: warms seat cache (evidence: `README.md`)
- Authentication → Eureka registry: registers (evidence: `README.md`)
- Booking service → Eureka registry: registers (evidence: `README.md`)
- Event inventory → Eureka registry: registers (evidence: `README.md`)
- Authentication → Shared security and DTOs: uses shared core
- Booking service → Shared security and DTOs: uses shared core
