# victornavarreteduran/apb-web-server architecture

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

- Interactive diagram: https://gitdiagram.com/victornavarreteduran/apb-web-server
- Repository: https://github.com/victornavarreteduran/apb-web-server

## Overview

Es una aplicación Express con vistas Handlebars para gestionar usuarios y una API JSON que también consume el cliente web. El flujo principal entra por las rutas, pasa al controlador para validar y ejecutar operaciones, y usa modelos Sequelize sobre PostgreSQL; altas transaccionales crean además historial. El producto incluye autenticación/perfil, estado del servidor y trazabilidad en archivo. Los vínculos se limitan a llamadas visibles en los extractos y capacidades descritas en el README; no se inspeccionaron vistas ni módulos no incluidos.

Main entry points: [`src/controllers/mainController.js`](https://github.com/victornavarreteduran/apb-web-server/blob/main/src/controllers/mainController.js) (Lógica de solicitudes), [`src/config/database.js`](https://github.com/victornavarreteduran/apb-web-server/blob/main/src/config/database.js) (Conexión PostgreSQL), [`server.js`](https://github.com/victornavarreteduran/apb-web-server/blob/main/server.js) (Servidor Express), [`src/routes/index.js`](https://github.com/victornavarreteduran/apb-web-server/blob/main/src/routes/index.js) (Rutas HTTP)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Interfaz web"]
  node_webviews["Vistas SSR"]
  node_client["Interfaz API<br/>[main.js]"]
end

subgraph group_app["Aplicación"]
  node_server["Servidor Express<br/>[server.js]"]
  node_routes["Rutas HTTP<br/>[index.js]"]
  node_controller["Lógica de solicitudes<br/>[mainController.js]"]
  node_sessions["Sesiones y autenticación<br/>[session.js]"]
end

subgraph group_data["Datos y trazabilidad"]
  node_dbconfig["Conexión PostgreSQL<br/>[database.js]"]
  node_usermodel["Modelo de usuario<br/>[user.js]"]
  node_historymodel["Modelo de historial<br/>[userHistory.js]"]
  node_postgres[("PostgreSQL")]
  node_logs["Archivo de logs<br/>[log.txt]"]
  node_logger["Middleware de logs<br/>[loggers.js]"]
end

node_visitor(("Usuario o cliente HTTP"))

node_visitor -->|"solicita"| node_server
node_server -->|"monta rutas"| node_routes
node_routes -->|"despacha"| node_controller
node_routes -->|"protege perfil"| node_sessions
node_controller -->|"gestiona sesión"| node_sessions
node_controller -.->|"renderiza vistas"| node_webviews
node_client -->|"muestra resultados"| node_visitor
node_client -->|"consulta y muta API"| node_routes
node_controller -->|"consulta y modifica"| node_usermodel
node_controller -->|"registra alta"| node_historymodel
node_controller -->|"abre transacción"| node_dbconfig
node_server -->|"verifica y sincroniza"| node_dbconfig
node_usermodel -->|"usa conexión"| node_dbconfig
node_historymodel -->|"usa conexión"| node_dbconfig
node_dbconfig -->|"conecta"| node_postgres
node_controller -->|"escribe operaciones"| node_logger
node_server -->|"registra accesos"| node_logger
node_logger -->|"añade entradas"| node_logs

click node_server "https://github.com/victornavarreteduran/apb-web-server/blob/main/server.js"
click node_routes "https://github.com/victornavarreteduran/apb-web-server/blob/main/src/routes/index.js"
click node_controller "https://github.com/victornavarreteduran/apb-web-server/blob/main/src/controllers/mainController.js"
click node_sessions "https://github.com/victornavarreteduran/apb-web-server/blob/main/src/middlewares/session.js"
click node_webviews "https://github.com/victornavarreteduran/apb-web-server/tree/main/src/views"
click node_client "https://github.com/victornavarreteduran/apb-web-server/blob/main/public/js/main.js"
click node_dbconfig "https://github.com/victornavarreteduran/apb-web-server/blob/main/src/config/database.js"
click node_usermodel "https://github.com/victornavarreteduran/apb-web-server/blob/main/src/models/user.js"
click node_historymodel "https://github.com/victornavarreteduran/apb-web-server/blob/main/src/models/userHistory.js"
click node_logs "https://github.com/victornavarreteduran/apb-web-server/blob/main/logs/log.txt"
click node_logger "https://github.com/victornavarreteduran/apb-web-server/blob/main/src/middlewares/loggers.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webviews,node_client,node_visitor toneBlue
class node_server,node_routes,node_controller,node_sessions toneAmber
class node_dbconfig,node_usermodel,node_historymodel,node_postgres,node_logs,node_logger toneMint
```

## Components

### Interfaz web

- [Vistas SSR](https://github.com/victornavarreteduran/apb-web-server/tree/main/src/views): `src/views`
- [Interfaz API](https://github.com/victornavarreteduran/apb-web-server/blob/main/public/js/main.js): `public/js/main.js`

### Aplicación

- [Servidor Express](https://github.com/victornavarreteduran/apb-web-server/blob/main/server.js): `server.js`
- [Rutas HTTP](https://github.com/victornavarreteduran/apb-web-server/blob/main/src/routes/index.js): `src/routes/index.js`
- [Lógica de solicitudes](https://github.com/victornavarreteduran/apb-web-server/blob/main/src/controllers/mainController.js): `src/controllers/mainController.js`
- [Sesiones y autenticación](https://github.com/victornavarreteduran/apb-web-server/blob/main/src/middlewares/session.js): `src/middlewares/session.js`

### Datos y trazabilidad

- [Conexión PostgreSQL](https://github.com/victornavarreteduran/apb-web-server/blob/main/src/config/database.js): `src/config/database.js`
- [Modelo de usuario](https://github.com/victornavarreteduran/apb-web-server/blob/main/src/models/user.js): `src/models/user.js`
- [Modelo de historial](https://github.com/victornavarreteduran/apb-web-server/blob/main/src/models/userHistory.js): `src/models/userHistory.js`
- **PostgreSQL**
- [Archivo de logs](https://github.com/victornavarreteduran/apb-web-server/blob/main/logs/log.txt): `logs/log.txt`
- [Middleware de logs](https://github.com/victornavarreteduran/apb-web-server/blob/main/src/middlewares/loggers.js): `src/middlewares/loggers.js`

### Other components

- **Usuario o cliente HTTP**

## Connections

- Usuario o cliente HTTP → Servidor Express: solicita (evidence: `server.js`)
- Servidor Express → Rutas HTTP: monta rutas (evidence: `server.js`)
- Rutas HTTP → Lógica de solicitudes: despacha (evidence: `src/routes/index.js`)
- Rutas HTTP → Sesiones y autenticación: protege perfil (evidence: `src/routes/index.js`)
- Lógica de solicitudes → Sesiones y autenticación: gestiona sesión (evidence: `src/controllers/mainController.js`)
- Lógica de solicitudes → Vistas SSR: renderiza vistas
- Interfaz API → Usuario o cliente HTTP: muestra resultados (evidence: `public/js/main.js`)
- Interfaz API → Rutas HTTP: consulta y muta API (evidence: `public/js/main.js`)
- Lógica de solicitudes → Modelo de usuario: consulta y modifica (evidence: `src/controllers/mainController.js`)
- Lógica de solicitudes → Modelo de historial: registra alta (evidence: `src/controllers/mainController.js`)
- Lógica de solicitudes → Conexión PostgreSQL: abre transacción (evidence: `src/controllers/mainController.js`)
- Servidor Express → Conexión PostgreSQL: verifica y sincroniza (evidence: `server.js`)
- Modelo de usuario → Conexión PostgreSQL: usa conexión (evidence: `src/models/user.js`)
- Modelo de historial → Conexión PostgreSQL: usa conexión (evidence: `src/models/userHistory.js`)
- Conexión PostgreSQL → PostgreSQL: conecta (evidence: `src/config/database.js`)
- Lógica de solicitudes → Middleware de logs: escribe operaciones (evidence: `src/controllers/mainController.js`)
- Servidor Express → Middleware de logs: registra accesos (evidence: `server.js`)
- Middleware de logs → Archivo de logs: añade entradas (evidence: `src/middlewares/loggers.js`)
