# techintobios/gestion-3d architecture

> Architecture diagram of the GitHub repository techintobios/gestion-3d, 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/techintobios/gestion-3d
- Repository: https://github.com/techintobios/gestion-3d

## Overview

ZUNOX 3D combina catálogo público y administración de pedidos en un sitio servido por la API. El recorrido principal va desde el panel al registro transaccional de una compra, y de allí al seguimiento público y los avisos por correo. Las relaciones entre módulos backend se apoyan en el índice de referencias y los extractos; la conexión del navegador con la API y las capacidades no muestreadas se basan en el README.

Main entry points: [`backend/Negocio/NegocioCompras.cs`](https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioCompras.cs) (Registro de compra), [`backend/Program.cs`](https://github.com/techintobios/gestion-3d/blob/main/backend/Program.cs) (Servidor web/API), [`backend/Negocio/NegocioPedidos.cs`](https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioPedidos.cs) (Gestión de pedidos), [`backend/Datos/AccesoDatos.cs`](https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/AccesoDatos.cs) (Acceso PostgreSQL)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Sitio web"]
  node_public_ui["Catálogo público<br/>[index.js]"]
  node_product_ui["Vista productos<br/>[products.js]"]
  node_tracking_ui["Seguimiento cliente<br/>[tracking.js]"]
  node_admin_ui["Panel admin<br/>[admin.js]"]
  node_tracking_admin_ui["Seguimiento admin<br/>[tracking-admin.js]"]
  node_api_client["Cliente API<br/>[api.js]"]
end

subgraph group_http["API y acceso"]
  node_program["Servidor web/API<br/>[Program.cs]"]
  node_auth["Autenticación<br/>[AuthController.cs]"]
  node_purchase_http["Recepción compra"]
  node_orders_http["Pedidos y estados"]
  node_catalog_http["API catálogo"]
  node_categories_http["API categorías"]
  node_customers_http["API clientes"]
end

subgraph group_domain["Reglas del negocio"]
  node_purchase_rules["Registro de compra<br/>[NegocioCompras.cs]"]
  node_order_rules["Gestión de pedidos<br/>[NegocioPedidos.cs]"]
  node_customer_rules["Gestión de clientes<br/>[NegocioClientes.cs]"]
  node_product_rules["Gestión de productos"]
  node_category_rules["Gestión de categorías"]
  node_state_rules["Estados de pedido"]
  node_mail["Avisos por mail<br/>[NegocioMail.cs]"]
  node_user_rules["Usuarios<br/>[NegocioUsuarios.cs]"]
  node_login_protection["Protección de acceso"]
end

subgraph group_persistence["Persistencia"]
  node_customer_dao["DAO clientes<br/>[DaoClientes.cs]"]
  node_orders_dao["DAO pedidos<br/>[DaoPedidos.cs]"]
  node_products_dao["DAO productos<br/>[DaoProductos.cs]"]
  node_categories_dao["DAO categorías<br/>[DaoCategorias.cs]"]
  node_details_dao["DAO detalles"]
  node_states_dao["DAO estados<br/>[DaoEstadoPedido.cs]"]
  node_users_dao["DAO usuarios<br/>[DaoUsuarios.cs]"]
  node_db_access["Acceso PostgreSQL<br/>[AccesoDatos.cs]"]
end

node_customer(("Cliente"))
node_admin(("Administrador"))
node_postgres[("PostgreSQL")]
node_resend["Resend"]

node_customer -->|"explora"| node_public_ui
node_customer -->|"consulta estado"| node_tracking_ui
node_admin -->|"gestiona pedidos"| node_admin_ui
node_admin -->|"actualiza estado"| node_tracking_admin_ui
node_public_ui -.->|"muestra catálogo"| node_product_ui
node_admin_ui -->|"usa"| node_api_client
node_tracking_admin_ui -->|"usa"| node_api_client
node_api_client -->|"solicita API"| node_program
node_program -.->|"sirve rutas"| node_auth
node_program -.->|"sirve rutas"| node_purchase_http
node_program -.->|"sirve rutas"| node_orders_http
node_program -.->|"sirve rutas"| node_catalog_http
node_program -.->|"sirve rutas"| node_categories_http
node_program -.->|"sirve rutas"| node_customers_http
node_purchase_http -->|"registra compra"| node_purchase_rules
node_orders_http -->|"gestiona pedidos"| node_order_rules
node_catalog_http -->|"gestiona productos"| node_product_rules
node_categories_http -->|"gestiona categorías"| node_category_rules
node_customers_http -->|"gestiona clientes"| node_customer_rules
node_auth -->|"autentica usuario"| node_user_rules
node_auth -->|"limita intentos"| node_login_protection
node_purchase_rules -->|"crea cliente"| node_customer_rules
node_purchase_rules -->|"crea pedido"| node_order_rules
node_purchase_rules -->|"valida venta"| node_product_rules
node_purchase_rules -->|"obtiene pendiente"| node_state_rules
node_purchase_rules -->|"notifica compra"| node_mail
node_order_rules -->|"busca cliente"| node_customer_rules
node_order_rules -->|"resuelve estado"| node_state_rules
node_order_rules -->|"avisa cambio"| node_mail
node_customer_rules -->|"consulta datos"| node_customer_dao
node_purchase_rules -->|"abre transacción"| node_db_access
node_purchase_rules -.->|"guarda detalles"| node_details_dao
node_order_rules -->|"consulta y cambia"| node_orders_dao
node_product_rules -->|"consulta productos"| node_products_dao
node_category_rules -->|"consulta categorías"| node_categories_dao
node_state_rules -->|"consulta estados"| node_states_dao
node_user_rules -->|"consulta usuarios"| node_users_dao
node_customer_dao -->|"consulta PostgreSQL"| node_db_access
node_orders_dao -->|"consulta PostgreSQL"| node_db_access
node_products_dao -->|"consulta PostgreSQL"| node_db_access
node_db_access -->|"conecta"| node_postgres
node_mail -->|"envía correo"| node_resend

click node_public_ui "https://github.com/techintobios/gestion-3d/blob/main/frontend/JavaScript/index.js"
click node_product_ui "https://github.com/techintobios/gestion-3d/blob/main/frontend/JavaScript/products.js"
click node_tracking_ui "https://github.com/techintobios/gestion-3d/blob/main/frontend/JavaScript/tracking.js"
click node_admin_ui "https://github.com/techintobios/gestion-3d/blob/main/frontend/JavaScript/admin.js"
click node_tracking_admin_ui "https://github.com/techintobios/gestion-3d/blob/main/frontend/JavaScript/tracking-admin.js"
click node_api_client "https://github.com/techintobios/gestion-3d/blob/main/frontend/JavaScript/api.js"
click node_program "https://github.com/techintobios/gestion-3d/blob/main/backend/Program.cs"
click node_auth "https://github.com/techintobios/gestion-3d/blob/main/backend/Controllers/AuthController.cs"
click node_purchase_http "https://github.com/techintobios/gestion-3d/blob/main/backend/Controllers/ComprasController.cs"
click node_orders_http "https://github.com/techintobios/gestion-3d/blob/main/backend/Controllers/PedidosController.cs"
click node_catalog_http "https://github.com/techintobios/gestion-3d/blob/main/backend/Controllers/ProductosController.cs"
click node_categories_http "https://github.com/techintobios/gestion-3d/blob/main/backend/Controllers/CategoriasController.cs"
click node_customers_http "https://github.com/techintobios/gestion-3d/blob/main/backend/Controllers/ClientesController.cs"
click node_purchase_rules "https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioCompras.cs"
click node_order_rules "https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioPedidos.cs"
click node_customer_rules "https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioClientes.cs"
click node_product_rules "https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioProductos.cs"
click node_category_rules "https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioCategorias.cs"
click node_state_rules "https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioEstadoPedido.cs"
click node_mail "https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioMail.cs"
click node_user_rules "https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioUsuarios.cs"
click node_login_protection "https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioProteccionLogin.cs"
click node_customer_dao "https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/DaoClientes.cs"
click node_orders_dao "https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/DaoPedidos.cs"
click node_products_dao "https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/DaoProductos.cs"
click node_categories_dao "https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/DaoCategorias.cs"
click node_details_dao "https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/DaoDetallePedidos.cs"
click node_states_dao "https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/DaoEstadoPedido.cs"
click node_users_dao "https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/DaoUsuarios.cs"
click node_db_access "https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/AccesoDatos.cs"

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_public_ui,node_product_ui,node_tracking_ui,node_admin_ui,node_tracking_admin_ui,node_api_client,node_customer toneBlue
class node_program,node_auth,node_purchase_http,node_orders_http,node_catalog_http,node_categories_http,node_customers_http,node_postgres toneAmber
class node_purchase_rules,node_order_rules,node_customer_rules,node_product_rules,node_category_rules,node_state_rules,node_mail,node_user_rules,node_login_protection toneMint
class node_customer_dao,node_orders_dao,node_products_dao,node_categories_dao,node_details_dao,node_states_dao,node_users_dao,node_db_access toneRose
class node_admin,node_resend toneIndigo
```

## Components

### Sitio web

- [Catálogo público](https://github.com/techintobios/gestion-3d/blob/main/frontend/JavaScript/index.js): `frontend/JavaScript/index.js`
- [Vista productos](https://github.com/techintobios/gestion-3d/blob/main/frontend/JavaScript/products.js): `frontend/JavaScript/products.js`
- [Seguimiento cliente](https://github.com/techintobios/gestion-3d/blob/main/frontend/JavaScript/tracking.js): `frontend/JavaScript/tracking.js`
- [Panel admin](https://github.com/techintobios/gestion-3d/blob/main/frontend/JavaScript/admin.js): `frontend/JavaScript/admin.js`
- [Seguimiento admin](https://github.com/techintobios/gestion-3d/blob/main/frontend/JavaScript/tracking-admin.js): `frontend/JavaScript/tracking-admin.js`
- [Cliente API](https://github.com/techintobios/gestion-3d/blob/main/frontend/JavaScript/api.js): `frontend/JavaScript/api.js`

### API y acceso

- [Servidor web/API](https://github.com/techintobios/gestion-3d/blob/main/backend/Program.cs): `backend/Program.cs`
- [Autenticación](https://github.com/techintobios/gestion-3d/blob/main/backend/Controllers/AuthController.cs): `backend/Controllers/AuthController.cs`
- [Recepción compra](https://github.com/techintobios/gestion-3d/blob/main/backend/Controllers/ComprasController.cs): `backend/Controllers/ComprasController.cs`
- [Pedidos y estados](https://github.com/techintobios/gestion-3d/blob/main/backend/Controllers/PedidosController.cs): `backend/Controllers/PedidosController.cs`
- [API catálogo](https://github.com/techintobios/gestion-3d/blob/main/backend/Controllers/ProductosController.cs): `backend/Controllers/ProductosController.cs`
- [API categorías](https://github.com/techintobios/gestion-3d/blob/main/backend/Controllers/CategoriasController.cs): `backend/Controllers/CategoriasController.cs`
- [API clientes](https://github.com/techintobios/gestion-3d/blob/main/backend/Controllers/ClientesController.cs): `backend/Controllers/ClientesController.cs`

### Reglas del negocio

- [Registro de compra](https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioCompras.cs): `backend/Negocio/NegocioCompras.cs`
- [Gestión de pedidos](https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioPedidos.cs): `backend/Negocio/NegocioPedidos.cs`
- [Gestión de clientes](https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioClientes.cs): `backend/Negocio/NegocioClientes.cs`
- [Gestión de productos](https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioProductos.cs): `backend/Negocio/NegocioProductos.cs`
- [Gestión de categorías](https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioCategorias.cs): `backend/Negocio/NegocioCategorias.cs`
- [Estados de pedido](https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioEstadoPedido.cs): `backend/Negocio/NegocioEstadoPedido.cs`
- [Avisos por mail](https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioMail.cs): `backend/Negocio/NegocioMail.cs`
- [Usuarios](https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioUsuarios.cs): `backend/Negocio/NegocioUsuarios.cs`
- [Protección de acceso](https://github.com/techintobios/gestion-3d/blob/main/backend/Negocio/NegocioProteccionLogin.cs): `backend/Negocio/NegocioProteccionLogin.cs`

### Persistencia

- [DAO clientes](https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/DaoClientes.cs): `backend/Datos/DaoClientes.cs`
- [DAO pedidos](https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/DaoPedidos.cs): `backend/Datos/DaoPedidos.cs`
- [DAO productos](https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/DaoProductos.cs): `backend/Datos/DaoProductos.cs`
- [DAO categorías](https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/DaoCategorias.cs): `backend/Datos/DaoCategorias.cs`
- [DAO detalles](https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/DaoDetallePedidos.cs): `backend/Datos/DaoDetallePedidos.cs`
- [DAO estados](https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/DaoEstadoPedido.cs): `backend/Datos/DaoEstadoPedido.cs`
- [DAO usuarios](https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/DaoUsuarios.cs): `backend/Datos/DaoUsuarios.cs`
- [Acceso PostgreSQL](https://github.com/techintobios/gestion-3d/blob/main/backend/Datos/AccesoDatos.cs): `backend/Datos/AccesoDatos.cs`

### Other components

- **Cliente**
- **Administrador**
- **PostgreSQL**
- **Resend**

## Connections

- Cliente → Catálogo público: explora (evidence: `README.md`)
- Cliente → Seguimiento cliente: consulta estado (evidence: `README.md`)
- Administrador → Panel admin: gestiona pedidos (evidence: `README.md`)
- Administrador → Seguimiento admin: actualiza estado (evidence: `README.md`)
- Catálogo público → Vista productos: muestra catálogo
- Panel admin → Cliente API: usa (evidence: `frontend/JavaScript/admin.js`)
- Seguimiento admin → Cliente API: usa (evidence: `frontend/JavaScript/tracking-admin.js`)
- Cliente API → Servidor web/API: solicita API (evidence: `README.md`)
- Servidor web/API → Autenticación: sirve rutas
- Servidor web/API → Recepción compra: sirve rutas
- Servidor web/API → Pedidos y estados: sirve rutas
- Servidor web/API → API catálogo: sirve rutas
- Servidor web/API → API categorías: sirve rutas
- Servidor web/API → API clientes: sirve rutas
- Recepción compra → Registro de compra: registra compra (evidence: `backend/Controllers/ComprasController.cs`)
- Pedidos y estados → Gestión de pedidos: gestiona pedidos (evidence: `backend/Controllers/PedidosController.cs`)
- API catálogo → Gestión de productos: gestiona productos (evidence: `backend/Controllers/ProductosController.cs`)
- API categorías → Gestión de categorías: gestiona categorías (evidence: `backend/Controllers/CategoriasController.cs`)
- API clientes → Gestión de clientes: gestiona clientes (evidence: `backend/Controllers/ClientesController.cs`)
- Autenticación → Usuarios: autentica usuario (evidence: `backend/Controllers/AuthController.cs`)
- Autenticación → Protección de acceso: limita intentos (evidence: `backend/Controllers/AuthController.cs`)
- Registro de compra → Gestión de clientes: crea cliente (evidence: `backend/Negocio/NegocioCompras.cs`)
- Registro de compra → Gestión de pedidos: crea pedido (evidence: `backend/Negocio/NegocioCompras.cs`)
- Registro de compra → Gestión de productos: valida venta (evidence: `backend/Negocio/NegocioCompras.cs`)
- Registro de compra → Estados de pedido: obtiene pendiente (evidence: `backend/Negocio/NegocioCompras.cs`)
- Registro de compra → Avisos por mail: notifica compra (evidence: `backend/Negocio/NegocioCompras.cs`)
- Gestión de pedidos → Gestión de clientes: busca cliente (evidence: `backend/Negocio/NegocioPedidos.cs`)
- Gestión de pedidos → Estados de pedido: resuelve estado (evidence: `backend/Negocio/NegocioPedidos.cs`)
- Gestión de pedidos → Avisos por mail: avisa cambio (evidence: `backend/Negocio/NegocioPedidos.cs`)
- Gestión de clientes → DAO clientes: consulta datos (evidence: `backend/Negocio/NegocioClientes.cs`)
- Registro de compra → Acceso PostgreSQL: abre transacción (evidence: `backend/Negocio/NegocioCompras.cs`)
- Registro de compra → DAO detalles: guarda detalles
- Gestión de pedidos → DAO pedidos: consulta y cambia (evidence: `backend/Negocio/NegocioPedidos.cs`)
- Gestión de productos → DAO productos: consulta productos (evidence: `backend/Negocio/NegocioProductos.cs`)
- Gestión de categorías → DAO categorías: consulta categorías (evidence: `backend/Negocio/NegocioCategorias.cs`)
- Estados de pedido → DAO estados: consulta estados (evidence: `backend/Negocio/NegocioEstadoPedido.cs`)
- Usuarios → DAO usuarios: consulta usuarios (evidence: `backend/Negocio/NegocioUsuarios.cs`)
- DAO clientes → Acceso PostgreSQL: consulta PostgreSQL (evidence: `backend/Datos/DaoClientes.cs`)
- DAO pedidos → Acceso PostgreSQL: consulta PostgreSQL (evidence: `backend/Datos/DaoPedidos.cs`)
- DAO productos → Acceso PostgreSQL: consulta PostgreSQL (evidence: `backend/Datos/DaoProductos.cs`)
- Acceso PostgreSQL → PostgreSQL: conecta (evidence: `backend/Datos/AccesoDatos.cs`)
- Avisos por mail → Resend: envía correo (evidence: `backend/Negocio/NegocioMail.cs`)
