# devkaran30/movie-ticket-booking-system architecture

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

- Interactive diagram: https://gitdiagram.com/devkaran30/movie-ticket-booking-system
- Repository: https://github.com/devkaran30/movie-ticket-booking-system

## Overview

This is a Spring-based movie-ticket booking API. Customers browse shows and seats, create a booking, then process payment; the API also exposes authentication, tickets, refunds, and administrative management/reporting. The graph emphasizes the booking, payment, and show paths plus persistence and catalog layers. The README provides no detailed workflow documentation, so edges are limited to relationships visible in sampled source or the SOURCE INDEX; unsampled capability branches are represented without speculative links.

Main entry points: [`src/main/java/com/nexturn/mtbs/service/impl/ShowServiceImpl.java`](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/service/impl/ShowServiceImpl.java) (Show and seat lookup), [`src/main/java/com/nexturn/mtbs/controller/BookingController.java`](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/controller/BookingController.java) (Booking API), [`src/main/java/com/nexturn/mtbs/service/impl/BookingServiceImpl.java`](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/service/impl/BookingServiceImpl.java) (Booking workflow), [`src/main/java/com/nexturn/mtbs/repository/BookingSeatRepository.java`](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/repository/BookingSeatRepository.java) (Booked seats)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API endpoints"]
  node_booking_api["Booking API"]
  node_payment_api["Payment API"]
  node_refund_api["Refund API"]
  node_show_api["Show API"]
  node_ticket_api["Ticket API"]
  node_user_api["User API"]
  node_admin_api["Admin APIs"]
  node_auth_service["Authentication"]
end

subgraph group_transactions["Booking and payment"]
  node_booking_service["Booking workflow"]
  node_payment_service["Payment processing"]
  node_booking_entity["Booking records<br/>[Booking.java]"]
  node_payment_entity["Payment records<br/>[Payment.java]"]
  node_booking_seats[("Booked seats")]
  node_seat_locks[("Seat locks")]
end

subgraph group_catalog["Cinema catalog"]
  node_show_service["Show and seat lookup"]
  node_catalog_services["Cinema management"]
  node_show_repository[("Show records")]
  node_domain_entities["Cinema entities"]
end

subgraph group_persistence["Persistence"]
  node_user_repository[("User records")]
  node_other_repositories[("Other repositories")]
end

node_customer(("Customer or admin"))

node_customer -->|"submits booking"| node_booking_api
node_customer -->|"queries shows"| node_show_api
node_booking_api -->|"calls booking service"| node_booking_service
node_booking_api -->|"reads seat IDs"| node_booking_seats
node_payment_api -->|"calls payment service"| node_payment_service
node_show_api -->|"calls show service"| node_show_service
node_ticket_api -->|"delegates ticket operations"| node_catalog_services
node_user_api -->|"uses authentication"| node_auth_service
node_booking_service -->|"queries booked seats"| node_booking_seats
node_booking_service -->|"checks seat locks"| node_seat_locks
node_payment_service -->|"updates seat locks"| node_seat_locks
node_show_service -->|"checks booked seats"| node_booking_seats
node_show_service -->|"checks seat locks"| node_seat_locks
node_show_service -->|"queries shows"| node_show_repository
node_auth_service -->|"uses user records"| node_user_repository
node_admin_api -.->|"manages catalog"| node_catalog_services
node_refund_api -.->|"delegates refund operations"| node_catalog_services

click node_booking_api "https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/controller/BookingController.java"
click node_payment_api "https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/controller/PaymentController.java"
click node_refund_api "https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/controller/RefundController.java"
click node_show_api "https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/controller/ShowController.java"
click node_ticket_api "https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/controller/TicketController.java"
click node_user_api "https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/controller/UserController.java"
click node_admin_api "https://github.com/devkaran30/movie-ticket-booking-system/tree/main/src/main/java/com/nexturn/mtbs/controller"
click node_booking_service "https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/service/impl/BookingServiceImpl.java"
click node_payment_service "https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/service/impl/PaymentServiceImpl.java"
click node_booking_entity "https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/entity/Booking.java"
click node_payment_entity "https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/entity/Payment.java"
click node_booking_seats "https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/repository/BookingSeatRepository.java"
click node_seat_locks "https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/repository/SeatLockRepository.java"
click node_show_service "https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/service/impl/ShowServiceImpl.java"
click node_catalog_services "https://github.com/devkaran30/movie-ticket-booking-system/tree/main/src/main/java/com/nexturn/mtbs/service"
click node_show_repository "https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/repository/ShowRepository.java"
click node_domain_entities "https://github.com/devkaran30/movie-ticket-booking-system/tree/main/src/main/java/com/nexturn/mtbs/entity"
click node_auth_service "https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/service/impl/AuthServiceImpl.java"
click node_user_repository "https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/repository/UserRepository.java"
click node_other_repositories "https://github.com/devkaran30/movie-ticket-booking-system/tree/main/src/main/java/com/nexturn/mtbs/repository"

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_booking_api,node_payment_api,node_refund_api,node_show_api,node_ticket_api,node_user_api,node_admin_api,node_auth_service toneBlue
class node_booking_service,node_payment_service,node_booking_entity,node_payment_entity,node_booking_seats,node_seat_locks toneAmber
class node_show_service,node_catalog_services,node_show_repository,node_domain_entities toneMint
class node_user_repository,node_other_repositories toneRose
class node_customer toneIndigo
```

## Components

### API endpoints

- [Booking API](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/controller/BookingController.java): `src/main/java/com/nexturn/mtbs/controller/BookingController.java`
- [Payment API](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/controller/PaymentController.java): `src/main/java/com/nexturn/mtbs/controller/PaymentController.java`
- [Refund API](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/controller/RefundController.java): `src/main/java/com/nexturn/mtbs/controller/RefundController.java`
- [Show API](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/controller/ShowController.java): `src/main/java/com/nexturn/mtbs/controller/ShowController.java`
- [Ticket API](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/controller/TicketController.java): `src/main/java/com/nexturn/mtbs/controller/TicketController.java`
- [User API](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/controller/UserController.java): `src/main/java/com/nexturn/mtbs/controller/UserController.java`
- [Admin APIs](https://github.com/devkaran30/movie-ticket-booking-system/tree/main/src/main/java/com/nexturn/mtbs/controller): `src/main/java/com/nexturn/mtbs/controller`
- [Authentication](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/service/impl/AuthServiceImpl.java): `src/main/java/com/nexturn/mtbs/service/impl/AuthServiceImpl.java`

### Booking and payment

- [Booking workflow](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/service/impl/BookingServiceImpl.java): `src/main/java/com/nexturn/mtbs/service/impl/BookingServiceImpl.java`
- [Payment processing](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/service/impl/PaymentServiceImpl.java): `src/main/java/com/nexturn/mtbs/service/impl/PaymentServiceImpl.java`
- [Booking records](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/entity/Booking.java): `src/main/java/com/nexturn/mtbs/entity/Booking.java`
- [Payment records](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/entity/Payment.java): `src/main/java/com/nexturn/mtbs/entity/Payment.java`
- [Booked seats](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/repository/BookingSeatRepository.java): `src/main/java/com/nexturn/mtbs/repository/BookingSeatRepository.java`
- [Seat locks](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/repository/SeatLockRepository.java): `src/main/java/com/nexturn/mtbs/repository/SeatLockRepository.java`

### Cinema catalog

- [Show and seat lookup](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/service/impl/ShowServiceImpl.java): `src/main/java/com/nexturn/mtbs/service/impl/ShowServiceImpl.java`
- [Cinema management](https://github.com/devkaran30/movie-ticket-booking-system/tree/main/src/main/java/com/nexturn/mtbs/service): `src/main/java/com/nexturn/mtbs/service`
- [Show records](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/repository/ShowRepository.java): `src/main/java/com/nexturn/mtbs/repository/ShowRepository.java`
- [Cinema entities](https://github.com/devkaran30/movie-ticket-booking-system/tree/main/src/main/java/com/nexturn/mtbs/entity): `src/main/java/com/nexturn/mtbs/entity`

### Persistence

- [User records](https://github.com/devkaran30/movie-ticket-booking-system/blob/main/src/main/java/com/nexturn/mtbs/repository/UserRepository.java): `src/main/java/com/nexturn/mtbs/repository/UserRepository.java`
- [Other repositories](https://github.com/devkaran30/movie-ticket-booking-system/tree/main/src/main/java/com/nexturn/mtbs/repository): `src/main/java/com/nexturn/mtbs/repository`

### Other components

- **Customer or admin**

## Connections

- Customer or admin → Booking API: submits booking (evidence: `src/main/java/com/nexturn/mtbs/controller/BookingController.java`)
- Customer or admin → Show API: queries shows (evidence: `src/main/java/com/nexturn/mtbs/controller/ShowController.java`)
- Booking API → Booking workflow: calls booking service (evidence: `src/main/java/com/nexturn/mtbs/controller/BookingController.java`)
- Booking API → Booked seats: reads seat IDs (evidence: `src/main/java/com/nexturn/mtbs/controller/BookingController.java`)
- Payment API → Payment processing: calls payment service (evidence: `src/main/java/com/nexturn/mtbs/controller/PaymentController.java`)
- Show API → Show and seat lookup: calls show service (evidence: `src/main/java/com/nexturn/mtbs/controller/ShowController.java`)
- Ticket API → Cinema management: delegates ticket operations (evidence: `src/main/java/com/nexturn/mtbs/controller/TicketController.java`)
- User API → Authentication: uses authentication (evidence: `src/main/java/com/nexturn/mtbs/controller/UserController.java`)
- Booking workflow → Booked seats: queries booked seats (evidence: `src/main/java/com/nexturn/mtbs/service/impl/BookingServiceImpl.java`)
- Booking workflow → Seat locks: checks seat locks (evidence: `src/main/java/com/nexturn/mtbs/service/impl/BookingServiceImpl.java`)
- Payment processing → Seat locks: updates seat locks (evidence: `src/main/java/com/nexturn/mtbs/service/impl/PaymentServiceImpl.java`)
- Show and seat lookup → Booked seats: checks booked seats (evidence: `src/main/java/com/nexturn/mtbs/service/impl/ShowServiceImpl.java`)
- Show and seat lookup → Seat locks: checks seat locks (evidence: `src/main/java/com/nexturn/mtbs/service/impl/ShowServiceImpl.java`)
- Show and seat lookup → Show records: queries shows (evidence: `src/main/java/com/nexturn/mtbs/service/impl/ShowServiceImpl.java`)
- Authentication → User records: uses user records (evidence: `src/main/java/com/nexturn/mtbs/service/impl/AuthServiceImpl.java`)
- Admin APIs → Cinema management: manages catalog (evidence: `src/main/java/com/nexturn/mtbs/controller/BookingController.java`)
- Refund API → Cinema management: delegates refund operations (evidence: `src/main/java/com/nexturn/mtbs/controller/RefundController.java`)
