# bulmarozr/puntodeventa architecture

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

- Interactive diagram: https://gitdiagram.com/bulmarozr/puntodeventa
- Repository: https://github.com/bulmarozr/puntodeventa

## Overview

Punto de Venta is a Windows Forms point-of-sale application backed by SQL Server. The apparent user workflow starts in the main sales screen, supports customer/product lookup and payment, and includes related returns, warranty, quoting, inventory, and reporting functions. The source index and excerpts establish several SQL-backed domain modules, but Form1 and many named capabilities were not sampled; those subsystems are represented without guessed call chains. The README also identifies local configuration and synchronization-related files, but does not describe their runtime wiring.

Main entry points: [`Punto de ventas/Models/Almacen.cs`](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Almacen.cs) (Warehouses), [`Punto de ventas/Form1.cs`](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Form1.cs) (POS screen), [`Punto de ventas/Models/Exposiciones.cs`](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Exposiciones.cs) (Exhibitions), [`Punto de ventas/BusquedaCliente.cs`](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/BusquedaCliente.cs) (Customer lookup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sales["Sales workflow"]
  node_main["POS screen<br/>[Form1.cs]"]
  node_customer_lookup["Customer lookup<br/>[BusquedaCliente.cs]"]
  node_payment["Payment<br/>[Cobro.cs]"]
  node_sales_core["Sales processing<br/>[Ventas.cs]"]
  node_quotes["Quotes<br/>[Cotizaciones.cs]"]
  node_returns["Returns<br/>[Devoluciones.cs]"]
  node_refund["Refund screen<br/>[Reembolso.cs]"]
  node_warranties["Warranties<br/>[Garantias.cs]"]
  node_serial_entry["Serial entry<br/>[LLenaSN.cs]"]
end

subgraph group_operations["Store operations"]
  node_inventory["Inventory<br/>[Inventario.cs]"]
  node_warehouse["Warehouses<br/>[Almacen.cs]"]
  node_bins["Storage bins<br/>[Bin.cs]"]
  node_transfers["Stock transfers<br/>[Traspasos.cs]"]
  node_exhibitions["Exhibitions<br/>[Exposiciones.cs]"]
  node_sync["Synchronization<br/>[Sincronizacion.cs]"]
end

subgraph group_management["Back office"]
  node_reports["Reports<br/>[Reportes.cs]"]
  node_cash_close["Cash closing<br/>[CorteDeCaja.cs]"]
end

subgraph group_data["Data and output"]
  node_customer_data["Customer records<br/>[Customer.cs]"]
  node_ticket_pdf["Ticket PDF<br/>[TicketPDF.cs]"]
  node_sql[("SQL Server")]
end

node_cashier(("Cashier"))

node_cashier -->|"uses"| node_main
node_main -.->|"opens"| node_customer_lookup
node_main -.->|"opens"| node_payment
node_warehouse -->|"uses"| node_bins
node_warehouse -->|"uses"| node_customer_data
node_exhibitions -->|"instantiates"| node_sales_core
node_warranties -->|"opens"| node_serial_entry
node_customer_lookup -->|"queries"| node_sql
node_payment -->|"queries"| node_sql
node_warehouse -->|"reads and writes"| node_sql
node_bins -->|"reads and writes"| node_sql
node_returns -->|"reads and writes"| node_sql
node_exhibitions -->|"reads and writes"| node_sql

click node_main "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Form1.cs"
click node_customer_lookup "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/BusquedaCliente.cs"
click node_payment "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Cobro.cs"
click node_sales_core "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Ventas.cs"
click node_quotes "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Cotizaciones.cs"
click node_returns "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Devoluciones.cs"
click node_refund "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Reembolso.cs"
click node_warranties "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Garantias.cs"
click node_serial_entry "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/LLenaSN.cs"
click node_inventory "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Inventario.cs"
click node_warehouse "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Almacen.cs"
click node_bins "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Bin.cs"
click node_transfers "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Traspasos.cs"
click node_exhibitions "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Exposiciones.cs"
click node_sync "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Sincronizacion.cs"
click node_reports "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Reportes.cs"
click node_cash_close "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/CorteDeCaja.cs"
click node_customer_data "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Customer.cs"
click node_ticket_pdf "https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/TicketPDF.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_main,node_customer_lookup,node_payment,node_sales_core,node_quotes,node_returns,node_refund,node_warranties,node_serial_entry toneBlue
class node_inventory,node_warehouse,node_bins,node_transfers,node_exhibitions,node_sync toneAmber
class node_reports,node_cash_close toneMint
class node_customer_data,node_ticket_pdf,node_sql toneRose
class node_cashier toneIndigo
```

## Components

### Sales workflow

- [POS screen](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Form1.cs): `Punto de ventas/Form1.cs`
- [Customer lookup](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/BusquedaCliente.cs): `Punto de ventas/BusquedaCliente.cs`
- [Payment](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Cobro.cs): `Punto de ventas/Cobro.cs`
- [Sales processing](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Ventas.cs): `Punto de ventas/Models/Ventas.cs`
- [Quotes](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Cotizaciones.cs): `Punto de ventas/Models/Cotizaciones.cs`
- [Returns](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Devoluciones.cs): `Punto de ventas/Models/Devoluciones.cs`
- [Refund screen](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Reembolso.cs): `Punto de ventas/Reembolso.cs`
- [Warranties](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Garantias.cs): `Punto de ventas/Garantias.cs`
- [Serial entry](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/LLenaSN.cs): `Punto de ventas/LLenaSN.cs`

### Store operations

- [Inventory](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Inventario.cs): `Punto de ventas/Models/Inventario.cs`
- [Warehouses](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Almacen.cs): `Punto de ventas/Models/Almacen.cs`
- [Storage bins](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Bin.cs): `Punto de ventas/Models/Bin.cs`
- [Stock transfers](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Traspasos.cs): `Punto de ventas/Models/Traspasos.cs`
- [Exhibitions](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Exposiciones.cs): `Punto de ventas/Models/Exposiciones.cs`
- [Synchronization](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Sincronizacion.cs): `Punto de ventas/Models/Sincronizacion.cs`

### Back office

- [Reports](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Reportes.cs): `Punto de ventas/Models/Reportes.cs`
- [Cash closing](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/CorteDeCaja.cs): `Punto de ventas/Models/CorteDeCaja.cs`

### Data and output

- [Customer records](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/Customer.cs): `Punto de ventas/Models/Customer.cs`
- [Ticket PDF](https://github.com/bulmarozr/puntodeventa/blob/main/Punto%20de%20ventas/Models/TicketPDF.cs): `Punto de ventas/Models/TicketPDF.cs`
- **SQL Server**

### Other components

- **Cashier**

## Connections

- Cashier → POS screen: uses (evidence: `README.md`)
- POS screen → Customer lookup: opens
- POS screen → Payment: opens
- Warehouses → Storage bins: uses (evidence: `Punto de ventas/Models/Almacen.cs`)
- Warehouses → Customer records: uses (evidence: `Punto de ventas/Models/Almacen.cs`)
- Exhibitions → Sales processing: instantiates (evidence: `Punto de ventas/Models/Exposiciones.cs`)
- Warranties → Serial entry: opens (evidence: `Punto de ventas/Garantias.cs`)
- Customer lookup → SQL Server: queries (evidence: `Punto de ventas/BusquedaCliente.cs`)
- Payment → SQL Server: queries (evidence: `Punto de ventas/Cobro.cs`)
- Warehouses → SQL Server: reads and writes (evidence: `Punto de ventas/Models/Almacen.cs`)
- Storage bins → SQL Server: reads and writes (evidence: `Punto de ventas/Models/Bin.cs`)
- Returns → SQL Server: reads and writes (evidence: `Punto de ventas/Models/Devoluciones.cs`)
- Exhibitions → SQL Server: reads and writes (evidence: `Punto de ventas/Models/Exposiciones.cs`)
