# margomez05/sistema_erp architecture

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

- Interactive diagram: https://gitdiagram.com/margomez05/sistema_erp
- Repository: https://github.com/margomez05/sistema_erp

## Overview

Tamachihua-ERP is an Angular web client backed by a Spring Boot REST API for ferretería/agroservicio operations. The user workflow is authenticated access to the web panel, followed by inventory/customer management and sales; a confirmed sale can be invoiced, paid, or credited. The README documents additional dashboard, lot, catalog, and product capabilities. Several frontend-to-API and backend persistence connections are documented at capability level but their implementation was not sampled, so those links are marked dashed.

Main entry points: [`Api/api/src/main/java/com/tamachihua_erp/api/ApiApplication.java`](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/ApiApplication.java) (REST API), [`Web/src/app/app.ts`](https://github.com/margomez05/sistema_erp/blob/main/Web/src/app/app.ts) (Web application), [`Api/api/src/main/java/com/tamachihua_erp/api/service/impl/AuthServiceImpl.java`](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/service/impl/AuthServiceImpl.java) (Authentication), [`Api/api/src/main/java/com/tamachihua_erp/api/service/InvoiceService.java`](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/service/InvoiceService.java) (Billing operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Angular web panel"]
  node_webapp["Web application<br/>[app.ts]"]
  node_login["Login<br/>[login.component.ts]"]
  node_catalogui["Catalog manager"]
  node_customerui["Customer workspace"]
  node_productui["Product workspace"]
  node_salesui["Sales workspace<br/>[sales.routes.ts]"]
  node_dashboard["Dashboard"]
end

subgraph group_identity["Identity and access"]
  node_authcontroller["Auth endpoints"]
  node_authlogic["Authentication"]
  node_userdetails["User lookup"]
  node_jwt["JWT tokens<br/>[JwtService.java]"]
end

subgraph group_inventory["Inventory and customers"]
  node_inventoryapi["Inventory endpoints"]
  node_customerapi["Customer endpoints"]
  node_productapi["Product endpoints"]
  node_dashboardlogic["Dashboard data"]
end

subgraph group_commerce["Sales and billing"]
  node_salesapi["Sales endpoints"]
  node_saleslogic["Sales operations"]
  node_invoiceapi["Invoice endpoints"]
  node_invoicelogic["Billing operations"]
end

subgraph group_persistence["Persistence"]
  node_userrepo["User repository"]
  node_database[("PostgreSQL")]
end

node_staff(("Staff user"))
node_api["REST API"]

node_staff -.->|"uses"| node_webapp
node_webapp -.->|"offers login"| node_login
node_login -.->|"authenticates"| node_authcontroller
node_authcontroller -.->|"delegates to"| node_authlogic
node_authlogic -->|"issues token"| node_jwt
node_authlogic -->|"looks up user"| node_userrepo
node_userdetails -->|"loads user"| node_userrepo
node_catalogui -.->|"manages catalogs"| node_api
node_customerui -.->|"manages customers"| node_customerapi
node_productui -.->|"manages products"| node_productapi
node_webapp -.->|"shows dashboard"| node_dashboard
node_dashboard -.->|"fetches data"| node_api
node_salesui -.->|"uses REST API"| node_api
node_salesapi -->|"delegates to"| node_saleslogic
node_salesapi -->|"creates invoice"| node_invoicelogic
node_invoiceapi -->|"delegates to"| node_invoicelogic
node_inventoryapi -.->|"serves inventory"| node_api
node_customerapi -.->|"serves customer CRUD"| node_api
node_productapi -.->|"serves catalog"| node_api
node_dashboardlogic -.->|"provides summaries"| node_api
node_saleslogic -.->|"persists sales"| node_database
node_invoicelogic -.->|"persists billing"| node_database
node_userrepo -.->|"queries users"| node_database

click node_webapp "https://github.com/margomez05/sistema_erp/blob/main/Web/src/app/app.ts"
click node_login "https://github.com/margomez05/sistema_erp/blob/main/Web/src/app/features/auth/login/login.component.ts"
click node_catalogui "https://github.com/margomez05/sistema_erp/blob/main/Web/src/app/features/catalogs/catalog-manager/catalog-manager.component.ts"
click node_customerui "https://github.com/margomez05/sistema_erp/blob/main/Web/src/app/features/customers/customers.component.ts"
click node_productui "https://github.com/margomez05/sistema_erp/blob/main/Web/src/app/features/products/products.component.ts"
click node_salesui "https://github.com/margomez05/sistema_erp/blob/main/Web/src/app/features/sales/sales.routes.ts"
click node_dashboard "https://github.com/margomez05/sistema_erp/blob/main/Web/src/app/features/dashboard/dashboard.service.ts"
click node_api "https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/ApiApplication.java"
click node_authcontroller "https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/controller/AuthController.java"
click node_authlogic "https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/service/impl/AuthServiceImpl.java"
click node_userdetails "https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/security/CustomUserDetailsService.java"
click node_jwt "https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/security/JwtService.java"
click node_salesapi "https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/controller/SaleController.java"
click node_saleslogic "https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/service/impl/SaleServiceImpl.java"
click node_invoiceapi "https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/controller/InvoiceController.java"
click node_invoicelogic "https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/service/InvoiceService.java"
click node_inventoryapi "https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/controller/ProductLotController.java"
click node_customerapi "https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/controller/CustomerController.java"
click node_productapi "https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/controller/ProductController.java"
click node_dashboardlogic "https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/service/impl/DashboardServiceImpl.java"
click node_userrepo "https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/repository/UserRepository.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_webapp,node_login,node_catalogui,node_customerui,node_productui,node_salesui,node_dashboard,node_staff toneBlue
class node_authcontroller,node_authlogic,node_userdetails,node_jwt toneAmber
class node_inventoryapi,node_customerapi,node_productapi,node_dashboardlogic,node_api toneMint
class node_salesapi,node_saleslogic,node_invoiceapi,node_invoicelogic toneRose
class node_userrepo,node_database toneIndigo
```

## Components

### Angular web panel

- [Web application](https://github.com/margomez05/sistema_erp/blob/main/Web/src/app/app.ts): `Web/src/app/app.ts`
- [Login](https://github.com/margomez05/sistema_erp/blob/main/Web/src/app/features/auth/login/login.component.ts): `Web/src/app/features/auth/login/login.component.ts`
- [Catalog manager](https://github.com/margomez05/sistema_erp/blob/main/Web/src/app/features/catalogs/catalog-manager/catalog-manager.component.ts): `Web/src/app/features/catalogs/catalog-manager/catalog-manager.component.ts`
- [Customer workspace](https://github.com/margomez05/sistema_erp/blob/main/Web/src/app/features/customers/customers.component.ts): `Web/src/app/features/customers/customers.component.ts`
- [Product workspace](https://github.com/margomez05/sistema_erp/blob/main/Web/src/app/features/products/products.component.ts): `Web/src/app/features/products/products.component.ts`
- [Sales workspace](https://github.com/margomez05/sistema_erp/blob/main/Web/src/app/features/sales/sales.routes.ts): `Web/src/app/features/sales/sales.routes.ts`
- [Dashboard](https://github.com/margomez05/sistema_erp/blob/main/Web/src/app/features/dashboard/dashboard.service.ts): `Web/src/app/features/dashboard/dashboard.service.ts`

### Identity and access

- [Auth endpoints](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/controller/AuthController.java): `Api/api/src/main/java/com/tamachihua_erp/api/controller/AuthController.java`
- [Authentication](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/service/impl/AuthServiceImpl.java): `Api/api/src/main/java/com/tamachihua_erp/api/service/impl/AuthServiceImpl.java`
- [User lookup](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/security/CustomUserDetailsService.java): `Api/api/src/main/java/com/tamachihua_erp/api/security/CustomUserDetailsService.java`
- [JWT tokens](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/security/JwtService.java): `Api/api/src/main/java/com/tamachihua_erp/api/security/JwtService.java`

### Inventory and customers

- [Inventory endpoints](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/controller/ProductLotController.java): `Api/api/src/main/java/com/tamachihua_erp/api/controller/ProductLotController.java`
- [Customer endpoints](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/controller/CustomerController.java): `Api/api/src/main/java/com/tamachihua_erp/api/controller/CustomerController.java`
- [Product endpoints](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/controller/ProductController.java): `Api/api/src/main/java/com/tamachihua_erp/api/controller/ProductController.java`
- [Dashboard data](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/service/impl/DashboardServiceImpl.java): `Api/api/src/main/java/com/tamachihua_erp/api/service/impl/DashboardServiceImpl.java`

### Sales and billing

- [Sales endpoints](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/controller/SaleController.java): `Api/api/src/main/java/com/tamachihua_erp/api/controller/SaleController.java`
- [Sales operations](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/service/impl/SaleServiceImpl.java): `Api/api/src/main/java/com/tamachihua_erp/api/service/impl/SaleServiceImpl.java`
- [Invoice endpoints](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/controller/InvoiceController.java): `Api/api/src/main/java/com/tamachihua_erp/api/controller/InvoiceController.java`
- [Billing operations](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/service/InvoiceService.java): `Api/api/src/main/java/com/tamachihua_erp/api/service/InvoiceService.java`

### Persistence

- [User repository](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/repository/UserRepository.java): `Api/api/src/main/java/com/tamachihua_erp/api/repository/UserRepository.java`
- **PostgreSQL**

### Other components

- **Staff user**
- [REST API](https://github.com/margomez05/sistema_erp/blob/main/Api/api/src/main/java/com/tamachihua_erp/api/ApiApplication.java): `Api/api/src/main/java/com/tamachihua_erp/api/ApiApplication.java`

## Connections

- Staff user → Web application: uses (evidence: `README.md`)
- Web application → Login: offers login (evidence: `README.md`)
- Login → Auth endpoints: authenticates (evidence: `README.md`)
- Auth endpoints → Authentication: delegates to (evidence: `README.md`)
- Authentication → JWT tokens: issues token (evidence: `Api/api/src/main/java/com/tamachihua_erp/api/service/impl/AuthServiceImpl.java`)
- Authentication → User repository: looks up user (evidence: `Api/api/src/main/java/com/tamachihua_erp/api/service/impl/AuthServiceImpl.java`)
- User lookup → User repository: loads user (evidence: `Api/api/src/main/java/com/tamachihua_erp/api/security/CustomUserDetailsService.java`)
- Catalog manager → REST API: manages catalogs (evidence: `README.md`)
- Customer workspace → Customer endpoints: manages customers (evidence: `README.md`)
- Product workspace → Product endpoints: manages products (evidence: `README.md`)
- Web application → Dashboard: shows dashboard (evidence: `README.md`)
- Dashboard → REST API: fetches data (evidence: `README.md`)
- Sales workspace → REST API: uses REST API (evidence: `README.md`)
- Sales endpoints → Sales operations: delegates to (evidence: `Api/api/src/main/java/com/tamachihua_erp/api/controller/SaleController.java`)
- Sales endpoints → Billing operations: creates invoice (evidence: `Api/api/src/main/java/com/tamachihua_erp/api/controller/SaleController.java`)
- Invoice endpoints → Billing operations: delegates to (evidence: `Api/api/src/main/java/com/tamachihua_erp/api/controller/InvoiceController.java`)
- Inventory endpoints → REST API: serves inventory (evidence: `README.md`)
- Customer endpoints → REST API: serves customer CRUD (evidence: `README.md`)
- Product endpoints → REST API: serves catalog (evidence: `README.md`)
- Dashboard data → REST API: provides summaries (evidence: `README.md`)
- Sales operations → PostgreSQL: persists sales (evidence: `README.md`)
- Billing operations → PostgreSQL: persists billing (evidence: `README.md`)
- User repository → PostgreSQL: queries users (evidence: `README.md`)
