# jvalenciav/cynthia architecture

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

- Interactive diagram: https://gitdiagram.com/jvalenciav/cynthia
- Repository: https://github.com/jvalenciav/cynthia

## Overview

##### Tipo y propósito del proyecto (según árbol + README)
Por el *file tree* se trata de un **sitio web estático multi‑página** (MPA): muchas páginas `.html`, un **CSS global** (`styles.css`) y un **JS global** (`script.js`). No hay backend, ni `package.json`, ni `src/`, ni dependencias server-side; por tanto la “arquitectura” es **cliente + hosting estático**.

El README está en plantilla (campos en blanco), así que la mejor inferencia es: **sitio web de contenido/experiencias** (p. ej. páginas temáticas como `poemas.html`, `razones.html`, y páginas interactivas tipo `quiz.html`, `cuestionario.html`, `game.html`, `countdown.html`, `ver-respuestas.html`).

##### Qué componentes existen realmente (para dibujarlos “bien”)
Piensa en capas:

##### Infra / Entrega
- **Usuario**
- **Navegador (runtime cliente)**
- **Hosting estático** (GitHub Pages / Netlify / Vercel / servidor Nginx/Apache)
- (Opcional) **CDN** si aplica

##### Aplicación (en el navegador)
- **Rutas/páginas HTML** (cada archivo `.html` es un “módulo” funcional):
- `index.html` como *landing* / hub
- páginas de contenido: `poemas.html`, `libro.html`, `carta.html`, `razones.html`, etc.
- páginas interactivas: `quiz.html`, `cuestionario.html`, `game.html`, `countdown.html`, `ver-respuestas.html`
- **Estilos**: `styles.css` (presentación compartida)
- **Lógica**: `script.js` (eventos, navegación, validaciones, temporizadores, scoring, etc.)
- (Probable) **Estado local**:
- `localStorage` / `sessionStorage` (para respuestas de cuestionario/quiz, progreso del juego, etc.)
- o estado en memoria (si todo se resuelve en una sola página)

##### Dependencias externas (si existieran)
En el árbol no se ven, pero al revisar el HTML podrías encontrar:
- fuentes (Google Fonts), analytics, embeds, APIs externas, etc.
Si no hay, tu diagrama debe reflejar **“sin servicios externos”**.

##### Relaciones e interacciones clave (qué flechas dibujar)
Tu diagrama debe mostrar estos flujos mínimos:

##### Usuario → Navegador
- Interacción (clicks, inputs, teclado) en páginas tipo quiz/juego.

##### Navegador → Hosting estático
- `GET /index.html`
- `GET /styles.css`
- `GET /script.js`
- `GET /<otra_pagina>.html` (navegación entre páginas)
- (Opcional) caching del navegador

##### HTML → CSS/JS
- Cada `.html` referencia a `styles.css` y `script.js` (si aplica).
- Dibuja flechas “incluye/usa”.

##### script.js ↔ DOM de cada página
- Listeners: `onclick`, `submit`, timers (countdown), lógica de juego/quiz.
- Renderizado: manipulación del DOM.

##### script.js ↔ Almacenamiento local (si aplica)
- Guardar/leer respuestas (para `ver-respuestas.html` esto es muy probable).
- Flechas bidireccionales.

##### Patrones arquitectónicos a resaltar (para que el diagrama sea fiel)
- **MPA (Multi-Page Application)**: cada página HTML es un “entry point”; no hay router SPA.
- **Assets compartidos**: `styles.css` + `script.js` como dependencias comunes.
- **Separación implícita**:
- Vista: HTML
- Presentación: CSS
- Comportamiento: JS
- **Sin backend**: todo es client-side; si hay persistencia, será local (o mediante servicios externos si los descubres en el HTML).

##### Cómo dibujar el “mejor” diagrama para este proyecto (recomendación práctica)
Dibuja en 2 niveles (y, si quieres, un tercero). Esto evita un diagrama demasiado plano y permite precisión.

##### Nivel 1 — Diagrama de Contexto (tipo C4 “System Context”)
**Objetivo:** mostrar “qué es” y “dónde corre”.
Incluye:
- Actor: Usuario
- Sistema: “Cynthia (sitio web estático)”
- Infra: Hosting estático (+ CDN opcional)
- Navegador como runtime

**Flechas:**
- Usuario ↔ Navegador
- Navegador → Hosting (HTTP GET de recursos)

##### Nivel 2 — Diagrama de Contenedores (C4 “Container” adaptado)
**Objetivo:** separar “entrega” vs “ejecución en cliente”.
Contenedores:
- Hosting estático (sirve archivos)
- Navegador (ejecuta app)
Dentro de Navegador, representa:
- Conjunto de páginas HTML (puedes agrupar en “Contenido” y “Interactivo”)
- `styles.css`
- `script.js`
- Storage local (localStorage/sessionStorage)

**Flechas:**
- HTML pages → styles.css / script.js (dependencia)
- script.js ↔ localStorage (persistencia)
- Navegador → Hosting (carga de cada página y assets)

##### Nivel 3 — Diagrama de Componentes (solo si quieres máxima exactitud)
**Objetivo:** documentar módulos lógicos dentro de `script.js` y cómo se conectan a páginas específicas.
Como no vemos el contenido del JS, dibuja componentes “probables” y luego los ajustas al inspeccionar `script.js`:
- “Quiz engine” (para `quiz.html`, `cuestionario.html`)
- “Game logic” (para `game.html`)
- “Countdown timer” (para `countdown.html`)
- “Answers viewer” (para `ver-respuestas.html`)
- “Navigation/helpers” (común)
- “Storage adapter” (lectura/escritura localStorage)

**Flechas:**
- Cada página interactiva → su componente lógico
- Componentes lógicos → “Storage adapter”
- Componentes lógicos → DOM API

##### Instrucciones concretas de diagramación (lo que no puede faltar)
Para que sea “muy detallado” sin sobrepensarlo:

##### Componentes (cajas) — sepáralos lo más posible
- Caja por **cada HTML** (o al menos por grupo: contenido vs interactivo).
- Caja para `styles.css`
- Caja para `script.js`
- Caja para `localStorage/sessionStorage` (si aplica)
- Caja para Hosting estático

##### Etiquetas
- En cada HTML, etiqueta el “rol”:
- `index.html` = Entrada / navegación
- `quiz.html` = Quiz UI + scoring
- `ver-respuestas.html` = Lectura de respuestas (probablemente desde storage)
- `game.html` = Game loop / interacciones
- etc.

##### Flechas direccionales (mínimas)
- `Browser -> Hosting`: “Fetch static assets (HTML/CSS/JS)”
- `HTML -> CSS`: “Loads styles”
- `HTML -> JS`: “Loads script”
- `User -> Page`: “Input / Click / Submit”
- `JS <-> DOM`: “Render / Events”
- `JS <-> Storage`: “Persist / Retrieve”

##### Abre 2–3 HTML representativos (`index.html`, `quiz.html`, `game.html`) y verifica
- si todos importan el mismo `script.js` y `styles.css`
- si hay assets adicionales (imágenes, audio, fuentes) aunque no aparezcan en el árbol (ojo: no hay carpeta `assets/`, pero pueden estar referenciados remotamente)
##### Revisa `script.js` para confirmar
- páginas objetivo (por `document.location`, IDs, clases)
- si usa `localStorage` (clave para `ver-respuestas.html`)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% =====================
    %% Context / Infra layer
    %% =====================
    U["Usuario"]:::external

    subgraph "Cliente"
        B["Navegador (Runtime)"]:::client

        subgraph "Aplicación (MPA en el navegador)"
            DOM["DOM (HTML Renderizado)"]:::client

            subgraph "Páginas HTML (Rutas / Entry points)"
                IDX["index.html (Landing / Hub)"]:::page

                subgraph "Contenido"
                    H14["14.html (Contenido)"]:::page
                    CARTA["carta.html (Contenido)"]:::page
                    LIBRO["libro.html (Contenido)"]:::page
                    POEMAS["poemas.html (Contenido)"]:::page
                    RAZONES["razones.html (Contenido)"]:::page
                    REMAR["remar.html (Contenido)"]:::page
                    RETOO["retoo.html (Contenido)"]:::page
                end

                subgraph "Interactivo"
                    QUIZ["quiz.html (Quiz UI + scoring)"]:::page
                    CUEST["cuestionario.html (Cuestionario)"]:::page
                    GAME["game.html (Juego / interacciones)"]:::page
                    COUNT["countdown.html (Temporizador)"]:::page
                    VER["ver-respuestas.html (Ver respuestas)"]:::page
                end
            end

            CSS["styles.css (Estilos globales)"]:::asset
            JS["script.js (Lógica global / eventos / estado)"]:::logic

            STORE[("localStorage / sessionStorage")]:::storage

            subgraph "Componentes lógicos (probables en script.js)"
                NAV["Navigation / Helpers"]:::logic
                QUIZENG["Quiz engine"]:::logic
                GAMELOG["Game logic"]:::logic
                TIMER["Countdown timer"]:::logic
                ANSW["Answers viewer"]:::logic
                SADAPT["Storage adapter"]:::logic
            end
        end
    end

    subgraph "Entrega (Infra)"
        CDN["CDN (Opcional)"]:::infra
        HOST["Hosting estático (GitHub Pages / Netlify / Vercel / Nginx)"]:::infra
    end

    DOC["README.md (Documentación)"]:::doc

    %% =====================
    %% Key interactions
    %% =====================
    U -->|"click/input/submit"| B
    B -->|"renderiza"| DOM

    %% Fetching assets (vertical, per type)
    B -->|"GET HTML/CSS/JS"| HOST
    CDN -.->|"cache/opcional"| HOST
    B -.->|"opcional: sirve estáticos cacheados"| CDN

    %% HTML includes shared assets
    IDX -->|"loads_styles"| CSS
    IDX -->|"loads_script"| JS

    H14 -->|"loads_styles"| CSS
    H14 -->|"loads_script"| JS
    CARTA -->|"loads_styles"| CSS
    CARTA -->|"loads_script"| JS
    LIBRO -->|"loads_styles"| CSS
    LIBRO -->|"loads_script"| JS
    POEMAS -->|"loads_styles"| CSS
    POEMAS -->|"loads_script"| JS
    RAZONES -->|"loads_styles"| CSS
    RAZONES -->|"loads_script"| JS
    REMAR -->|"loads_styles"| CSS
    REMAR -->|"loads_script"| JS
    RETOO -->|"loads_styles"| CSS
    RETOO -->|"loads_script"| JS

    QUIZ -->|"loads_styles"| CSS
    QUIZ -->|"loads_script"| JS
    CUEST -->|"loads_styles"| CSS
    CUEST -->|"loads_script"| JS
    GAME -->|"loads_styles"| CSS
    GAME -->|"loads_script"| JS
    COUNT -->|"loads_styles"| CSS
    COUNT -->|"loads_script"| JS
    VER -->|"loads_styles"| CSS
    VER -->|"loads_script"| JS

    %% JS runtime interactions
    JS <-->|"events/render"| DOM
    JS <-->|"persist/retrieve"| STORE

    %% Page -> component affinity (probable)
    JS -->|"contains"| NAV
    JS -->|"contains"| QUIZENG
    JS -->|"contains"| GAMELOG
    JS -->|"contains"| TIMER
    JS -->|"contains"| ANSW
    JS -->|"contains"| SADAPT

    QUIZ -->|"uses"| QUIZENG
    CUEST -->|"uses"| QUIZENG
    GAME -->|"uses"| GAMELOG
    COUNT -->|"uses"| TIMER
    VER -->|"uses"| ANSW

    NAV -->|"manipulates"| DOM
    QUIZENG -->|"manipulates"| DOM
    GAMELOG -->|"manipulates"| DOM
    TIMER -->|"manipulates"| DOM
    ANSW -->|"manipulates"| DOM

    QUIZENG -->|"read/write"| SADAPT
    GAMELOG -->|"read/write"| SADAPT
    TIMER -->|"read/write"| SADAPT
    ANSW -->|"read/write"| SADAPT
    SADAPT <-->|"localStorage API"| STORE

    %% Documentation relation
    DOC -.->|"describe/notes"| HOST

    %% =====================
    %% Click events (mapped)
    %% =====================
    click IDX "https://github.com/jvalenciav/cynthia/blob/main/index.html"
    click H14 "https://github.com/jvalenciav/cynthia/blob/main/14.html"
    click CARTA "https://github.com/jvalenciav/cynthia/blob/main/carta.html"
    click LIBRO "https://github.com/jvalenciav/cynthia/blob/main/libro.html"
    click POEMAS "https://github.com/jvalenciav/cynthia/blob/main/poemas.html"
    click RAZONES "https://github.com/jvalenciav/cynthia/blob/main/razones.html"
    click REMAR "https://github.com/jvalenciav/cynthia/blob/main/remar.html"
    click RETOO "https://github.com/jvalenciav/cynthia/blob/main/retoo.html"
    click QUIZ "https://github.com/jvalenciav/cynthia/blob/main/quiz.html"
    click CUEST "https://github.com/jvalenciav/cynthia/blob/main/cuestionario.html"
    click GAME "https://github.com/jvalenciav/cynthia/blob/main/game.html"
    click COUNT "https://github.com/jvalenciav/cynthia/blob/main/countdown.html"
    click VER "https://github.com/jvalenciav/cynthia/blob/main/ver-respuestas.html"
    click JS "https://github.com/jvalenciav/cynthia/blob/main/script.js"
    click CSS "https://github.com/jvalenciav/cynthia/blob/main/styles.css"
    click DOC "https://github.com/jvalenciav/cynthia/blob/main/README.md"

    %% =====================
    %% Styles
    %% =====================
    classDef external fill:#ffffff,stroke:#111827,stroke-width:2,color:#111827
    classDef infra fill:#e5e7eb,stroke:#6b7280,stroke-width:2,color:#111827
    classDef client fill:#dbeafe,stroke:#2563eb,stroke-width:2,color:#0f172a
    classDef page fill:#ffffff,stroke:#94a3b8,stroke-width:1.5,color:#0f172a
    classDef asset fill:#ede9fe,stroke:#7c3aed,stroke-width:2,color:#0f172a
    classDef logic fill:#dcfce7,stroke:#16a34a,stroke-width:2,color:#052e16
    classDef storage fill:#ffedd5,stroke:#f97316,stroke-width:2,color:#7c2d12
    classDef doc fill:#fef9c3,stroke:#ca8a04,stroke-width:2,color:#713f12
```
