# crisflorez06/papeleria architecture

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

## Overview

Papelería is a retail-management application: users manage products and stock, record sales and expenses, and review date-range reports. Angular routes expose product, sales, and report screens; the frontend consumes a Spring Boot REST API backed by relational persistence. Backend services implement business rules and delegate persistence to repositories. The README documents the overall frontend-to-API-to-MySQL architecture; sampled source supports several service and repository relationships, but not endpoint-by-endpoint wiring from Angular services.

Main entry points: [`src/main/java/com/papeleria/repositories`](https://github.com/crisflorez06/papeleria/tree/main/src/main/java/com/papeleria/repositories) (JPA repositories), [`frontend/src/app/app.routes.ts`](https://github.com/crisflorez06/papeleria/blob/main/frontend/src/app/app.routes.ts) (Application routes), [`frontend/src/app/services`](https://github.com/crisflorez06/papeleria/tree/main/frontend/src/app/services) (API client services), [`src/main/java/com/papeleria/services/producto/ProductoService.java`](https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/services/producto/ProductoService.java) (Product and stock rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Angular frontend"]
  node_routes["Application routes<br/>[app.routes.ts]"]
  node_product_ui["Product screen"]
  node_sales_ui["Sales screen"]
  node_reports_ui["Reports screen"]
  node_frontend_services["API client services"]
end

subgraph group_api["REST API"]
  node_product_api["Product endpoints"]
  node_sales_api["Sales endpoints"]
  node_expense_api["Expense endpoints"]
  node_movement_api["Stock movement endpoints"]
  node_report_api["Report endpoints"]
  node_filter_api["Filter endpoint"]
  node_spring_api["Spring Boot REST API"]
end

subgraph group_operations["Retail operations"]
  node_product_service["Product and stock rules"]
  node_sales_service["Sales and inventory rules<br/>[VentaService.java]"]
  node_movement_service["Movement records"]
  node_expense_service["Expense management<br/>[GastoService.java]"]
end

subgraph group_insights["Reports and filters"]
  node_report_service["Report calculations"]
  node_filter_service["Product filters<br/>[FiltroService.java]"]
end

subgraph group_persistence["Persistence"]
  node_repositories["JPA repositories"]
  node_mysql[("MySQL database")]
end

node_user(("Store user"))

node_user -->|"uses"| node_routes
node_routes -->|"routes to"| node_product_ui
node_routes -->|"routes to"| node_sales_ui
node_routes -->|"routes to"| node_reports_ui
node_product_ui -.->|"requests data"| node_frontend_services
node_sales_ui -.->|"requests data"| node_frontend_services
node_reports_ui -.->|"requests data"| node_frontend_services
node_frontend_services -->|"consumes REST API"| node_spring_api
node_product_api -->|"delegates to"| node_product_service
node_sales_api -->|"delegates to"| node_sales_service
node_expense_api -->|"delegates to"| node_expense_service
node_movement_api -->|"delegates to"| node_movement_service
node_report_api -->|"delegates to"| node_report_service
node_filter_api -->|"delegates to"| node_filter_service
node_product_service -->|"records stock entry"| node_movement_service
node_product_service -->|"reads and saves"| node_repositories
node_sales_service -->|"reads and writes"| node_repositories
node_movement_service -->|"reads and saves"| node_repositories
node_expense_service -->|"reads and writes"| node_repositories
node_report_service -->|"queries totals"| node_repositories
node_filter_service -->|"queries products"| node_repositories
node_repositories -->|"persists via JPA"| node_mysql
node_spring_api -->|"persists through JPA"| node_mysql

click node_routes "https://github.com/crisflorez06/papeleria/blob/main/frontend/src/app/app.routes.ts"
click node_product_ui "https://github.com/crisflorez06/papeleria/blob/main/frontend/src/app/pages/productos/productos.component.ts"
click node_sales_ui "https://github.com/crisflorez06/papeleria/blob/main/frontend/src/app/pages/ventas/ventas.component.ts"
click node_reports_ui "https://github.com/crisflorez06/papeleria/blob/main/frontend/src/app/pages/reportes/reportes.component.ts"
click node_frontend_services "https://github.com/crisflorez06/papeleria/tree/main/frontend/src/app/services"
click node_product_api "https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/controllers/producto/ProductoController.java"
click node_sales_api "https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/controllers/venta/VentaController.java"
click node_expense_api "https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/controllers/gasto/GastoController.java"
click node_movement_api "https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/controllers/movimiento/MovimientoController.java"
click node_report_api "https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/controllers/reporte/ReporteController.java"
click node_filter_api "https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/controllers/FiltroController.java"
click node_product_service "https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/services/producto/ProductoService.java"
click node_sales_service "https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/services/venta/VentaService.java"
click node_movement_service "https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/services/movimiento/MovimientoService.java"
click node_expense_service "https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/services/gasto/GastoService.java"
click node_report_service "https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/services/reporte/ReporteService.java"
click node_filter_service "https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/services/FiltroService.java"
click node_repositories "https://github.com/crisflorez06/papeleria/tree/main/src/main/java/com/papeleria/repositories"
click node_spring_api "https://github.com/crisflorez06/papeleria/tree/main/src/main/java/com/papeleria/controllers"

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_routes,node_product_ui,node_sales_ui,node_reports_ui,node_frontend_services,node_user toneBlue
class node_product_api,node_sales_api,node_expense_api,node_movement_api,node_report_api,node_filter_api,node_spring_api toneAmber
class node_product_service,node_sales_service,node_movement_service,node_expense_service toneMint
class node_report_service,node_filter_service toneRose
class node_repositories,node_mysql toneIndigo
```

## Components

### Angular frontend

- [Application routes](https://github.com/crisflorez06/papeleria/blob/main/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Product screen](https://github.com/crisflorez06/papeleria/blob/main/frontend/src/app/pages/productos/productos.component.ts): `frontend/src/app/pages/productos/productos.component.ts`
- [Sales screen](https://github.com/crisflorez06/papeleria/blob/main/frontend/src/app/pages/ventas/ventas.component.ts): `frontend/src/app/pages/ventas/ventas.component.ts`
- [Reports screen](https://github.com/crisflorez06/papeleria/blob/main/frontend/src/app/pages/reportes/reportes.component.ts): `frontend/src/app/pages/reportes/reportes.component.ts`
- [API client services](https://github.com/crisflorez06/papeleria/tree/main/frontend/src/app/services): `frontend/src/app/services`

### REST API

- [Product endpoints](https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/controllers/producto/ProductoController.java): `src/main/java/com/papeleria/controllers/producto/ProductoController.java`
- [Sales endpoints](https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/controllers/venta/VentaController.java): `src/main/java/com/papeleria/controllers/venta/VentaController.java`
- [Expense endpoints](https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/controllers/gasto/GastoController.java): `src/main/java/com/papeleria/controllers/gasto/GastoController.java`
- [Stock movement endpoints](https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/controllers/movimiento/MovimientoController.java): `src/main/java/com/papeleria/controllers/movimiento/MovimientoController.java`
- [Report endpoints](https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/controllers/reporte/ReporteController.java): `src/main/java/com/papeleria/controllers/reporte/ReporteController.java`
- [Filter endpoint](https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/controllers/FiltroController.java): `src/main/java/com/papeleria/controllers/FiltroController.java`
- [Spring Boot REST API](https://github.com/crisflorez06/papeleria/tree/main/src/main/java/com/papeleria/controllers): `src/main/java/com/papeleria/controllers`

### Retail operations

- [Product and stock rules](https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/services/producto/ProductoService.java): `src/main/java/com/papeleria/services/producto/ProductoService.java`
- [Sales and inventory rules](https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/services/venta/VentaService.java): `src/main/java/com/papeleria/services/venta/VentaService.java`
- [Movement records](https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/services/movimiento/MovimientoService.java): `src/main/java/com/papeleria/services/movimiento/MovimientoService.java`
- [Expense management](https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/services/gasto/GastoService.java): `src/main/java/com/papeleria/services/gasto/GastoService.java`

### Reports and filters

- [Report calculations](https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/services/reporte/ReporteService.java): `src/main/java/com/papeleria/services/reporte/ReporteService.java`
- [Product filters](https://github.com/crisflorez06/papeleria/blob/main/src/main/java/com/papeleria/services/FiltroService.java): `src/main/java/com/papeleria/services/FiltroService.java`

### Persistence

- [JPA repositories](https://github.com/crisflorez06/papeleria/tree/main/src/main/java/com/papeleria/repositories): `src/main/java/com/papeleria/repositories`
- **MySQL database**

### Other components

- **Store user**

## Connections

- Store user → Application routes: uses
- Application routes → Product screen: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Application routes → Sales screen: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Application routes → Reports screen: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Product screen → API client services: requests data
- Sales screen → API client services: requests data
- Reports screen → API client services: requests data
- API client services → Spring Boot REST API: consumes REST API
- Product endpoints → Product and stock rules: delegates to (evidence: `src/main/java/com/papeleria/controllers/producto/ProductoController.java`)
- Sales endpoints → Sales and inventory rules: delegates to (evidence: `src/main/java/com/papeleria/controllers/venta/VentaController.java`)
- Expense endpoints → Expense management: delegates to (evidence: `src/main/java/com/papeleria/controllers/gasto/GastoController.java`)
- Stock movement endpoints → Movement records: delegates to (evidence: `src/main/java/com/papeleria/controllers/movimiento/MovimientoController.java`)
- Report endpoints → Report calculations: delegates to (evidence: `src/main/java/com/papeleria/controllers/reporte/ReporteController.java`)
- Filter endpoint → Product filters: delegates to (evidence: `src/main/java/com/papeleria/controllers/FiltroController.java`)
- Product and stock rules → Movement records: records stock entry (evidence: `src/main/java/com/papeleria/services/producto/ProductoService.java`)
- Product and stock rules → JPA repositories: reads and saves (evidence: `src/main/java/com/papeleria/services/producto/ProductoService.java`)
- Sales and inventory rules → JPA repositories: reads and writes (evidence: `src/main/java/com/papeleria/services/venta/VentaService.java`)
- Movement records → JPA repositories: reads and saves (evidence: `src/main/java/com/papeleria/services/movimiento/MovimientoService.java`)
- Expense management → JPA repositories: reads and writes (evidence: `src/main/java/com/papeleria/services/gasto/GastoService.java`)
- Report calculations → JPA repositories: queries totals (evidence: `src/main/java/com/papeleria/services/reporte/ReporteService.java`)
- Product filters → JPA repositories: queries products (evidence: `src/main/java/com/papeleria/services/FiltroService.java`)
- JPA repositories → MySQL database: persists via JPA
- Spring Boot REST API → MySQL database: persists through JPA
