# enzojp/primera-pulpa architecture

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

- Interactive diagram: https://gitdiagram.com/enzojp/primera-pulpa
- Repository: https://github.com/enzojp/primera-pulpa

## Overview

Primera-Pulpa is a server-side application for managing mix production, raw-material inventory, and customer orders. The visible workflow covers order entry and production: controllers delegate to services, which apply domain rules and persist through repositories. Separate capabilities include receiving stock, formulas, reporting, users/roles, and backup/restore. The README does not describe product features, so these branches are identified from the source tree; their internal connections are not asserted where source evidence was unavailable.

Main entry points: [`Server/src/main/java/com/primeraPulpa/repositories`](https://github.com/enzojp/primera-pulpa/tree/main/Server/src/main/java/com/primeraPulpa/repositories) (JPA repositories), [`Server/src/main/java/com/primeraPulpa/Services/MixService.java`](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/MixService.java) (Mix costing and production), [`Server/src/main/java/com/primeraPulpa/controller/PedidoController.java`](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/controller/PedidoController.java) (Order endpoints), [`Server/src/main/java/com/primeraPulpa/Services/PedidoService.java`](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/PedidoService.java) (Order workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operations["Sales and production"]
  node_order_api["Order endpoints"]
  node_order_rules["Order workflow<br/>[PedidoService.java]"]
  node_production_api["Production endpoints"]
  node_mix_rules["Mix costing and production<br/>[MixService.java]"]
end

subgraph group_inventory["Inventory and recipes"]
  node_mix_stock["Mix stock movements"]
  node_raw_receiving["Raw material receipts"]
  node_raw_stock["Raw material catalog"]
  node_recipes["Formula management"]
  node_batch_rules["Production batches"]
  node_domain["Business entities"]
end

subgraph group_insights["Reporting and backup"]
  node_reports_api["Dashboard and statistics"]
  node_reports["Statistics aggregation"]
  node_backup_api["Backup endpoints"]
  node_backup["Backup and restore"]
end

subgraph group_platform["Access and persistence"]
  node_persistence[("JPA repositories")]
  node_identity["Users and roles"]
  node_security["Authentication and security"]
end

node_operator(("Staff user"))

node_operator -.->|"submits orders"| node_order_api
node_order_api -->|"delegates order work"| node_order_rules
node_order_api -->|"uses mix operations"| node_mix_rules
node_operator -.->|"records production"| node_production_api
node_production_api -->|"requests production details"| node_mix_rules
node_production_api -->|"delegates batch work"| node_batch_rules
node_mix_rules -->|"queries and saves"| node_persistence
node_mix_rules -->|"uses mix and formula entities"| node_domain
node_order_rules -->|"loads and saves orders"| node_persistence
node_order_rules -->|"uses order entities"| node_domain
node_mix_stock -->|"accesses stock records"| node_persistence
node_raw_receiving -.->|"persists receipts"| node_persistence
node_raw_stock -.->|"manages raw stock"| node_persistence
node_recipes -.->|"manages formulas"| node_persistence
node_batch_rules -.->|"stores batches"| node_persistence
node_reports_api -.->|"requests statistics"| node_reports
node_reports -->|"reads operational data"| node_persistence
node_backup_api -.->|"requests backup work"| node_backup
node_operator -.->|"authenticates"| node_security
node_security -.->|"checks user access"| node_identity

click node_order_api "https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/controller/PedidoController.java"
click node_order_rules "https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/PedidoService.java"
click node_production_api "https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/controller/ElaboracionController.java"
click node_mix_rules "https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/MixService.java"
click node_mix_stock "https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/MovimientoStockService.java"
click node_raw_receiving "https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/IngresoMPService.java"
click node_raw_stock "https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/MateriaPrimaService.java"
click node_recipes "https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/FormulaService.java"
click node_batch_rules "https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/LoteMixService.java"
click node_domain "https://github.com/enzojp/primera-pulpa/tree/main/Server/src/main/java/com/primeraPulpa/entities"
click node_persistence "https://github.com/enzojp/primera-pulpa/tree/main/Server/src/main/java/com/primeraPulpa/repositories"
click node_reports_api "https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/controller/EstadisticasController.java"
click node_reports "https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/EstadisticasService.java"
click node_backup_api "https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/controller/BackupController.java"
click node_backup "https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/BackupRestoreService.java"
click node_identity "https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/UsuarioService.java"
click node_security "https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/configs/SecurityConfig.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_order_api,node_order_rules,node_production_api,node_mix_rules,node_operator toneBlue
class node_mix_stock,node_raw_receiving,node_raw_stock,node_recipes,node_batch_rules,node_domain toneAmber
class node_reports_api,node_reports,node_backup_api,node_backup toneMint
class node_persistence,node_identity,node_security toneRose
```

## Components

### Sales and production

- [Order endpoints](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/controller/PedidoController.java): `Server/src/main/java/com/primeraPulpa/controller/PedidoController.java`
- [Order workflow](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/PedidoService.java): `Server/src/main/java/com/primeraPulpa/Services/PedidoService.java`
- [Production endpoints](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/controller/ElaboracionController.java): `Server/src/main/java/com/primeraPulpa/controller/ElaboracionController.java`
- [Mix costing and production](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/MixService.java): `Server/src/main/java/com/primeraPulpa/Services/MixService.java`

### Inventory and recipes

- [Mix stock movements](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/MovimientoStockService.java): `Server/src/main/java/com/primeraPulpa/Services/MovimientoStockService.java`
- [Raw material receipts](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/IngresoMPService.java): `Server/src/main/java/com/primeraPulpa/Services/IngresoMPService.java`
- [Raw material catalog](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/MateriaPrimaService.java): `Server/src/main/java/com/primeraPulpa/Services/MateriaPrimaService.java`
- [Formula management](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/FormulaService.java): `Server/src/main/java/com/primeraPulpa/Services/FormulaService.java`
- [Production batches](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/LoteMixService.java): `Server/src/main/java/com/primeraPulpa/Services/LoteMixService.java`
- [Business entities](https://github.com/enzojp/primera-pulpa/tree/main/Server/src/main/java/com/primeraPulpa/entities): `Server/src/main/java/com/primeraPulpa/entities`

### Reporting and backup

- [Dashboard and statistics](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/controller/EstadisticasController.java): `Server/src/main/java/com/primeraPulpa/controller/EstadisticasController.java`
- [Statistics aggregation](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/EstadisticasService.java): `Server/src/main/java/com/primeraPulpa/Services/EstadisticasService.java`
- [Backup endpoints](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/controller/BackupController.java): `Server/src/main/java/com/primeraPulpa/controller/BackupController.java`
- [Backup and restore](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/BackupRestoreService.java): `Server/src/main/java/com/primeraPulpa/Services/BackupRestoreService.java`

### Access and persistence

- [JPA repositories](https://github.com/enzojp/primera-pulpa/tree/main/Server/src/main/java/com/primeraPulpa/repositories): `Server/src/main/java/com/primeraPulpa/repositories`
- [Users and roles](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/Services/UsuarioService.java): `Server/src/main/java/com/primeraPulpa/Services/UsuarioService.java`
- [Authentication and security](https://github.com/enzojp/primera-pulpa/blob/main/Server/src/main/java/com/primeraPulpa/configs/SecurityConfig.java): `Server/src/main/java/com/primeraPulpa/configs/SecurityConfig.java`

### Other components

- **Staff user**

## Connections

- Staff user → Order endpoints: submits orders
- Order endpoints → Order workflow: delegates order work (evidence: `Server/src/main/java/com/primeraPulpa/controller/PedidoController.java`)
- Order endpoints → Mix costing and production: uses mix operations (evidence: `Server/src/main/java/com/primeraPulpa/controller/PedidoController.java`)
- Staff user → Production endpoints: records production
- Production endpoints → Mix costing and production: requests production details (evidence: `Server/src/main/java/com/primeraPulpa/controller/ElaboracionController.java`)
- Production endpoints → Production batches: delegates batch work (evidence: `Server/src/main/java/com/primeraPulpa/controller/ElaboracionController.java`)
- Mix costing and production → JPA repositories: queries and saves (evidence: `Server/src/main/java/com/primeraPulpa/Services/MixService.java`)
- Mix costing and production → Business entities: uses mix and formula entities (evidence: `Server/src/main/java/com/primeraPulpa/Services/MixService.java`)
- Order workflow → JPA repositories: loads and saves orders (evidence: `Server/src/main/java/com/primeraPulpa/Services/PedidoService.java`)
- Order workflow → Business entities: uses order entities (evidence: `Server/src/main/java/com/primeraPulpa/Services/PedidoService.java`)
- Mix stock movements → JPA repositories: accesses stock records (evidence: `Server/src/main/java/com/primeraPulpa/Services/MovimientoStockService.java`)
- Raw material receipts → JPA repositories: persists receipts (evidence: `Server/src/main/java/com/primeraPulpa/Services/IngresoMPService.java`)
- Raw material catalog → JPA repositories: manages raw stock
- Formula management → JPA repositories: manages formulas
- Production batches → JPA repositories: stores batches (evidence: `Server/src/main/java/com/primeraPulpa/Services/LoteMixService.java`)
- Dashboard and statistics → Statistics aggregation: requests statistics (evidence: `Server/src/main/java/com/primeraPulpa/controller/EstadisticasController.java`)
- Statistics aggregation → JPA repositories: reads operational data (evidence: `Server/src/main/java/com/primeraPulpa/Services/EstadisticasService.java`)
- Backup endpoints → Backup and restore: requests backup work
- Staff user → Authentication and security: authenticates
- Authentication and security → Users and roles: checks user access
