# irshadalam-dev/theatre-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/irshadalam-dev/theatre-management-system
- Repository: https://github.com/irshadalam-dev/theatre-management-system

## Overview

The repository is a full-stack theatre booking application: customers browse shows, reserve seats, record pending cash payments, and may cancel unpaid bookings; admins maintain catalogue data and confirm cash payments. The browser UI is served by Spring Boot and calls its API. The README documents the controller → service → repository request layers and MySQL persistence. Backend source excerpts were not provided, so those links rely on the README rather than inspected implementation; feature nodes use exact paths from the tree.

Main entry points: [`src/main/java/com/example/theatre/controller`](https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/java/com/example/theatre/controller) (HTTP controllers), [`src/main/java/com/example/theatre/repository`](https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/java/com/example/theatre/repository) (Data access), [`src/main/resources/static/app.js`](https://github.com/irshadalam-dev/theatre-management-system/blob/main/src/main/resources/static/app.js) (Booking UI), [`src/main/java/com/example/theatre/TheatreManagementApplication.java`](https://github.com/irshadalam-dev/theatre-management-system/blob/main/src/main/java/com/example/theatre/TheatreManagementApplication.java) (Spring Boot app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Browser experience"]
  node_ui["Booking UI<br/>[app.js]"]
end

subgraph group_api["API and security"]
  node_application["Spring Boot app"]
  node_controllers["HTTP controllers"]
  node_security["JWT and roles"]
  node_dto["API contracts"]
  node_errors["API errors"]
end

subgraph group_domain["Booking operations"]
  node_auth["Accounts<br/>[AuthService.java]"]
  node_catalogue["Theatre catalogue"]
  node_booking["Seat bookings"]
  node_payments["Cash payments"]
end

subgraph group_data["Persistence"]
  node_entities["Domain records"]
  node_repositories["Data access"]
  node_migrations["Schema migrations"]
end

node_customer(("Customer"))
node_admin(("Admin"))
node_mysql[("MySQL")]

node_customer -->|"uses"| node_ui
node_admin -->|"uses"| node_ui
node_ui -->|"calls API"| node_controllers
node_application -->|"serves"| node_ui
node_application -->|"handles requests"| node_controllers
node_controllers -->|"enforces access"| node_security
node_controllers -->|"uses contracts"| node_dto
node_controllers -->|"delegates"| node_auth
node_controllers -->|"delegates"| node_catalogue
node_controllers -->|"delegates"| node_booking
node_controllers -->|"delegates"| node_payments
node_controllers -->|"returns errors"| node_errors
node_auth -->|"accesses data"| node_repositories
node_catalogue -->|"accesses data"| node_repositories
node_booking -->|"accesses data"| node_repositories
node_payments -->|"accesses data"| node_repositories
node_repositories -->|"maps records"| node_entities
node_repositories -->|"persists data"| node_mysql
node_migrations -->|"manages schema"| node_mysql

click node_ui "https://github.com/irshadalam-dev/theatre-management-system/blob/main/src/main/resources/static/app.js"
click node_application "https://github.com/irshadalam-dev/theatre-management-system/blob/main/src/main/java/com/example/theatre/TheatreManagementApplication.java"
click node_controllers "https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/java/com/example/theatre/controller"
click node_security "https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/java/com/example/theatre/security"
click node_dto "https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/java/com/example/theatre/dto"
click node_errors "https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/java/com/example/theatre/exception"
click node_auth "https://github.com/irshadalam-dev/theatre-management-system/blob/main/src/main/java/com/example/theatre/service/AuthService.java"
click node_catalogue "https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/java/com/example/theatre/service"
click node_booking "https://github.com/irshadalam-dev/theatre-management-system/blob/main/src/main/java/com/example/theatre/service/BookingService.java"
click node_payments "https://github.com/irshadalam-dev/theatre-management-system/blob/main/src/main/java/com/example/theatre/service/PaymentService.java"
click node_entities "https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/java/com/example/theatre/entity"
click node_repositories "https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/java/com/example/theatre/repository"
click node_migrations "https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/resources/db/migration"

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_ui toneBlue
class node_application,node_controllers,node_security,node_dto,node_errors,node_mysql toneAmber
class node_auth,node_catalogue,node_booking,node_payments toneMint
class node_entities,node_repositories,node_migrations toneRose
class node_customer,node_admin toneIndigo
```

## Components

### Browser experience

- [Booking UI](https://github.com/irshadalam-dev/theatre-management-system/blob/main/src/main/resources/static/app.js): `src/main/resources/static/app.js`

### API and security

- [Spring Boot app](https://github.com/irshadalam-dev/theatre-management-system/blob/main/src/main/java/com/example/theatre/TheatreManagementApplication.java): `src/main/java/com/example/theatre/TheatreManagementApplication.java`
- [HTTP controllers](https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/java/com/example/theatre/controller): `src/main/java/com/example/theatre/controller`
- [JWT and roles](https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/java/com/example/theatre/security): `src/main/java/com/example/theatre/security`
- [API contracts](https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/java/com/example/theatre/dto): `src/main/java/com/example/theatre/dto`
- [API errors](https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/java/com/example/theatre/exception): `src/main/java/com/example/theatre/exception`

### Booking operations

- [Accounts](https://github.com/irshadalam-dev/theatre-management-system/blob/main/src/main/java/com/example/theatre/service/AuthService.java): `src/main/java/com/example/theatre/service/AuthService.java`
- [Theatre catalogue](https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/java/com/example/theatre/service): `src/main/java/com/example/theatre/service`
- [Seat bookings](https://github.com/irshadalam-dev/theatre-management-system/blob/main/src/main/java/com/example/theatre/service/BookingService.java): `src/main/java/com/example/theatre/service/BookingService.java`
- [Cash payments](https://github.com/irshadalam-dev/theatre-management-system/blob/main/src/main/java/com/example/theatre/service/PaymentService.java): `src/main/java/com/example/theatre/service/PaymentService.java`

### Persistence

- [Domain records](https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/java/com/example/theatre/entity): `src/main/java/com/example/theatre/entity`
- [Data access](https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/java/com/example/theatre/repository): `src/main/java/com/example/theatre/repository`
- [Schema migrations](https://github.com/irshadalam-dev/theatre-management-system/tree/main/src/main/resources/db/migration): `src/main/resources/db/migration`

### Other components

- **Customer**
- **Admin**
- **MySQL**

## Connections

- Customer → Booking UI: uses (evidence: `README.md`)
- Admin → Booking UI: uses (evidence: `README.md`)
- Booking UI → HTTP controllers: calls API (evidence: `src/main/resources/static/app.js`)
- Spring Boot app → Booking UI: serves (evidence: `README.md`)
- Spring Boot app → HTTP controllers: handles requests (evidence: `README.md`)
- HTTP controllers → JWT and roles: enforces access (evidence: `README.md`)
- HTTP controllers → API contracts: uses contracts (evidence: `README.md`)
- HTTP controllers → Accounts: delegates (evidence: `README.md`)
- HTTP controllers → Theatre catalogue: delegates (evidence: `README.md`)
- HTTP controllers → Seat bookings: delegates (evidence: `README.md`)
- HTTP controllers → Cash payments: delegates (evidence: `README.md`)
- HTTP controllers → API errors: returns errors (evidence: `README.md`)
- Accounts → Data access: accesses data (evidence: `README.md`)
- Theatre catalogue → Data access: accesses data (evidence: `README.md`)
- Seat bookings → Data access: accesses data (evidence: `README.md`)
- Cash payments → Data access: accesses data (evidence: `README.md`)
- Data access → Domain records: maps records (evidence: `README.md`)
- Data access → MySQL: persists data (evidence: `README.md`)
- Schema migrations → MySQL: manages schema (evidence: `README.md`)
