# ogonzalez-2021370/control-cine architecture

> Architecture diagram of the GitHub repository ogonzalez-2021370/control-cine, 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/ogonzalez-2021370/control-cine
- Repository: https://github.com/ogonzalez-2021370/control-cine

## Overview

##### Project Type and Purpose
- This is a standalone, Windows‐desktop full‐stack application (C++/CLI with Windows Forms) for managing all cinema operations: movies, rooms, assignments, clients, tickets, users and HTML report generation.
- Persistence is file‐based (CSV import/export). No external services or databases.

##### High‐Level Component Breakdown
A. Presentation Layer (UI)
- LoginForm – handles authentication and role selection (Administrator vs. Operator)
- CRUD forms (Form1, FormReportePeliculas, FormReporteSalas, FormReporteAsignaciones, etc.) – each module’s dialog panels for create/read/update/delete operations
- Report Forms – display HTML reports in embedded browser control or launch default browser

B. Business Logic Layer
- Domain Entities – classes: Pelicula, Sala, Asignacion, Cliente, Boleto, Usuario
- Managers/Controllers – “Array…” classes (e.g., ArrayPeliculas, ArrayClientes, …) implement in‐memory arrays, CRUD operations, validations, associations
- Security/Session Manager – user login, role permissions enforcement

C. Data Access Layer
- CSV Importer/Exporter – routines under “Cargar archivos .csv” folder that read/write domain data to files: Peliculas.csv, Salas.csv, AsigPeliculasSalas.csv, Clientes.csv, CompraBoleto.csv, Usuarios.csv
- Persistence Interface – a thin adapter between Array… managers and CSV routines

D. Reporting Module
- HTML Generator – transforms in‐memory data (via Array… managers) into HTML tables and writes “Reportes generados/*.html”

E. External/Support
- File System – CSV files, generated HTML reports
- Manuals (Technical/User) – PDF documents for reference

##### Relationships and Data Flow
- UI Forms → invoke Business Logic methods on Controllers/Managers
- Controllers operate on Domain Entities stored in Array… classes
- Controllers call Persistence Interface to load or save CSV files
- Reporting Module reads Domain data from Controllers, outputs HTML to disk
- LoginForm calls Security Manager → grants UI access based on role

##### Architectural Patterns & Principles
- Layered Architecture (Presentation → Business → Data)
- MVC‐like separation: Forms = View+Controller, Array… classes = Model
- Single Responsibility: each Array… class manages one entity type
- Composition & Association: Asignacion links Pelicula+Sala, Boleto references Cliente & Asignacion
- File‐based Repository Pattern: CSV adapter abstracts persistence

##### Essential Elements
- Clear labels for each component (e.g., “ArrayPeliculas Manager”, “Pelicula Entity”, “Peliculas.csv”)
- Annotations for user roles (Administrator vs. Operator) tied to LoginForm and UI visibility

##### Putting It All Together
[Tier 1: Presentation]
- LoginForm, Form1 (CRUD UIs), ReportForms
↓
[Tier 2: Business Logic]
- ArrayPeliculas, ArraySalas, ArrayAsignaciones, ArrayClientes, ArrayBoletos, ArrayUsuarios
- Pelicula, Sala, Asignacion, Cliente, Boleto, Usuario classes
- SecurityManager (role enforcement)
↓
[Tier 3: Data Access]
- CSVImporter/Exporter adapters
↓
[Tier 4: Storage]
- Peliculas.csv, Salas.csv, AsigPeliculasSalas.csv, Clientes.csv, CompraBoleto.csv, Usuarios.csv
- Reportes generados/*.html

- On startup: CSVImporter.loadAll() → Array… populate memory
- On CRUD: UIForm.call(ArrayManager.create/update/delete) → CSVExporter.save()
- Generate report: ReportForm.request() → ArrayManager.fetchData() → HTMLGenerator.write()

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer" 
        direction TB
        LoginForm["LoginForm «UI»"]:::ui
        Form1["Form1 «UI»"]:::ui
        subgraph "Report Forms"
            direction TB
            FRP["FormReportePeliculas «UI»"]:::ui
            FRC["FormReporteClientes «UI»"]:::ui
            FRA["ReporteAsignacionesForm «UI»"]:::ui
            FRB["ReporteBoletosForm «UI»"]:::ui
            FRS["ReporteSalasForm «UI»"]:::ui
            FRU["ReporteUsuariosForm «UI»"]:::ui
        end
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        direction TB
        SecurityManager["SecurityManager «Controller»"]:::controller
        subgraph "Managers"
            direction TB
            AP["ArrayPeliculas «Controller»"]:::controller
            AS["ArraySalas «Controller»"]:::controller
            AA["ArrayAsignaciones «Controller»"]:::controller
            AC["ArrayClientes «Controller»"]:::controller
            AB["ArrayBoletos «Controller»"]:::controller
            AU["ArrayUsuarios «Controller»"]:::controller
        end
        subgraph "Entities"
            direction TB
            P["Pelicula «Entity»"]:::entity
            S["Sala «Entity»"]:::entity
            A["Asignacion «Entity»"]:::entity
            C["Cliente «Entity»"]:::entity
            B["Boleto «Entity»"]:::entity
            U["Usuario «Entity»"]:::entity
        end
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        direction TB
        CSVAdapter["CSV Importer/Exporter «DataAccess»"]:::dataaccess
    end

    %% Reporting Module
    HTMLGen["HTMLGenerator «Reporting»"]:::reporting

    %% Storage Layer
    subgraph "Storage"
        direction TB
        CSVFiles["CSV Files"]:::storage
        HTMLReports["Reportes generados/*.html"]:::storage
        Manuals["Manuales"]:::storage
    end

    %% Connections
    LoginForm -->|"authenticate()"| SecurityManager
    LoginForm -->|"call CRUD"| AP
    LoginForm -->|"call CRUD"| AS
    LoginForm -->|"call CRUD"| AA
    LoginForm -->|"call CRUD"| AC
    LoginForm -->|"call CRUD"| AB
    LoginForm -->|"call CRUD"| AU

    Form1 -->|"call CRUD"| AP
    Form1 -->|"call CRUD"| AS
    Form1 -->|"call CRUD"| AA
    Form1 -->|"call CRUD"| AC
    Form1 -->|"call CRUD"| AB
    Form1 -->|"call CRUD"| AU

    FRP -->|"generateReport()"| HTMLGen
    FRC -->|"generateReport()"| HTMLGen
    FRA -->|"generateReport()"| HTMLGen
    FRB -->|"generateReport()"| HTMLGen
    FRS -->|"generateReport()"| HTMLGen
    FRU -->|"generateReport()"| HTMLGen

    subgraph BusinessDataFlow
        AP -->|"loadCSV()/saveCSV()"| CSVAdapter
        AS -->|"loadCSV()/saveCSV()"| CSVAdapter
        AA -->|"loadCSV()/saveCSV()"| CSVAdapter
        AC -->|"loadCSV()/saveCSV()"| CSVAdapter
        AB -->|"loadCSV()/saveCSV()"| CSVAdapter
        AU -->|"loadCSV()/saveCSV()"| CSVAdapter
        %% Entities associations
        AP --- P
        AS --- S
        AA --- A
        AC --- C
        AB --- B
        AU --- U
    end

    CSVAdapter -->|"reads/writes"| CSVFiles
    HTMLGen -->|"writes"| HTMLReports

    %% Click Events
    click LoginForm "https://github.com/ogonzalez-2021370/control-cine/blob/main/LoginForm.h"
    click Form1 "https://github.com/ogonzalez-2021370/control-cine/blob/main/Form1.h"
    click AP "https://github.com/ogonzalez-2021370/control-cine/blob/main/ArrayPeliculas.h"
    click AS "https://github.com/ogonzalez-2021370/control-cine/blob/main/ArraySalas.h"
    click AA "https://github.com/ogonzalez-2021370/control-cine/blob/main/ArrayAsignaciones.h"
    click AC "https://github.com/ogonzalez-2021370/control-cine/blob/main/ArrayClientes.h"
    click AB "https://github.com/ogonzalez-2021370/control-cine/blob/main/ArrayBoletos.h"
    click AU "https://github.com/ogonzalez-2021370/control-cine/blob/main/ArrayUsuarios.h"
    click P "https://github.com/ogonzalez-2021370/control-cine/blob/main/Pelicula.h"
    click S "https://github.com/ogonzalez-2021370/control-cine/blob/main/Sala.h"
    click A "https://github.com/ogonzalez-2021370/control-cine/blob/main/Asignacion.h"
    click C "https://github.com/ogonzalez-2021370/control-cine/blob/main/Cliente.h"
    click B "https://github.com/ogonzalez-2021370/control-cine/blob/main/Boleto.h"
    click U "https://github.com/ogonzalez-2021370/control-cine/blob/main/Usuario.h"
    click CSVAdapter "https://github.com/ogonzalez-2021370/control-cine/blob/main/Cargar archivos .csv"
    click HTMLReports "https://github.com/ogonzalez-2021370/control-cine/tree/main/Reportes generados"
    click Manuals "https://github.com/ogonzalez-2021370/control-cine/tree/main/Manuales"

    %% Styles
    classDef ui fill:#D6EFFF,stroke:#0366D6,color:#0366D6;
    classDef controller fill:#E6F4EA,stroke:#28A745,color:#28A745;
    classDef entity fill:#E6F4EA,stroke:#28A745,color:#28A745;
    classDef dataaccess fill:#FFE8CC,stroke:#D9822B,color:#D9822B;
    classDef reporting fill:#FFF5E5,stroke:#FF8C00,color:#FF8C00;
    classDef storage fill:#F0F0F0,stroke:#6A737D,color:#6A737D;
```
