# bravosoon54/tetris architecture

> Architecture diagram of the GitHub repository bravosoon54/tetris, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bravosoon54/tetris
- Repository: https://github.com/bravosoon54/tetris

## Overview

##### Proyecto, propósito y tipo
- Este es un proyecto “front-end only”: un juego de Tetris desarrollado en HTML, CSS y JavaScript puro.
- No hay backend, base de datos ni microservicios: todo sucede en el navegador del usuario.

##### Análisis de la estructura de archivos
- index.html: punto de entrada, incluye referencias a estilos, scripts y assets.
- css/estilos.css: define colores, posiciones y animaciones CSS.
- js/codigo.js: contiene la lógica del juego (generación de piezas, detección de colisiones, control de input, puntajes, bucle de render).
- audio/*.m4a: efectos de sonido para movimientos, rotaciones y “game over”.
- Particles.js (mencionado en README): librería externa para fondo animado.

##### Cómo modelar el diagrama de arquitectura
a. Componentes principales
- Navegador / Cliente
- Carga de recursos (index.html)
- Capa de presentación
- HTML (estructura del tablero y botones)
- CSS (estilos, animaciones)
- Particles.js (fondo animado)
- Motor de juego (JavaScript)
- Input Handler (teclas, eventos)
- Game State Manager (tablero, piezas, puntaje)
- Collision Detector (lógica de encaje de piezas)
- Renderer (dibujar en DOM / Canvas)
- Audio Manager (reproducir audio/*.m4a)
- Assets externos
- Sonidos (.m4a)
- Librería Particles.js

b. Relaciones e interacciones
- El navegador carga index.html
- index.html enlaza a estilos.css, codigo.js, audio y Particles.js
- El Game Engine registra event listeners en el DOM (Input Handler)
- Cada tick del bucle de juego:
- Game State Manager actualiza la posición de las piezas
- Collision Detector valida movimientos
- Renderer aplica cambios al DOM/Canvas y dispara animaciones CSS
- Audio Manager reproduce sonidos según eventos (movimiento, línea completa, game over)
- Particles.js corre en paralelo para animar el fondo sin interferir con la lógica de Tetris

c. Patrones y principios arquitectónicos
- Separación de responsabilidades:
- Presentación (HTML + CSS + Particles.js)
- Lógica de juego (JS puro, módulos conceptuales)
- Gestión de audio (componentizado dentro de JS)
- Bucle de juego (Game Loop) con clear separation entre update() y render()
- Gestión de eventos (Event-driven design para input y audio)

d. Tecnologías y librerías clave
- HTML5, CSS3
- JavaScript ES6+
- API de Audio del navegador
- Particles.js para fondo animado

##### Guía para el diagrama
- Usa rectángulos o contenedores coloreados:
- Azul claro para “Front-End” (HTML/CSS)
- Verde para “Game Engine” (JS)
- Naranja para “Assets” (audio, Particles.js)
- Etiqueta cada componente: p.ej. “Input Handler”, “Collision Detector”
- Flechas direccionales:
- Navegador → index.html → (CSS, JS, Assets)
- JS Game Loop → DOM updates → Browser render
- JS events → Audio Manager → API Web Audio
- Leyenda para tipos de flechas (flujo de datos vs. dependencias)

##### Elementos imprescindibles en el diagrama
- Componentes claramente nombrados
- Flechas que muestren secuencia y dependencia
- Colores o formas distintas para:
- Presentación vs. lógica vs. recursos
- Notas breves junto a flechas clave (p.ej. “keypress → move piece”)

Con este diagrama detallado y coloreado, el equipo podrá ver de un vistazo cómo fluye la información desde el input del usuario hasta la representación gráfica y sonora, y entenderá la separación de responsabilidades dentro del juego Tetris.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Browser["Browser / Client"]:::frontend

    subgraph "Front-End"
        HTML["index.html"]:::frontend
        CSS["Presentation Styles (CSS)"]:::frontend
        Particles["Particles.js (Background)"]:::frontend
    end

    subgraph "Game Engine"
        JSMain["Game Engine (codigo.js)"]:::game
        Input["Input Handler"]:::game
        State["Game State Manager"]:::game
        Collision["Collision Detector"]:::game
        Render["Renderer"]:::game
        AudioMgr["Audio Manager"]:::game
    end

    subgraph "Assets"
        AudioDir["Audio Assets"]:::assets
        arriba["arriba.m4a"]:::assets
        arriba2["arriba2.m4a"]:::assets
        caer["caer.m4a"]:::assets
        mover["mover.m4a"]:::assets
    end

    Browser --> HTML
    HTML --> CSS
    HTML --> JSMain
    HTML --> Particles
    HTML --> AudioDir

    JSMain --> Input
    Input --> State
    State --> Collision
    Collision --> Render
    Render -->|"DOM updates"| Browser

    Input -->|"keypress→move piece"| AudioMgr
    State -->|"line complete/game over"| AudioMgr
    AudioMgr -->|"plays sound via Web Audio API"| Browser

    AudioDir --> arriba
    AudioDir --> arriba2
    AudioDir --> caer
    AudioDir --> mover

    click HTML "https://github.com/bravosoon54/tetris/blob/main/index.html"
    click CSS "https://github.com/bravosoon54/tetris/blob/main/css/estilos.css"
    click JSMain "https://github.com/bravosoon54/tetris/blob/main/js/codigo.js"
    click Input "https://github.com/bravosoon54/tetris/blob/main/js/codigo.js"
    click State "https://github.com/bravosoon54/tetris/blob/main/js/codigo.js"
    click Collision "https://github.com/bravosoon54/tetris/blob/main/js/codigo.js"
    click Render "https://github.com/bravosoon54/tetris/blob/main/js/codigo.js"
    click AudioMgr "https://github.com/bravosoon54/tetris/blob/main/js/codigo.js"
    click AudioDir "https://github.com/bravosoon54/tetris/tree/main/audio/"
    click arriba "https://github.com/bravosoon54/tetris/blob/main/audio/arriba.m4a"
    click arriba2 "https://github.com/bravosoon54/tetris/blob/main/audio/arriba2.m4a"
    click caer "https://github.com/bravosoon54/tetris/blob/main/audio/caer.m4a"
    click mover "https://github.com/bravosoon54/tetris/blob/main/audio/mover.m4a"

    classDef frontend fill:#ADD8E6,stroke:#000,stroke-width:1px;
    classDef game fill:#90EE90,stroke:#000,stroke-width:1px;
    classDef assets fill:#FFA500,stroke:#000,stroke-width:1px;
```
