# pablofls/libreria architecture

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

- Interactive diagram: https://gitdiagram.com/pablofls/libreria
- Repository: https://github.com/pablofls/libreria

## Overview

Librería Online is a monorepo centered on a server-rendered Express/PostgreSQL bookstore monolith; it also contains an Electron XML client, independent Flask services, and SOAP classification clients. The primary workflow is browser request → Express routes and middleware → domain controller and validation → model/PostgreSQL → rendered HTML. Other documented product branches cover catalog XML/JSON, ordering and payments, user services, and cloud classification. Edges reflect README statements and shown source references; unsampled service internals and inter-service links are not inferred.

Main entry points: [`apps/web-monolito/src/modules`](https://github.com/pablofls/libreria/tree/main/apps/web-monolito/src/modules) (Domain controllers), [`apps/web-monolito/app.js`](https://github.com/pablofls/libreria/blob/main/apps/web-monolito/app.js) (Express application), [`apps/services/soap/soap/service.py`](https://github.com/pablofls/libreria/blob/main/apps/services/soap/soap/service.py) (Classification service), [`apps/web-monolito/config/db.js`](https://github.com/pablofls/libreria/blob/main/apps/web-monolito/config/db.js) (Database pool)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web monolith"]
  node_webapp["Express application<br/>[app.js]"]
  node_routes["Domain routes"]
  node_middleware["Request middleware"]
  node_controllers["Domain controllers"]
  node_validation["Input validation<br/>[validacion.js]"]
  node_cataloglogic["Catalog CRUD<br/>[crudCatalogo.js]"]
  node_bookdata["Book data access<br/>[libros.model.js]"]
  node_authmodel["Auth data access<br/>[auth.model.js]"]
  node_dbconfig["Database pool<br/>[db.js]"]
end

subgraph group_clients["Desktop clients"]
  node_electronmain["Electron main<br/>[main.js]"]
  node_electronrenderer["Electron renderer<br/>[renderer.js]"]
end

subgraph group_services["Flask services"]
  node_catalogservice["Catalog XML/JSON<br/>[app.py]"]
  node_userservice["Users and roles<br/>[app.py]"]
  node_loginservice["Authentication service<br/>[app.py]"]
  node_authorsservice["Authors service<br/>[app.py]"]
  node_orderservice["Orders and stock<br/>[app.py]"]
  node_paymentservice["Payments<br/>[app.py]"]
end

subgraph group_classification["SOAP classification"]
  node_soapapp["SOAP HTTP adapter<br/>[app.py]"]
  node_soapservice["Classification service<br/>[service.py]"]
  node_soapdb["SOAP data access<br/>[acceso.py]"]
  node_pyclient["Python classifier client"]
  node_pygui["Python desktop UI<br/>[app_window.py]"]
  node_javaui["Java desktop UI<br/>[AppWindow.java]"]
  node_javaclient["Java SOAP client<br/>[SoapClient.java]"]
end

node_browser(("Browser user"))
node_postgres[("PostgreSQL")]

node_browser -->|"requests pages"| node_webapp
node_webapp -->|"applies middleware"| node_middleware
node_webapp -->|"mounts routes"| node_routes
node_routes -->|"dispatches to"| node_controllers
node_controllers -->|"validates input"| node_validation
node_controllers -->|"uses shared CRUD"| node_cataloglogic
node_controllers -->|"calls model"| node_bookdata
node_controllers -->|"calls model"| node_authmodel
node_bookdata -->|"uses pool"| node_dbconfig
node_authmodel -.->|"uses pool"| node_dbconfig
node_dbconfig -->|"queries"| node_postgres
node_controllers -->|"renders HTML"| node_browser
node_electronmain -.->|"bridges to"| node_electronrenderer
node_electronmain -->|"downloads XML"| node_catalogservice
node_browser -.->|"requests catalog"| node_catalogservice
node_pygui -->|"invokes classifier"| node_pyclient
node_pyclient -.->|"sends SOAP"| node_soapapp
node_javaui -->|"uses SOAP client"| node_javaclient
node_javaclient -.->|"posts SOAP"| node_soapapp
node_soapapp -->|"delegates requests"| node_soapservice
node_soapservice -->|"accesses data"| node_soapdb
node_soapservice -.->|"uses database"| node_postgres

click node_webapp "https://github.com/pablofls/libreria/blob/main/apps/web-monolito/app.js"
click node_routes "https://github.com/pablofls/libreria/tree/main/apps/web-monolito/src/modules"
click node_middleware "https://github.com/pablofls/libreria/tree/main/apps/web-monolito/middleware"
click node_controllers "https://github.com/pablofls/libreria/tree/main/apps/web-monolito/src/modules"
click node_validation "https://github.com/pablofls/libreria/blob/main/apps/web-monolito/services/validacion.js"
click node_cataloglogic "https://github.com/pablofls/libreria/blob/main/apps/web-monolito/services/crudCatalogo.js"
click node_bookdata "https://github.com/pablofls/libreria/blob/main/apps/web-monolito/src/modules/libros/libros.model.js"
click node_authmodel "https://github.com/pablofls/libreria/blob/main/apps/web-monolito/src/modules/auth/auth.model.js"
click node_dbconfig "https://github.com/pablofls/libreria/blob/main/apps/web-monolito/config/db.js"
click node_electronmain "https://github.com/pablofls/libreria/blob/main/apps/electron-app/main.js"
click node_electronrenderer "https://github.com/pablofls/libreria/blob/main/apps/electron-app/renderer/renderer.js"
click node_catalogservice "https://github.com/pablofls/libreria/blob/main/apps/services/catalogo/app.py"
click node_userservice "https://github.com/pablofls/libreria/blob/main/apps/services/users/app.py"
click node_loginservice "https://github.com/pablofls/libreria/blob/main/apps/services/login/app.py"
click node_authorsservice "https://github.com/pablofls/libreria/blob/main/apps/services/authors/app.py"
click node_orderservice "https://github.com/pablofls/libreria/blob/main/apps/services/pedidos/app.py"
click node_paymentservice "https://github.com/pablofls/libreria/blob/main/apps/services/pagos/app.py"
click node_soapapp "https://github.com/pablofls/libreria/blob/main/apps/services/soap/app.py"
click node_soapservice "https://github.com/pablofls/libreria/blob/main/apps/services/soap/soap/service.py"
click node_soapdb "https://github.com/pablofls/libreria/blob/main/apps/services/soap/db/acceso.py"
click node_pyclient "https://github.com/pablofls/libreria/blob/main/clients/clasificador_python/classifier/cloud_classifier.py"
click node_pygui "https://github.com/pablofls/libreria/blob/main/clients/clasificador_python/gui/app_window.py"
click node_javaui "https://github.com/pablofls/libreria/blob/main/clients/clasificador_java/src/gui/AppWindow.java"
click node_javaclient "https://github.com/pablofls/libreria/blob/main/clients/clasificador_java/src/soap/SoapClient.java"

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_webapp,node_routes,node_middleware,node_controllers,node_validation,node_cataloglogic,node_bookdata,node_authmodel,node_dbconfig,node_browser toneBlue
class node_electronmain,node_electronrenderer,node_postgres toneAmber
class node_catalogservice,node_userservice,node_loginservice,node_authorsservice,node_orderservice,node_paymentservice toneMint
class node_soapapp,node_soapservice,node_soapdb,node_pyclient,node_pygui,node_javaui,node_javaclient toneRose
```

## Components

### Web monolith

- [Express application](https://github.com/pablofls/libreria/blob/main/apps/web-monolito/app.js): `apps/web-monolito/app.js`
- [Domain routes](https://github.com/pablofls/libreria/tree/main/apps/web-monolito/src/modules): `apps/web-monolito/src/modules`
- [Request middleware](https://github.com/pablofls/libreria/tree/main/apps/web-monolito/middleware): `apps/web-monolito/middleware`
- [Domain controllers](https://github.com/pablofls/libreria/tree/main/apps/web-monolito/src/modules): `apps/web-monolito/src/modules`
- [Input validation](https://github.com/pablofls/libreria/blob/main/apps/web-monolito/services/validacion.js): `apps/web-monolito/services/validacion.js`
- [Catalog CRUD](https://github.com/pablofls/libreria/blob/main/apps/web-monolito/services/crudCatalogo.js): `apps/web-monolito/services/crudCatalogo.js`
- [Book data access](https://github.com/pablofls/libreria/blob/main/apps/web-monolito/src/modules/libros/libros.model.js): `apps/web-monolito/src/modules/libros/libros.model.js`
- [Auth data access](https://github.com/pablofls/libreria/blob/main/apps/web-monolito/src/modules/auth/auth.model.js): `apps/web-monolito/src/modules/auth/auth.model.js`
- [Database pool](https://github.com/pablofls/libreria/blob/main/apps/web-monolito/config/db.js): `apps/web-monolito/config/db.js`

### Desktop clients

- [Electron main](https://github.com/pablofls/libreria/blob/main/apps/electron-app/main.js): `apps/electron-app/main.js`
- [Electron renderer](https://github.com/pablofls/libreria/blob/main/apps/electron-app/renderer/renderer.js): `apps/electron-app/renderer/renderer.js`

### Flask services

- [Catalog XML/JSON](https://github.com/pablofls/libreria/blob/main/apps/services/catalogo/app.py): `apps/services/catalogo/app.py`
- [Users and roles](https://github.com/pablofls/libreria/blob/main/apps/services/users/app.py): `apps/services/users/app.py`
- [Authentication service](https://github.com/pablofls/libreria/blob/main/apps/services/login/app.py): `apps/services/login/app.py`
- [Authors service](https://github.com/pablofls/libreria/blob/main/apps/services/authors/app.py): `apps/services/authors/app.py`
- [Orders and stock](https://github.com/pablofls/libreria/blob/main/apps/services/pedidos/app.py): `apps/services/pedidos/app.py`
- [Payments](https://github.com/pablofls/libreria/blob/main/apps/services/pagos/app.py): `apps/services/pagos/app.py`

### SOAP classification

- [SOAP HTTP adapter](https://github.com/pablofls/libreria/blob/main/apps/services/soap/app.py): `apps/services/soap/app.py`
- [Classification service](https://github.com/pablofls/libreria/blob/main/apps/services/soap/soap/service.py): `apps/services/soap/soap/service.py`
- [SOAP data access](https://github.com/pablofls/libreria/blob/main/apps/services/soap/db/acceso.py): `apps/services/soap/db/acceso.py`
- [Python classifier client](https://github.com/pablofls/libreria/blob/main/clients/clasificador_python/classifier/cloud_classifier.py): `clients/clasificador_python/classifier/cloud_classifier.py`
- [Python desktop UI](https://github.com/pablofls/libreria/blob/main/clients/clasificador_python/gui/app_window.py): `clients/clasificador_python/gui/app_window.py`
- [Java desktop UI](https://github.com/pablofls/libreria/blob/main/clients/clasificador_java/src/gui/AppWindow.java): `clients/clasificador_java/src/gui/AppWindow.java`
- [Java SOAP client](https://github.com/pablofls/libreria/blob/main/clients/clasificador_java/src/soap/SoapClient.java): `clients/clasificador_java/src/soap/SoapClient.java`

### Other components

- **Browser user**
- **PostgreSQL**

## Connections

- Browser user → Express application: requests pages (evidence: `README.md`)
- Express application → Request middleware: applies middleware (evidence: `README.md`)
- Express application → Domain routes: mounts routes (evidence: `apps/web-monolito/app.js`)
- Domain routes → Domain controllers: dispatches to (evidence: `README.md`)
- Domain controllers → Input validation: validates input (evidence: `apps/web-monolito/src/modules/libros/libros.controller.js`)
- Domain controllers → Catalog CRUD: uses shared CRUD (evidence: `apps/web-monolito/src/modules/autores/autores.controller.js`)
- Domain controllers → Book data access: calls model (evidence: `apps/web-monolito/src/modules/libros/libros.controller.js`)
- Domain controllers → Auth data access: calls model (evidence: `apps/web-monolito/src/modules/auth/auth.controller.js`)
- Book data access → Database pool: uses pool (evidence: `apps/web-monolito/src/modules/libros/libros.model.js`)
- Auth data access → Database pool: uses pool
- Database pool → PostgreSQL: queries (evidence: `README.md`)
- Domain controllers → Browser user: renders HTML (evidence: `README.md`)
- Electron main → Electron renderer: bridges to
- Electron main → Catalog XML/JSON: downloads XML (evidence: `README.md`)
- Browser user → Catalog XML/JSON: requests catalog
- Python desktop UI → Python classifier client: invokes classifier (evidence: `clients/clasificador_python/gui/app_window.py`)
- Python classifier client → SOAP HTTP adapter: sends SOAP
- Java desktop UI → Java SOAP client: uses SOAP client (evidence: `clients/clasificador_java/src/gui/AppWindow.java`)
- Java SOAP client → SOAP HTTP adapter: posts SOAP
- SOAP HTTP adapter → Classification service: delegates requests (evidence: `apps/services/soap/app.py`)
- Classification service → SOAP data access: accesses data (evidence: `apps/services/soap/soap/service.py`)
- Classification service → PostgreSQL: uses database
