How imrajeevnayan/bookmyshow works
BookMyShow is a movie-ticket booking application. The customer workflow is to browse movies, inspect a movie, choose a show and seats, authenticate if needed, then create or cancel a booking. The backend also exposes catalog, city, theater, user-profile, and booking-management capabilities. The README documents PostgreSQL and the concurrency-safe inventory design; sampled booking code confirms its locking, validation, idempotency, and persistence flow. Some frontend and backend modules were not sampled, so those links are limited to documented relationships.
Main entry points: App.tsx React SPA · BookingService.java Booking Workflow · BookingController.java Booking Endpoints · UserService.java Authentication And Users
Components 21
Customer Web App
- React SPA
frontend/src/App.tsx - Movie Details
frontend/src/pages/MovieDetail.tsx - Seat Selection
frontend/src/pages/SeatSelection.tsx - Login And Signup
frontend/src/pages/Login.tsx - Movie API Client
frontend/src/services/api.ts
HTTP API
- Booking Endpoints
src/main/java/com/cfs/BMS/controller/BookingController.java - User Endpoints
src/main/java/com/cfs/BMS/controller/UserController.java - Movie Endpoints
src/main/java/com/cfs/BMS/controller/MovieController.java - Show Endpoints
src/main/java/com/cfs/BMS/controller/ShowController.java - Theater And City API
src/main/java/com/cfs/BMS/controller/TheaterController.java
Booking And Catalog
- Booking Workflow
src/main/java/com/cfs/BMS/service/BookingService.java - Authentication And Users
src/main/java/com/cfs/BMS/service/UserService.java - Movie Catalog
src/main/java/com/cfs/BMS/service/MovieService.java - Show Scheduling
src/main/java/com/cfs/BMS/service/ShowService.java - Theaters And Cities
src/main/java/com/cfs/BMS/service/TheaterService.java
Persistence And Security
- Show Seat Inventory
src/main/java/com/cfs/BMS/entity/ShowSeat.java - Booking Records
src/main/java/com/cfs/BMS/entity/Booking.java - Data Repositories
src/main/java/com/cfs/BMS/repository/ShowSeatRepository.java - JWT Security
src/main/java/com/cfs/BMS/security/JwtAuthFilter.java
Other components
- Customer
- PostgreSQL
Connections 24
- Customer → React SPA: uses
- React SPA → Movie Details: routes to
frontend/src/App.tsx - React SPA → Seat Selection: routes to
frontend/src/App.tsx - React SPA → Login And Signup: routes to
frontend/src/App.tsx - Movie Details → Movie API Client: fetches movie
frontend/src/pages/MovieDetail.tsx - React SPA → Movie Endpoints: calls API
- React SPA → Booking Endpoints: calls API
- React SPA → User Endpoints: calls API
- Booking Endpoints → Booking Workflow: delegates
src/main/java/com/cfs/BMS/controller/BookingController.java - User Endpoints → Authentication And Users: delegates
src/main/java/com/cfs/BMS/controller/UserController.java - Movie Endpoints → Movie Catalog: delegates
src/main/java/com/cfs/BMS/controller/MovieController.java - Show Endpoints → Show Scheduling: delegates
- Theater And City API → Theaters And Cities: delegates
src/main/java/com/cfs/BMS/controller/TheaterController.java - Booking Workflow → Authentication And Users: loads user
src/main/java/com/cfs/BMS/service/BookingService.java - Booking Workflow → Show Scheduling: loads show
src/main/java/com/cfs/BMS/service/BookingService.java - Show Scheduling → Movie Catalog: loads movie
src/main/java/com/cfs/BMS/service/ShowService.java - Booking Workflow → Data Repositories: locks inventory
src/main/java/com/cfs/BMS/service/BookingService.java - Booking Workflow → Booking Records: persists booking
src/main/java/com/cfs/BMS/service/BookingService.java - Booking Workflow → Show Seat Inventory: updates seats
src/main/java/com/cfs/BMS/service/BookingService.java - Authentication And Users → JWT Security: creates JWT
src/main/java/com/cfs/BMS/service/UserService.java - Data Repositories → PostgreSQL: reads and writes
- Show Seat Inventory → PostgreSQL: stored in
- Booking Records → PostgreSQL: stored in
- Booking Endpoints → JWT Security: requires bearer auth