# alvinrhd/cinemark_management architecture

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

- Interactive diagram: https://gitdiagram.com/alvinrhd/cinemark_management
- Repository: https://github.com/alvinrhd/cinemark_management

## Overview

##### Project type and purpose
- Full-stack, PHP web application for internal administrative management of Cinemark’s cinema chain.
- Key features: user authentication, CRUD on movies/salas/usuarios, report generation (PDF, charts), seating management, video asset presentation.

##### File structure
- Top-level:
– auth/ : login/logout workflows (login.php, procesos_login.php, logout.php)
– config.php : DB credentials, global settings
– db/ : schema script.sql
– functions/ : business-logic functions (cargar_asientos, editar, eliminar, gestionar)
– pages/ : “controller–view” scripts (index, peliculas, salass, usuarios, ventas, generar_pdf, grafico, analisis_datos)
– assets/ : static front-end (CSS, images, videos)
– uploads/ : runtime file storage (e.g. user-uploaded files)
– index.php : main router/landing page
- Pattern: Monolithic MVC-style PHP with folders separating auth, business logic, views, and assets.

##### Extract insights from README
- Confirms internal admin system.
- No microservices or external APIs mentioned beyond typical PHP libraries (PDF generation, chart libraries).

##### Main components & interactions
a. Browser / Client (Admin UI)
– Loads HTML/CSS/JS from assets/ and pages/*.php
– Sends HTTP(S) requests (login, CRUD, report generation).
b. Web Server & PHP Application
– Apache/Nginx + PHP engine
– Routes requests via index.php or direct to pages/*.php and auth/*.php
– Calls functions in functions/*.php
– Reads config.php for DB connection
c. Database (MySQL/MariaDB)
– Defined by db/script.sql
– Stores users, movies, salas, ventas, seating, etc.
d. File Storage
– assets/ for static files
– uploads/ for dynamic user files (e.g., images, CSV imports)
e. Report/Chart Service (internal PHP libraries)
– pages/generar_pdf.php → PDF generator (e.g., TCPDF)
– pages/grafico.php → chart library (e.g., Chart.js)
f. External Dependencies (implicit)
– CSS/JS frameworks loaded locally under assets/css
– No third-party APIs or microservices evident.

##### Architectural patterns & principles
- Clear separation:
– Presentation (pages/, assets/)
– Business logic (functions/)
– Persistence (config.php → MySQL)
- Stateless HTTP requests with sessions for auth
- Modular PHP includes (require config.php + functions/*.php in pages)
- CRUD-oriented controllers in pages + processes in functions/

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client
    Browser["Client Browser (Admin UI)"]:::browser

    %% PHP Application
    subgraph "Web Server + PHP Application"
        direction TB
        Config["config.php"]:::config
        subgraph "Authentication Module"
            direction TB
            Login["auth/login.php"]:::auth
            ProcLogin["auth/procesos_login.php"]:::auth
            Logout["auth/logout.php"]:::auth
        end
        subgraph "Controller–View Scripts (pages/)"
            direction TB
            PageIndex["pages/index.php"]:::pages
            PagePeliculas["pages/peliculas.php"]:::pages
            PageSalas["pages/salas.php"]:::pages
            PageUsuarios["pages/usuarios.php"]:::pages
            PageVentas["pages/ventas.php"]:::pages
            PageAnalisis["pages/analisis_datos.php"]:::pages
            PageFunciones["pages/funciones.php"]:::pages
            PageStyle["pages/style.css"]:::pages
        end
        subgraph "Business Logic Functions"
            direction TB
            FuncCargar["functions/cargar_asientos.php"]:::func
            FuncEditar["functions/editar.php"]:::func
            FuncEliminar["functions/eliminar.php"]:::func
            FuncGestionar["functions/gestionar.php"]:::func
        end
        subgraph "Reporting Engines"
            direction TB
            PDFEngine["pages/generar_pdf.php"]:::report
            ChartEngine["pages/grafico.php"]:::report
        end
    end

    %% Database
    Database["MySQL Database\n(db/script.sql)"]:::db

    %% Static & Upload Storage
    subgraph "Static File Storage"
        direction TB
        Assets["assets/"]:::storage
        Uploads["uploads/"]:::storage
    end

    %% Connections
    Browser -->|"HTTP(S) request/response"| PageIndex
    Browser -->|"HTTP(S) request/response"| Login
    PageIndex -->|"includes config.php"| Config
    Login -->|"includes config.php"| Config
    PageIndex -->|"requires CRUD"| FuncGestionar
    PagePeliculas -->|"requires CRUD"| FuncGestionar
    PageSalas -->|"requires CRUD"| FuncGestionar
    PageUsuarios -->|"requires CRUD"| FuncGestionar
    PageVentas -->|"requires CRUD"| FuncGestionar
    PageAnalisis -->|"requires data"| FuncGestionar
    PageFunciones -->|"includes functions"| FuncGestionar
    FuncGestionar -->|"SQL queries"| Database
    FuncCargar -->|"SQL queries"| Database
    FuncEditar -->|"SQL queries"| Database
    FuncEliminar -->|"SQL queries"| Database
    ProcLogin -->|"SQL query"| Database
    Config -->|"DB credentials"| Database

    Browser -->|"request assets"| Assets
    Browser -->|"download/upload files"| Uploads

    Browser -->|"Download PDF"| PDFEngine
    Browser -->|"Display Chart"| ChartEngine
    PDFEngine -->|"uses config & functions"| Config
    ChartEngine -->|"uses config & functions"| Config

    %% Click Events
    click Browser "https://github.com/alvinrhd/cinemark_management/tree/main/assets/"
    click Assets "https://github.com/alvinrhd/cinemark_management/tree/main/assets/"
    click Uploads "https://github.com/alvinrhd/cinemark_management/tree/main/uploads/"
    click Config "https://github.com/alvinrhd/cinemark_management/blob/main/config.php"
    click Login "https://github.com/alvinrhd/cinemark_management/blob/main/auth/login.php"
    click ProcLogin "https://github.com/alvinrhd/cinemark_management/blob/main/auth/procesos_login.php"
    click Logout "https://github.com/alvinrhd/cinemark_management/blob/main/auth/logout.php"
    click FuncCargar "https://github.com/alvinrhd/cinemark_management/blob/main/functions/cargar_asientos.php"
    click FuncEditar "https://github.com/alvinrhd/cinemark_management/blob/main/functions/editar.php"
    click FuncEliminar "https://github.com/alvinrhd/cinemark_management/blob/main/functions/eliminar.php"
    click FuncGestionar "https://github.com/alvinrhd/cinemark_management/blob/main/functions/gestionar.php"
    click PageIndex "https://github.com/alvinrhd/cinemark_management/blob/main/pages/index.php"
    click PagePeliculas "https://github.com/alvinrhd/cinemark_management/blob/main/pages/peliculas.php"
    click PageSalas "https://github.com/alvinrhd/cinemark_management/blob/main/pages/salas.php"
    click PageUsuarios "https://github.com/alvinrhd/cinemark_management/blob/main/pages/usuarios.php"
    click PageVentas "https://github.com/alvinrhd/cinemark_management/blob/main/pages/ventas.php"
    click PageAnalisis "https://github.com/alvinrhd/cinemark_management/blob/main/pages/analisis_datos.php"
    click PageFunciones "https://github.com/alvinrhd/cinemark_management/blob/main/pages/funciones.php"
    click PageStyle "https://github.com/alvinrhd/cinemark_management/blob/main/pages/style.css"
    click PDFEngine "https://github.com/alvinrhd/cinemark_management/blob/main/pages/generar_pdf.php"
    click ChartEngine "https://github.com/alvinrhd/cinemark_management/blob/main/pages/grafico.php"
    click Database "https://github.com/alvinrhd/cinemark_management/blob/main/db/script.sql"

    %% Styles
    classDef browser fill:#c6dbef,stroke:#3182bd,color:#000
    classDef config fill:#e5f5e0,stroke:#31a354,color:#000
    classDef auth fill:#cb181d,stroke:#fb6a4a,color:#fff
    classDef pages fill:#6baed6,stroke:#08519c,color:#fff
    classDef func fill:#74c476,stroke:#238b45,color:#000
    classDef report fill:#969696,stroke:#636363,color:#fff,stroke-dasharray: 5 5
    classDef db fill:#fd8d3c,stroke:#d94801,color:#000
    classDef storage fill:#b2df8a,stroke:#33a02c,color:#000
```
