# juanc-32/puerta-de-la-verdad architecture

> Architecture diagram of the GitHub repository juanc-32/puerta-de-la-verdad, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/juanc-32/puerta-de-la-verdad
- Repository: https://github.com/juanc-32/puerta-de-la-verdad

## Overview

##### Project type and purpose
- Puerta de la Verdad is a static, front-end–only website (no backend/API layer).
- It’s an interactive fan site built with HTML5, CSS3 (Bootstrap 5 via CDN, Flexbox, Grid) and uses SCSS for authoring styles.
- The site is delivered as pre‐built static assets, hosted (for example) on Netlify or any static-hosting CDN.

##### File structure
- Top-level assets:
- index.html (landing page)
- pages/ (sub-pages: personajes, multimedia, universo, contacto)
- css/ (compiled CSS, including estilos.css, style.css, style.css.map)
- scss/ (source styles split into base/ and components/)
- img/ (static images for characters, logos, backgrounds)
- package.json (build/dev scripts for compiling SCSS and possibly installing dependencies)
- No server-side code, no database, no JS beyond what Bootstrap and browser provide.
- Deployment concerns: build/compile SCSS, bundle assets, then push to static host.

##### README for additional insights
- Confirms responsive design via Bootstrap 5 CDN + custom CSS.
- Mentions Flexbox & Grid for layout.
- Details site sections (Alquimistas, Homúnculos, etc.) — purely static HTML pages.
- Deployment in README suggests local clone & open index.html, demo on Netlify.

##### Detail without over-segmenting
- Asset categories (HTML, CSS, images).
- Build vs runtime flows distinctly.
- Do not overcomplicate: this is a single-page‐and-multi‐page static site—focus on assets, CDN, and build process.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% User Facing Components
    Browser["User Browser"]:::user
    StaticHost["Static Host (Netlify/S3+CloudFront)"]:::external
    BootstrapCDN["Bootstrap CDN (Bootstrap 5)"]:::external

    Browser -->|"GET /index.html"| StaticHost
    Browser -->|"GET /css/estilos.css, style.css, style.css.map"| StaticHost
    Browser -->|"GET /img/*"| StaticHost
    Browser -->|"GET CSS/JS"| BootstrapCDN

    subgraph "Static Assets"
        direction TB
        HTML1["index.html"]:::user
        HTML2["pages/contacto.html"]:::user
        HTML3["pages/multimedia.html"]:::user
        HTML4["pages/personajes.html"]:::user
        HTML5["pages/universo.html"]:::user
        CSS1["css/estilos.css"]:::user
        CSS2["css/style.css"]:::user
        CSS3["css/style.css.map"]:::user
        IMG["img/"]:::user
    end

    StaticHost --> HTML1
    StaticHost --> HTML2
    StaticHost --> HTML3
    StaticHost --> HTML4
    StaticHost --> HTML5
    StaticHost --> CSS1
    StaticHost --> CSS2
    StaticHost --> CSS3
    StaticHost --> IMG

    subgraph "Build Pipeline"
        direction TB
        Config["package.json"]:::build
        Docs["README.md"]:::build
        SCSS["SCSS Source Modules"]:::build
        Compiler["SCSS Compiler"]:::build
        Compiled["Compiled CSS Assets"]:::build
        GitHub["GitHub Repo"]:::build
        CICD["CI/CD Pipeline"]:::build
    end

    Config --> SCSS
    Docs --> SCSS
    SCSS --> Compiler
    Compiler --> Compiled
    Compiled --> GitHub
    GitHub --> CICD
    CICD --> StaticHost

    subgraph "SCSS Modules (scss/)"
        direction TB
        S1["_base.scss"]:::build
        S2["_media.scss"]:::build
        S3["_navbar.scss"]:::build
        S4["_submenu.scss"]:::build
        S5["_variables.scss"]:::build
        C1["_animaciones.scss"]:::build
        C2["_footer.scss"]:::build
        C3["_form.scss"]:::build
        C4["_header.scss"]:::build
        C5["_tarjetas.scss"]:::build
        MainSCSS["style.scss"]:::build
    end

    SCSS --> S1
    SCSS --> S2
    SCSS --> S3
    SCSS --> S4
    SCSS --> S5
    SCSS --> C1
    SCSS --> C2
    SCSS --> C3
    SCSS --> C4
    SCSS --> C5
    SCSS --> MainSCSS

    %% Click Events
    click HTML1 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/index.html"
    click HTML2 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/pages/contacto.html"
    click HTML3 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/pages/multimedia.html"
    click HTML4 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/pages/personajes.html"
    click HTML5 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/pages/universo.html"
    click CSS1 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/css/estilos.css"
    click CSS2 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/css/style.css"
    click CSS3 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/css/style.css.map"
    click IMG "https://github.com/juanc-32/puerta-de-la-verdad/tree/master/img/"
    click S1 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/scss/base/_base.scss"
    click S2 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/scss/base/_media.scss"
    click S3 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/scss/base/_navbar.scss"
    click S4 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/scss/base/_submenu.scss"
    click S5 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/scss/base/_variables.scss"
    click C1 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/scss/components/_animaciones.scss"
    click C2 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/scss/components/_footer.scss"
    click C3 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/scss/components/_form.scss"
    click C4 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/scss/components/_header.scss"
    click C5 "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/scss/components/_tarjetas.scss"
    click MainSCSS "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/scss/style.scss"
    click Config "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/package.json"
    click Docs "https://github.com/juanc-32/puerta-de-la-verdad/blob/master/README.md"

    %% Styles
    classDef user fill:#e6ffe6,stroke:#099,stroke-width:2px
    classDef build fill:#e6f0ff,stroke:#036,stroke-width:2px
    classDef external fill:#fff4e6,stroke:#e65c00,stroke-width:2px
    class Browser,HTML1,HTML2,HTML3,HTML4,HTML5,CSS1,CSS2,CSS3,IMG user
    class Config,Docs,SCSS,Compiler,Compiled,GitHub,CICD,S1,S2,S3,S4,S5,C1,C2,C3,C4,C5,MainSCSS build
    class StaticHost,BootstrapCDN external
```
