# proyectoscopersonales/movie-reservation-system-solutions architecture

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

- Interactive diagram: https://gitdiagram.com/proyectoscopersonales/movie-reservation-system-solutions
- Repository: https://github.com/proyectoscopersonales/movie-reservation-system-solutions

## Overview

##### Project Type and Purpose
- This is a full-stack web application (“Sistema de Reserva de un Cine”) composed of:
a) A Java/Spring Boot backend providing a REST API (business logic, security, data persistence)
b) A static frontend built with plain HTML/CSS/JavaScript that consumes the API
c) A PostgreSQL database for data storage
- Purpose: allow users (USER, ADMIN) to register/login (JWT-based), browse movies and showtimes, make/track reservations; admins manage movies, showtimes, halls, users.

##### High-Level File Structure Analysis
- BackendCine/
- mvnw, pom.xml → Maven wrapper and project definition
- src/main/java/com/jordancode/plataformacine/…
– Auth (AuthController, AuthService, DTOs)
– Config (ApplicationConfig, SecurityConfig)
– Jwt (filter, service)
– Controller (MovieController, ReservationController, etc.)
– Service (MovieService, ReservationService, etc.)
– Repository (Spring Data JPA interfaces)
– Entity (Movie, Horario, Reservation, Salas, User, Role)
- src/main/resources/application.properties → DB and security settings
- FrontendCine/
– View/<Feature>/… HTML/CSS/JS per page (Login, Dashboard, MovieForm, etc.)
– Reservation/… standalone reservation page

##### Key README Insights
- Spring Security with Bcrypt password hashing and JWT for stateless auth
- Two roles: USER (view/buy seats) and ADMIN (CRUD on movies, halls, showtimes, users)
- Exposed REST endpoints under /auth, /user/*, /admin/*
- PostgreSQL backing store

a. Main Components
1) Web Browser (User’s UI)
2) Frontend Static Files (HTML/CSS/JS)
3) Spring Boot Application (API)
– Security Layer (JWTAuthenticationFilter, SecurityConfig)
– Controllers (AuthController, MovieController, etc.)
– Service Layer (AuthService, MovieService, etc.)
– Repository Layer (Spring Data JPA)
4) PostgreSQL Database
5) External JWT Provider (internal library com.jordancode.plataformacine.Jwt)
b. Interactions & Data Flows
- Browser → HTTP(S) → Frontend HTML/JS
- JS (fetch/AJAX) → REST API (/auth/login, /user/movie, /admin/movie, etc.)
- Security filter intercepts → validates JWT → populates SecurityContext
- Controller invokes Service → uses Repository → queries/updates DB
- DB returns result → Service → Controller → JSON → Browser
c. Architectural Patterns
- Layered (Controller → Service → Repository)
- Stateless authentication using JWT
- Role-based access control (USER vs ADMIN)
d. Key Technologies/Libs
- Spring Boot (REST API, DI, auto-configuration)
- Spring Security + JWT for auth
- Spring Data JPA + Hibernate
- Maven build
- PostgreSQL
- Vanilla JS frontend

– Inside, at the top edge, show “JWT Auth Filter (JwtAuthenticationFilter)” and “SecurityConfig.”
– Beneath, group Controllers (AuthController, MovieController, etc.) in one layer.
– Under that, group Services (AuthService, MovieService, etc.).
– Under that, group Repositories.
– Browser → Static Frontend → API/AuthController (POST /auth/login) → JWTFilter → AuthService → UserRepository → DB
– Post-login: Browser stores JWT → attaches to /user/movie etc. calls
– Controller → Service → Repository → DB → back up to Controller → Browser

## Diagram (Mermaid)

```mermaid
graph TB
    %% Frontend Tier
    subgraph "Frontend Tier"
        direction TB
        Browser["Web Browser UI"]:::frontend
        Static["Static Frontend Files\n(HTML/CSS/JS)"]:::frontend
    end

    Browser -->|"loads"| Static
    Static -->|"AJAX/Fetch"| AuthController
    Static -->|"AJAX/Fetch"| MovieUserController
    Static -->|"AJAX/Fetch"| ReservationUserController

    %% Backend Tier
    subgraph "Backend Tier"
        direction TB
        subgraph "API Security Layer"
            direction TB
            JWTFilter["JwtAuthenticationFilter"]:::security
            SecurityCfg["SecurityConfig"]:::security
        end

        subgraph "Controllers"
            direction TB
            AuthController["AuthController\nPOST /auth/login, /auth/register"]:::controller
            MovieController["MovieController (ADMIN)\n/admin/movie"]:::controller
            MovieUserController["MovieUserController (USER)\n/user/movie"]:::controller
            ReservationController["ReservationController (ADMIN)\n/admin/reservation"]:::controller
            ReservationUserController["ReservationUserController (USER)\n/user/reservation"]:::controller
            SalasController["SalasController (ADMIN)\n/admin/salas"]:::controller
            HorarioController["HorarioController (ADMIN)\n/admin/horario"]:::controller
            UserController["UserController (ADMIN)\n/admin/user"]:::controller
        end

        subgraph "Services"
            direction TB
            AuthService["AuthService"]:::service
            MovieService["MovieService"]:::service
            ReservationService["ReservationService"]:::service
            SalasService["SalasService"]:::service
            HorarioService["HorarioService"]:::service
            UserService["UserService"]:::service
            JwtService["JwtService"]:::service
        end

        subgraph "Repositories"
            direction TB
            MovieRepo["MovieRepository"]:::repo
            ReservationRepo["ReservationRepository"]:::repo
            SalasRepo["SalasRepository"]:::repo
            HorarioRepo["HorarioRepository"]:::repo
            UserRepo["UserRepository"]:::repo
        end
    end

    %% Database
    DB[(PostgreSQL Database)]:::database

    %% Flows
    Static -->|"POST /auth/login"| JWTFilter
    JWTFilter -->|validates JWT| AuthService
    AuthService -->|uses| UserRepo
    UserRepo -->|query/insert| DB
    AuthService -->|issue token| JwtService
    JwtService -->|returns JWT| JWTFilter
    JWTFilter -->|populates SecurityContext| AuthController

    AuthController -->|calls| AuthService

    MovieController -->|calls| MovieService
    MovieService -->|calls| MovieRepo
    MovieRepo -->|accesses| DB

    MovieUserController -->|calls| MovieService
    ReservationController -->|calls| ReservationService
    ReservationUserController -->|calls| ReservationService
    ReservationService -->|calls| ReservationRepo
    ReservationRepo -->|accesses| DB

    SalasController -->|calls| SalasService
    SalasService -->|calls| SalasRepo
    SalasRepo -->|accesses| DB

    HorarioController -->|calls| HorarioService
    HorarioService -->|calls| HorarioRepo
    HorarioRepo -->|accesses| DB

    UserController -->|calls| UserService
    UserService -->|calls| UserRepo

    %% Component Entry & Config
    Entry["PlataformacineApplication\n(Spring Boot Entry)"]:::entry --> SecurityCfg
    SecurityCfg --> JWTFilter
    SecurityCfg --> ApplicationCfg["ApplicationConfig"]:::config
    ApplicationCfg -->|defines Bean| AuthService
    ApplicationCfg -->|defines Bean| PasswordEncoder
    ApplicationCfg -->|defines Bean| AuthenticationManager

    %% Click Events
    click Entry "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/PlataformacineApplication.java"
    click SecurityCfg "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/Config/SecurityConfig.java"
    click ApplicationCfg "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/Config/ApplicationConfig.java"
    click JWTFilter "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/Jwt/JwtAuthenticationFilter.java"
    click JwtService "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/Jwt/JwtService.java"
    click AuthController "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/Auth/AuthController.java"
    click AuthService "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/Auth/AuthService.java"
    click MovieController "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/controller/MovieController.java"
    click MovieUserController "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/controller/MovieUserController.java"
    click ReservationController "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/controller/ReservationController.java"
    click ReservationUserController "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/controller/ReservationUserController.java"
    click SalasController "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/controller/SalasController.java"
    click HorarioController "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/controller/HorarioController.java"
    click UserController "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/controller/UserController.java"
    click MovieService "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/service/MovieService.java"
    click ReservationService "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/service/ReservationService.java"
    click SalasService "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/service/SalasService.java"
    click HorarioService "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/service/HorarioService.java"
    click UserService "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/User/UserService.java"
    click MovieRepo "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/repository/MovieRepository.java"
    click ReservationRepo "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/repository/ReservationRepository.java"
    click SalasRepo "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/repository/SalasRepository.java"
    click HorarioRepo "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/repository/HorarioRepository.java"
    click UserRepo "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/java/com/jordancode/plataformacine/User/UserRepository.java"
    click DB "https://github.com/proyectoscopersonales/movie-reservation-system-solutions/blob/main/BackendCine/src/main/resources/application.properties"

    %% Styles
    classDef frontend fill:#BBDEFB,stroke:#0D47A1,color:#0D47A1;
    classDef security fill:#C8E6C9,stroke:#2E7D32,color:#2E7D32;
    classDef controller fill:#FFF9C4,stroke:#F9A825,color:#F57F17;
    classDef service fill:#FFECB3,stroke:#FF8F00,color:#E65100;
    classDef repo fill:#FFE0B2,stroke:#EF6C00,color:#E65100;
    classDef database fill:#E1BEE7,stroke:#6A1B9A,color:#4A148C,shape:cylinder;
    classDef entry fill:#CFD8DC,stroke:#455A64,color:#263238;
    classDef config fill:#B2DFDB,stroke:#00897B,color:#004D40;
```
