# chartgrafitero/papeleriajv architecture

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

- Interactive diagram: https://gitdiagram.com/chartgrafitero/papeleriajv
- Repository: https://github.com/chartgrafitero/papeleriajv

## Overview

PapeleriaJv is a JavaFX stationery-shop desktop application for maintaining inventory and recording sales by unit or box. Staff navigate between inventory and sales screens; they add products to a ticket, then the sales controller submits it for transactional validation, stock deduction, and ticket/detail persistence. The graph also shows the product-edit dialog and the shared JDBC/database layer. The README is empty, and edges are limited to relationships visible in the supplied excerpts and source index.

Main entry points: [`src/main/java/Controllers/VentasController.java`](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/Controllers/VentasController.java) (Sales screen), [`src/main/java/DAO/TicketDAO.java`](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/DAO/TicketDAO.java) (Ticket persistence), [`src/main/java/Controllers/InventarioController.java`](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/Controllers/InventarioController.java) (Inventory screen), [`src/main/java/DAO/ProductoDAO.java`](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/DAO/ProductoDAO.java) (Product persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["JavaFX screens"]
  node_app["Application entry<br/>[App.java]"]
  node_inventory["Inventory screen"]
  node_product_form["Product editor"]
  node_sales_screen["Sales screen"]
  node_shared_ui["UI utilities"]
end

subgraph group_sales["Sales domain"]
  node_product["Product model<br/>[Producto.java]"]
  node_sale_line["Cart line<br/>[LineaVenta.java]"]
  node_sale_detail["Ticket detail<br/>[DetalleTicket.java]"]
  node_sale_type["Sale type<br/>[TipoVenta.java]"]
  node_ticket["Ticket model<br/>[Ticket.java]"]
end

subgraph group_data["Persistence"]
  node_product_dao["Product persistence<br/>[ProductoDAO.java]"]
  node_ticket_dao["Ticket persistence<br/>[TicketDAO.java]"]
  node_connection["DB connection<br/>[ConexionBD.java]"]
end

node_staff(("Shop staff"))
node_mariadb[("MariaDB")]

node_staff -.->|"manages stock"| node_inventory
node_staff -.->|"records sales"| node_sales_screen
node_inventory -->|"opens editor"| node_product_form
node_inventory -->|"lists, deletes"| node_product_dao
node_product_form -->|"saves product"| node_product_dao
node_inventory -->|"navigates"| node_sales_screen
node_sales_screen -->|"loads catalog"| node_product_dao
node_sales_screen -->|"builds cart"| node_sale_line
node_sale_line -->|"converts to"| node_sale_detail
node_sales_screen -->|"registers sale"| node_ticket_dao
node_sales_screen -->|"creates ticket"| node_ticket
node_sales_screen -->|"submits details"| node_sale_detail
node_ticket_dao -->|"looks up, deducts"| node_product_dao
node_ticket_dao -->|"opens transaction"| node_connection
node_product_dao -->|"opens connection"| node_connection
node_ticket_dao -->|"persists header"| node_ticket
node_ticket_dao -->|"persists details"| node_sale_detail
node_connection -->|"connects via JDBC"| node_mariadb
node_shared_ui -.->|"provides UI helpers"| node_inventory
node_shared_ui -.->|"provides UI helpers"| node_product_form
node_shared_ui -.->|"provides UI helpers"| node_sales_screen

click node_app "https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/com/papeleria/papeleriajv/App.java"
click node_inventory "https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/Controllers/InventarioController.java"
click node_product_form "https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/Controllers/AgreeProductController.java"
click node_sales_screen "https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/Controllers/VentasController.java"
click node_shared_ui "https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/Controllers/BaseController.java"
click node_product "https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/models/Producto.java"
click node_sale_line "https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/models/LineaVenta.java"
click node_sale_detail "https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/models/DetalleTicket.java"
click node_sale_type "https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/DAO/TipoVenta.java"
click node_ticket "https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/models/Ticket.java"
click node_product_dao "https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/DAO/ProductoDAO.java"
click node_ticket_dao "https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/DAO/TicketDAO.java"
click node_connection "https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/database/ConexionBD.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_app,node_inventory,node_product_form,node_sales_screen,node_shared_ui toneBlue
class node_product,node_sale_line,node_sale_detail,node_sale_type,node_ticket,node_mariadb toneAmber
class node_product_dao,node_ticket_dao,node_connection toneMint
class node_staff toneIndigo
```

## Components

### JavaFX screens

- [Application entry](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/com/papeleria/papeleriajv/App.java): `src/main/java/com/papeleria/papeleriajv/App.java`
- [Inventory screen](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/Controllers/InventarioController.java): `src/main/java/Controllers/InventarioController.java`
- [Product editor](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/Controllers/AgreeProductController.java): `src/main/java/Controllers/AgreeProductController.java`
- [Sales screen](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/Controllers/VentasController.java): `src/main/java/Controllers/VentasController.java`
- [UI utilities](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/Controllers/BaseController.java): `src/main/java/Controllers/BaseController.java`

### Sales domain

- [Product model](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/models/Producto.java): `src/main/java/models/Producto.java`
- [Cart line](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/models/LineaVenta.java): `src/main/java/models/LineaVenta.java`
- [Ticket detail](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/models/DetalleTicket.java): `src/main/java/models/DetalleTicket.java`
- [Sale type](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/DAO/TipoVenta.java): `src/main/java/DAO/TipoVenta.java`
- [Ticket model](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/models/Ticket.java): `src/main/java/models/Ticket.java`

### Persistence

- [Product persistence](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/DAO/ProductoDAO.java): `src/main/java/DAO/ProductoDAO.java`
- [Ticket persistence](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/DAO/TicketDAO.java): `src/main/java/DAO/TicketDAO.java`
- [DB connection](https://github.com/chartgrafitero/papeleriajv/blob/master/src/main/java/database/ConexionBD.java): `src/main/java/database/ConexionBD.java`

### Other components

- **Shop staff**
- **MariaDB**

## Connections

- Shop staff → Inventory screen: manages stock
- Shop staff → Sales screen: records sales
- Inventory screen → Product editor: opens editor (evidence: `src/main/java/Controllers/InventarioController.java`)
- Inventory screen → Product persistence: lists, deletes (evidence: `src/main/java/Controllers/InventarioController.java`)
- Product editor → Product persistence: saves product (evidence: `src/main/java/Controllers/AgreeProductController.java`)
- Inventory screen → Sales screen: navigates
- Sales screen → Product persistence: loads catalog (evidence: `src/main/java/Controllers/VentasController.java`)
- Sales screen → Cart line: builds cart (evidence: `src/main/java/Controllers/VentasController.java`)
- Cart line → Ticket detail: converts to (evidence: `src/main/java/models/LineaVenta.java`)
- Sales screen → Ticket persistence: registers sale (evidence: `src/main/java/Controllers/VentasController.java`)
- Sales screen → Ticket model: creates ticket (evidence: `src/main/java/Controllers/VentasController.java`)
- Sales screen → Ticket detail: submits details (evidence: `src/main/java/Controllers/VentasController.java`)
- Ticket persistence → Product persistence: looks up, deducts (evidence: `src/main/java/DAO/TicketDAO.java`)
- Ticket persistence → DB connection: opens transaction (evidence: `src/main/java/DAO/TicketDAO.java`)
- Product persistence → DB connection: opens connection (evidence: `src/main/java/DAO/ProductoDAO.java`)
- Ticket persistence → Ticket model: persists header (evidence: `src/main/java/DAO/TicketDAO.java`)
- Ticket persistence → Ticket detail: persists details (evidence: `src/main/java/DAO/TicketDAO.java`)
- DB connection → MariaDB: connects via JDBC (evidence: `src/main/java/database/ConexionBD.java`)
- UI utilities → Inventory screen: provides UI helpers (evidence: `src/main/java/Controllers/InventarioController.java`)
- UI utilities → Product editor: provides UI helpers (evidence: `src/main/java/Controllers/AgreeProductController.java`)
- UI utilities → Sales screen: provides UI helpers (evidence: `src/main/java/Controllers/VentasController.java`)
