# daroncin/peonanny architecture

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

- Interactive diagram: https://gitdiagram.com/daroncin/peonanny
- Repository: https://github.com/daroncin/peonanny

## Overview

##### Tipo y propósito del proyecto (según file tree + README)
**PeoNanny** es un **sitio web estático** cuyo propósito es mostrar **flores peonias “en carrusel”**. El árbol de archivos indica que:
- Hay un **`index.html`** (punto de entrada web).
- Hay varios **assets 3D en formato `.glb`** (`peony.glb`, `pink_peony.glb`, `peony_scan.glb`, `peony_point_cloud.glb`), lo que sugiere un visor 3D (WebGL) y/o un componente tipo carousel que cambia el modelo mostrado.
- **No hay backend** (no hay `server/`, `api/`, `package.json`, etc.). La arquitectura más probable es **Browser + Static Hosting + Assets**.

Tu diagrama debe reflejar que el “sistema” es, esencialmente, una **aplicación front-end estática** que carga modelos 3D y los renderiza.

##### Cómo leer la estructura y mapearla a arquitectura
Con este árbol tan pequeño, la regla es: **cada archivo importante = un componente o artefacto**.
- `index.html` ⇒ **UI / App shell** (y probablemente contiene el JS embebido o referencias a librerías externas).
- `*.glb` ⇒ **3D Model Assets** (recursos estáticos servidos por HTTP).
- `README.md` ⇒ documentación (no es runtime).

Como no vemos otros archivos JS/CSS, es posible que:
##### el JS esté inline en `index.html`, y/o
2) se use una librería via CDN (p.ej., `<script src="...">`) como **three.js** o **`<model-viewer>`**.

Esto es importante para el diagrama: **incluye dependencias externas “CDN / third-party libs”** aunque no existan como archivos locales.

##### Componentes principales que debe contener el diagrama (para este proyecto)
A un nivel “system design” (tipo C4-Container / deployment conceptual) usa estos bloques:

##### Usuario / Cliente
- **User**
- **Browser (Web App runtime)**: donde corre HTML/JS, WebGL, event loop, etc.

##### Hosting / Entrega
- **Static Web Host** (GitHub Pages / Netlify / S3+CloudFront / servidor HTTP simple; no se especifica cuál, pero el patrón es el mismo):
- Sirve `index.html`
- Sirve los `.glb`

##### Frontend (en el browser)
- **UI Layer / Carousel Controller**
Responsable de:
- Interacciones (next/prev, autoplay, thumbnails, etc.)
- Decidir qué modelo `.glb` se carga
- **3D Viewer / Renderer (WebGL)**
Puede ser:
- Three.js (scene/camera/light/loader/renderer), o
- `<model-viewer>` (Web Component con backend WebGL interno)
- **Asset Loader**
- Descarga `.glb` via HTTP(s)
- Cache del navegador (opcional, pero vale la pena mostrar como “Browser Cache” si quieres más detalle)

##### Recursos estáticos
- **GLB Assets Repository (static files)**
Representa el set:
- `peony.glb`
- `pink_peony.glb`
- `peony_scan.glb`
- `peony_point_cloud.glb`

##### Dependencias externas (probables)
- **CDN / Third-party libraries** (si `index.html` referencia scripts externos)
- Librería 3D
- CSS frameworks (si aplica)
- (Opcional) fuentes/íconos

##### Relaciones e interacciones (flechas obligatorias)
Para que sea “accurate”, muestra flujos concretos:

##### User → Browser
- “Clicks / swipe / keyboard” para mover el carrusel
##### Browser → Static Host
- `GET /index.html`
- `GET /peony.glb`, etc.
##### Browser UI/Carousel → Asset Loader
- “select model” / “load model X”
##### Asset Loader → GLB Assets (via Host)
- Descarga binaria `.glb`
##### Asset Loader → 3D Viewer
- Entrega “parsed GLTF/GLB scene” o “model resource”
##### (Si hay CDN) Browser → CDN
- “GET three.js / model-viewer.js”

Con esto queda claro: **no hay API**, **no hay DB**, **no hay autenticación**, **no hay colas**.

##### Patrones/decisiones arquitectónicas a resaltar (específicas a este proyecto)
- **Static-site architecture**: hosting simple, sin servidor de aplicación.
- **Client-side rendering**: todo el render 3D ocurre en el cliente.
- **Asset-driven app**: la “data principal” son los `.glb`.
- **Carousel as state machine** (implícito): estado = modelo actual, transiciones = next/prev/autoplay.
- (Si usas three.js) **Render loop** y separación conceptual: Scene/Camera/Lights/Controls/Loader.

##### Diagrama de contexto/containers (alto nivel)
- Usuario, Browser, Static Host, CDN, Assets.
##### Diagrama de componentes dentro del Browser (detalle)
- UI/Carousel, Viewer, Loader, Cache, WebGL/GPU.

Esto te da precisión sin mezclar niveles.

##### Paso 2: Nombra componentes con base en artefactos reales
- “`index.html` (App Shell + UI)” como componente
- “GLB Assets (*.glb)” como componente
- Si confirmas librería al abrir `index.html`, nómbrala literalmente:
- “Three.js (GLTFLoader, WebGLRenderer)” o “`<model-viewer>`”

##### Paso 3: Señala dónde vive cada cosa (deployment)
- **Client (Browser)** boundary
- **Static Hosting** boundary
- **Internet/CDN** boundary

##### Diagrama 1 (alto nivel)
- [User]
→ [Browser: PeoNanny Web App (index.html)]
→ (HTTP GET) [Static Web Host]
→ serves: [index.html] y [GLB assets: peony*.glb]
- [Browser] → (optional HTTP GET) [CDN: three.js / model-viewer]

##### Diagrama 2 (interno del Browser)
Dentro de un boundary “Browser”:
- [UI / Carousel Controller]
→ triggers → [Asset Loader (GLB/GLTF)]
→ feeds → [3D Viewer / Renderer]
→ renders via → [WebGL / GPU]
- [Asset Loader] ↔ [Browser Cache] (opcional)
- Fuera del boundary:
- [Static Host / Assets] como fuente de descarga

##### Qué verificar rápidamente en `index.html` para aumentar exactitud
Antes de finalizar el diagrama, abre `index.html` y busca:
- Referencias a CDN (`three.min.js`, `model-viewer`, `babylon.js`, etc.)
- Nombres de funciones/IDs que indiquen “carousel”, “model list”, “autoplay”
- Rutas exactas a `.glb` (para etiquetar “Model list / manifest” si existe inline)

Si encuentras que el carousel usa, por ejemplo, un array de modelos, puedes agregar un componente:
- **Model Registry (inline config in index.html)** → lista de `.glb`

##### Enfoque: “separar en tantos componentes como sea posible”
Para este repo minimalista, “detallado” no significa inventar microservicios; significa:
- Separar **UI**, **loader**, **renderer**, **assets**, **hosting**, **CDN**, **GPU/WebGL**,
- y dibujar **flujos HTTP y de render**.

Eso produce un diagrama preciso, útil para performance (tamaño de assets), caching, y dependencias externas.

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% ========= Diagram 1: Context / Containers (High-level) =========
  subgraph "Context / Containers"
    U["User"]:::external

    subgraph "Client Device"
      B["Browser Runtime"]:::client
      APP["PeoNanny Web App (index.html)"]:::frontend
    end

    subgraph "Internet"
      CDN["CDN / Third-party Libraries\n(e.g., three.js or <model-viewer>)"]:::external
    end

    subgraph "Static Hosting"
      HOST["Static Web Host\n(GitHub Pages / Netlify / S3)"]:::infra
      IDX["index.html (served)"]:::file
      subgraph "Static Assets"
        GLBSET["GLB Assets Repository\n(peony*.glb)"]:::assets
        GLB1["peony.glb"]:::assets
        GLB2["pink_peony.glb"]:::assets
        GLB3["peony_scan.glb"]:::assets
        GLB4["peony_point_cloud.glb"]:::assets
      end
      DOC["README.md"]:::doc
    end
  end

  U -->|"clicks/swipe/keyboard"| B
  B -->|"loads"| APP

  B -->|"HTTP_GET_/index.html"| HOST
  HOST -->|"serves"| IDX
  IDX -->|"bootstraps"| APP

  B -->|"HTTP_GET_/scripts_(optional)"| CDN

  B -->|"HTTP_GET_*.glb"| HOST
  HOST -->|"serves_static"| GLBSET
  GLBSET -->|"includes"| GLB1
  GLBSET -->|"includes"| GLB2
  GLBSET -->|"includes"| GLB3
  GLBSET -->|"includes"| GLB4

  %% ========= Diagram 2: Browser Internal Components (Detailed) =========
  subgraph "Browser Internals (Client-side only)"
    subgraph "UI + State"
      UI["UI Layer / Carousel Controller"]:::frontend
      REG["Model Registry\n(list of .glb paths; inline config)"]:::frontend
    end

    subgraph "Loading"
      LOADER["Asset Loader (GLB/GLTF)"]:::frontend
      CACHE[("Browser Cache")]:::cache
    end

    subgraph "Rendering"
      VIEW["3D Viewer / Renderer (WebGL integration)"]:::render
      WEBGL["WebGL Context + Render Loop"]:::render
      GPU["GPU"]:::gpu
    end
  end

  U -->|"next/prev/autoplay"| UI
  UI -->|"selects_model"| REG
  UI -->|"load_model"| LOADER
  LOADER <-->|"read/write"| CACHE
  LOADER -->|"fetch_*.glb_via_HTTP"| HOST
  HOST -->|"returns_GLBin_bytes"| LOADER
  LOADER -->|"parsed_model_resource"| VIEW
  VIEW -->|"draw_calls"| WEBGL
  WEBGL -->|"renders_on"| GPU

  %% ========= Click Events (from component_mapping) =========
  click APP "https://github.com/daroncin/peonanny/blob/main/index.html"
  click UI "https://github.com/daroncin/peonanny/blob/main/index.html"
  click LOADER "https://github.com/daroncin/peonanny/blob/main/index.html"
  click VIEW "https://github.com/daroncin/peonanny/blob/main/index.html"
  click GLB1 "https://github.com/daroncin/peonanny/blob/main/peony.glb"
  click GLB2 "https://github.com/daroncin/peonanny/blob/main/pink_peony.glb"
  click GLB3 "https://github.com/daroncin/peonanny/blob/main/peony_scan.glb"
  click GLB4 "https://github.com/daroncin/peonanny/blob/main/peony_point_cloud.glb"
  click DOC "https://github.com/daroncin/peonanny/blob/main/README.md"

  %% ========= Styles =========
  classDef external fill:#E6E6E6,stroke:#666,color:#111,stroke-width:1.2px;
  classDef infra fill:#D9D9D9,stroke:#555,color:#111,stroke-width:1.2px;
  classDef client fill:#DDEBFF,stroke:#3B6FB6,color:#0B1B33,stroke-width:1.2px;
  classDef frontend fill:#BFD7FF,stroke:#2F5FA7,color:#0B1B33,stroke-width:1.2px;
  classDef render fill:#C9F2D2,stroke:#2F7D44,color:#0B1B33,stroke-width:1.2px;
  classDef gpu fill:#B8F0E8,stroke:#1C7C73,color:#0B1B33,stroke-width:1.2px;
  classDef cache fill:#FFF2B3,stroke:#B28700,color:#3A2A00,stroke-width:1.2px;
  classDef assets fill:#FFD1DC,stroke:#B94B63,color:#3A0F18,stroke-width:1.2px;
  classDef file fill:#FFFFFF,stroke:#777,color:#111,stroke-width:1.2px;
  classDef doc fill:#F4F4F4,stroke:#777,color:#111,stroke-dasharray: 4 3,stroke-width:1.2px;
```
