# zack2141/proyecto-bootcamp-energia-sostenible architecture

> Architecture diagram of the GitHub repository zack2141/proyecto-bootcamp-energia-sostenible, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-02-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zack2141/proyecto-bootcamp-energia-sostenible
- Repository: https://github.com/zack2141/proyecto-bootcamp-energia-sostenible

## Overview

##### Project Type and Purpose
- This is a purely front-end, multi-page web application built with vanilla HTML, CSS and JavaScript.
- Its goal is to present sustainable energy data via interactive pages: a calculator, several chart dashboards, a feedback form and a landing page.

##### File-Structure Analysis
- Top-level modules (each a self-contained “page”):
- Inicio (landing page)
- Calculadora (energy calculator)
- Dashboard (data visualizations)
- Feedback (user input form)
- Navegador (client-side router/navigation)
- Dashboard sub-modules: Grafico_area, Grafico_barra, Grafico_linea, Grafico_torta, Tabla, Documentacion loader.
- Recursos holds static assets: images + CSV data under Recursos/documentacion.
- No server-side code: served as static files from a web server (e.g., Nginx, Apache, GitHub Pages).

##### Key Components
a. Client Browser (User Agent)
b. Static File Server (serving .html, .css, .js, CSV, images)
c. Presentation Layer (HTML + CSS per module)
d. Controller Layer (JavaScript modules):
- Navegador.js (page navigation)
- Dashboard_Controlador.js + carga_documentos.js (data loading)
- Each graph’s .js file (view logic)
e. Data Layer (CSV files in Recursos/documentacion)
f. Assets Store (images under Recursos/Imagenes_*)

##### Component Relationships and Data Flow
- User opens Browser → HTTP GET to Static File Server → receives HTML/CSS/JS for chosen page.
- Navegador.js intercepts link clicks, loads appropriate HTML/JS.
- On Dashboard pages, Dashboard_Controlador.js and carga_documentos.js issue AJAX/fetch requests to CSV files → raw data returned → graph modules render charts.
- Feedback.js handles form input, could send data via client API or localStorage (if extended).
- Calculadora.js reads user input, computes results in-browser, updates DOM.

##### Architectural Patterns & Design Principles
- Client-side MVC (rough):
- Model = CSV/data loader
- View = HTML/CSS templates + chart canvases
- Controller = individual .js scripts per page/module
- Modular folder structure: each page view and its assets (styles + scripts) in its own directory.
- Static asset separation: images, data, CSS divided by module for maintainability.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Server Boundary
    subgraph "Static File Server" 
        direction TB
        ServerFiles["HTML/CSS/JS, CSV, Images"]:::server
    end

    %% Data Store
    DataStore[("CSV Data Store")]:::data

    %% Assets Store
    AssetsStore["Image Assets"]:::data

    %% Browser
    subgraph "Client Browser" 
        direction TB
        subgraph "Navigation Module"
            Navegador["Navegador.js"]:::controller
        end
        subgraph "Page Modules"
            Inicio["Inicio.html + CSS + JS"]:::presentation
            Calculadora["Calculadora.html + CSS + JS"]:::presentation
            DashboardPage["Dashboard.html + CSS"]:::presentation
            FeedbackPage["Feedback.html + CSS + JS"]:::presentation
        end
        subgraph "Dashboard Module"
            direction TB
            DashboardController["Dashboard_Controlador.js"]:::controller
            CargaDocs["carga_documentos.js"]:::controller
            subgraph "Chart Modules"
                direction TB
                GraficoArea["Grafico_area.js"]:::controller
                GraficoBarra["Grafico_barra.js"]:::controller
                GraficoLinea["Grafico_linea.js"]:::controller
                GraficoTorta["Grafico_torta.js"]:::controller
                Tabla["Tabla.html + CSS"]:::presentation
            end
        end
    end

    %% Data Flow Arrows
    Inicio -->|HTTP GET| ServerFiles
    Calculadora -->|HTTP GET| ServerFiles
    DashboardPage -->|HTTP GET| ServerFiles
    FeedbackPage -->|HTTP GET| ServerFiles
    ServerFiles -->|serves files| Inicio
    ServerFiles -->|serves files| Calculadora
    ServerFiles -->|serves files| DashboardPage
    ServerFiles -->|serves files| FeedbackPage

    DashboardController -->|fetch .csv| DataStore
    CargaDocs -->|fetch .csv| DataStore
    DataStore -->|returns CSV| DashboardController
    DataStore -->|returns CSV| CargaDocs

    DashboardController -->|"render charts"| GraficoArea
    DashboardController -->|"render charts"| GraficoBarra
    DashboardController -->|"render charts"| GraficoLinea
    DashboardController -->|"render charts"| GraficoTorta
    DashboardController -->|"render table"| Tabla

    Calculadora -->|"compute results"| Calculadora
    FeedbackPage -->|"handle form"| FeedbackPage

    Navegador -->|route pages| Inicio
    Navegador -->|route pages| Calculadora
    Navegador -->|route pages| DashboardPage
    Navegador -->|route pages| FeedbackPage

    %% Click Events
    click Inicio "https://github.com/zack2141/proyecto-bootcamp-energia-sostenible/blob/main/Inicio/Inicio.html"
    click Calculadora "https://github.com/zack2141/proyecto-bootcamp-energia-sostenible/blob/main/Calculadora/Calculadora.html"
    click DashboardPage "https://github.com/zack2141/proyecto-bootcamp-energia-sostenible/blob/main/Dashboard/Dashboard.html"
    click FeedbackPage "https://github.com/zack2141/proyecto-bootcamp-energia-sostenible/blob/main/Feedback/Feedback.html"
    click Navegador "https://github.com/zack2141/proyecto-bootcamp-energia-sostenible/blob/main/Navegador/Estilo_navegador.css"
    click DashboardController "https://github.com/zack2141/proyecto-bootcamp-energia-sostenible/blob/main/Dashboard/Dashboard_Controlador.js"
    click CargaDocs "https://github.com/zack2141/proyecto-bootcamp-energia-sostenible/blob/main/Dashboard/Documentacion/carga_documentos.js"
    click GraficoArea "https://github.com/zack2141/proyecto-bootcamp-energia-sostenible/blob/main/Dashboard/Grafico_area/Grafico_area.js"
    click GraficoBarra "https://github.com/zack2141/proyecto-bootcamp-energia-sostenible/blob/main/Dashboard/Grafico_barra/Grafico_barra.js"
    click GraficoLinea "https://github.com/zack2141/proyecto-bootcamp-energia-sostenible/blob/main/Dashboard/Grafico_linea/Grafico_linea.js"
    click GraficoTorta "https://github.com/zack2141/proyecto-bootcamp-energia-sostenible/blob/main/Dashboard/Grafico_torta/Grafico_torta.js"

    %% Styles
    classDef presentation fill:#cce5ff,stroke:#004085,color:#004085
    classDef controller fill:#d4edda,stroke:#155724,color:#155724
    classDef data fill:#fff3cd,stroke:#856404,color:#856404
    classDef server fill:#e2e3e5,stroke:#6c757d,color:#6c757d
```
