# pratikjesthi/movie-reservation-system--java-project architecture

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

- Interactive diagram: https://gitdiagram.com/pratikjesthi/movie-reservation-system--java-project
- Repository: https://github.com/pratikjesthi/movie-reservation-system--java-project

## Overview

CHALCHITRA is a Spring Boot movie-reservation application with a JSON API and server-rendered frontend. The main user journey is account/session access, movie and showtime discovery, seat availability, a pending booking and payment, then confirmation and ticket delivery. Administration manages movie/show catalog data; scheduled cleanup releases expired holds. The graph preserves documented ticketing and admin capabilities even where their implementation was not sampled. Edges are limited to excerpted references/calls or README statements; unsampled subsystem links are marked unverified where useful.

Main entry points: [`src/main/java/com/moviebooking/service/PaymentService.java`](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/PaymentService.java) (Payment verification), [`src/main/resources/static/js/app.js`](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/resources/static/js/app.js) (Browser UI), [`src/main/java/com/moviebooking/service/BookingService.java`](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/BookingService.java) (Booking lifecycle), [`src/main/java/com/moviebooking/controller/MovieController.java`](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/MovieController.java) (Movie API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_browser["Browser UI<br/>[app.js]"]
  node_pages["Page routes"]
end

subgraph group_catalog["Catalog management"]
  node_movie_api["Movie API"]
  node_movie_service["Movie catalog<br/>[MovieService.java]"]
  node_show_api["Show API"]
  node_show_service["Show and seats<br/>[ShowService.java]"]
  node_admin_api["Admin API"]
  node_admin_service["Admin catalog"]
  node_movie_store[("Movie persistence")]
  node_show_store[("Show persistence")]
  node_seed["Sample catalog seed"]
end

subgraph group_reservation["Reservation lifecycle"]
  node_booking_api["Booking API"]
  node_booking_service["Booking lifecycle"]
  node_booking_store[("Booking persistence")]
end

subgraph group_identity["Identity and access"]
  node_auth_api["Auth API"]
  node_auth_service["Account service<br/>[AuthService.java]"]
  node_session["Session access<br/>[SessionAuth.java]"]
end

subgraph group_ticketing["Payment and tickets"]
  node_payment_api["Payment endpoints"]
  node_callback_api["Payment callback"]
  node_payment_service["Payment verification"]
  node_payment_store[("Payment records")]
  node_ticket_mail["Ticket delivery"]
  node_ticket_qr["Ticket QR"]
  node_booking_event["Booking confirmed event"]
end

node_customer(("Moviegoer"))
node_admin(("Administrator"))
node_razorpay["Razorpay"]

node_customer -->|"uses"| node_browser
node_admin -->|"uses"| node_browser
node_browser -.->|"requests pages"| node_pages
node_browser -->|"fetches auth"| node_auth_api
node_browser -->|"fetches catalog"| node_movie_api
node_browser -->|"submits booking"| node_booking_api
node_customer -->|"registers or logs in"| node_auth_api
node_auth_api -->|"delegates to"| node_auth_service
node_auth_api -->|"manages session"| node_session
node_auth_service -.->|"creates session"| node_session
node_customer -->|"browses movies"| node_movie_api
node_movie_api -->|"delegates to"| node_movie_service
node_movie_api -->|"requests showtimes"| node_show_service
node_show_api -.->|"delegates to"| node_show_service
node_movie_service -->|"reads catalog"| node_movie_store
node_show_service -->|"reads shows"| node_show_store
node_seed -->|"seeds movies"| node_movie_store
node_admin -->|"manages catalog"| node_admin_api
node_admin_api -.->|"delegates to"| node_admin_service
node_customer -->|"checks seats"| node_show_api
node_customer -->|"reserves seats"| node_booking_api
node_booking_api -->|"delegates to"| node_booking_service
node_booking_service -->|"loads show"| node_show_service
node_booking_service -->|"saves booking"| node_booking_store
node_booking_service -->|"creates payment link"| node_payment_service
node_payment_api -->|"delegates to"| node_payment_service
node_callback_api -->|"verifies callback"| node_payment_service
node_payment_service -->|"loads booking"| node_booking_store
node_payment_service -->|"reads or saves"| node_payment_store
node_payment_service -->|"creates or verifies link"| node_razorpay
node_payment_service -->|"publishes confirmation"| node_booking_event
node_booking_event -->|"triggers delivery"| node_ticket_mail
node_ticket_mail -->|"uses QR"| node_ticket_qr
node_booking_service -->|"expires stale holds"| node_booking_store

click node_browser "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/resources/static/js/app.js"
click node_pages "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/PageController.java"
click node_auth_api "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/AuthController.java"
click node_auth_service "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/AuthService.java"
click node_session "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/SessionAuth.java"
click node_movie_api "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/MovieController.java"
click node_movie_service "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/MovieService.java"
click node_show_api "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/ShowController.java"
click node_show_service "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/ShowService.java"
click node_admin_api "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/AdminController.java"
click node_admin_service "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/AdminCatalogService.java"
click node_booking_api "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/BookingController.java"
click node_booking_service "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/BookingService.java"
click node_booking_store "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/repository/BookingRepository.java"
click node_payment_api "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/PaymentController.java"
click node_callback_api "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/PaymentCallbackController.java"
click node_payment_service "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/PaymentService.java"
click node_payment_store "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/repository/PaymentRepository.java"
click node_ticket_mail "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/TicketMailService.java"
click node_ticket_qr "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/TicketQrService.java"
click node_booking_event "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/event/BookingConfirmedEvent.java"
click node_movie_store "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/repository/MovieRepository.java"
click node_show_store "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/repository/ShowRepository.java"
click node_seed "https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/config/DatabaseSeeder.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_browser,node_pages toneBlue
class node_movie_api,node_movie_service,node_show_api,node_show_service,node_admin_api,node_admin_service,node_movie_store,node_show_store,node_seed toneAmber
class node_booking_api,node_booking_service,node_booking_store toneMint
class node_auth_api,node_auth_service,node_session toneRose
class node_payment_api,node_callback_api,node_payment_service,node_payment_store,node_ticket_mail,node_ticket_qr,node_booking_event,node_customer,node_admin,node_razorpay toneIndigo
```

## Components

### Web interface

- [Browser UI](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/resources/static/js/app.js): `src/main/resources/static/js/app.js`
- [Page routes](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/PageController.java): `src/main/java/com/moviebooking/controller/PageController.java`

### Catalog management

- [Movie API](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/MovieController.java): `src/main/java/com/moviebooking/controller/MovieController.java`
- [Movie catalog](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/MovieService.java): `src/main/java/com/moviebooking/service/MovieService.java`
- [Show API](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/ShowController.java): `src/main/java/com/moviebooking/controller/ShowController.java`
- [Show and seats](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/ShowService.java): `src/main/java/com/moviebooking/service/ShowService.java`
- [Admin API](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/AdminController.java): `src/main/java/com/moviebooking/controller/AdminController.java`
- [Admin catalog](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/AdminCatalogService.java): `src/main/java/com/moviebooking/service/AdminCatalogService.java`
- [Movie persistence](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/repository/MovieRepository.java): `src/main/java/com/moviebooking/repository/MovieRepository.java`
- [Show persistence](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/repository/ShowRepository.java): `src/main/java/com/moviebooking/repository/ShowRepository.java`
- [Sample catalog seed](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/config/DatabaseSeeder.java): `src/main/java/com/moviebooking/config/DatabaseSeeder.java`

### Reservation lifecycle

- [Booking API](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/BookingController.java): `src/main/java/com/moviebooking/controller/BookingController.java`
- [Booking lifecycle](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/BookingService.java): `src/main/java/com/moviebooking/service/BookingService.java`
- [Booking persistence](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/repository/BookingRepository.java): `src/main/java/com/moviebooking/repository/BookingRepository.java`

### Identity and access

- [Auth API](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/AuthController.java): `src/main/java/com/moviebooking/controller/AuthController.java`
- [Account service](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/AuthService.java): `src/main/java/com/moviebooking/service/AuthService.java`
- [Session access](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/SessionAuth.java): `src/main/java/com/moviebooking/service/SessionAuth.java`

### Payment and tickets

- [Payment endpoints](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/PaymentController.java): `src/main/java/com/moviebooking/controller/PaymentController.java`
- [Payment callback](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/controller/PaymentCallbackController.java): `src/main/java/com/moviebooking/controller/PaymentCallbackController.java`
- [Payment verification](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/PaymentService.java): `src/main/java/com/moviebooking/service/PaymentService.java`
- [Payment records](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/repository/PaymentRepository.java): `src/main/java/com/moviebooking/repository/PaymentRepository.java`
- [Ticket delivery](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/TicketMailService.java): `src/main/java/com/moviebooking/service/TicketMailService.java`
- [Ticket QR](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/service/TicketQrService.java): `src/main/java/com/moviebooking/service/TicketQrService.java`
- [Booking confirmed event](https://github.com/pratikjesthi/movie-reservation-system--java-project/blob/main/src/main/java/com/moviebooking/event/BookingConfirmedEvent.java): `src/main/java/com/moviebooking/event/BookingConfirmedEvent.java`

### Other components

- **Moviegoer**
- **Administrator**
- **Razorpay**

## Connections

- Moviegoer → Browser UI: uses
- Administrator → Browser UI: uses
- Browser UI → Page routes: requests pages
- Browser UI → Auth API: fetches auth
- Browser UI → Movie API: fetches catalog
- Browser UI → Booking API: submits booking
- Moviegoer → Auth API: registers or logs in
- Auth API → Account service: delegates to (evidence: `src/main/java/com/moviebooking/controller/AuthController.java`)
- Auth API → Session access: manages session (evidence: `src/main/java/com/moviebooking/controller/AuthController.java`)
- Account service → Session access: creates session
- Moviegoer → Movie API: browses movies
- Movie API → Movie catalog: delegates to (evidence: `src/main/java/com/moviebooking/controller/MovieController.java`)
- Movie API → Show and seats: requests showtimes (evidence: `src/main/java/com/moviebooking/controller/MovieController.java`)
- Show API → Show and seats: delegates to
- Movie catalog → Movie persistence: reads catalog (evidence: `src/main/java/com/moviebooking/service/MovieService.java`)
- Show and seats → Show persistence: reads shows (evidence: `src/main/java/com/moviebooking/service/ShowService.java`)
- Sample catalog seed → Movie persistence: seeds movies (evidence: `src/main/java/com/moviebooking/config/DatabaseSeeder.java`)
- Administrator → Admin API: manages catalog
- Admin API → Admin catalog: delegates to (evidence: `src/main/java/com/moviebooking/controller/AdminController.java`)
- Moviegoer → Show API: checks seats
- Moviegoer → Booking API: reserves seats
- Booking API → Booking lifecycle: delegates to (evidence: `src/main/java/com/moviebooking/controller/BookingController.java`)
- Booking lifecycle → Show and seats: loads show (evidence: `src/main/java/com/moviebooking/service/BookingService.java`)
- Booking lifecycle → Booking persistence: saves booking (evidence: `src/main/java/com/moviebooking/service/BookingService.java`)
- Booking lifecycle → Payment verification: creates payment link (evidence: `src/main/java/com/moviebooking/service/BookingService.java`)
- Payment endpoints → Payment verification: delegates to (evidence: `src/main/java/com/moviebooking/controller/PaymentController.java`)
- Payment callback → Payment verification: verifies callback (evidence: `src/main/java/com/moviebooking/controller/PaymentCallbackController.java`)
- Payment verification → Booking persistence: loads booking (evidence: `src/main/java/com/moviebooking/service/PaymentService.java`)
- Payment verification → Payment records: reads or saves (evidence: `src/main/java/com/moviebooking/service/PaymentService.java`)
- Payment verification → Razorpay: creates or verifies link
- Payment verification → Booking confirmed event: publishes confirmation (evidence: `src/main/java/com/moviebooking/service/PaymentService.java`)
- Booking confirmed event → Ticket delivery: triggers delivery (evidence: `src/main/java/com/moviebooking/service/TicketMailService.java`)
- Ticket delivery → Ticket QR: uses QR (evidence: `src/main/java/com/moviebooking/service/TicketMailService.java`)
- Booking lifecycle → Booking persistence: expires stale holds (evidence: `src/main/java/com/moviebooking/service/BookingService.java`)
