# stablelife11-commits/business-erp-backend architecture

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

- Interactive diagram: https://gitdiagram.com/stablelife11-commits/business-erp-backend
- Repository: https://github.com/stablelife11-commits/business-erp-backend

## Overview

This is a Spring API for inventory and small-business sales operations, despite the application name referencing student management. Its main user workflow is to manage products and counterparties, record purchases and sales, then retrieve operational reports or a sale PDF. The tree also shows customer and supplier payment/ledger features, expenses, dashboard data, and JWT authentication. The available excerpts show selected controller-to-service and service-to-repository relationships; other links are omitted where source evidence was not provided.

Main entry points: [`src/main/java/com/student/studentmanagementapi/repository/ProductRepository.java`](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/repository/ProductRepository.java) (Product repository), [`src/main/java/com/student/studentmanagementapi/service/ReportService.java`](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/ReportService.java) (Report service), [`src/main/java/com/student/studentmanagementapi/repository/SaleRepository.java`](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/repository/SaleRepository.java) (Sale repository), [`src/main/java/com/student/studentmanagementapi/service/PurchaseService.java`](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/PurchaseService.java) (Purchase service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["API and security"]
  node_product_api["Product API"]
  node_customer_api["Customer API"]
  node_supplier_api["Supplier API"]
  node_supplier_payment_api["Supplier payment API"]
  node_report_api["Report API"]
  node_jwt_filter["JWT filter"]
end

subgraph group_catalog["Catalog and parties"]
  node_product_service["Product service"]
  node_customer_service["Customer service"]
  node_supplier_service["Supplier service"]
  node_customer_ledger["Customer ledger"]
end

subgraph group_transactions["Commerce transactions"]
  node_purchase_service["Purchase service"]
  node_sale_service["Sale service<br/>[SaleService.java]"]
  node_sale_pdf["Sale PDF"]
end

subgraph group_insights["Reports and summaries"]
  node_report_service["Report service<br/>[ReportService.java]"]
  node_dashboard_service["Dashboard service"]
end

subgraph group_persistence["Persistence models"]
  node_product_repo["Product repository"]
  node_purchase_repo["Purchase repository"]
  node_sale_repo["Sale repository"]
  node_supplier_repo["Supplier repository"]
  node_domain_entities["Business entities"]
end

node_operator(("API user"))
node_database[("Relational database")]

node_operator -->|"manages products"| node_product_api
node_operator -->|"requests reports"| node_report_api
node_product_api -->|"delegates to"| node_product_service
node_customer_api -->|"delegates to"| node_customer_service
node_supplier_api -->|"delegates to"| node_supplier_service
node_supplier_payment_api -->|"uses"| node_supplier_service
node_report_api -->|"delegates to"| node_report_service
node_product_service -->|"reads and writes"| node_product_repo
node_purchase_service -->|"updates stock"| node_product_repo
node_purchase_service -->|"persists purchases"| node_purchase_repo
node_purchase_service -->|"loads suppliers"| node_supplier_repo
node_sale_service -->|"uses products"| node_product_repo
node_sale_service -->|"persists sales"| node_sale_repo
node_report_service -->|"queries sales"| node_sale_repo
node_report_service -->|"queries purchases"| node_purchase_repo
node_report_service -->|"queries stock"| node_product_repo
node_sale_pdf -->|"loads sale"| node_sale_repo
node_sale_pdf -->|"renders sale items"| node_domain_entities
node_customer_ledger -->|"builds ledger"| node_domain_entities
node_product_repo -.->|"accesses records"| node_database
node_purchase_repo -.->|"accesses records"| node_database
node_sale_repo -.->|"accesses records"| node_database
node_supplier_repo -.->|"accesses records"| node_database
node_jwt_filter -.->|"authenticates requests"| node_operator

click node_product_api "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/controller/ProductController.java"
click node_customer_api "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/controller/CustomerController.java"
click node_supplier_api "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/controller/SupplierController.java"
click node_supplier_payment_api "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/controller/SupplierPaymentController.java"
click node_report_api "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/controller/ReportController.java"
click node_jwt_filter "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/security/JwtAuthenticationFilter.java"
click node_product_service "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/ProductService.java"
click node_customer_service "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/CustomerService.java"
click node_supplier_service "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/SupplierService.java"
click node_customer_ledger "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/CustomerLedgerService.java"
click node_purchase_service "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/PurchaseService.java"
click node_sale_service "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/SaleService.java"
click node_sale_pdf "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/SalePdfService.java"
click node_report_service "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/ReportService.java"
click node_dashboard_service "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/DashboardService.java"
click node_product_repo "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/repository/ProductRepository.java"
click node_purchase_repo "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/repository/PurchaseRepository.java"
click node_sale_repo "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/repository/SaleRepository.java"
click node_supplier_repo "https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/repository/SupplierRepository.java"
click node_domain_entities "https://github.com/stablelife11-commits/business-erp-backend/tree/main/src/main/java/com/student/studentmanagementapi/entity"

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_product_api,node_customer_api,node_supplier_api,node_supplier_payment_api,node_report_api,node_jwt_filter,node_operator toneBlue
class node_product_service,node_customer_service,node_supplier_service,node_customer_ledger,node_database toneAmber
class node_purchase_service,node_sale_service,node_sale_pdf toneMint
class node_report_service,node_dashboard_service toneRose
class node_product_repo,node_purchase_repo,node_sale_repo,node_supplier_repo,node_domain_entities toneIndigo
```

## Components

### API and security

- [Product API](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/controller/ProductController.java): `src/main/java/com/student/studentmanagementapi/controller/ProductController.java`
- [Customer API](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/controller/CustomerController.java): `src/main/java/com/student/studentmanagementapi/controller/CustomerController.java`
- [Supplier API](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/controller/SupplierController.java): `src/main/java/com/student/studentmanagementapi/controller/SupplierController.java`
- [Supplier payment API](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/controller/SupplierPaymentController.java): `src/main/java/com/student/studentmanagementapi/controller/SupplierPaymentController.java`
- [Report API](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/controller/ReportController.java): `src/main/java/com/student/studentmanagementapi/controller/ReportController.java`
- [JWT filter](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/security/JwtAuthenticationFilter.java): `src/main/java/com/student/studentmanagementapi/security/JwtAuthenticationFilter.java`

### Catalog and parties

- [Product service](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/ProductService.java): `src/main/java/com/student/studentmanagementapi/service/ProductService.java`
- [Customer service](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/CustomerService.java): `src/main/java/com/student/studentmanagementapi/service/CustomerService.java`
- [Supplier service](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/SupplierService.java): `src/main/java/com/student/studentmanagementapi/service/SupplierService.java`
- [Customer ledger](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/CustomerLedgerService.java): `src/main/java/com/student/studentmanagementapi/service/CustomerLedgerService.java`

### Commerce transactions

- [Purchase service](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/PurchaseService.java): `src/main/java/com/student/studentmanagementapi/service/PurchaseService.java`
- [Sale service](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/SaleService.java): `src/main/java/com/student/studentmanagementapi/service/SaleService.java`
- [Sale PDF](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/SalePdfService.java): `src/main/java/com/student/studentmanagementapi/service/SalePdfService.java`

### Reports and summaries

- [Report service](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/ReportService.java): `src/main/java/com/student/studentmanagementapi/service/ReportService.java`
- [Dashboard service](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/service/DashboardService.java): `src/main/java/com/student/studentmanagementapi/service/DashboardService.java`

### Persistence models

- [Product repository](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/repository/ProductRepository.java): `src/main/java/com/student/studentmanagementapi/repository/ProductRepository.java`
- [Purchase repository](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/repository/PurchaseRepository.java): `src/main/java/com/student/studentmanagementapi/repository/PurchaseRepository.java`
- [Sale repository](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/repository/SaleRepository.java): `src/main/java/com/student/studentmanagementapi/repository/SaleRepository.java`
- [Supplier repository](https://github.com/stablelife11-commits/business-erp-backend/blob/main/src/main/java/com/student/studentmanagementapi/repository/SupplierRepository.java): `src/main/java/com/student/studentmanagementapi/repository/SupplierRepository.java`
- [Business entities](https://github.com/stablelife11-commits/business-erp-backend/tree/main/src/main/java/com/student/studentmanagementapi/entity): `src/main/java/com/student/studentmanagementapi/entity`

### Other components

- **API user**
- **Relational database**

## Connections

- API user → Product API: manages products
- API user → Report API: requests reports
- Product API → Product service: delegates to (evidence: `src/main/java/com/student/studentmanagementapi/controller/ProductController.java`)
- Customer API → Customer service: delegates to (evidence: `src/main/java/com/student/studentmanagementapi/controller/CustomerController.java`)
- Supplier API → Supplier service: delegates to (evidence: `src/main/java/com/student/studentmanagementapi/controller/SupplierController.java`)
- Supplier payment API → Supplier service: uses (evidence: `src/main/java/com/student/studentmanagementapi/controller/SupplierPaymentController.java`)
- Report API → Report service: delegates to (evidence: `src/main/java/com/student/studentmanagementapi/controller/ReportController.java`)
- Product service → Product repository: reads and writes (evidence: `src/main/java/com/student/studentmanagementapi/service/ProductService.java`)
- Purchase service → Product repository: updates stock (evidence: `src/main/java/com/student/studentmanagementapi/service/PurchaseService.java`)
- Purchase service → Purchase repository: persists purchases (evidence: `src/main/java/com/student/studentmanagementapi/service/PurchaseService.java`)
- Purchase service → Supplier repository: loads suppliers (evidence: `src/main/java/com/student/studentmanagementapi/service/PurchaseService.java`)
- Sale service → Product repository: uses products (evidence: `src/main/java/com/student/studentmanagementapi/service/SaleService.java`)
- Sale service → Sale repository: persists sales (evidence: `src/main/java/com/student/studentmanagementapi/service/SaleService.java`)
- Report service → Sale repository: queries sales (evidence: `src/main/java/com/student/studentmanagementapi/service/ReportService.java`)
- Report service → Purchase repository: queries purchases (evidence: `src/main/java/com/student/studentmanagementapi/service/ReportService.java`)
- Report service → Product repository: queries stock (evidence: `src/main/java/com/student/studentmanagementapi/service/ReportService.java`)
- Sale PDF → Sale repository: loads sale (evidence: `src/main/java/com/student/studentmanagementapi/service/SalePdfService.java`)
- Sale PDF → Business entities: renders sale items (evidence: `src/main/java/com/student/studentmanagementapi/service/SalePdfService.java`)
- Customer ledger → Business entities: builds ledger (evidence: `src/main/java/com/student/studentmanagementapi/service/CustomerLedgerService.java`)
- Product repository → Relational database: accesses records
- Purchase repository → Relational database: accesses records
- Sale repository → Relational database: accesses records
- Supplier repository → Relational database: accesses records
- JWT filter → API user: authenticates requests
