# yuupwp/gaona architecture

> Architecture diagram of the GitHub repository yuupwp/gaona, 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/yuupwp/gaona
- Repository: https://github.com/yuupwp/gaona

## Overview

GAONA is a catalog and quotation product: customers browse products and submit quote requests; staff manage the resulting work, create quotations, and send PDF quotes by email. The README documents a public web API backed by shared Supabase services, alongside retained administrative and desktop features. Source excerpts establish several API calls and PDF/email steps; other unsampled routes are represented as capabilities, with uncertain connections omitted or marked dashed.

Main entry points: [`api/src/escritorio.ts`](https://github.com/yuupwp/gaona/blob/main/api/src/escritorio.ts) (Desktop API router), [`api/src/api-web.ts`](https://github.com/yuupwp/gaona/blob/main/api/src/api-web.ts) (Public web API), [`api/src/solicitud-correo.ts`](https://github.com/yuupwp/gaona/blob/main/api/src/solicitud-correo.ts) (Request email), [`api/src/cotizaciones.ts`](https://github.com/yuupwp/gaona/blob/main/api/src/cotizaciones.ts) (Quotation management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public web"]
  node_catalog["Product catalog<br/>[catalogo.js]"]
  node_quoteform["Quote request form<br/>[cotizacion.js]"]
  node_publicapi["Public web API<br/>[api-web.ts]"]
  node_catalogapi["Catalog service<br/>[catalogo.ts]"]
end

subgraph group_workflow["Quote workflow"]
  node_requestdata["Request persistence"]
  node_requestpdf["Request PDF<br/>[solicitud-pdf.ts]"]
  node_requestemail["Request email"]
  node_requestvalidation["Request validation"]
  node_requestestimate["Request estimate"]
  node_whatsapp["WhatsApp requests"]
  node_webhook["WhatsApp webhook"]
end

subgraph group_admin["Administration"]
  node_desktop["Desktop client"]
  node_desktopmain["Desktop runtime<br/>[main.ts]"]
  node_pdfviewer["Local PDF viewer<br/>[visor-pdf.ts]"]
  node_adminrouter["Desktop API router<br/>[escritorio.ts]"]
  node_quotes["Quotation management<br/>[cotizaciones.ts]"]
  node_appointments["Appointments<br/>[citas.ts]"]
  node_customers["Customer management<br/>[clientes.ts]"]
  node_employees["Employee management<br/>[empleado.ts]"]
  node_orders["Orders<br/>[pedidos.ts]"]
  node_inventory["Inventory<br/>[inventario.ts]"]
  node_finance["Finance<br/>[finanzas.ts]"]
end

subgraph group_services["Shared services"]
  node_auth["Authentication<br/>[autenticacion.ts]"]
  node_prisma["Database access<br/>[prisma.ts]"]
  node_database[("Shared Supabase data")]
  node_pdfquote["Quotation PDF<br/>[cotizacion-pdf.ts]"]
  node_quoteemail["Quotation email"]
end

node_customer(("Customer"))
node_adminactor(("Staff"))
node_mailprovider["Brevo SMTP"]
node_whatsappservice["WhatsApp service"]

node_customer -->|"browses"| node_catalog
node_customer -->|"submits request"| node_quoteform
node_catalog -.->|"loads catalog"| node_publicapi
node_quoteform -.->|"submits quote"| node_publicapi
node_publicapi -.->|"routes catalog"| node_catalogapi
node_publicapi -.->|"persists requests"| node_requestdata
node_publicapi -.->|"generates PDF"| node_requestpdf
node_publicapi -.->|"sends request email"| node_requestemail
node_requestemail -->|"validates address"| node_requestvalidation
node_requestemail -->|"uses estimate"| node_requestestimate
node_requestemail -->|"attaches PDF"| node_requestpdf
node_requestemail -->|"sends mail"| node_mailprovider
node_whatsapp -->|"uses estimate"| node_requestestimate
node_whatsapp -->|"uses document"| node_requestpdf
node_webhook -->|"dispatches events"| node_whatsapp
node_webhook -.->|"receives callbacks"| node_whatsappservice
node_adminactor -->|"uses"| node_desktop
node_desktop -.->|"calls API"| node_adminrouter
node_desktopmain -->|"opens PDF"| node_pdfviewer
node_adminrouter -->|"authenticates routes"| node_auth
node_adminrouter -->|"mounts routes"| node_quotes
node_adminrouter -->|"mounts routes"| node_appointments
node_adminrouter -->|"mounts routes"| node_customers
node_adminrouter -->|"mounts routes"| node_employees
node_adminrouter -->|"mounts routes"| node_orders
node_adminrouter -->|"mounts routes"| node_inventory
node_adminrouter -->|"mounts routes"| node_finance
node_quotes -->|"generates PDF"| node_pdfquote
node_quotes -->|"sends quotation"| node_quoteemail
node_quotes -->|"checks scheduling"| node_appointments
node_quoteemail -->|"attaches PDF"| node_pdfquote
node_quoteemail -->|"uses mail service"| node_requestemail
node_appointments -->|"uses quote helpers"| node_quotes
node_appointments -->|"notifies order customer"| node_orders
node_employees -->|"requires admin"| node_auth
node_employees -->|"sends reset email"| node_mailprovider
node_quotes -->|"reads and writes"| node_prisma
node_appointments -->|"reads and writes"| node_prisma
node_customers -->|"reads and writes"| node_prisma
node_employees -->|"reads and writes"| node_prisma
node_auth -->|"loads user"| node_prisma
node_prisma -->|"accesses shared data"| node_database
node_mailprovider -.->|"delivers quote email"| node_customer

click node_catalog "https://github.com/yuupwp/gaona/blob/main/P%C3%A1gina/catalogo.js"
click node_quoteform "https://github.com/yuupwp/gaona/blob/main/P%C3%A1gina/cotizacion.js"
click node_publicapi "https://github.com/yuupwp/gaona/blob/main/api/src/api-web.ts"
click node_catalogapi "https://github.com/yuupwp/gaona/blob/main/api/src/catalogo.ts"
click node_requestdata "https://github.com/yuupwp/gaona/blob/main/api/src/solicitud-persistencia.ts"
click node_requestpdf "https://github.com/yuupwp/gaona/blob/main/api/src/solicitud-pdf.ts"
click node_requestemail "https://github.com/yuupwp/gaona/blob/main/api/src/solicitud-correo.ts"
click node_requestvalidation "https://github.com/yuupwp/gaona/blob/main/api/src/solicitud-correo-validacion.ts"
click node_requestestimate "https://github.com/yuupwp/gaona/blob/main/api/src/solicitud-estimado.ts"
click node_whatsapp "https://github.com/yuupwp/gaona/blob/main/api/src/solicitud-whatsapp.ts"
click node_webhook "https://github.com/yuupwp/gaona/blob/main/api/src/solicitud-whatsapp-webhook.ts"
click node_desktop "https://github.com/yuupwp/gaona/tree/main/Appescritorio/src/renderer"
click node_desktopmain "https://github.com/yuupwp/gaona/blob/main/Appescritorio/src/main.ts"
click node_pdfviewer "https://github.com/yuupwp/gaona/blob/main/Appescritorio/src/visor-pdf.ts"
click node_adminrouter "https://github.com/yuupwp/gaona/blob/main/api/src/escritorio.ts"
click node_quotes "https://github.com/yuupwp/gaona/blob/main/api/src/cotizaciones.ts"
click node_appointments "https://github.com/yuupwp/gaona/blob/main/api/src/citas.ts"
click node_customers "https://github.com/yuupwp/gaona/blob/main/api/src/clientes.ts"
click node_employees "https://github.com/yuupwp/gaona/blob/main/api/src/empleado.ts"
click node_orders "https://github.com/yuupwp/gaona/blob/main/api/src/pedidos.ts"
click node_inventory "https://github.com/yuupwp/gaona/blob/main/api/src/inventario.ts"
click node_finance "https://github.com/yuupwp/gaona/blob/main/api/src/finanzas.ts"
click node_auth "https://github.com/yuupwp/gaona/blob/main/api/src/middleware/autenticacion.ts"
click node_prisma "https://github.com/yuupwp/gaona/blob/main/api/src/lib/prisma.ts"
click node_pdfquote "https://github.com/yuupwp/gaona/blob/main/api/src/cotizacion-pdf.ts"
click node_quoteemail "https://github.com/yuupwp/gaona/blob/main/api/src/cotizacion-correo.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_catalog,node_quoteform,node_publicapi,node_catalogapi toneBlue
class node_requestdata,node_requestpdf,node_requestemail,node_requestvalidation,node_requestestimate,node_whatsapp,node_webhook toneAmber
class node_desktop,node_desktopmain,node_pdfviewer,node_adminrouter,node_quotes,node_appointments,node_customers,node_employees,node_orders,node_inventory,node_finance toneMint
class node_auth,node_prisma,node_database,node_pdfquote,node_quoteemail toneRose
class node_customer,node_adminactor,node_mailprovider,node_whatsappservice toneIndigo
```

## Components

### Public web

- [Product catalog](https://github.com/yuupwp/gaona/blob/main/P%C3%A1gina/catalogo.js): `Página/catalogo.js`
- [Quote request form](https://github.com/yuupwp/gaona/blob/main/P%C3%A1gina/cotizacion.js): `Página/cotizacion.js`
- [Public web API](https://github.com/yuupwp/gaona/blob/main/api/src/api-web.ts): `api/src/api-web.ts`
- [Catalog service](https://github.com/yuupwp/gaona/blob/main/api/src/catalogo.ts): `api/src/catalogo.ts`

### Quote workflow

- [Request persistence](https://github.com/yuupwp/gaona/blob/main/api/src/solicitud-persistencia.ts): `api/src/solicitud-persistencia.ts`
- [Request PDF](https://github.com/yuupwp/gaona/blob/main/api/src/solicitud-pdf.ts): `api/src/solicitud-pdf.ts`
- [Request email](https://github.com/yuupwp/gaona/blob/main/api/src/solicitud-correo.ts): `api/src/solicitud-correo.ts`
- [Request validation](https://github.com/yuupwp/gaona/blob/main/api/src/solicitud-correo-validacion.ts): `api/src/solicitud-correo-validacion.ts`
- [Request estimate](https://github.com/yuupwp/gaona/blob/main/api/src/solicitud-estimado.ts): `api/src/solicitud-estimado.ts`
- [WhatsApp requests](https://github.com/yuupwp/gaona/blob/main/api/src/solicitud-whatsapp.ts): `api/src/solicitud-whatsapp.ts`
- [WhatsApp webhook](https://github.com/yuupwp/gaona/blob/main/api/src/solicitud-whatsapp-webhook.ts): `api/src/solicitud-whatsapp-webhook.ts`

### Administration

- [Desktop client](https://github.com/yuupwp/gaona/tree/main/Appescritorio/src/renderer): `Appescritorio/src/renderer`
- [Desktop runtime](https://github.com/yuupwp/gaona/blob/main/Appescritorio/src/main.ts): `Appescritorio/src/main.ts`
- [Local PDF viewer](https://github.com/yuupwp/gaona/blob/main/Appescritorio/src/visor-pdf.ts): `Appescritorio/src/visor-pdf.ts`
- [Desktop API router](https://github.com/yuupwp/gaona/blob/main/api/src/escritorio.ts): `api/src/escritorio.ts`
- [Quotation management](https://github.com/yuupwp/gaona/blob/main/api/src/cotizaciones.ts): `api/src/cotizaciones.ts`
- [Appointments](https://github.com/yuupwp/gaona/blob/main/api/src/citas.ts): `api/src/citas.ts`
- [Customer management](https://github.com/yuupwp/gaona/blob/main/api/src/clientes.ts): `api/src/clientes.ts`
- [Employee management](https://github.com/yuupwp/gaona/blob/main/api/src/empleado.ts): `api/src/empleado.ts`
- [Orders](https://github.com/yuupwp/gaona/blob/main/api/src/pedidos.ts): `api/src/pedidos.ts`
- [Inventory](https://github.com/yuupwp/gaona/blob/main/api/src/inventario.ts): `api/src/inventario.ts`
- [Finance](https://github.com/yuupwp/gaona/blob/main/api/src/finanzas.ts): `api/src/finanzas.ts`

### Shared services

- [Authentication](https://github.com/yuupwp/gaona/blob/main/api/src/middleware/autenticacion.ts): `api/src/middleware/autenticacion.ts`
- [Database access](https://github.com/yuupwp/gaona/blob/main/api/src/lib/prisma.ts): `api/src/lib/prisma.ts`
- **Shared Supabase data**
- [Quotation PDF](https://github.com/yuupwp/gaona/blob/main/api/src/cotizacion-pdf.ts): `api/src/cotizacion-pdf.ts`
- [Quotation email](https://github.com/yuupwp/gaona/blob/main/api/src/cotizacion-correo.ts): `api/src/cotizacion-correo.ts`

### Other components

- **Customer**
- **Staff**
- **Brevo SMTP**
- **WhatsApp service**

## Connections

- Customer → Product catalog: browses
- Customer → Quote request form: submits request
- Product catalog → Public web API: loads catalog
- Quote request form → Public web API: submits quote
- Public web API → Catalog service: routes catalog
- Public web API → Request persistence: persists requests
- Public web API → Request PDF: generates PDF
- Public web API → Request email: sends request email
- Request email → Request validation: validates address (evidence: `api/src/solicitud-correo.ts`)
- Request email → Request estimate: uses estimate (evidence: `api/src/solicitud-correo.ts`)
- Request email → Request PDF: attaches PDF (evidence: `api/src/solicitud-correo.ts`)
- Request email → Brevo SMTP: sends mail (evidence: `api/src/solicitud-correo.ts`)
- WhatsApp requests → Request estimate: uses estimate (evidence: `api/src/solicitud-whatsapp.ts`)
- WhatsApp requests → Request PDF: uses document (evidence: `api/src/solicitud-whatsapp.ts`)
- WhatsApp webhook → WhatsApp requests: dispatches events (evidence: `api/src/solicitud-whatsapp-webhook.ts`)
- WhatsApp webhook → WhatsApp service: receives callbacks
- Staff → Desktop client: uses
- Desktop client → Desktop API router: calls API
- Desktop runtime → Local PDF viewer: opens PDF (evidence: `Appescritorio/src/main.ts`)
- Desktop API router → Authentication: authenticates routes (evidence: `api/src/escritorio.ts`)
- Desktop API router → Quotation management: mounts routes (evidence: `api/src/escritorio.ts`)
- Desktop API router → Appointments: mounts routes (evidence: `api/src/escritorio.ts`)
- Desktop API router → Customer management: mounts routes (evidence: `api/src/escritorio.ts`)
- Desktop API router → Employee management: mounts routes (evidence: `api/src/escritorio.ts`)
- Desktop API router → Orders: mounts routes (evidence: `api/src/escritorio.ts`)
- Desktop API router → Inventory: mounts routes (evidence: `api/src/escritorio.ts`)
- Desktop API router → Finance: mounts routes (evidence: `api/src/escritorio.ts`)
- Quotation management → Quotation PDF: generates PDF (evidence: `api/src/cotizaciones.ts`)
- Quotation management → Quotation email: sends quotation (evidence: `api/src/cotizaciones.ts`)
- Quotation management → Appointments: checks scheduling (evidence: `api/src/cotizaciones.ts`)
- Quotation email → Quotation PDF: attaches PDF (evidence: `api/src/cotizacion-correo.ts`)
- Quotation email → Request email: uses mail service (evidence: `api/src/cotizacion-correo.ts`)
- Appointments → Quotation management: uses quote helpers (evidence: `api/src/citas.ts`)
- Appointments → Orders: notifies order customer (evidence: `api/src/citas.ts`)
- Employee management → Authentication: requires admin (evidence: `api/src/empleado.ts`)
- Employee management → Brevo SMTP: sends reset email (evidence: `api/src/empleado.ts`)
- Quotation management → Database access: reads and writes (evidence: `api/src/cotizaciones.ts`)
- Appointments → Database access: reads and writes (evidence: `api/src/citas.ts`)
- Customer management → Database access: reads and writes (evidence: `api/src/clientes.ts`)
- Employee management → Database access: reads and writes (evidence: `api/src/empleado.ts`)
- Authentication → Database access: loads user (evidence: `api/src/middleware/autenticacion.ts`)
- Database access → Shared Supabase data: accesses shared data
- Brevo SMTP → Customer: delivers quote email
