How sebas830/proyectofinalcompiladores works
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.