# tin1508/movieticketsmanagementsystem architecture

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

- Interactive diagram: https://gitdiagram.com/tin1508/movieticketsmanagementsystem
- Repository: https://github.com/tin1508/movieticketsmanagementsystem

## Overview

##### Project Type and Purpose
- This is a full-stack web application called “MovieTicketsManagementSystem” composed of:
- A React/Vite-based SPA (“movie-login” folder) for user authentication, movie browsing, and admin dashboards.
- A Spring Boot microservice (“movie-service” folder) providing REST endpoints for authentication, user/genre/movie management, and file-storage.
- A relational database (DDL script in `ddl_Movie.sql`) and a filesystem directory (`uploads/movies/posters`) for storing movie poster images.

##### Architectural Analysis
- Top-level directories:
- `movie-login`: Front-end app structured by components, pages, services, context.
- `movie-service`: Back-end service using Spring Boot with layered packages (config, controller, service, repository, entity, dto, mapper, specification).
- `uploads`: File storage for uploaded movie posters.
- Key patterns:
- Front-end: Component-based SPA with context for auth, protected routes, and a service layer for HTTP calls.
- Back-end: Classic layered MVC + Service + Repository architecture with JWT security and file storage.
- Deployment files:
- `vite.config.js`, `package.json` for front-end build.
- `pom.xml`, Maven wrapper, `application.yaml` for back-end.
- `ddl_Movie.sql` for database schema.

a. Front-end (React SPA)
– Hosted on a CDN or web server (e.g., Nginx)
– Routes: /login, /register, /dashboard, /movies, etc.
– Services: authService, movieService, genreService, userService (HTTP clients)
b. Back-end (Spring Boot API)
– Controllers: AuthenticationController, MovieController, GenreController, UserController
– Services: AuthenticationService, MovieService, GenreService, UserService, FileStorageService
– Security: JWT filter/entry point, SecurityConfig
– Configuration: CORS (WebConfig), file-upload properties
c. Database
– Tables: users, movies, genres, invalidated_tokens, etc.
– SQL script: `ddl_Movie.sql`
d. File Storage
– Local folder `uploads/movies/posters`
– Managed by FileStorageService
e. Authentication Flow
– Clients send credentials → `/api/auth/login` → JWT in response → stored in client context → sent in `Authorization: Bearer` header for protected API calls
f. Data Flow
– User actions in UI → React services → REST calls → Spring Boot controllers → Service layer → Repository → Database or File Storage → Response back through layers to front-end

- User ↔︎ Browser (UI)
- UI → REST API endpoints
- API → Database (CRUD)
- API → File System (upload/download posters)
- UI ↔︎ Local Storage or Context (JWT tokens)
- Sequence: Login → Token issuance → Authorized requests → Data updates → UI state changes

##### Architectural Patterns & Principles
- Separation of concerns: UI layer, API layer, persistence, and file storage each in its own component.
- Layered architecture on back-end: Controller → Service → Repository.
- Stateless authentication via JWT.
- SPA with client-side routing and protected routes.
- Configuration-driven (YAML, Vite config) and environment isolation.

##### Detail Level
- Be as granular as necessary: show individual services if needed (e.g., FileStorageService vs MovieService).
- Endpoints and data-flow paths that are critical for understanding system behavior.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Actors
    User((User)):::actor

    %% Front-end
    subgraph "Front-end (React/Vite)" 
        direction TB
        UI["Browser UI"]:::frontend
        AuthCtx["AuthContext"]:::frontend
        ProtRoute["ProtectedRoute"]:::frontend
        subgraph "Services"
            direction TB
            AuthService["authService"]:::frontend
            MovieServiceFE["movieService"]:::frontend
            GenreService["genreService"]:::frontend
            UserServiceFE["userService"]:::frontend
        end
        subgraph "Pages & Components"
            direction TB
            LoginForm["LoginForm"]:::frontend
            RegisterForm["RegisterForm"]:::frontend
            Dashboard["Dashboard"]:::frontend
            MovieListPage["MovieListPage"]:::frontend
            UserListPage["UserListPage"]:::frontend
        end
    end

    %% Back-end
    subgraph "Back-end (Spring Boot API)" 
        direction TB
        subgraph "Configuration"
            direction TB
            AppInit["ApplicationInitConfig"]:::backend
            FileProps["FileStorageProperties"]:::backend
            WebCfg["WebConfig"]:::backend
            SecurityCfg["SecurityConfig"]:::security
            JwtEntry["JwtAuthenticationEntryPoint"]:::security
        end
        subgraph "Controllers"
            direction TB
            AuthCtrl["AuthenticationController"]:::backend
            MovieCtrl["MovieController"]:::backend
            GenreCtrl["GenreController"]:::backend
            UserCtrl["UserController"]:::backend
        end
        subgraph "Services"
            direction TB
            AuthServiceBE["AuthenticationService"]:::backend
            MovieServiceBE["MovieService"]:::backend
            GenreServiceBE["GenreService"]:::backend
            UserServiceBE["UserService"]:::backend
            FileStorageSrv["FileStorageService"]:::backend
        end
        subgraph "Persistence"
            direction TB
            Entities["Entities (User, Movie, Genre, InvalidatedToken)"]:::backend
            Repos["Repositories"]:::backend
        end
        subgraph "Other"
            DTOs["DTOs"]:::backend
            Mappers["Mappers"]:::backend
            Specs["MovieSpecification"]:::backend
        end
    end

    %% Data Stores
    DB[(Relational Database)]:::datastore
    FS[(File Storage: uploads/movies/posters)]:::datastore

    %% Connections
    User -->|interacts with| UI
    UI -->|uses AuthContext| AuthCtx
    UI -->|uses ProtectedRoute| ProtRoute
    UI -->|calls| AuthService
    UI -->|calls| MovieServiceFE
    AuthService -->|POST /api/auth/login| AuthCtrl
    MovieServiceFE -->|GET /api/movies| MovieCtrl
    GenreService -->|GET /api/genres| GenreCtrl
    UserServiceFE -->|GET /api/users| UserCtrl

    AuthCtrl -->|delegates to| AuthServiceBE
    MovieCtrl -->|delegates to| MovieServiceBE
    GenreCtrl -->|delegates to| GenreServiceBE
    UserCtrl -->|delegates to| UserServiceBE
    FileStorageSrv -->|stores files in| FS

    AuthServiceBE -->|reads/writes| Repos
    MovieServiceBE -->|reads/writes| Repos
    GenreServiceBE -->|reads/writes| Repos
    UserServiceBE -->|reads/writes| Repos

    Repos -->|CRUD| DB
    FileStorageSrv -->|writes/reads| FS

    %% Click Events Front-end
    click UI "https://github.com/tin1508/movieticketsmanagementsystem/tree/main/movie-login/"
    click AuthCtx "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-login/src/context/AuthContext.jsx"
    click ProtRoute "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-login/src/components/common/ProtectedRoute.jsx"
    click AuthService "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-login/src/services/authService.jsx"
    click MovieServiceFE "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-login/src/services/movieService.jsx"
    click GenreService "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-login/src/services/genreService.jsx"
    click UserServiceFE "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-login/src/services/userService.jsx"
    click LoginForm "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-login/src/components/auth/LoginForm.jsx"
    click RegisterForm "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-login/src/components/auth/RegisterForm.jsx"
    click Dashboard "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-login/src/pages/Dashboard.jsx"
    click MovieListPage "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-login/src/pages/MovieListPage.jsx"
    click UserListPage "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-login/src/pages/UserListPage.jsx"
    click UI "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-login/vite.config.js"
    click UI "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-login/package.json"

    %% Click Events Back-end
    click AppInit "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-service/src/main/java/com/moviebooking/movie_service/config/ApplicationInitConfig.java"
    click FileProps "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-service/src/main/java/com/moviebooking/movie_service/config/FileStorageProperties.java"
    click WebCfg "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-service/src/main/java/com/moviebooking/movie_service/config/WebConfig.java"
    click SecurityCfg "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-service/src/main/java/com/moviebooking/movie_service/config/SecurityConfig.java"
    click JwtEntry "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-service/src/main/java/com/moviebooking/movie_service/config/JwtAuthenticationEntryPoint.java"
    click AuthCtrl "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-service/src/main/java/com/moviebooking/movie_service/controller/AuthenticationController.java"
    click MovieCtrl "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-service/src/main/java/com/moviebooking/movie_service/controller/MovieController.java"
    click GenreCtrl "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-service/src/main/java/com/moviebooking/movie_service/controller/GenreController.java"
    click UserCtrl "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-service/src/main/java/com/moviebooking/movie_service/controller/UserController.java"
    click AuthServiceBE "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-service/src/main/java/com/moviebooking/movie_service/service/AuthenticationService.java"
    click MovieServiceBE "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-service/src/main/java/com/moviebooking/movie_service/service/MovieService.java"
    click GenreServiceBE "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-service/src/main/java/com/moviebooking/movie_service/service/GenreService.java"
    click UserServiceBE "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-service/src/main/java/com/moviebooking/movie_service/service/UserService.java"
    click FileStorageSrv "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-service/src/main/java/com/moviebooking/movie_service/service/FileStorageService.java"
    click Entities "https://github.com/tin1508/movieticketsmanagementsystem/tree/main/movie-service/src/main/java/com/moviebooking/movie_service/entity"
    click Repos "https://github.com/tin1508/movieticketsmanagementsystem/tree/main/movie-service/src/main/java/com/moviebooking/movie_service/repository"
    click DTOs "https://github.com/tin1508/movieticketsmanagementsystem/tree/main/movie-service/src/main/java/com/moviebooking/movie_service/dto"
    click Mappers "https://github.com/tin1508/movieticketsmanagementsystem/tree/main/movie-service/src/main/java/com/moviebooking/movie_service/mapper"
    click Specs "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/movie-service/src/main/java/com/moviebooking/movie_service/specification/MovieSpecification.java"
    click DB "https://github.com/tin1508/movieticketsmanagementsystem/blob/main/ddl_Movie.sql"
    click FS "https://github.com/tin1508/movieticketsmanagementsystem/tree/main/uploads/movies/posters"

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef backend fill:#d4edda,stroke:#333,stroke-width:1px
    classDef datastore fill:#fff3cd,stroke:#333,stroke-width:1px
    classDef security fill:#e2d6f3,stroke:#333,stroke-width:1px
    classDef actor fill:#e2e3e5,stroke:#333,stroke-width:1px
```
