How arunkumar235/stagepass works
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: BookingService.java Booking Saga · apigateway API gateway · PaymentService.java Payment processing · service Identity and profiles
Components 21
Edge and identity
- API gateway
api-gateway/src/main/java/org/stagepass/apigateway - Identity and profiles
user-service/src/main/java/org/stagepass/userservice/service - User database
user-service/src/main/java/org/stagepass/userservice/entity/User.java - Service registry
eureka-server/src/main/java/org/stagepass/eurekaserver/EurekaServerApplication.java
Event catalog
- Event management
event-service/src/main/java/org/stagepass/eventservice/service/EventService.java - Seat maps and validation
event-service/src/main/java/org/stagepass/eventservice/service/SeatService.java - Event and venue data
event-service/src/main/java/org/stagepass/eventservice/entity/Event.java
Booking and payment
- Booking Saga
booking-service/src/main/java/org/stagepass/bookingservice/service/BookingService.java - Seat locks
booking-service/src/main/java/org/stagepass/bookingservice/service/SeatLockService.java - Booking records
booking-service/src/main/java/org/stagepass/bookingservice/entity/Booking.java - Payment processing
payment-service/src/main/java/org/stagepass/paymentservice/service/PaymentService.java - Payment webhooks
payment-service/src/main/java/org/stagepass/paymentservice/service/WebhookService.java - Payment records
payment-service/src/main/java/org/stagepass/paymentservice/entity/PaymentRecord.java
Messaging and operations
- Kafka
- Booking event publisher
booking-service/src/main/java/org/stagepass/bookingservice/kafka/BookingEventPublisher.java - Notification consumers
notification-service/src/main/java/org/stagepass/notificationservice/kafka - Email delivery
notification-service/src/main/java/org/stagepass/notificationservice/service/EmailService.java - PDF tickets
notification-service/src/main/java/org/stagepass/notificationservice/service/TicketPdfService.java
Other components
- Attendee
- Razorpay
- Redis
Connections 25
- 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
user-service/src/main/java/org/stagepass/userservice/service/UserService.java - Identity and profiles → Booking event publisher: publishes registration
user-service/src/main/java/org/stagepass/userservice/service/UserService.java - Event management → Event and venue data: persists events
event-service/src/main/java/org/stagepass/eventservice/service/EventService.java - Event management → Seat maps and validation: generates seats
event-service/src/main/java/org/stagepass/eventservice/service/SeatService.java - Seat maps and validation → Event and venue data: reads seat data
event-service/src/main/java/org/stagepass/eventservice/service/SeatService.java - Booking Saga → Seat maps and validation: validates seats
booking-service/src/main/java/org/stagepass/bookingservice/service/BookingService.java - Booking Saga → Seat locks: locks seats
booking-service/src/main/java/org/stagepass/bookingservice/service/BookingService.java - Seat locks → Redis: stores locks
booking-service/src/main/java/org/stagepass/bookingservice/service/SeatLockService.java - Booking Saga → Booking records: persists bookings
booking-service/src/main/java/org/stagepass/bookingservice/service/BookingService.java - Booking Saga → Payment processing: requests charge
booking-service/src/main/java/org/stagepass/bookingservice/service/BookingService.java - Payment processing → Payment records: records payments
payment-service/src/main/java/org/stagepass/paymentservice/service/PaymentService.java - Payment processing → Razorpay: charges and refunds
payment-service/src/main/java/org/stagepass/paymentservice/service/PaymentService.java - Razorpay → Payment webhooks: sends outcomes
- Payment webhooks → Payment records: updates statuses
payment-service/src/main/java/org/stagepass/paymentservice/service/WebhookService.java - Payment webhooks → Kafka: publishes outcomes
payment-service/src/main/java/org/stagepass/paymentservice/service/WebhookService.java - Booking Saga → Booking event publisher: publishes booking events
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