# imrajeevnayan/bookmyshow architecture

> Architecture diagram of the GitHub repository imrajeevnayan/bookmyshow, 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/imrajeevnayan/bookmyshow
- Repository: https://github.com/imrajeevnayan/bookmyshow

## Overview

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: [`frontend/src/App.tsx`](https://github.com/imrajeevnayan/bookmyshow/blob/main/frontend/src/App.tsx) (React SPA), [`src/main/java/com/cfs/BMS/service/BookingService.java`](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/service/BookingService.java) (Booking Workflow), [`src/main/java/com/cfs/BMS/controller/BookingController.java`](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/controller/BookingController.java) (Booking Endpoints), [`src/main/java/com/cfs/BMS/service/UserService.java`](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/service/UserService.java) (Authentication And Users)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Customer Web App"]
  node_spa["React SPA<br/>[App.tsx]"]
  node_movie_detail["Movie Details<br/>[MovieDetail.tsx]"]
  node_seat_ui["Seat Selection<br/>[SeatSelection.tsx]"]
  node_auth_ui["Login And Signup<br/>[Login.tsx]"]
  node_api_client["Movie API Client<br/>[api.ts]"]
end

subgraph group_api["HTTP API"]
  node_booking_http["Booking Endpoints"]
  node_user_http["User Endpoints"]
  node_movie_http["Movie Endpoints"]
  node_show_http["Show Endpoints"]
  node_theater_http["Theater And City API"]
end

subgraph group_domain["Booking And Catalog"]
  node_booking_service["Booking Workflow"]
  node_user_service["Authentication And Users<br/>[UserService.java]"]
  node_movie_service["Movie Catalog<br/>[MovieService.java]"]
  node_show_service["Show Scheduling<br/>[ShowService.java]"]
  node_theater_service["Theaters And Cities"]
end

subgraph group_data["Persistence And Security"]
  node_inventory[("Show Seat Inventory<br/>[ShowSeat.java]")]
  node_booking_records[("Booking Records<br/>[Booking.java]")]
  node_repositories["Data Repositories"]
  node_security["JWT Security<br/>[JwtAuthFilter.java]"]
end

node_customer(("Customer"))
node_postgres[("PostgreSQL")]

node_customer -->|"uses"| node_spa
node_spa -->|"routes to"| node_movie_detail
node_spa -->|"routes to"| node_seat_ui
node_spa -->|"routes to"| node_auth_ui
node_movie_detail -->|"fetches movie"| node_api_client
node_spa -->|"calls API"| node_movie_http
node_spa -->|"calls API"| node_booking_http
node_spa -->|"calls API"| node_user_http
node_booking_http -->|"delegates"| node_booking_service
node_user_http -->|"delegates"| node_user_service
node_movie_http -->|"delegates"| node_movie_service
node_show_http -.->|"delegates"| node_show_service
node_theater_http -->|"delegates"| node_theater_service
node_booking_service -->|"loads user"| node_user_service
node_booking_service -->|"loads show"| node_show_service
node_show_service -->|"loads movie"| node_movie_service
node_booking_service -->|"locks inventory"| node_repositories
node_booking_service -->|"persists booking"| node_booking_records
node_booking_service -->|"updates seats"| node_inventory
node_user_service -->|"creates JWT"| node_security
node_repositories -->|"reads and writes"| node_postgres
node_inventory -->|"stored in"| node_postgres
node_booking_records -->|"stored in"| node_postgres
node_booking_http -->|"requires bearer auth"| node_security

click node_spa "https://github.com/imrajeevnayan/bookmyshow/blob/main/frontend/src/App.tsx"
click node_movie_detail "https://github.com/imrajeevnayan/bookmyshow/blob/main/frontend/src/pages/MovieDetail.tsx"
click node_seat_ui "https://github.com/imrajeevnayan/bookmyshow/blob/main/frontend/src/pages/SeatSelection.tsx"
click node_auth_ui "https://github.com/imrajeevnayan/bookmyshow/blob/main/frontend/src/pages/Login.tsx"
click node_api_client "https://github.com/imrajeevnayan/bookmyshow/blob/main/frontend/src/services/api.ts"
click node_booking_http "https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/controller/BookingController.java"
click node_user_http "https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/controller/UserController.java"
click node_movie_http "https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/controller/MovieController.java"
click node_show_http "https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/controller/ShowController.java"
click node_theater_http "https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/controller/TheaterController.java"
click node_booking_service "https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/service/BookingService.java"
click node_user_service "https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/service/UserService.java"
click node_movie_service "https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/service/MovieService.java"
click node_show_service "https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/service/ShowService.java"
click node_theater_service "https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/service/TheaterService.java"
click node_inventory "https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/entity/ShowSeat.java"
click node_booking_records "https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/entity/Booking.java"
click node_repositories "https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/repository/ShowSeatRepository.java"
click node_security "https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/security/JwtAuthFilter.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_spa,node_movie_detail,node_seat_ui,node_auth_ui,node_api_client toneBlue
class node_booking_http,node_user_http,node_movie_http,node_show_http,node_theater_http,node_postgres toneAmber
class node_booking_service,node_user_service,node_movie_service,node_show_service,node_theater_service toneMint
class node_inventory,node_booking_records,node_repositories,node_security toneRose
class node_customer toneIndigo
```

## Components

### Customer Web App

- [React SPA](https://github.com/imrajeevnayan/bookmyshow/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Movie Details](https://github.com/imrajeevnayan/bookmyshow/blob/main/frontend/src/pages/MovieDetail.tsx): `frontend/src/pages/MovieDetail.tsx`
- [Seat Selection](https://github.com/imrajeevnayan/bookmyshow/blob/main/frontend/src/pages/SeatSelection.tsx): `frontend/src/pages/SeatSelection.tsx`
- [Login And Signup](https://github.com/imrajeevnayan/bookmyshow/blob/main/frontend/src/pages/Login.tsx): `frontend/src/pages/Login.tsx`
- [Movie API Client](https://github.com/imrajeevnayan/bookmyshow/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### HTTP API

- [Booking Endpoints](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/controller/BookingController.java): `src/main/java/com/cfs/BMS/controller/BookingController.java`
- [User Endpoints](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/controller/UserController.java): `src/main/java/com/cfs/BMS/controller/UserController.java`
- [Movie Endpoints](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/controller/MovieController.java): `src/main/java/com/cfs/BMS/controller/MovieController.java`
- [Show Endpoints](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/controller/ShowController.java): `src/main/java/com/cfs/BMS/controller/ShowController.java`
- [Theater And City API](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/controller/TheaterController.java): `src/main/java/com/cfs/BMS/controller/TheaterController.java`

### Booking And Catalog

- [Booking Workflow](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/service/BookingService.java): `src/main/java/com/cfs/BMS/service/BookingService.java`
- [Authentication And Users](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/service/UserService.java): `src/main/java/com/cfs/BMS/service/UserService.java`
- [Movie Catalog](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/service/MovieService.java): `src/main/java/com/cfs/BMS/service/MovieService.java`
- [Show Scheduling](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/service/ShowService.java): `src/main/java/com/cfs/BMS/service/ShowService.java`
- [Theaters And Cities](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/service/TheaterService.java): `src/main/java/com/cfs/BMS/service/TheaterService.java`

### Persistence And Security

- [Show Seat Inventory](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/entity/ShowSeat.java): `src/main/java/com/cfs/BMS/entity/ShowSeat.java`
- [Booking Records](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/entity/Booking.java): `src/main/java/com/cfs/BMS/entity/Booking.java`
- [Data Repositories](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/repository/ShowSeatRepository.java): `src/main/java/com/cfs/BMS/repository/ShowSeatRepository.java`
- [JWT Security](https://github.com/imrajeevnayan/bookmyshow/blob/main/src/main/java/com/cfs/BMS/security/JwtAuthFilter.java): `src/main/java/com/cfs/BMS/security/JwtAuthFilter.java`

### Other components

- **Customer**
- **PostgreSQL**

## Connections

- Customer → React SPA: uses
- React SPA → Movie Details: routes to (evidence: `frontend/src/App.tsx`)
- React SPA → Seat Selection: routes to (evidence: `frontend/src/App.tsx`)
- React SPA → Login And Signup: routes to (evidence: `frontend/src/App.tsx`)
- Movie Details → Movie API Client: fetches movie (evidence: `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 (evidence: `src/main/java/com/cfs/BMS/controller/BookingController.java`)
- User Endpoints → Authentication And Users: delegates (evidence: `src/main/java/com/cfs/BMS/controller/UserController.java`)
- Movie Endpoints → Movie Catalog: delegates (evidence: `src/main/java/com/cfs/BMS/controller/MovieController.java`)
- Show Endpoints → Show Scheduling: delegates
- Theater And City API → Theaters And Cities: delegates (evidence: `src/main/java/com/cfs/BMS/controller/TheaterController.java`)
- Booking Workflow → Authentication And Users: loads user (evidence: `src/main/java/com/cfs/BMS/service/BookingService.java`)
- Booking Workflow → Show Scheduling: loads show (evidence: `src/main/java/com/cfs/BMS/service/BookingService.java`)
- Show Scheduling → Movie Catalog: loads movie (evidence: `src/main/java/com/cfs/BMS/service/ShowService.java`)
- Booking Workflow → Data Repositories: locks inventory (evidence: `src/main/java/com/cfs/BMS/service/BookingService.java`)
- Booking Workflow → Booking Records: persists booking (evidence: `src/main/java/com/cfs/BMS/service/BookingService.java`)
- Booking Workflow → Show Seat Inventory: updates seats (evidence: `src/main/java/com/cfs/BMS/service/BookingService.java`)
- Authentication And Users → JWT Security: creates JWT (evidence: `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
