# pa1in/proyecto-si-2 architecture

> Architecture diagram of the GitHub repository pa1in/proyecto-si-2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pa1in/proyecto-si-2
- Repository: https://github.com/pa1in/proyecto-si-2

## Overview

Lesgo is an inventory module for a LEGO-set e-commerce business: its core workflow manages product and warehouse data, records stock movements, and exposes stock and reservation information to the e-commerce and logistics systems. The React interface covers product, warehouse, and stock-entry tasks; the NestJS API provides the broader documented integration workflows. The movement service excerpt is partial, so some internal movement details are represented at subsystem level rather than as inferred call chains.

Main entry points: [`Backend/src/movimientos/movimientos.controller.ts`](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/movimientos/movimientos.controller.ts) (Movement routes), [`Frontend/src/App.tsx`](https://github.com/pa1in/proyecto-si-2/blob/main/Frontend/src/App.tsx) (React application), [`Backend/src/stock/stock.service.ts`](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/stock/stock.service.ts) (Stock service), [`Backend/src/movimientos/movimientos.service.ts`](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/movimientos/movimientos.service.ts) (Movement service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Inventory interface"]
  node_webapp["React application<br/>[App.tsx]"]
  node_product_pages["Product pages<br/>[Productos.tsx]"]
  node_create_product["Create product<br/>[CrearProducto.tsx]"]
  node_stock_entry["Stock entry<br/>[IngresoStock.tsx]"]
  node_frontend_api["API client<br/>[api.ts]"]
end

subgraph group_api["Inventory API"]
  node_api_bootstrap["API bootstrap<br/>[main.ts]"]
  node_product_routes["Product routes"]
  node_warehouse_routes["Warehouse routes"]
  node_stock_routes["Stock routes"]
  node_movement_routes["Movement routes"]
  node_reservation_route["Reservation lookup"]
  node_api_guard["API key guard<br/>[api-key.guard.ts]"]
end

subgraph group_catalog["Product catalog"]
  node_catalog_service["Catalog service"]
  node_product_repo["Product repository"]
  node_topic_repo["Theme repository<br/>[tema.repository.ts]"]
end

subgraph group_stock["Warehouse stock"]
  node_stock_service["Stock service<br/>[stock.service.ts]"]
  node_stock_repo["Stock repository"]
  node_warehouse_repo["Warehouse repository"]
end

subgraph group_movement["Stock operations"]
  node_movement_service["Movement service"]
  node_movement_repo["Movement repository"]
end

node_staff(("Inventory staff"))
node_ecommerce(("E-commerce"))
node_logistics(("Logistics"))
node_postgres[("PostgreSQL")]

node_staff -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_product_pages
node_webapp -->|"routes to"| node_create_product
node_webapp -->|"routes to"| node_stock_entry
node_product_pages -->|"requests data"| node_frontend_api
node_create_product -->|"submits product"| node_frontend_api
node_stock_entry -.->|"submits entry"| node_frontend_api
node_frontend_api -->|"calls API"| node_product_routes
node_api_bootstrap -.->|"hosts routes"| node_product_routes
node_api_bootstrap -.->|"hosts routes"| node_warehouse_routes
node_api_bootstrap -.->|"hosts routes"| node_movement_routes
node_product_routes -->|"delegates to"| node_catalog_service
node_warehouse_routes -->|"delegates to"| node_stock_service
node_stock_routes -->|"delegates to"| node_stock_service
node_movement_routes -->|"delegates to"| node_movement_service
node_reservation_route -->|"delegates to"| node_movement_service
node_movement_routes -->|"guards integrations"| node_api_guard
node_reservation_route -->|"guards lookup"| node_api_guard
node_ecommerce -->|"reserves stock"| node_movement_routes
node_logistics -->|"reports handling"| node_movement_routes
node_catalog_service -->|"queries products"| node_product_repo
node_catalog_service -->|"queries themes"| node_topic_repo
node_stock_service -->|"queries stock"| node_stock_repo
node_stock_service -->|"queries warehouses"| node_warehouse_repo
node_movement_service -->|"updates stock"| node_stock_repo
node_movement_service -.->|"records operations"| node_movement_repo
node_product_repo -.->|"reads and writes"| node_postgres
node_topic_repo -.->|"reads"| node_postgres
node_stock_repo -->|"reads and updates"| node_postgres
node_warehouse_repo -.->|"reads and writes"| node_postgres
node_movement_repo -->|"reads and writes"| node_postgres

click node_webapp "https://github.com/pa1in/proyecto-si-2/blob/main/Frontend/src/App.tsx"
click node_product_pages "https://github.com/pa1in/proyecto-si-2/blob/main/Frontend/src/Productos.tsx"
click node_create_product "https://github.com/pa1in/proyecto-si-2/blob/main/Frontend/src/CrearProducto.tsx"
click node_stock_entry "https://github.com/pa1in/proyecto-si-2/blob/main/Frontend/src/IngresoStock.tsx"
click node_frontend_api "https://github.com/pa1in/proyecto-si-2/blob/main/Frontend/src/api.ts"
click node_api_bootstrap "https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/main.ts"
click node_product_routes "https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/catalogo/catalogo.controller.ts"
click node_warehouse_routes "https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/stock/bodegas.controller.ts"
click node_stock_routes "https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/stock/stock.controller.ts"
click node_movement_routes "https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/movimientos/movimientos.controller.ts"
click node_reservation_route "https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/movimientos/reservas.controller.ts"
click node_api_guard "https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/auth/api-key.guard.ts"
click node_catalog_service "https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/catalogo/catalogo.service.ts"
click node_product_repo "https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/catalogo/repositories/producto.repository.ts"
click node_topic_repo "https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/catalogo/repositories/tema.repository.ts"
click node_stock_service "https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/stock/stock.service.ts"
click node_stock_repo "https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/stock/repositories/stock.repository.ts"
click node_warehouse_repo "https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/stock/repositories/bodega.repository.ts"
click node_movement_service "https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/movimientos/movimientos.service.ts"
click node_movement_repo "https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/movimientos/repositories/movimiento.repository.ts"

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_product_pages,node_create_product,node_stock_entry,node_frontend_api toneBlue
class node_api_bootstrap,node_product_routes,node_warehouse_routes,node_stock_routes,node_movement_routes,node_reservation_route,node_api_guard,node_postgres toneAmber
class node_catalog_service,node_product_repo,node_topic_repo toneMint
class node_stock_service,node_stock_repo,node_warehouse_repo toneRose
class node_movement_service,node_movement_repo,node_staff,node_ecommerce,node_logistics toneIndigo
```

## Components

### Inventory interface

- [React application](https://github.com/pa1in/proyecto-si-2/blob/main/Frontend/src/App.tsx): `Frontend/src/App.tsx`
- [Product pages](https://github.com/pa1in/proyecto-si-2/blob/main/Frontend/src/Productos.tsx): `Frontend/src/Productos.tsx`
- [Create product](https://github.com/pa1in/proyecto-si-2/blob/main/Frontend/src/CrearProducto.tsx): `Frontend/src/CrearProducto.tsx`
- [Stock entry](https://github.com/pa1in/proyecto-si-2/blob/main/Frontend/src/IngresoStock.tsx): `Frontend/src/IngresoStock.tsx`
- [API client](https://github.com/pa1in/proyecto-si-2/blob/main/Frontend/src/api.ts): `Frontend/src/api.ts`

### Inventory API

- [API bootstrap](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/main.ts): `Backend/src/main.ts`
- [Product routes](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/catalogo/catalogo.controller.ts): `Backend/src/catalogo/catalogo.controller.ts`
- [Warehouse routes](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/stock/bodegas.controller.ts): `Backend/src/stock/bodegas.controller.ts`
- [Stock routes](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/stock/stock.controller.ts): `Backend/src/stock/stock.controller.ts`
- [Movement routes](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/movimientos/movimientos.controller.ts): `Backend/src/movimientos/movimientos.controller.ts`
- [Reservation lookup](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/movimientos/reservas.controller.ts): `Backend/src/movimientos/reservas.controller.ts`
- [API key guard](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/auth/api-key.guard.ts): `Backend/src/auth/api-key.guard.ts`

### Product catalog

- [Catalog service](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/catalogo/catalogo.service.ts): `Backend/src/catalogo/catalogo.service.ts`
- [Product repository](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/catalogo/repositories/producto.repository.ts): `Backend/src/catalogo/repositories/producto.repository.ts`
- [Theme repository](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/catalogo/repositories/tema.repository.ts): `Backend/src/catalogo/repositories/tema.repository.ts`

### Warehouse stock

- [Stock service](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/stock/stock.service.ts): `Backend/src/stock/stock.service.ts`
- [Stock repository](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/stock/repositories/stock.repository.ts): `Backend/src/stock/repositories/stock.repository.ts`
- [Warehouse repository](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/stock/repositories/bodega.repository.ts): `Backend/src/stock/repositories/bodega.repository.ts`

### Stock operations

- [Movement service](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/movimientos/movimientos.service.ts): `Backend/src/movimientos/movimientos.service.ts`
- [Movement repository](https://github.com/pa1in/proyecto-si-2/blob/main/Backend/src/movimientos/repositories/movimiento.repository.ts): `Backend/src/movimientos/repositories/movimiento.repository.ts`

### Other components

- **Inventory staff**
- **E-commerce**
- **Logistics**
- **PostgreSQL**

## Connections

- Inventory staff → React application: uses (evidence: `README.md`)
- React application → Product pages: routes to (evidence: `Frontend/src/App.tsx`)
- React application → Create product: routes to (evidence: `Frontend/src/App.tsx`)
- React application → Stock entry: routes to (evidence: `Frontend/src/App.tsx`)
- Product pages → API client: requests data (evidence: `Frontend/src/Productos.tsx`)
- Create product → API client: submits product (evidence: `Frontend/src/CrearProducto.tsx`)
- Stock entry → API client: submits entry
- API client → Product routes: calls API (evidence: `README.md`)
- API bootstrap → Product routes: hosts routes
- API bootstrap → Warehouse routes: hosts routes
- API bootstrap → Movement routes: hosts routes
- Product routes → Catalog service: delegates to (evidence: `Backend/src/catalogo/catalogo.controller.ts`)
- Warehouse routes → Stock service: delegates to (evidence: `Backend/src/stock/bodegas.controller.ts`)
- Stock routes → Stock service: delegates to (evidence: `Backend/src/stock/stock.controller.ts`)
- Movement routes → Movement service: delegates to (evidence: `Backend/src/movimientos/movimientos.controller.ts`)
- Reservation lookup → Movement service: delegates to (evidence: `Backend/src/movimientos/reservas.controller.ts`)
- Movement routes → API key guard: guards integrations (evidence: `Backend/src/movimientos/movimientos.controller.ts`)
- Reservation lookup → API key guard: guards lookup (evidence: `Backend/src/movimientos/reservas.controller.ts`)
- E-commerce → Movement routes: reserves stock (evidence: `Backend/src/movimientos/movimientos.controller.ts`)
- Logistics → Movement routes: reports handling (evidence: `Backend/src/movimientos/movimientos.controller.ts`)
- Catalog service → Product repository: queries products (evidence: `Backend/src/catalogo/catalogo.service.ts`)
- Catalog service → Theme repository: queries themes (evidence: `Backend/src/catalogo/catalogo.service.ts`)
- Stock service → Stock repository: queries stock (evidence: `Backend/src/stock/stock.service.ts`)
- Stock service → Warehouse repository: queries warehouses (evidence: `Backend/src/stock/stock.service.ts`)
- Movement service → Stock repository: updates stock (evidence: `Backend/src/movimientos/movimientos.service.ts`)
- Movement service → Movement repository: records operations (evidence: `Backend/src/movimientos/movimientos.service.ts`)
- Product repository → PostgreSQL: reads and writes
- Theme repository → PostgreSQL: reads
- Stock repository → PostgreSQL: reads and updates (evidence: `Backend/src/stock/repositories/stock.repository.ts`)
- Warehouse repository → PostgreSQL: reads and writes
- Movement repository → PostgreSQL: reads and writes (evidence: `Backend/src/movimientos/repositories/movimiento.repository.ts`)
