# sabarish-k-s/movie_booking_system architecture

> Architecture diagram of the GitHub repository sabarish-k-s/movie_booking_system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sabarish-k-s/movie_booking_system
- Repository: https://github.com/sabarish-k-s/movie_booking_system

## Overview

This repository is a Spring-based movie-booking project whose sampled runtime currently implements authentication: users register or log in, receive a JWT, and later requests can be authenticated from that token. The README provides no booking-flow details, and the tree contains no movie, showtime, or reservation modules, so those capabilities are not represented. The graph focuses on the evidenced auth path and supporting persistence and security; unsampled configuration is included only where the source index records its references.

Main entry points: [`Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/AuthService.java`](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/AuthService.java) (Auth Service), [`Booking-System/src/main/java/com/movie_booking/movie_booking_system/controller/AuthController.java`](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/controller/AuthController.java) (Auth Controller), [`Booking-System/src/main/java/com/movie_booking/movie_booking_system/repository/UserRepository.java`](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/repository/UserRepository.java) (User Repository), [`Booking-System/src/main/java/com/movie_booking/movie_booking_system/exception/GlobalExceptionHandler.java`](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/exception/GlobalExceptionHandler.java) (Exception Handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_auth_controller["Auth Controller"]
  node_register_dto["Registration Input<br/>[RegisterDTO.java]"]
  node_login_dto["Login Input<br/>[LoginDTO.java]"]
  node_auth_response["Auth Response"]
  node_exception_handler["Exception Handler"]
  node_error_response["Error Response"]
end

subgraph group_auth["Authentication"]
  node_auth_service["Auth Service<br/>[AuthService.java]"]
  node_email_exception["Duplicate Email Error"]
  node_invalid_exception["Invalid Credentials Error"]
end

subgraph group_security["Request Security"]
  node_jwt_service["JWT Service<br/>[JwtService.java]"]
  node_jwt_filter["JWT Filter<br/>[JwtFilter.java]"]
  node_security_config["Security Configuration"]
  node_user_details["User Details Service"]
end

subgraph group_data["User Persistence"]
  node_user_repository["User Repository"]
  node_user_entity["User Account<br/>[User.java]"]
  node_role_entity["User Role<br/>[Role.java]"]
  node_user_store[("User Database")]
end

node_client(("API Client"))

node_client -->|"sends auth requests"| node_auth_controller
node_auth_controller -->|"accepts registration"| node_register_dto
node_auth_controller -->|"accepts login"| node_login_dto
node_auth_controller -->|"delegates auth"| node_auth_service
node_auth_service -->|"returns token data"| node_auth_response
node_auth_controller -->|"returns response"| node_auth_response
node_auth_service -->|"checks and saves users"| node_user_repository
node_auth_service -->|"generates token"| node_jwt_service
node_auth_service -->|"throws on duplicate"| node_email_exception
node_auth_service -->|"throws on bad login"| node_invalid_exception
node_user_details -->|"loads account"| node_user_repository
node_jwt_filter -->|"extracts and validates"| node_jwt_service
node_jwt_filter -->|"loads token subject"| node_user_details
node_security_config -->|"configures filter"| node_jwt_filter
node_security_config -->|"configures user lookup"| node_user_details
node_user_repository -->|"persists accounts"| node_user_entity
node_user_entity -->|"stores role"| node_role_entity
node_user_repository -.->|"reads and writes"| node_user_store
node_exception_handler -->|"handles duplicate email"| node_email_exception
node_exception_handler -->|"handles bad credentials"| node_invalid_exception
node_exception_handler -->|"builds error response"| node_error_response

click node_auth_controller "https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/controller/AuthController.java"
click node_register_dto "https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/dto/RegisterDTO.java"
click node_login_dto "https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/dto/LoginDTO.java"
click node_auth_response "https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/dto/AuthResponseDTO.java"
click node_auth_service "https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/AuthService.java"
click node_email_exception "https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/exception/EmailAlreadyExistsException.java"
click node_invalid_exception "https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/exception/InvalidCredentialsException.java"
click node_exception_handler "https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/exception/GlobalExceptionHandler.java"
click node_error_response "https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/dto/ErrorResponseDTO.java"
click node_jwt_service "https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/JwtService.java"
click node_jwt_filter "https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/security/JwtFilter.java"
click node_security_config "https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/security/SecurityConfig.java"
click node_user_details "https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/CustomUserDetailsService.java"
click node_user_repository "https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/repository/UserRepository.java"
click node_user_entity "https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/entity/User.java"
click node_role_entity "https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/entity/Role.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_auth_controller,node_register_dto,node_login_dto,node_auth_response,node_exception_handler,node_error_response,node_client toneBlue
class node_auth_service,node_email_exception,node_invalid_exception toneAmber
class node_jwt_service,node_jwt_filter,node_security_config,node_user_details toneMint
class node_user_repository,node_user_entity,node_role_entity,node_user_store toneRose
```

## Components

### HTTP API

- [Auth Controller](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/controller/AuthController.java): `Booking-System/src/main/java/com/movie_booking/movie_booking_system/controller/AuthController.java`
- [Registration Input](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/dto/RegisterDTO.java): `Booking-System/src/main/java/com/movie_booking/movie_booking_system/dto/RegisterDTO.java`
- [Login Input](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/dto/LoginDTO.java): `Booking-System/src/main/java/com/movie_booking/movie_booking_system/dto/LoginDTO.java`
- [Auth Response](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/dto/AuthResponseDTO.java): `Booking-System/src/main/java/com/movie_booking/movie_booking_system/dto/AuthResponseDTO.java`
- [Exception Handler](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/exception/GlobalExceptionHandler.java): `Booking-System/src/main/java/com/movie_booking/movie_booking_system/exception/GlobalExceptionHandler.java`
- [Error Response](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/dto/ErrorResponseDTO.java): `Booking-System/src/main/java/com/movie_booking/movie_booking_system/dto/ErrorResponseDTO.java`

### Authentication

- [Auth Service](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/AuthService.java): `Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/AuthService.java`
- [Duplicate Email Error](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/exception/EmailAlreadyExistsException.java): `Booking-System/src/main/java/com/movie_booking/movie_booking_system/exception/EmailAlreadyExistsException.java`
- [Invalid Credentials Error](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/exception/InvalidCredentialsException.java): `Booking-System/src/main/java/com/movie_booking/movie_booking_system/exception/InvalidCredentialsException.java`

### Request Security

- [JWT Service](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/JwtService.java): `Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/JwtService.java`
- [JWT Filter](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/security/JwtFilter.java): `Booking-System/src/main/java/com/movie_booking/movie_booking_system/security/JwtFilter.java`
- [Security Configuration](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/security/SecurityConfig.java): `Booking-System/src/main/java/com/movie_booking/movie_booking_system/security/SecurityConfig.java`
- [User Details Service](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/CustomUserDetailsService.java): `Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/CustomUserDetailsService.java`

### User Persistence

- [User Repository](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/repository/UserRepository.java): `Booking-System/src/main/java/com/movie_booking/movie_booking_system/repository/UserRepository.java`
- [User Account](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/entity/User.java): `Booking-System/src/main/java/com/movie_booking/movie_booking_system/entity/User.java`
- [User Role](https://github.com/sabarish-k-s/movie_booking_system/blob/main/Booking-System/src/main/java/com/movie_booking/movie_booking_system/entity/Role.java): `Booking-System/src/main/java/com/movie_booking/movie_booking_system/entity/Role.java`
- **User Database**

### Other components

- **API Client**

## Connections

- API Client → Auth Controller: sends auth requests (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/controller/AuthController.java`)
- Auth Controller → Registration Input: accepts registration (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/controller/AuthController.java`)
- Auth Controller → Login Input: accepts login (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/controller/AuthController.java`)
- Auth Controller → Auth Service: delegates auth (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/controller/AuthController.java`)
- Auth Service → Auth Response: returns token data (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/AuthService.java`)
- Auth Controller → Auth Response: returns response (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/controller/AuthController.java`)
- Auth Service → User Repository: checks and saves users (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/AuthService.java`)
- Auth Service → JWT Service: generates token (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/AuthService.java`)
- Auth Service → Duplicate Email Error: throws on duplicate (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/AuthService.java`)
- Auth Service → Invalid Credentials Error: throws on bad login (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/AuthService.java`)
- User Details Service → User Repository: loads account (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/service/CustomUserDetailsService.java`)
- JWT Filter → JWT Service: extracts and validates (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/security/JwtFilter.java`)
- JWT Filter → User Details Service: loads token subject (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/security/JwtFilter.java`)
- Security Configuration → JWT Filter: configures filter (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/security/SecurityConfig.java`)
- Security Configuration → User Details Service: configures user lookup (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/security/SecurityConfig.java`)
- User Repository → User Account: persists accounts (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/repository/UserRepository.java`)
- User Account → User Role: stores role (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/entity/User.java`)
- User Repository → User Database: reads and writes
- Exception Handler → Duplicate Email Error: handles duplicate email (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/exception/GlobalExceptionHandler.java`)
- Exception Handler → Invalid Credentials Error: handles bad credentials (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/exception/GlobalExceptionHandler.java`)
- Exception Handler → Error Response: builds error response (evidence: `Booking-System/src/main/java/com/movie_booking/movie_booking_system/exception/GlobalExceptionHandler.java`)
