# shinjon101/ticketing-system architecture

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

- Interactive diagram: https://gitdiagram.com/shinjon101/ticketing-system
- Repository: https://github.com/shinjon101/ticketing-system

## Overview

The product is a five-service event-ticketing platform. A customer authenticates, discovers an event, submits an idempotent booking, and proceeds through payment; seat allocation and payment outcomes are coordinated asynchronously by Kafka rather than a central saga orchestrator. The graph preserves the documented outbox, concurrency-safety, and observability capabilities. Some cross-service event links are documented only at the architecture level, so those links are dashed; unsampled internals are not inferred.

Main entry points: [`services/booking-service/src/booking/booking.service.ts`](https://github.com/shinjon101/ticketing-system/blob/main/services/booking-service/src/booking/booking.service.ts) (Booking workflow), [`packages/kafka-client/src/consumer.ts`](https://github.com/shinjon101/ticketing-system/blob/main/packages/kafka-client/src/consumer.ts) (Kafka event bus), [`services/payment-service/src/payment/payment.service.ts`](https://github.com/shinjon101/ticketing-system/blob/main/services/payment-service/src/payment/payment.service.ts) (Payment workflow), [`services/auth-service/src/auth/auth.routes.ts`](https://github.com/shinjon101/ticketing-system/blob/main/services/auth-service/src/auth/auth.routes.ts) (Auth API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Identity"]
  node_auth_http["Auth API<br/>[auth.routes.ts]"]
  node_auth_logic["Identity logic<br/>[auth.service.ts]"]
  node_auth_store[("Auth data<br/>[auth.repository.ts]")]
end

subgraph group_catalog["Events"]
  node_event_http["Event API<br/>[events.routes.ts]"]
  node_event_logic["Event management<br/>[event.service.ts]"]
  node_event_store[("Event data")]
end

subgraph group_booking["Booking"]
  node_booking_http["Booking API<br/>[booking.routes.ts]"]
  node_booking_logic["Booking workflow<br/>[booking.service.ts]"]
  node_booking_store[("Booking data")]
  node_booking_outbox[("Booking outbox<br/>[outbox.poller.ts]")]
end

subgraph group_inventory["Inventory"]
  node_inventory_logic["Seat allocation<br/>[seat.service.ts]"]
  node_seat_store[("Seat data<br/>[seat.repository.ts]")]
  node_seat_cache[("Availability cache<br/>[seat-counter.ts]")]
end

subgraph group_shared["Payments and infrastructure"]
  node_payment_http["Payment API<br/>[payment.routes.ts]"]
  node_payment_logic["Payment workflow<br/>[payment.service.ts]"]
  node_payment_store[("Payment data")]
  node_kafka["Kafka event bus<br/>[consumer.ts]"]
  node_metrics["Metrics and telemetry<br/>[registry.ts]"]
end

node_customer(("Customer"))
node_payment_gateway["Razorpay"]
node_prometheus["Prometheus and dashboards"]

node_customer -->|"authenticates"| node_auth_http
node_auth_http -->|"routes to"| node_auth_logic
node_auth_logic -->|"reads and writes"| node_auth_store
node_customer -.->|"browses events"| node_event_http
node_event_http -->|"routes to"| node_event_logic
node_event_logic -->|"uses repository"| node_event_store
node_customer -.->|"requests booking"| node_booking_http
node_booking_http -->|"routes to"| node_booking_logic
node_booking_logic -->|"uses repository"| node_booking_store
node_booking_logic -.->|"publishes events"| node_booking_outbox
node_booking_logic -.->|"dispatches events"| node_kafka
node_kafka -.->|"delivers events"| node_inventory_logic
node_inventory_logic -->|"locks and updates"| node_seat_store
node_seat_store -->|"seeds availability"| node_seat_cache
node_customer -.->|"submits payment"| node_payment_http
node_payment_http -->|"routes to"| node_payment_logic
node_payment_logic -->|"uses repository"| node_payment_store
node_payment_logic -.->|"handles gateway payment"| node_payment_gateway
node_payment_logic -.->|"dispatches outcomes"| node_kafka
node_kafka -.->|"delivers outcomes"| node_booking_logic
node_kafka -.->|"exports telemetry"| node_metrics
node_metrics -.->|"scrapes metrics"| node_prometheus

click node_auth_http "https://github.com/shinjon101/ticketing-system/blob/main/services/auth-service/src/auth/auth.routes.ts"
click node_auth_logic "https://github.com/shinjon101/ticketing-system/blob/main/services/auth-service/src/auth/auth.service.ts"
click node_auth_store "https://github.com/shinjon101/ticketing-system/blob/main/services/auth-service/src/auth/auth.repository.ts"
click node_event_http "https://github.com/shinjon101/ticketing-system/blob/main/services/event-service/src/events/events.routes.ts"
click node_event_logic "https://github.com/shinjon101/ticketing-system/blob/main/services/event-service/src/events/event.service.ts"
click node_event_store "https://github.com/shinjon101/ticketing-system/blob/main/services/event-service/src/events/events.repository.ts"
click node_booking_http "https://github.com/shinjon101/ticketing-system/blob/main/services/booking-service/src/booking/booking.routes.ts"
click node_booking_logic "https://github.com/shinjon101/ticketing-system/blob/main/services/booking-service/src/booking/booking.service.ts"
click node_booking_store "https://github.com/shinjon101/ticketing-system/blob/main/services/booking-service/src/booking/booking.repsoitory.ts"
click node_booking_outbox "https://github.com/shinjon101/ticketing-system/blob/main/services/booking-service/src/outbox/outbox.poller.ts"
click node_inventory_logic "https://github.com/shinjon101/ticketing-system/blob/main/services/inventory-service/src/seats/seat.service.ts"
click node_seat_store "https://github.com/shinjon101/ticketing-system/blob/main/services/inventory-service/src/seats/seat.repository.ts"
click node_seat_cache "https://github.com/shinjon101/ticketing-system/blob/main/services/inventory-service/src/redis/seat-counter.ts"
click node_payment_http "https://github.com/shinjon101/ticketing-system/blob/main/services/payment-service/src/payment/payment.routes.ts"
click node_payment_logic "https://github.com/shinjon101/ticketing-system/blob/main/services/payment-service/src/payment/payment.service.ts"
click node_payment_store "https://github.com/shinjon101/ticketing-system/blob/main/services/payment-service/src/payment/payment.repository.ts"
click node_kafka "https://github.com/shinjon101/ticketing-system/blob/main/packages/kafka-client/src/consumer.ts"
click node_metrics "https://github.com/shinjon101/ticketing-system/blob/main/packages/common/src/metrics/registry.ts"

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_auth_http,node_auth_logic,node_auth_store toneBlue
class node_event_http,node_event_logic,node_event_store toneAmber
class node_booking_http,node_booking_logic,node_booking_store,node_booking_outbox toneMint
class node_inventory_logic,node_seat_store,node_seat_cache toneRose
class node_payment_http,node_payment_logic,node_payment_store,node_kafka,node_metrics,node_customer,node_payment_gateway,node_prometheus toneIndigo
```

## Components

### Identity

- [Auth API](https://github.com/shinjon101/ticketing-system/blob/main/services/auth-service/src/auth/auth.routes.ts): `services/auth-service/src/auth/auth.routes.ts`
- [Identity logic](https://github.com/shinjon101/ticketing-system/blob/main/services/auth-service/src/auth/auth.service.ts): `services/auth-service/src/auth/auth.service.ts`
- [Auth data](https://github.com/shinjon101/ticketing-system/blob/main/services/auth-service/src/auth/auth.repository.ts): `services/auth-service/src/auth/auth.repository.ts`

### Events

- [Event API](https://github.com/shinjon101/ticketing-system/blob/main/services/event-service/src/events/events.routes.ts): `services/event-service/src/events/events.routes.ts`
- [Event management](https://github.com/shinjon101/ticketing-system/blob/main/services/event-service/src/events/event.service.ts): `services/event-service/src/events/event.service.ts`
- [Event data](https://github.com/shinjon101/ticketing-system/blob/main/services/event-service/src/events/events.repository.ts): `services/event-service/src/events/events.repository.ts`

### Booking

- [Booking API](https://github.com/shinjon101/ticketing-system/blob/main/services/booking-service/src/booking/booking.routes.ts): `services/booking-service/src/booking/booking.routes.ts`
- [Booking workflow](https://github.com/shinjon101/ticketing-system/blob/main/services/booking-service/src/booking/booking.service.ts): `services/booking-service/src/booking/booking.service.ts`
- [Booking data](https://github.com/shinjon101/ticketing-system/blob/main/services/booking-service/src/booking/booking.repsoitory.ts): `services/booking-service/src/booking/booking.repsoitory.ts`
- [Booking outbox](https://github.com/shinjon101/ticketing-system/blob/main/services/booking-service/src/outbox/outbox.poller.ts): `services/booking-service/src/outbox/outbox.poller.ts`

### Inventory

- [Seat allocation](https://github.com/shinjon101/ticketing-system/blob/main/services/inventory-service/src/seats/seat.service.ts): `services/inventory-service/src/seats/seat.service.ts`
- [Seat data](https://github.com/shinjon101/ticketing-system/blob/main/services/inventory-service/src/seats/seat.repository.ts): `services/inventory-service/src/seats/seat.repository.ts`
- [Availability cache](https://github.com/shinjon101/ticketing-system/blob/main/services/inventory-service/src/redis/seat-counter.ts): `services/inventory-service/src/redis/seat-counter.ts`

### Payments and infrastructure

- [Payment API](https://github.com/shinjon101/ticketing-system/blob/main/services/payment-service/src/payment/payment.routes.ts): `services/payment-service/src/payment/payment.routes.ts`
- [Payment workflow](https://github.com/shinjon101/ticketing-system/blob/main/services/payment-service/src/payment/payment.service.ts): `services/payment-service/src/payment/payment.service.ts`
- [Payment data](https://github.com/shinjon101/ticketing-system/blob/main/services/payment-service/src/payment/payment.repository.ts): `services/payment-service/src/payment/payment.repository.ts`
- [Kafka event bus](https://github.com/shinjon101/ticketing-system/blob/main/packages/kafka-client/src/consumer.ts): `packages/kafka-client/src/consumer.ts`
- [Metrics and telemetry](https://github.com/shinjon101/ticketing-system/blob/main/packages/common/src/metrics/registry.ts): `packages/common/src/metrics/registry.ts`

### Other components

- **Customer**
- **Razorpay**
- **Prometheus and dashboards**

## Connections

- Customer → Auth API: authenticates
- Auth API → Identity logic: routes to
- Identity logic → Auth data: reads and writes (evidence: `services/auth-service/src/auth/auth.service.ts`)
- Customer → Event API: browses events (evidence: `README.md`)
- Event API → Event management: routes to
- Event management → Event data: uses repository (evidence: `services/event-service/src/events/event.service.ts`)
- Customer → Booking API: requests booking (evidence: `README.md`)
- Booking API → Booking workflow: routes to
- Booking workflow → Booking data: uses repository (evidence: `services/booking-service/src/booking/booking.service.ts`)
- Booking workflow → Booking outbox: publishes events (evidence: `README.md`)
- Booking workflow → Kafka event bus: dispatches events (evidence: `README.md`)
- Kafka event bus → Seat allocation: delivers events (evidence: `README.md`)
- Seat allocation → Seat data: locks and updates (evidence: `services/inventory-service/src/seats/seat.service.ts`)
- Seat data → Availability cache: seeds availability (evidence: `services/inventory-service/src/app.ts`)
- Customer → Payment API: submits payment (evidence: `README.md`)
- Payment API → Payment workflow: routes to
- Payment workflow → Payment data: uses repository (evidence: `services/payment-service/src/payment/payment.service.ts`)
- Payment workflow → Razorpay: handles gateway payment
- Payment workflow → Kafka event bus: dispatches outcomes (evidence: `README.md`)
- Kafka event bus → Booking workflow: delivers outcomes (evidence: `README.md`)
- Kafka event bus → Metrics and telemetry: exports telemetry (evidence: `README.md`)
- Metrics and telemetry → Prometheus and dashboards: scrapes metrics (evidence: `README.md`)
