# arunkumar235/stagepass architecture

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

- Interactive diagram: https://gitdiagram.com/arunkumar235/stagepass
- Repository: https://github.com/arunkumar235/stagepass

## Overview

StagePass is a distributed event-ticketing platform. Users authenticate or register, browse events and seat maps, then book seats through a Saga that locks seats, validates availability, and charges through the payment service; asynchronous events drive confirmations, cancellation notices, and PDF tickets. Event and venue management, payment webhooks/refunds, and gateway security are distinct capabilities. The README documents the broad service interactions; source excerpts substantiate selected booking, seat, payment, and user paths. Other service internals are represented at their exact tree paths, with unsampled links omitted where wiring is not shown.

Main entry points: [`booking-service/src/main/java/org/stagepass/bookingservice/service/BookingService.java`](https://github.com/arunkumar235/stagepass/blob/main/booking-service/src/main/java/org/stagepass/bookingservice/service/BookingService.java) (Booking Saga), [`api-gateway/src/main/java/org/stagepass/apigateway`](https://github.com/arunkumar235/stagepass/tree/main/api-gateway/src/main/java/org/stagepass/apigateway) (API gateway), [`payment-service/src/main/java/org/stagepass/paymentservice/service/PaymentService.java`](https://github.com/arunkumar235/stagepass/blob/main/payment-service/src/main/java/org/stagepass/paymentservice/service/PaymentService.java) (Payment processing), [`user-service/src/main/java/org/stagepass/userservice/service`](https://github.com/arunkumar235/stagepass/tree/main/user-service/src/main/java/org/stagepass/userservice/service) (Identity and profiles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["Edge and identity"]
  node_gateway["API gateway"]
  node_identity["Identity and profiles"]
  node_userdb[("User database<br/>[User.java]")]
  node_registry["Service registry"]
end

subgraph group_catalog["Event catalog"]
  node_events["Event management<br/>[EventService.java]"]
  node_seats["Seat maps and validation<br/>[SeatService.java]"]
  node_eventdb[("Event and venue data<br/>[Event.java]")]
end

subgraph group_booking["Booking and payment"]
  node_booking["Booking Saga"]
  node_seatlock["Seat locks"]
  node_bookingdb[("Booking records<br/>[Booking.java]")]
  node_payment["Payment processing"]
  node_webhook["Payment webhooks"]
  node_paymentdb[("Payment records<br/>[PaymentRecord.java]")]
end

subgraph group_messaging["Messaging and operations"]
  node_kafka["Kafka"]
  node_bookingevents["Booking event publisher"]
  node_notifications["Notification consumers"]
  node_email["Email delivery<br/>[EmailService.java]"]
  node_tickets["PDF tickets"]
end

node_attendee(("Attendee"))
node_razorpay["Razorpay"]
node_redis[("Redis")]

node_attendee -->|"sends requests"| node_gateway
node_gateway -->|"routes requests"| node_identity
node_gateway -->|"routes requests"| node_events
node_gateway -->|"routes requests"| node_booking
node_gateway -->|"routes requests"| node_payment
node_identity -->|"reads and writes"| node_userdb
node_identity -->|"publishes registration"| node_bookingevents
node_events -->|"persists events"| node_eventdb
node_events -->|"generates seats"| node_seats
node_seats -->|"reads seat data"| node_eventdb
node_booking -->|"validates seats"| node_seats
node_booking -->|"locks seats"| node_seatlock
node_seatlock -->|"stores locks"| node_redis
node_booking -->|"persists bookings"| node_bookingdb
node_booking -->|"requests charge"| node_payment
node_payment -->|"records payments"| node_paymentdb
node_payment -->|"charges and refunds"| node_razorpay
node_razorpay -->|"sends outcomes"| node_webhook
node_webhook -->|"updates statuses"| node_paymentdb
node_webhook -->|"publishes outcomes"| node_kafka
node_booking -->|"publishes booking events"| node_bookingevents
node_bookingevents -.->|"publishes events"| node_kafka
node_kafka -->|"delivers events"| node_notifications
node_notifications -->|"dispatches mail"| node_email
node_notifications -->|"creates attachments"| node_tickets

click node_gateway "https://github.com/arunkumar235/stagepass/tree/main/api-gateway/src/main/java/org/stagepass/apigateway"
click node_identity "https://github.com/arunkumar235/stagepass/tree/main/user-service/src/main/java/org/stagepass/userservice/service"
click node_userdb "https://github.com/arunkumar235/stagepass/blob/main/user-service/src/main/java/org/stagepass/userservice/entity/User.java"
click node_registry "https://github.com/arunkumar235/stagepass/blob/main/eureka-server/src/main/java/org/stagepass/eurekaserver/EurekaServerApplication.java"
click node_events "https://github.com/arunkumar235/stagepass/blob/main/event-service/src/main/java/org/stagepass/eventservice/service/EventService.java"
click node_seats "https://github.com/arunkumar235/stagepass/blob/main/event-service/src/main/java/org/stagepass/eventservice/service/SeatService.java"
click node_eventdb "https://github.com/arunkumar235/stagepass/blob/main/event-service/src/main/java/org/stagepass/eventservice/entity/Event.java"
click node_booking "https://github.com/arunkumar235/stagepass/blob/main/booking-service/src/main/java/org/stagepass/bookingservice/service/BookingService.java"
click node_seatlock "https://github.com/arunkumar235/stagepass/blob/main/booking-service/src/main/java/org/stagepass/bookingservice/service/SeatLockService.java"
click node_bookingdb "https://github.com/arunkumar235/stagepass/blob/main/booking-service/src/main/java/org/stagepass/bookingservice/entity/Booking.java"
click node_payment "https://github.com/arunkumar235/stagepass/blob/main/payment-service/src/main/java/org/stagepass/paymentservice/service/PaymentService.java"
click node_webhook "https://github.com/arunkumar235/stagepass/blob/main/payment-service/src/main/java/org/stagepass/paymentservice/service/WebhookService.java"
click node_paymentdb "https://github.com/arunkumar235/stagepass/blob/main/payment-service/src/main/java/org/stagepass/paymentservice/entity/PaymentRecord.java"
click node_bookingevents "https://github.com/arunkumar235/stagepass/blob/main/booking-service/src/main/java/org/stagepass/bookingservice/kafka/BookingEventPublisher.java"
click node_notifications "https://github.com/arunkumar235/stagepass/tree/main/notification-service/src/main/java/org/stagepass/notificationservice/kafka"
click node_email "https://github.com/arunkumar235/stagepass/blob/main/notification-service/src/main/java/org/stagepass/notificationservice/service/EmailService.java"
click node_tickets "https://github.com/arunkumar235/stagepass/blob/main/notification-service/src/main/java/org/stagepass/notificationservice/service/TicketPdfService.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_gateway,node_identity,node_userdb,node_registry toneBlue
class node_events,node_seats,node_eventdb,node_redis toneAmber
class node_booking,node_seatlock,node_bookingdb,node_payment,node_webhook,node_paymentdb toneMint
class node_kafka,node_bookingevents,node_notifications,node_email,node_tickets toneRose
class node_attendee,node_razorpay toneIndigo
```

## Components

### Edge and identity

- [API gateway](https://github.com/arunkumar235/stagepass/tree/main/api-gateway/src/main/java/org/stagepass/apigateway): `api-gateway/src/main/java/org/stagepass/apigateway`
- [Identity and profiles](https://github.com/arunkumar235/stagepass/tree/main/user-service/src/main/java/org/stagepass/userservice/service): `user-service/src/main/java/org/stagepass/userservice/service`
- [User database](https://github.com/arunkumar235/stagepass/blob/main/user-service/src/main/java/org/stagepass/userservice/entity/User.java): `user-service/src/main/java/org/stagepass/userservice/entity/User.java`
- [Service registry](https://github.com/arunkumar235/stagepass/blob/main/eureka-server/src/main/java/org/stagepass/eurekaserver/EurekaServerApplication.java): `eureka-server/src/main/java/org/stagepass/eurekaserver/EurekaServerApplication.java`

### Event catalog

- [Event management](https://github.com/arunkumar235/stagepass/blob/main/event-service/src/main/java/org/stagepass/eventservice/service/EventService.java): `event-service/src/main/java/org/stagepass/eventservice/service/EventService.java`
- [Seat maps and validation](https://github.com/arunkumar235/stagepass/blob/main/event-service/src/main/java/org/stagepass/eventservice/service/SeatService.java): `event-service/src/main/java/org/stagepass/eventservice/service/SeatService.java`
- [Event and venue data](https://github.com/arunkumar235/stagepass/blob/main/event-service/src/main/java/org/stagepass/eventservice/entity/Event.java): `event-service/src/main/java/org/stagepass/eventservice/entity/Event.java`

### Booking and payment

- [Booking Saga](https://github.com/arunkumar235/stagepass/blob/main/booking-service/src/main/java/org/stagepass/bookingservice/service/BookingService.java): `booking-service/src/main/java/org/stagepass/bookingservice/service/BookingService.java`
- [Seat locks](https://github.com/arunkumar235/stagepass/blob/main/booking-service/src/main/java/org/stagepass/bookingservice/service/SeatLockService.java): `booking-service/src/main/java/org/stagepass/bookingservice/service/SeatLockService.java`
- [Booking records](https://github.com/arunkumar235/stagepass/blob/main/booking-service/src/main/java/org/stagepass/bookingservice/entity/Booking.java): `booking-service/src/main/java/org/stagepass/bookingservice/entity/Booking.java`
- [Payment processing](https://github.com/arunkumar235/stagepass/blob/main/payment-service/src/main/java/org/stagepass/paymentservice/service/PaymentService.java): `payment-service/src/main/java/org/stagepass/paymentservice/service/PaymentService.java`
- [Payment webhooks](https://github.com/arunkumar235/stagepass/blob/main/payment-service/src/main/java/org/stagepass/paymentservice/service/WebhookService.java): `payment-service/src/main/java/org/stagepass/paymentservice/service/WebhookService.java`
- [Payment records](https://github.com/arunkumar235/stagepass/blob/main/payment-service/src/main/java/org/stagepass/paymentservice/entity/PaymentRecord.java): `payment-service/src/main/java/org/stagepass/paymentservice/entity/PaymentRecord.java`

### Messaging and operations

- **Kafka**
- [Booking event publisher](https://github.com/arunkumar235/stagepass/blob/main/booking-service/src/main/java/org/stagepass/bookingservice/kafka/BookingEventPublisher.java): `booking-service/src/main/java/org/stagepass/bookingservice/kafka/BookingEventPublisher.java`
- [Notification consumers](https://github.com/arunkumar235/stagepass/tree/main/notification-service/src/main/java/org/stagepass/notificationservice/kafka): `notification-service/src/main/java/org/stagepass/notificationservice/kafka`
- [Email delivery](https://github.com/arunkumar235/stagepass/blob/main/notification-service/src/main/java/org/stagepass/notificationservice/service/EmailService.java): `notification-service/src/main/java/org/stagepass/notificationservice/service/EmailService.java`
- [PDF tickets](https://github.com/arunkumar235/stagepass/blob/main/notification-service/src/main/java/org/stagepass/notificationservice/service/TicketPdfService.java): `notification-service/src/main/java/org/stagepass/notificationservice/service/TicketPdfService.java`

### Other components

- **Attendee**
- **Razorpay**
- **Redis**

## Connections

- Attendee → API gateway: sends requests
- API gateway → Identity and profiles: routes requests
- API gateway → Event management: routes requests
- API gateway → Booking Saga: routes requests
- API gateway → Payment processing: routes requests
- Identity and profiles → User database: reads and writes (evidence: `user-service/src/main/java/org/stagepass/userservice/service/UserService.java`)
- Identity and profiles → Booking event publisher: publishes registration (evidence: `user-service/src/main/java/org/stagepass/userservice/service/UserService.java`)
- Event management → Event and venue data: persists events (evidence: `event-service/src/main/java/org/stagepass/eventservice/service/EventService.java`)
- Event management → Seat maps and validation: generates seats (evidence: `event-service/src/main/java/org/stagepass/eventservice/service/SeatService.java`)
- Seat maps and validation → Event and venue data: reads seat data (evidence: `event-service/src/main/java/org/stagepass/eventservice/service/SeatService.java`)
- Booking Saga → Seat maps and validation: validates seats (evidence: `booking-service/src/main/java/org/stagepass/bookingservice/service/BookingService.java`)
- Booking Saga → Seat locks: locks seats (evidence: `booking-service/src/main/java/org/stagepass/bookingservice/service/BookingService.java`)
- Seat locks → Redis: stores locks (evidence: `booking-service/src/main/java/org/stagepass/bookingservice/service/SeatLockService.java`)
- Booking Saga → Booking records: persists bookings (evidence: `booking-service/src/main/java/org/stagepass/bookingservice/service/BookingService.java`)
- Booking Saga → Payment processing: requests charge (evidence: `booking-service/src/main/java/org/stagepass/bookingservice/service/BookingService.java`)
- Payment processing → Payment records: records payments (evidence: `payment-service/src/main/java/org/stagepass/paymentservice/service/PaymentService.java`)
- Payment processing → Razorpay: charges and refunds (evidence: `payment-service/src/main/java/org/stagepass/paymentservice/service/PaymentService.java`)
- Razorpay → Payment webhooks: sends outcomes
- Payment webhooks → Payment records: updates statuses (evidence: `payment-service/src/main/java/org/stagepass/paymentservice/service/WebhookService.java`)
- Payment webhooks → Kafka: publishes outcomes (evidence: `payment-service/src/main/java/org/stagepass/paymentservice/service/WebhookService.java`)
- Booking Saga → Booking event publisher: publishes booking events (evidence: `booking-service/src/main/java/org/stagepass/bookingservice/service/BookingService.java`)
- Booking event publisher → Kafka: publishes events
- Kafka → Notification consumers: delivers events
- Notification consumers → Email delivery: dispatches mail
- Notification consumers → PDF tickets: creates attachments
