# erickmontesdk/opus-cinemas architecture

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

- Interactive diagram: https://gitdiagram.com/erickmontesdk/opus-cinemas
- Repository: https://github.com/erickmontesdk/opus-cinemas

## Overview

##### Main components
- Frontend (Client-Side): Represent the “public” folder. This includes:
- HTML pages (e.g., home, about, film-info, payment, etc.)
- CSS files for UI styling.
- JavaScript modules found in “public/js” which manage API calls (to email service, Movieglu, Supabase) and handle features like QR code generation and seat selection.
- Backend (Serverless Functions): Located in “netlify/functions”. These modules encapsulate the business logic for:
- Handling requests related to auditoriums, films, movie schedules, ticket sales, and email services.
- Performing CRUD operations via Node.js-based services.
- Database: Supabase is used for persistent storage. Note the presence of:
- Migration scripts in the “migrations” directory (“createSupabaseElements.js” and “initialMigration.sql”), which set up the necessary tables and functions.
- External Services:
- MovieGlu API – The application integrates with this API for movie metadata.
- Email services invoked through the API functions.

##### Relationships and interactions
- The client’s browser loads static assets (HTML, CSS, JS) from the “public” folder. When user interactions require dynamic data or processing (like movie schedule queries or ticket purchases), the frontend JavaScript makes API calls.
- These API calls are directed towards the serverless functions deployed via Netlify. The functions process the requests by:
- Querying or updating data in the Supabase database.
- Consuming external APIs like MovieGlu for real-time movie information.
- Migrations scripts are used during the initial application setup or upgrades to prepare and update the database schema.

##### Architectural patterns and design principles
- Serverless/Function-as-a-Service: Instead of a monolithic backend, the project leverages Netlify’s serverless functions, making scaling and deployments lightweight.
- Separation of Concerns: The clear separation between the frontend (static assets) and backend (API logic) ensures that UI and business logic remain modular.
- Integration Patterns: Explicit integration with third-party services (like MovieGlu) and managed databases (Supabase) are ideal for modular expansion and easier maintenance.

##### Relevant technologies and libraries
- Node.js for backend functions.
- Netlify for serverless deployments and CI/CD.
- Supabase for database and authentication.
- MovieGlu API for movie information.
- Standard HTML/CSS/JavaScript for the UI.

## Diagram (Mermaid)

```mermaid
flowchart TD
    A("User Browser"):::browser

    subgraph "Frontend Layer"
        FE("Frontend (Public Assets)"):::frontend
        subgraph "Client-Side Modules"
            FE_Email("Email Service API"):::frontend
            FE_MovieGlu("MovieGlu API"):::frontend
            FE_Supabase("Supabase API"):::frontend
            FE_QR("QR Code Generator"):::frontend
            FE_MovieInfo("Movie Info Module"):::frontend
            FE_Seat("Seat Selection Module"):::frontend
            FE_Data("Data Service"):::frontend
            FE_Utils("Utility Scripts"):::frontend
        end
    end

    subgraph "Serverless Backend (Netlify Functions)"
        S_Aud("Auditoriums Handling"):::serverless
        S_Film("Film Information"):::serverless
        S_Movie("Movie Details"):::serverless
        S_Sched("Movie Schedules"):::serverless
        S_Sales("Sales Handling"):::serverless
        S_Show("Showtimes Handling"):::serverless
        S_Tickets("Tickets Handling"):::serverless
        S_Email("Email Service (Backend)"):::serverless
        S_Config("Backend Config"):::serverless
        S_Utils("Backend Utils"):::serverless
    end

    subgraph "Database Layer"
        DB("Supabase Database"):::database
        subgraph "Migrations"
            M_Create("Create Supabase Elements"):::database
            M_Initial("Initial Migration SQL"):::database
        end
    end

    subgraph "External Services"
        ES_MovieGlu("MovieGlu API (External)"):::external
        ES_Email("Email Service (External)"):::external
    end

    NLC("Netlify Deployment Config"):::serverless

    A -->|"loads"| FE
    FE -->|"includes"| FE_Email
    FE -->|"includes"| FE_MovieGlu
    FE -->|"includes"| FE_Supabase
    FE -->|"includes"| FE_QR
    FE -->|"includes"| FE_MovieInfo
    FE -->|"includes"| FE_Seat
    FE -->|"includes"| FE_Data
    FE -->|"includes"| FE_Utils

    FE_Email -->|"calls"| S_Email
    FE_MovieGlu -->|"calls"| S_Movie
    FE_Supabase -->|"calls"| S_Config

    FE -->|"makesAPICallsTo"| S_Aud
    FE -->|"makesAPICallsTo"| S_Film
    FE -->|"makesAPICallsTo"| S_Sched
    FE -->|"makesAPICallsTo"| S_Sales
    FE -->|"makesAPICallsTo"| S_Show
    FE -->|"makesAPICallsTo"| S_Tickets

    S_Aud -->|"queriesUpdates"| DB
    S_Film -->|"queriesUpdates"| DB
    S_Movie -->|"queriesUpdates"| DB
    S_Sched -->|"queriesUpdates"| DB
    S_Sales -->|"queriesUpdates"| DB
    S_Show -->|"queriesUpdates"| DB
    S_Tickets -->|"queriesUpdates"| DB
    S_Email -->|"queriesUpdates"| DB

    S_Movie -->|"fetchesDataFrom"| ES_MovieGlu
    S_Email -->|"calls"| ES_Email

    M_Create -->|"setsUp"| DB
    M_Initial -->|"initializes"| DB

    NLC -->|"configures"| S_Aud

    click FE "https://github.com/erickmontesdk/opus-cinemas/tree/main/public"
    click FE_Email "https://github.com/erickmontesdk/opus-cinemas/blob/main/public/js/api/emailService.js"
    click FE_MovieGlu "https://github.com/erickmontesdk/opus-cinemas/blob/main/public/js/api/moviegluApi.js"
    click FE_Supabase "https://github.com/erickmontesdk/opus-cinemas/blob/main/public/js/api/supabaseApi.js"
    click FE_QR "https://github.com/erickmontesdk/opus-cinemas/blob/main/public/js/makeQrCode.js"
    click FE_MovieInfo "https://github.com/erickmontesdk/opus-cinemas/blob/main/public/js/movieinfo.js"
    click FE_Seat "https://github.com/erickmontesdk/opus-cinemas/blob/main/public/js/seatsSelection.js"
    click FE_Data "https://github.com/erickmontesdk/opus-cinemas/blob/main/public/js/services/dataService.js"
    click FE_Utils "https://github.com/erickmontesdk/opus-cinemas/blob/main/public/js/utils.js"

    click S_Aud "https://github.com/erickmontesdk/opus-cinemas/blob/main/netlify/functions/auditoriumsHandling.mjs"
    click S_Film "https://github.com/erickmontesdk/opus-cinemas/blob/main/netlify/functions/filmInformation.js"
    click S_Movie "https://github.com/erickmontesdk/opus-cinemas/blob/main/netlify/functions/movieDetails.js"
    click S_Sched "https://github.com/erickmontesdk/opus-cinemas/blob/main/netlify/functions/movieSchedules.mjs"
    click S_Sales "https://github.com/erickmontesdk/opus-cinemas/blob/main/netlify/functions/salesHandling.mjs"
    click S_Show "https://github.com/erickmontesdk/opus-cinemas/blob/main/netlify/functions/showtimesHandling.mjs"
    click S_Tickets "https://github.com/erickmontesdk/opus-cinemas/blob/main/netlify/functions/ticketsHandling.mjs"
    click S_Email "https://github.com/erickmontesdk/opus-cinemas/blob/main/netlify/functions/emailService.mjs"
    click S_Config "https://github.com/erickmontesdk/opus-cinemas/blob/main/netlify/functions/config.js"
    click S_Utils "https://github.com/erickmontesdk/opus-cinemas/blob/main/netlify/functions/utils.js"
    click NLC "https://github.com/erickmontesdk/opus-cinemas/blob/main/netlify.toml"

    click M_Create "https://github.com/erickmontesdk/opus-cinemas/blob/main/migrations/createSupabaseElements.js"
    click M_Initial "https://github.com/erickmontesdk/opus-cinemas/blob/main/migrations/initialMigration.sql"

    classDef frontend fill:#B3E5FC,stroke:#0277BD,stroke-width:2px;
    classDef serverless fill:#FFE082,stroke:#FF6F00,stroke-width:2px;
    classDef database fill:#C8E6C9,stroke:#2E7D32,stroke-width:2px;
    classDef external fill:#FFCDD2,stroke:#C62828,stroke-dasharray: 5, 5,stroke-width:2px;
    classDef browser fill:#D1C4E9,stroke:#512DA8,stroke-width:2px;
```
