# phuchau0310/movie-ticket-system architecture

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

- Interactive diagram: https://gitdiagram.com/phuchau0310/movie-ticket-system
- Repository: https://github.com/phuchau0310/movie-ticket-system

## Overview

##### Project Type and Purpose
- This is a full-stack desktop application:
- MovieTicketAPI (FastAPI-based REST backend)
- MovieTicketApp (C# Windows Forms frontend)
- Purpose: allow Admin/Staff/Customer to manage movies, book tickets (with VNPay), view recommendations (via Pinecone), and track purchase history.

##### File Structure
- Backend folder (MovieTicketAPI):
- app/main.py: entry point (uvicorn)
- app/routers/*.py: REST endpoints (movies, tickets, users, purchase_history, recommendations)
- app/models.py + database.py: SQLAlchemy models & DB session
- app/schemas.py: Pydantic request/response models
- app/utils: helper modules (vector_utils → Pinecone; vnpay_utils → payment integration)
- alembic/: DB migrations
- Dockerfile + docker-compose.yml: containerization
- Frontend folder (MovieTicketApp):
- Forms/: UI screens by role (AdminForm, AuthForm, CustomerForm)
- Models/: local data models mirroring API schemas
- Services/: ApiClient.cs + domain services (MovieService, TicketService, PaymentService, UserService)
- Utils/Config.cs: configuration (API base URL, keys)

##### Extract Key Architectural Insights from README
- Role-based access control
- Transactions: VNPay integration
- Recommendations: Pinecone vector similarity
- PostgreSQL as primary datastore
- Docker support for backend

##### Main Components
a. Frontend Desktop App
- UI Layer (Windows Forms)
- Client Service Layer (ApiClient + domain services)
b. Backend API
- FastAPI Application
- Router Layer (controllers)
- Service/Utility Layer (vector_utils, vnpay_utils)
- Data Access Layer (SQLAlchemy models + Alembic)
c. Database
- PostgreSQL instance
d. External Services
- Pinecone Vector DB
- VNPay Payment Gateway
e. Infrastructure

##### Relationships and Data Flows
- Desktop App → HTTP requests → FastAPI routers
- Auth (login/register)
- Movie CRUD (Admin)
- Ticket booking → vnpay_utils → VNPay
- Recommendation requests → vector_utils → Pinecone
- Purchase history retrieval
- FastAPI → SQLAlchemy → PostgreSQL
- Alembic applies migrations to PostgreSQL
- Optional: show Swagger UI for API docs

##### Architectural Patterns & Principles
- Layered architecture (Presentation → Controllers/Routers → Business Logic/Utils → Data Access)
- Separation of concerns: UI vs. networking vs. business logic
- Dependency injection for DB session in routers (via FastAPI)
- Externalized configuration (Docker, .env)

##### Essential Elements Checklist
- Frontend → Backend
- Backend → DB
- Backend → Pinecone / VNPay
- Container boundary for Docker if drawing deployment view

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Desktop App
    subgraph "Desktop App"
        UI["UI Layer (Windows Forms)"]:::frontend
        AuthForm["AuthForm"]:::frontend
        AdminForm["AdminForm"]:::frontend
        CustomerForm["CustomerForm"]:::frontend
        Models["Data Models"]:::frontend
        ApiClient["ApiClient"]:::frontend
        MovieService["MovieService"]:::frontend
        TicketService["TicketService"]:::frontend
        PaymentService["PaymentService"]:::frontend
        UserService["UserService"]:::frontend
        Config["Config"]:::frontend
    end

    %% Backend with Docker boundary
    subgraph "Backend (Docker)"
        Dockerfile["Dockerfile"]:::infra
        Compose["docker-compose.yml"]:::infra

        subgraph "FastAPI Application"
            main["main.py (Entry Point)"]:::backend

            subgraph "Routers"
                Movies["Movies Router"]:::backend
                Tickets["Tickets Router"]:::backend
                Users["Users Router"]:::backend
                PurchaseHistory["PurchaseHistory Router"]:::backend
                Recommendations["Recommendations Router"]:::backend
            end

            subgraph "Models & DB"
                SQLModels["SQLAlchemy Models"]:::backend
                DBSess["Database Session"]:::backend
                Schemas["Pydantic Schemas"]:::backend
                Alembic["Alembic Migrations"]:::backend
            end

            subgraph "Utils/Services"
                VectorUtils["vector_utils (Pinecone)"]:::backend
                VnPayUtils["vnpay_utils (VNPay)"]:::backend
            end
        end
    end

    %% Database and External Services
    DB["PostgreSQL"]:::db
    Pinecone["Pinecone Vector DB"]:::external
    VNPay["VNPay Gateway"]:::external

    %% Data Flows
    UI -->|"calls"| ApiClient
    AuthForm --> UI
    AdminForm --> UI
    CustomerForm --> UI
    ApiClient -->|"HTTP"| main
    MovieService --> ApiClient
    TicketService --> ApiClient
    PaymentService --> ApiClient
    UserService --> ApiClient

    main --> Movies
    main --> Tickets
    main --> Users
    main --> PurchaseHistory
    main --> Recommendations

    Movies --> SQLModels
    Tickets --> SQLModels
    Users --> SQLModels
    PurchaseHistory --> SQLModels
    Recommendations --> VectorUtils

    SQLModels --> DBSess
    DBSess --> DB
    Alembic -.->|"Schema Migrations"| DB

    VectorUtils --> Pinecone
    VnPayUtils --> VNPay
    Tickets --> VnPayUtils

    %% Click Events
    click UI "https://github.com/phuchau0310/movie-ticket-system/tree/main/MovieTicketApp/Forms"
    click AuthForm "https://github.com/phuchau0310/movie-ticket-system/tree/main/MovieTicketApp/Forms/AuthForm"
    click AdminForm "https://github.com/phuchau0310/movie-ticket-system/tree/main/MovieTicketApp/Forms/AdminForm"
    click CustomerForm "https://github.com/phuchau0310/movie-ticket-system/tree/main/MovieTicketApp/Forms/CustomerForm"
    click Models "https://github.com/phuchau0310/movie-ticket-system/tree/main/MovieTicketApp/Models"
    click ApiClient "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketApp/Services/ApiClient.cs"
    click MovieService "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketApp/Services/MovieService.cs"
    click TicketService "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketApp/Services/TicketService.cs"
    click PaymentService "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketApp/Services/PaymentService.cs"
    click UserService "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketApp/Services/UserService.cs"
    click Config "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketApp/Utils/Config.cs"
    click main "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketAPI/app/main.py"
    click Movies "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketAPI/app/routers/movies.py"
    click Tickets "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketAPI/app/routers/tickets.py"
    click Users "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketAPI/app/routers/users.py"
    click PurchaseHistory "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketAPI/app/routers/purchase_history.py"
    click Recommendations "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketAPI/app/routers/recommendations.py"
    click SQLModels "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketAPI/app/models.py"
    click DBSess "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketAPI/app/database.py"
    click Schemas "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketAPI/app/schemas.py"
    click VectorUtils "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketAPI/app/utils/vector_utils.py"
    click VnPayUtils "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketAPI/app/utils/vnpay_utils.py"
    click Alembic "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketAPI/alembic/env.py"
    click Dockerfile "https://github.com/phuchau0310/movie-ticket-system/tree/main/MovieTicketAPI/Dockerfile"
    click Compose "https://github.com/phuchau0310/movie-ticket-system/blob/main/MovieTicketAPI/docker-compose.yml"

    %% Styles
    classDef frontend fill:#DDA0DD,stroke:#800080,color:#000000
    classDef backend fill:#ADD8E6,stroke:#0000FF,color:#000000
    classDef db fill:#98FB98,stroke:#008000,color:#000000
    classDef external fill:#FFA500,stroke:#FF8C00,color:#000000
    classDef infra fill:#D3D3D3,stroke:#A9A9A9,color:#000000
```
