# denyspi/cinema-reservation architecture

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

- Interactive diagram: https://gitdiagram.com/denyspi/cinema-reservation
- Repository: https://github.com/denyspi/cinema-reservation

## Overview

This Spring application supports cinema discovery and seat reservations: users authenticate, browse movies and screenings, inspect seat availability, hold seats, and create or cancel bookings. The booking path combines short-lived Redis holds with persisted booking records; booking services publish events for reservation changes. Authentication and user lookup are separate supporting capabilities. The graph follows relationships visible in the sampled source or SOURCE INDEX; event consumers, WebSocket delivery, and unsampled infrastructure wiring are not expanded.

Main entry points: [`src/main/java/com/tonnom/cinema/booking/service/BookingService.java`](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/booking/service/BookingService.java) (Booking service), [`src/main/java/com/tonnom/cinema/booking/service/SeatAvaibilityService.java`](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/booking/service/SeatAvaibilityService.java) (Seat availability), [`src/main/java/com/tonnom/cinema/screening/service/ScreeningService.java`](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/screening/service/ScreeningService.java) (Screening service), [`src/main/java/com/tonnom/cinema/auth/service/AuthService.java`](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/auth/service/AuthService.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity"]
  node_auth_api["Auth API"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_token_service["Token service<br/>[TokenService.java]"]
  node_user_api["User API"]
  node_user_service["User service<br/>[UserService.java]"]
end

subgraph group_discovery["Cinema discovery"]
  node_movie_api["Movie API"]
  node_movie_service["Movie service<br/>[MovieService.java]"]
  node_screening_api["Screening API"]
  node_screening_service["Screening service"]
  node_hall_seats[("Hall seats<br/>[Seat.java]")]
end

subgraph group_reservation["Reservations"]
  node_seat_api["Seat hold API"]
  node_availability["Seat availability"]
  node_booking_api["Booking API"]
  node_booking_service["Booking service"]
  node_reservation_events["Reservation events"]
end

subgraph group_persistence["Persistence"]
  node_user_store[("User repository")]
  node_movie_store[("Movie repository")]
  node_screening_store[("Screening repository")]
  node_redis[("Hold state")]
  node_booking_store[("Booking records")]
  node_booking_seats[("Booked seats")]
end

node_customer(("Customer"))

node_customer -->|"authenticates"| node_auth_api
node_customer -->|"browses"| node_movie_api
node_customer -->|"chooses screening"| node_screening_api
node_customer -->|"holds seats"| node_seat_api
node_customer -->|"books seats"| node_booking_api
node_customer -->|"views profile"| node_user_api
node_auth_api -->|"delegates"| node_auth_service
node_auth_service -->|"reads and saves"| node_user_store
node_auth_service -->|"creates token"| node_token_service
node_user_api -->|"delegates"| node_user_service
node_user_service -->|"loads user"| node_user_store
node_movie_api -->|"delegates"| node_movie_service
node_movie_service -->|"queries"| node_movie_store
node_screening_api -->|"delegates"| node_screening_service
node_screening_service -->|"queries"| node_screening_store
node_screening_service -->|"loads seat map"| node_hall_seats
node_screening_service -->|"checks taken seats"| node_booking_seats
node_seat_api -->|"delegates"| node_availability
node_availability -->|"reads and writes holds"| node_redis
node_availability -->|"checks booked seats"| node_booking_seats
node_availability -->|"publishes hold events"| node_reservation_events
node_booking_api -->|"delegates"| node_booking_service
node_booking_service -->|"verifies holds"| node_availability
node_booking_service -->|"loads customer"| node_user_store
node_booking_service -->|"loads screening"| node_screening_store
node_booking_service -->|"loads selected seats"| node_hall_seats
node_booking_service -->|"saves and queries bookings"| node_booking_store
node_booking_service -->|"saves and queries seats"| node_booking_seats
node_booking_service -->|"publishes booking events"| node_reservation_events

click node_auth_api "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/auth/controller/AuthController.java"
click node_auth_service "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/auth/service/AuthService.java"
click node_token_service "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/auth/service/TokenService.java"
click node_user_api "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/user/controller/UserController.java"
click node_user_service "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/user/service/UserService.java"
click node_user_store "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/user/repository/UserRepository.java"
click node_movie_api "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/movie/controller/MovieController.java"
click node_movie_service "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/movie/service/MovieService.java"
click node_movie_store "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/movie/repository/MovieRepository.java"
click node_screening_api "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/screening/controller/ScreeningController.java"
click node_screening_service "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/screening/service/ScreeningService.java"
click node_screening_store "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/screening/repository/ScreeningRepository.java"
click node_hall_seats "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/hall/model/Seat.java"
click node_seat_api "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/booking/controller/SeatHoldController.java"
click node_availability "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/booking/service/SeatAvaibilityService.java"
click node_booking_api "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/booking/controller/BookingController.java"
click node_booking_service "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/booking/service/BookingService.java"
click node_booking_store "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/booking/repository/BookingRepository.java"
click node_booking_seats "https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/booking/repository/BookingSeatRepository.java"
click node_reservation_events "https://github.com/denyspi/cinema-reservation/tree/main/src/main/java/com/tonnom/cinema/booking/event"

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_api,node_auth_service,node_token_service,node_user_api,node_user_service toneBlue
class node_movie_api,node_movie_service,node_screening_api,node_screening_service,node_hall_seats toneAmber
class node_seat_api,node_availability,node_booking_api,node_booking_service,node_reservation_events toneMint
class node_user_store,node_movie_store,node_screening_store,node_redis,node_booking_store,node_booking_seats toneRose
class node_customer toneIndigo
```

## Components

### Identity

- [Auth API](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/auth/controller/AuthController.java): `src/main/java/com/tonnom/cinema/auth/controller/AuthController.java`
- [Authentication](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/auth/service/AuthService.java): `src/main/java/com/tonnom/cinema/auth/service/AuthService.java`
- [Token service](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/auth/service/TokenService.java): `src/main/java/com/tonnom/cinema/auth/service/TokenService.java`
- [User API](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/user/controller/UserController.java): `src/main/java/com/tonnom/cinema/user/controller/UserController.java`
- [User service](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/user/service/UserService.java): `src/main/java/com/tonnom/cinema/user/service/UserService.java`

### Cinema discovery

- [Movie API](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/movie/controller/MovieController.java): `src/main/java/com/tonnom/cinema/movie/controller/MovieController.java`
- [Movie service](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/movie/service/MovieService.java): `src/main/java/com/tonnom/cinema/movie/service/MovieService.java`
- [Screening API](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/screening/controller/ScreeningController.java): `src/main/java/com/tonnom/cinema/screening/controller/ScreeningController.java`
- [Screening service](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/screening/service/ScreeningService.java): `src/main/java/com/tonnom/cinema/screening/service/ScreeningService.java`
- [Hall seats](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/hall/model/Seat.java): `src/main/java/com/tonnom/cinema/hall/model/Seat.java`

### Reservations

- [Seat hold API](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/booking/controller/SeatHoldController.java): `src/main/java/com/tonnom/cinema/booking/controller/SeatHoldController.java`
- [Seat availability](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/booking/service/SeatAvaibilityService.java): `src/main/java/com/tonnom/cinema/booking/service/SeatAvaibilityService.java`
- [Booking API](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/booking/controller/BookingController.java): `src/main/java/com/tonnom/cinema/booking/controller/BookingController.java`
- [Booking service](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/booking/service/BookingService.java): `src/main/java/com/tonnom/cinema/booking/service/BookingService.java`
- [Reservation events](https://github.com/denyspi/cinema-reservation/tree/main/src/main/java/com/tonnom/cinema/booking/event): `src/main/java/com/tonnom/cinema/booking/event`

### Persistence

- [User repository](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/user/repository/UserRepository.java): `src/main/java/com/tonnom/cinema/user/repository/UserRepository.java`
- [Movie repository](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/movie/repository/MovieRepository.java): `src/main/java/com/tonnom/cinema/movie/repository/MovieRepository.java`
- [Screening repository](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/screening/repository/ScreeningRepository.java): `src/main/java/com/tonnom/cinema/screening/repository/ScreeningRepository.java`
- **Hold state**
- [Booking records](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/booking/repository/BookingRepository.java): `src/main/java/com/tonnom/cinema/booking/repository/BookingRepository.java`
- [Booked seats](https://github.com/denyspi/cinema-reservation/blob/main/src/main/java/com/tonnom/cinema/booking/repository/BookingSeatRepository.java): `src/main/java/com/tonnom/cinema/booking/repository/BookingSeatRepository.java`

### Other components

- **Customer**

## Connections

- Customer → Auth API: authenticates
- Customer → Movie API: browses
- Customer → Screening API: chooses screening
- Customer → Seat hold API: holds seats
- Customer → Booking API: books seats
- Customer → User API: views profile
- Auth API → Authentication: delegates (evidence: `src/main/java/com/tonnom/cinema/auth/controller/AuthController.java`)
- Authentication → User repository: reads and saves (evidence: `src/main/java/com/tonnom/cinema/auth/service/AuthService.java`)
- Authentication → Token service: creates token (evidence: `src/main/java/com/tonnom/cinema/auth/service/AuthService.java`)
- User API → User service: delegates (evidence: `src/main/java/com/tonnom/cinema/user/controller/UserController.java`)
- User service → User repository: loads user (evidence: `src/main/java/com/tonnom/cinema/user/service/UserService.java`)
- Movie API → Movie service: delegates (evidence: `src/main/java/com/tonnom/cinema/movie/controller/MovieController.java`)
- Movie service → Movie repository: queries (evidence: `src/main/java/com/tonnom/cinema/movie/service/MovieService.java`)
- Screening API → Screening service: delegates (evidence: `src/main/java/com/tonnom/cinema/screening/controller/ScreeningController.java`)
- Screening service → Screening repository: queries (evidence: `src/main/java/com/tonnom/cinema/screening/service/ScreeningService.java`)
- Screening service → Hall seats: loads seat map (evidence: `src/main/java/com/tonnom/cinema/screening/service/ScreeningService.java`)
- Screening service → Booked seats: checks taken seats (evidence: `src/main/java/com/tonnom/cinema/screening/service/ScreeningService.java`)
- Seat hold API → Seat availability: delegates (evidence: `src/main/java/com/tonnom/cinema/booking/controller/SeatHoldController.java`)
- Seat availability → Hold state: reads and writes holds (evidence: `src/main/java/com/tonnom/cinema/booking/service/SeatAvaibilityService.java`)
- Seat availability → Booked seats: checks booked seats (evidence: `src/main/java/com/tonnom/cinema/booking/service/SeatAvaibilityService.java`)
- Seat availability → Reservation events: publishes hold events (evidence: `src/main/java/com/tonnom/cinema/booking/service/SeatAvaibilityService.java`)
- Booking API → Booking service: delegates (evidence: `src/main/java/com/tonnom/cinema/booking/controller/BookingController.java`)
- Booking service → Seat availability: verifies holds (evidence: `src/main/java/com/tonnom/cinema/booking/service/BookingService.java`)
- Booking service → User repository: loads customer (evidence: `src/main/java/com/tonnom/cinema/booking/service/BookingService.java`)
- Booking service → Screening repository: loads screening (evidence: `src/main/java/com/tonnom/cinema/booking/service/BookingService.java`)
- Booking service → Hall seats: loads selected seats (evidence: `src/main/java/com/tonnom/cinema/booking/service/BookingService.java`)
- Booking service → Booking records: saves and queries bookings (evidence: `src/main/java/com/tonnom/cinema/booking/service/BookingService.java`)
- Booking service → Booked seats: saves and queries seats (evidence: `src/main/java/com/tonnom/cinema/booking/service/BookingService.java`)
- Booking service → Reservation events: publishes booking events (evidence: `src/main/java/com/tonnom/cinema/booking/service/BookingService.java`)
