# angelteret/proyecto-progra architecture

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

- Interactive diagram: https://gitdiagram.com/angelteret/proyecto-progra
- Repository: https://github.com/angelteret/proyecto-progra

## Overview

##### Identificación del proyecto
- Tipo: Aplicación web full-stack de comercio electrónico.
- Propósito: Gestionar catálogo de productos, carrito y compras simuladas con un sistema bancario externo en Java, más herramientas de administración y logging.

##### Análisis de la estructura de ficheros
- src/controllers, routes.js, database.js → capa de backend (Express + lógica MVC).
- src/modelo/*.java (.class) y utilsBanco.js → integración con sistema bancario externo vía Child Process.
- src/public + src/views → frontend estático (HTML5/CSS3/JS ES6+), carrito, pago, chat de tramas y panel admin.
- src/logs + logger.js (Winston) → sistema de bitácora.
- database.sql → esquema MySQL.

##### Cómo dibujar el diagrama de arquitectura
a. Componentes principales
‑ Usuario (navegador)
‑ Frontend Público (HTML/CSS/JS, Multer uploads, SweetAlert2)
‑ Frontend Admin (páginas /admin/*)
‑ API HTTP (Express: routes.js)
‑ Controladores (controllers/*.js)
‑ Capa de persistencia (MySQL database)
‑ Integración bancaria
- utilsBanco.js → Java ClienteBanco (.class) → sockets TCP/IP → BancoExterno
‑ Logging (Winston → src/logs/app.log)

b. Relaciones e interacciones
‑ Flechas dirigidas:
Usuario → Frontend → API → Controladores → Base de datos
Controladores → utilsBanco → JavaClient → BancoExterno → Controladores → Frontend
Controladores → Logger → Archivo de logs
‑ Flujo de compra y flujo de chat de tramas comparten backend y lógica de pago.

c. Patrones arquitectónicos
‑ MVC ligero (views/public → controllers → modelo/BD)
‑ Capa de servicios JS desacoplada (public/js/services)
‑ Integración síncrona con proceso externo (Child Process + TCP/IP)
‑ Logging centralizado (Winston)

d. Tecnologías clave
‑ Node.js, Express.js, MySQL
‑ Java (.class) invocado con child_process
‑ Winston (logs), Multer (uploads), SweetAlert2 (notificaciones)

##### Guía para adaptar el diagrama a este full-stack
- Dibuja en vertical (top-down) para que no quede muy ancho.
- Agrupa frontend en un bloque, backend en otro, y servicios externos abajo.
- Muestra capas: presentación → API → lógica → datos / servicios.

##### Elementos que debe incluir el diagrama
- Etiquetas claras (p. ej. “Express API”, “MySQL DB”, “Java ClientBanco”)
- Flechas con direccionalidad y nombre del protocolo (HTTP, SQL, TCP)
- Colores o formas distintas:
- Azul para componentes internos Node
- Verde para frontend
- Naranja para servicios externos (Java, banco)
- Gris para persistencia (MySQL, logs)

##### Consejos finales
- Detalla cada bloque: incluye puertos (3000), endpoints clave (/api/trama, /admin/*).
- Añade leyenda de colores y protocolos.
- Verifica que las flechas no se crucen y el diseño sea fluido de arriba hacia abajo.
- Revisa que cubre todos los casos de uso: compra, pago, chat de tramas, logging, administración.
- Ajusta tamaños para convertirse en un diagrama legible y vertical.

## Diagram (Mermaid)

```mermaid
graph TB
  %% User
  User["Usuario (Navegador)"]:::frontend

  %% Frontend Público
  subgraph "Frontend Público"
    FP1["styles.css"]:::frontend
    FP2["main.js"]:::frontend
    FP3["chat.js"]:::frontend
    FP4["apiService.js"]:::frontend
  end

  %% Frontend Admin
  subgraph "Frontend Admin"
    FA1["auth.js"]:::frontend
    FA2["dashboard.js"]:::frontend
    FA3["categorias.js"]:::frontend
    FA4["productos.js"]:::frontend
    FA5["login.html"]:::frontend
    FA6["dashboard.html"]:::frontend
    FA7["categorias.html"]:::frontend
    FA8["productos.html"]:::frontend
  end

  %% Backend
  subgraph "Backend (Node.js/Express)" 
    Routes["Express API (routes.js)"]:::node
    Controllers["Controladores"]:::node
    DB["MySQL Database"]:::db
    Logger["Logger (Winston)"]:::db
    UtilsBanco["utilsBanco.js"]:::node
  end

  %% Integración bancaria
  subgraph "Integración Bancaria"
    JavaClient["ClienteBanco.java"]:::external
    Bank["BancoExterno (TCP/IP)"]:::external
  end

  %% Flujos
  User -->|"Interfaz Pública"| FP1
  FP1 --> FP2
  FP2 --> FP4
  FP2 --> FP3

  User -->|"Interfaz Admin"| FA5
  FA5 --> FA1
  FA1 --> FA2
  FA1 --> FA3
  FA1 --> FA4

  FP4 -->|"HTTP"| Routes
  FA4 -->|"HTTP"| Routes

  Routes -->|"calls"| Controllers
  Controllers -->|"SQL"| DB
  Controllers -->|"log"| Logger
  Controllers -->|"child_process"| UtilsBanco

  UtilsBanco -->|"spawn java"| JavaClient
  JavaClient -->|"TCP/IP"| Bank
  Bank -->|"TCP/IP"| JavaClient
  JavaClient -->|"respuesta"| UtilsBanco

  %% Click Events Publico
  click FP1 "https://github.com/angelteret/proyecto-progra/blob/main/src/public/styles/styles.css"
  click FP2 "https://github.com/angelteret/proyecto-progra/blob/main/src/public/js/main.js"
  click FP3 "https://github.com/angelteret/proyecto-progra/blob/main/src/public/js/chat.js"
  click FP4 "https://github.com/angelteret/proyecto-progra/blob/main/src/public/js/services/apiService.js"
  click FP1 "https://github.com/angelteret/proyecto-progra/tree/main/src/public"
  %% Click Events Admin
  click FA1 "https://github.com/angelteret/proyecto-progra/blob/main/src/public/js/admin/auth.js"
  click FA2 "https://github.com/angelteret/proyecto-progra/blob/main/src/public/js/admin/dashboard.js"
  click FA3 "https://github.com/angelteret/proyecto-progra/blob/main/src/public/js/admin/categorias.js"
  click FA4 "https://github.com/angelteret/proyecto-progra/blob/main/src/public/js/admin/productos.js"
  click FA5 "https://github.com/angelteret/proyecto-progra/blob/main/src/views/admin/login.html"
  click FA6 "https://github.com/angelteret/proyecto-progra/blob/main/src/views/admin/dashboard.html"
  click FA7 "https://github.com/angelteret/proyecto-progra/blob/main/src/views/admin/categorias.html"
  click FA8 "https://github.com/angelteret/proyecto-progra/blob/main/src/views/admin/productos.html"
  click Routes "https://github.com/angelteret/proyecto-progra/blob/main/src/routes.js"
  click Controllers "https://github.com/angelteret/proyecto-progra/tree/main/src/controllers"
  click DB "https://github.com/angelteret/proyecto-progra/blob/main/src/database.js"
  click Bank "https://github.com/angelteret/proyecto-progra/blob/main/src/modelo/ClienteBanco.java"
  click UtilsBanco "https://github.com/angelteret/proyecto-progra/blob/main/src/utilsBanco.js"
  click Logger "https://github.com/angelteret/proyecto-progra/blob/main/src/logger.js"
  click Logger "https://github.com/angelteret/proyecto-progra/tree/main/src/logs"

  %% Styles
  classDef frontend fill:#9f6,stroke:#333,stroke-width:1px;
  classDef node fill:#6cf,stroke:#333,stroke-width:1px;
  classDef external fill:#f96,stroke:#333,stroke-width:1px;
  classDef db fill:#bbb,stroke:#333,stroke-width:1px;
```
