# honcito/hong_movies architecture

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

- Interactive diagram: https://gitdiagram.com/honcito/hong_movies
- Repository: https://github.com/honcito/hong_movies

## Overview

##### Project type and purpose
- This is primarily a backend service for a personal full-stack movie streaming platform (“HONG_MOVIES”).
- Purpose: expose REST endpoints for user authentication/authorization (role-based), user management, movie lookup (via TMDB API), and secure streaming of private video files hosted on an Ubuntu server.

##### File structure
- Top level:
- README.md, LICENSE, .gitignore
- backend/ (entire Node.js service)
- backend/
- package.json / package-lock.json – Node.js dependencies
- src/
– config/db.js – database connection (likely MongoDB)
– controllers/ – business-logic handlers (auth, user, movie)
– middlewares/ – auth checks, rate limiting, validation, error handling
– models/ – Mongoose schema definitions (User.js, Movie.js)
– routes/ – Express routers (authRoutes, userRoutes, movieRoutes)
– utils/ – JWT generation
– validation/ – request payload schemas
– server.js – Express app setup, middleware registration, route mounting
- No frontend folder in this repo; assume a separate client (web/mobile) consumes the API.

##### Key insights from README
- Role-based access (admin vs regular users)
- TMDB integration for movie metadata
- Private video streaming from an Ubuntu file store
- Multi-language UI + theme toggling (light/dark) – client-side concerns

##### Main components
a. Clients
– Web/Mobile App (React/Vue/Flutter): UI layer with routing, theme + language toggle
b. API Server (Node.js / Express)
– Route layer → Controller layer → Model layer
– Middlewares: auth JWT check, isAdmin guard, rate limiter, request validators, error handler
– Utils: JWT generator
c. Database
– MongoDB (hosted or Atlas) storing Users and Movies
d. External Services
– TMDB REST API for fresh movie metadata
e. Video Storage & Streaming
– Ubuntu server (NGINX or custom) hosting video files behind an auth proxy

##### Relationships & interactions
- Client sends HTTP(S) requests to API Gateway (Express server)
- AuthController issues JWTs; middleware protects movie/user routes
- MovieController fetches and caches metadata from TMDB, or reads from MongoDB
- When streaming, API either issues a signed URL or proxies the video request to the Ubuntu server
- All persistent reads/writes go to MongoDB
- RateLimiter middleware caps abusive request patterns

##### Architectural patterns & design principles
- Layered architecture (Routes → Controllers → Models)
- RESTful API design
- Middleware pipeline for cross-cutting concerns (auth, validation, errors)
- Single Responsibility: each controller handles one resource type
- Extensibility: external TMDB integration via a service adapter

##### Technologies & frameworks
- Node.js, Express.js
- MongoDB + Mongoose
- JSON Web Tokens (JWT)
- TMDB external REST service
- NGINX or custom streaming proxy on Ubuntu

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Compute Components
    Server["Express API Gateway"]:::compute

    %% Internal Server Structure
    subgraph "Routes"
        AuthRoutes["Auth Routes"]:::compute
        UserRoutes["User Routes"]:::compute
        MovieRoutes["Movie Routes"]:::compute
    end

    subgraph "Middlewares"
        Validation["Validation Middleware"]:::compute
        RateLimiter["Rate Limiter Middleware"]:::compute
        AuthMiddleware["Auth Middleware"]:::compute
        AdminGuard["Admin Guard Middleware"]:::compute
        ErrorHandler["Error Handler Middleware"]:::compute
    end

    subgraph "Controllers"
        AuthController["Authentication Controller"]:::compute
        UserController["User Controller"]:::compute
        MovieController["Movie Controller"]:::compute
    end

    subgraph "Models"
        UserModel["User Model"]:::data
        MovieModel["Movie Model"]:::data
    end

    subgraph "Utils"
        JWTUtil["JWT Utility"]:::compute
    end

    %% External Components
    TMDB["TMDB API"]:::external
    MongoDB["MongoDB"]:::data
    VideoServer["Video Storage Server"]:::data

    %% Connections (vertical flow)
    Server --> Validation
    Validation --> RateLimiter
    RateLimiter --> AuthMiddleware
    AuthMiddleware --> AdminGuard
    AdminGuard --> ErrorHandler
    ErrorHandler --> AuthRoutes
    ErrorHandler --> UserRoutes
    ErrorHandler --> MovieRoutes

    AuthRoutes --> AuthController
    UserRoutes --> UserController
    MovieRoutes --> MovieController

    AuthController --> JWTUtil
    AuthController --> MongoDB

    UserController --> UserModel
    UserController --> MongoDB

    MovieController --> MovieModel
    MovieController --> MongoDB
    MovieController --> TMDB
    MovieController --> VideoServer

    %% Click Events
    click Server "https://github.com/honcito/hong_movies/blob/main/backend/src/server.js"
    click DBConfig "https://github.com/honcito/hong_movies/blob/main/backend/src/config/db.js"
    click AuthController "https://github.com/honcito/hong_movies/blob/main/backend/src/controllers/authController.js"
    click UserController "https://github.com/honcito/hong_movies/blob/main/backend/src/controllers/userController.js"
    click MovieController "https://github.com/honcito/hong_movies/blob/main/backend/src/controllers/movieController.js"
    click AuthMiddleware "https://github.com/honcito/hong_movies/blob/main/backend/src/middlewares/auth.js"
    click AdminGuard "https://github.com/honcito/hong_movies/blob/main/backend/src/middlewares/isAdmin.js"
    click RateLimiter "https://github.com/honcito/hong_movies/blob/main/backend/src/middlewares/rateLimit.js"
    click Validation "https://github.com/honcito/hong_movies/blob/main/backend/src/middlewares/validateFields.js"
    click ErrorHandler "https://github.com/honcito/hong_movies/blob/main/backend/src/middlewares/errorHandler.js"
    click UserModel "https://github.com/honcito/hong_movies/blob/main/backend/src/models/User.js"
    click MovieModel "https://github.com/honcito/hong_movies/blob/main/backend/src/models/Movie.js"
    click AuthRoutes "https://github.com/honcito/hong_movies/blob/main/backend/src/routes/authRoutes.js"
    click UserRoutes "https://github.com/honcito/hong_movies/blob/main/backend/src/routes/userRoutes.js"
    click MovieRoutes "https://github.com/honcito/hong_movies/blob/main/backend/src/routes/movieRoutes.js"
    click JWTUtil "https://github.com/honcito/hong_movies/blob/main/backend/src/utils/generateJWT.js"
    click UserValidation "https://github.com/honcito/hong_movies/blob/main/backend/src/validation/userValidation.js"

    %% Styles
    classDef compute fill:#D0E8FF,stroke:#0366d6,stroke-width:1px
    classDef data fill:#DFFFD6,stroke:#22863a,stroke-width:1px
    classDef external fill:#FFE3B3,stroke:#d93f0b,stroke-width:1px
```
