# kouniakioskatakthths/uniwa-ecommerce architecture

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

- Interactive diagram: https://gitdiagram.com/kouniakioskatakthths/uniwa-ecommerce
- Repository: https://github.com/kouniakioskatakthths/uniwa-ecommerce

## Overview

Cinema Reservation System is a Laravel web application for browsing films and screenings, reserving seats, and presenting QR-coded tickets. Its main user journey moves from movie/showtime discovery through seat selection and booking to ticket display; authenticated users can also manage reservation history. A separate staff/admin back office manages catalog and screenings, while TMDB supports movie import and rating refresh. The tree and excerpts establish the domain models and TMDB integration, but ticket-controller and route wiring were not sampled, so workflow links rely on README statements; other uncertain connections are omitted.

Main entry points: [`app/Http/Controllers/DashboardController.php`](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/DashboardController.php) (Admin panel), [`app/Http/Controllers/MovieController.php`](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/MovieController.php) (Movie management), [`app/Http/Controllers/TicketController.php`](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/TicketController.php) (Ticket booking), [`app/Services/TmdbMovieImporter.php`](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Services/TmdbMovieImporter.php) (TMDB importer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Film discovery"]
  node_movie_browse["Movie browsing<br/>[HomeController.php]"]
  node_now_playing["Now playing"]
  node_movie_detail["Movie details"]
  node_movie_data[("Movie records<br/>[Movie.php]")]
end

subgraph group_booking["Reservations"]
  node_showtime_data[("Showtime records<br/>[Showtime.php]")]
  node_seat_selection["Seat selection"]
  node_ticket_flow["Ticket booking"]
  node_ticket_data[("Ticket records<br/>[Ticket.php]")]
  node_ticket_display["QR ticket"]
  node_ticket_status["Ticket status<br/>[TicketStatus.php]"]
end

subgraph group_operations["Staff operations"]
  node_showtime_flow["Showtime management"]
  node_dashboard["Admin panel"]
  node_movie_admin["Movie management"]
  node_user_admin["User management"]
end

subgraph group_identity["Identity"]
  node_signup["Registration"]
  node_login["Login"]
  node_user_data[("User records<br/>[User.php]")]
  node_user_role["User roles<br/>[UserRole.php]"]
end

subgraph group_catalog["Catalog integration"]
  node_tmdb_importer["TMDB importer"]
  node_tmdb_service{{"TMDB API"}}
  node_tmdb_lookup_ui["TMDB lookup UI<br/>[tmdb_lookup.js]"]
  node_movie_genre["Movie genres<br/>[MovieGenre.php]"]
  node_movie_rating["Movie ratings<br/>[MovieRating.php]"]
end

node_patron(("Cinema patron"))

node_patron -->|"browses"| node_movie_browse
node_patron -->|"explores"| node_now_playing
node_movie_browse -.->|"opens film"| node_movie_detail
node_movie_detail -->|"shows schedules"| node_showtime_data
node_patron -->|"chooses seats"| node_seat_selection
node_seat_selection -->|"submits booking"| node_ticket_flow
node_ticket_flow -->|"creates ticket"| node_ticket_data
node_ticket_flow -->|"generates QR"| node_ticket_display
node_patron -->|"registers"| node_signup
node_signup -->|"creates user"| node_user_data
node_patron -->|"authenticates"| node_login
node_patron -->|"manages cinema"| node_dashboard
node_dashboard -->|"manages catalog"| node_movie_admin
node_dashboard -->|"manages screenings"| node_showtime_flow
node_dashboard -->|"manages users"| node_user_admin
node_movie_admin -->|"creates and updates"| node_movie_data
node_movie_admin -->|"requests import"| node_tmdb_importer
node_tmdb_importer -->|"fetches metadata"| node_tmdb_service
node_tmdb_importer -->|"updates ratings"| node_movie_data
node_tmdb_lookup_ui -.->|"supports lookup"| node_movie_admin
node_movie_data -->|"has screenings"| node_showtime_data
node_showtime_data -->|"has tickets"| node_ticket_data
node_user_data -->|"has reservations"| node_ticket_data

click node_movie_browse "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/HomeController.php"
click node_now_playing "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/NowPlayingController.php"
click node_movie_detail "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/MovieController.php"
click node_movie_data "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Models/Movie.php"
click node_showtime_flow "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/ShowtimeController.php"
click node_showtime_data "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Models/Showtime.php"
click node_seat_selection "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/resources/views/components/seats-viewer.blade.php"
click node_ticket_flow "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/TicketController.php"
click node_ticket_data "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Models/Ticket.php"
click node_ticket_display "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/resources/views/tickets/show-ticket.blade.php"
click node_dashboard "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/DashboardController.php"
click node_movie_admin "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/MovieController.php"
click node_user_admin "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/ProfileController.php"
click node_signup "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/Auth/RegisteredUserController.php"
click node_login "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/Auth/AuthenticatedSessionController.php"
click node_user_data "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Models/User.php"
click node_tmdb_importer "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Services/TmdbMovieImporter.php"
click node_tmdb_lookup_ui "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/resources/js/tmdb_lookup.js"
click node_movie_genre "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Enums/MovieGenre.php"
click node_movie_rating "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Enums/MovieRating.php"
click node_ticket_status "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Enums/TicketStatus.php"
click node_user_role "https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Enums/UserRole.php"

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_movie_browse,node_now_playing,node_movie_detail,node_movie_data toneBlue
class node_showtime_data,node_seat_selection,node_ticket_flow,node_ticket_data,node_ticket_display,node_ticket_status toneAmber
class node_showtime_flow,node_dashboard,node_movie_admin,node_user_admin toneMint
class node_signup,node_login,node_user_data,node_user_role toneRose
class node_tmdb_importer,node_tmdb_service,node_tmdb_lookup_ui,node_movie_genre,node_movie_rating,node_patron toneIndigo
```

## Components

### Film discovery

- [Movie browsing](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/HomeController.php): `app/Http/Controllers/HomeController.php`
- [Now playing](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/NowPlayingController.php): `app/Http/Controllers/NowPlayingController.php`
- [Movie details](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/MovieController.php): `app/Http/Controllers/MovieController.php`
- [Movie records](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Models/Movie.php): `app/Models/Movie.php`

### Reservations

- [Showtime records](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Models/Showtime.php): `app/Models/Showtime.php`
- [Seat selection](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/resources/views/components/seats-viewer.blade.php): `resources/views/components/seats-viewer.blade.php`
- [Ticket booking](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/TicketController.php): `app/Http/Controllers/TicketController.php`
- [Ticket records](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Models/Ticket.php): `app/Models/Ticket.php`
- [QR ticket](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/resources/views/tickets/show-ticket.blade.php): `resources/views/tickets/show-ticket.blade.php`
- [Ticket status](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Enums/TicketStatus.php): `app/Enums/TicketStatus.php`

### Staff operations

- [Showtime management](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/ShowtimeController.php): `app/Http/Controllers/ShowtimeController.php`
- [Admin panel](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`
- [Movie management](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/MovieController.php): `app/Http/Controllers/MovieController.php`
- [User management](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/ProfileController.php): `app/Http/Controllers/ProfileController.php`

### Identity

- [Registration](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/Auth/RegisteredUserController.php): `app/Http/Controllers/Auth/RegisteredUserController.php`
- [Login](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Http/Controllers/Auth/AuthenticatedSessionController.php): `app/Http/Controllers/Auth/AuthenticatedSessionController.php`
- [User records](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Models/User.php): `app/Models/User.php`
- [User roles](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Enums/UserRole.php): `app/Enums/UserRole.php`

### Catalog integration

- [TMDB importer](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Services/TmdbMovieImporter.php): `app/Services/TmdbMovieImporter.php`
- **TMDB API**
- [TMDB lookup UI](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/resources/js/tmdb_lookup.js): `resources/js/tmdb_lookup.js`
- [Movie genres](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Enums/MovieGenre.php): `app/Enums/MovieGenre.php`
- [Movie ratings](https://github.com/kouniakioskatakthths/uniwa-ecommerce/blob/master/app/Enums/MovieRating.php): `app/Enums/MovieRating.php`

### Other components

- **Cinema patron**

## Connections

- Cinema patron → Movie browsing: browses
- Cinema patron → Now playing: explores
- Movie browsing → Movie details: opens film
- Movie details → Showtime records: shows schedules
- Cinema patron → Seat selection: chooses seats
- Seat selection → Ticket booking: submits booking
- Ticket booking → Ticket records: creates ticket
- Ticket booking → QR ticket: generates QR
- Cinema patron → Registration: registers
- Registration → User records: creates user (evidence: `app/Http/Controllers/Auth/RegisteredUserController.php`)
- Cinema patron → Login: authenticates
- Cinema patron → Admin panel: manages cinema
- Admin panel → Movie management: manages catalog
- Admin panel → Showtime management: manages screenings
- Admin panel → User management: manages users
- Movie management → Movie records: creates and updates (evidence: `app/Http/Controllers/MovieController.php`)
- Movie management → TMDB importer: requests import (evidence: `app/Http/Controllers/MovieController.php`)
- TMDB importer → TMDB API: fetches metadata (evidence: `app/Services/TmdbMovieImporter.php`)
- TMDB importer → Movie records: updates ratings (evidence: `app/Services/TmdbMovieImporter.php`)
- TMDB lookup UI → Movie management: supports lookup
- Movie records → Showtime records: has screenings (evidence: `app/Models/Movie.php`)
- Showtime records → Ticket records: has tickets (evidence: `app/Models/Showtime.php`)
- User records → Ticket records: has reservations (evidence: `app/Models/User.php`)
