# sebas830/proyectofinalcompiladores architecture

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

- Interactive diagram: https://gitdiagram.com/sebas830/proyectofinalcompiladores
- Repository: https://github.com/sebas830/proyectofinalcompiladores

## Overview

Para dibujar un diagrama de arquitectura claro y preciso de este proyecto de compilador web interactivo, sigue estos pasos adaptados a su estructura y propósito:

##### Identificación del tipo y propósito del proyecto
- Es una aplicación web didáctica (tipo full‑stack ligero) que ilustra los procesos de análisis léxico, sintáctico y semántico en el navegador.
- Combina un servidor Node.js que sirve archivos estáticos y un frontend (HTML/CSS/JS) con módulos de compilación (lexer, parser, semantic).

##### Análisis de la estructura de directorios
- Top‑level:
- server.js y package.json → servidor Node.js (e.g., usando “serve”).
- index.html, USAGE.md → entrada y documentación del frontend.
- Folder compilador‑grupo_uno:
- frontend/ → assets estáticos y hojas de estilo CSS para cada análisis.
- src/ → módulos JS: lexer.js, parser.js, semantic.js.
- docs/ → documentación del compilador (fuera de la ruta de ejecución).

##### Componentes principales a representar
a. Cliente (navegador web)
- UI (index.html + estilos CSS).
- Controlador de eventos (botones “Léxico”, “Sintáctico”, “Semántico”).
- Módulos JS cargados en el navegador:
– Lexer (lexical analysis)
– Parser (syntactic analysis + AST generation)
– Semantic (semantic rules, symbol table)
b. Servidor Node.js
- Punto de entrada: server.js
- Servicio de archivos estáticos (HTML, CSS, JS, assets).
c. Sistema de archivos
- Directorio de build/deployment con todos los assets.

##### Relaciones e interacciones
- El usuario abre la URL (GET) → navegador solicita index.html al servidor Node.js.
- El servidor devuelve recursos estáticos (HTML, CSS, JS).
- El navegador renderiza la UI y carga los módulos JS.
- Al hacer clic en un botón de análisis, la UI invoca la función correspondiente en el módulo (lexer/parser/semantic).
- El módulo procesa el texto ingresado y devuelve tokens/AST/errores.
- La UI recibe el resultado y actualiza el DOM (lista de tokens, árbol sintáctico, mensajes semánticos).

##### Patrones y principios arquitecturales
- Arquitectura “SPA” ligera: cliente hace todo el procesamiento, el servidor solo sirve estáticos.
- Código modular en el frontend: separación de responsabilidades (3 módulos de análisis).
- Flujo unidireccional de datos: Input → Módulo → UI.

##### Cómo adaptar el diagrama a este proyecto
- Usa rectángulos grandes para agrupar “Frontend (Browser)” y “Backend (Node.js)”.
- Dentro del frontend, dibuja tres sub‑componentes: Lexer, Parser, Semantic.
- Muestra el flujo de datos: Usuario → UI → Módulo → UI.
- Entre Frontend y Backend, dibuja flechas HTTP GET para recursos estáticos.
- Incluye un componente “File System” o “Static Assets” conectado al servidor.

##### Elementos clave y recomendaciones de estilo
- Etiquetas claras: “Navegador”, “Server.js (Node.js)”, “lexer.js”, etc.
- Flechas con sentido:
- Requests HTTP → servidor
- Carga de módulos → navegador
- Flujo de procesamiento de texto → módulos
- Azul para componentes de red (Browser ↔ Server)
- Verde para módulos de análisis (lex, parse, semantic)
- Gris para filesystem/assets
- Añade notas indicando tecnologías: HTML5, CSS, JavaScript, Node.js.

##### Detalle y profundidad
- Incluye en el diagrama todos los archivos de configuración relevantes (package.json) como nota en el servidor.
- Si quieres, marca las carpetas frontend/ y src/ para enfatizar la separación de estilos y lógica de negocio.
- No sobrecargues con cada archivo CSS, basta con agruparlos bajo “Assets estáticos (CSS, imágenes)”.

Con este enfoque tendrás un diagrama que:
- Refleja fielmente la naturaleza SPA de la aplicación.
- Muestra claramente la modularidad de los componentes de compilación.
- Detalla el papel mínimo del servidor Node.js.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend (Browser)"
        subgraph "Client UI"
            IndexHTML["index.html"]:::frontend
            AssetsDir["assets"]:::fs
            StylesLexico["stylesLexico.css"]:::fs
            StylesSintactico["stylesSintactico.css"]:::fs
            StylesSemantico["stylesSemantico.css"]:::fs
            EventController["Event Controller"]:::frontend
        end
        subgraph "Compilation Modules"
            Lexer["lexer.js"]:::module
            Parser["parser.js"]:::module
            Semantic["semantic.js"]:::module
        end
    end

    %% Backend Layer
    subgraph "Backend (Node.js)"
        Server["server.js"]:::backend
        Package["package.json"]:::backend
    end

    %% Documentation
    subgraph "Documentation"
        Docs1["Documentación Compilador.pdf"]:::fs
        Docs2["INFORME PROYECTO FINAL.pdf"]:::fs
        Docs3["informe-tecnico.txt"]:::fs
        Usage["USAGE.md"]:::fs
    end

    %% External User
    User["Usuario"]:::network

    %% Connections
    User -->|"opens URL"| IndexHTML
    IndexHTML -->|"GET request"| Server
    Server -->|"serves HTML"| IndexHTML
    Server -->|"serves assets"| AssetsDir
    Server -->|"serves CSS"| StylesLexico
    Server -->|"serves CSS"| StylesSintactico
    Server -->|"serves CSS"| StylesSemantico
    Server -->|"reads config"| Package

    IndexHTML -->|"registers listeners"| EventController
    EventController -->|"invoke"| Lexer
    EventController -->|"invoke"| Parser
    EventController -->|"invoke"| Semantic

    Lexer -->|"returns tokens"| IndexHTML
    Parser -->|"returns AST"| IndexHTML
    Semantic -->|"returns results"| IndexHTML

    %% Click Events
    click IndexHTML "https://github.com/sebas830/proyectofinalcompiladores/blob/main/index.html"
    click AssetsDir "https://github.com/sebas830/proyectofinalcompiladores/tree/main/compilador-grupo_uno/frontend/assets"
    click StylesLexico "https://github.com/sebas830/proyectofinalcompiladores/blob/main/compilador-grupo_uno/frontend/stylesLexico.css"
    click StylesSintactico "https://github.com/sebas830/proyectofinalcompiladores/blob/main/compilador-grupo_uno/frontend/stylesSintactico.css"
    click StylesSemantico "https://github.com/sebas830/proyectofinalcompiladores/blob/main/compilador-grupo_uno/frontend/stylesSemantico.css"
    click EventController "https://github.com/sebas830/proyectofinalcompiladores/blob/main/index.html"
    click Lexer "https://github.com/sebas830/proyectofinalcompiladores/blob/main/compilador-grupo_uno/src/lexer.js"
    click Parser "https://github.com/sebas830/proyectofinalcompiladores/blob/main/compilador-grupo_uno/src/parser.js"
    click Semantic "https://github.com/sebas830/proyectofinalcompiladores/blob/main/compilador-grupo_uno/src/semantic.js"
    click Server "https://github.com/sebas830/proyectofinalcompiladores/blob/main/server.js"
    click Package "https://github.com/sebas830/proyectofinalcompiladores/blob/main/package.json"
    click Docs1 "https://github.com/sebas830/proyectofinalcompiladores/blob/main/compilador-grupo_uno/docs/Documentación Compilador.pdf"
    click Docs2 "https://github.com/sebas830/proyectofinalcompiladores/blob/main/compilador-grupo_uno/docs/INFORME PROYECTO FINAL.pdf"
    click Docs3 "https://github.com/sebas830/proyectofinalcompiladores/blob/main/compilador-grupo_uno/docs/informe-tecnico.txt"
    click Usage "https://github.com/sebas830/proyectofinalcompiladores/blob/main/USAGE.md"

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#2a6496,color:#000;
    classDef module fill:#d4edda,stroke:#3c763d,color:#000;
    classDef backend fill:#fff3cd,stroke:#8a6d3b,color:#000;
    classDef fs fill:#e2e3e5,stroke:#ccc,color:#000;
    classDef network fill:#b8daff,stroke:#31708f,color:#000;
```
