How jvalenciav/cynthia works
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)