# prince200510/business-operations-erp architecture

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

- Interactive diagram: https://gitdiagram.com/prince200510/business-operations-erp
- Repository: https://github.com/prince200510/business-operations-erp

## Overview

Nexora is a multi-tenant business operations ERP/POS. Users enter through the React application, authenticate, then use its dashboard to reach sales, inventory, procurement, invoicing, reporting, and business-management features; FastAPI exposes the corresponding backend API. The graph includes the documented invoice/PDF capability, though its implementation details are not shown in the excerpts. Backend route-to-model links follow the SOURCE INDEX; frontend-to-API requests are dashed because the sampled service module does not show their wiring.

Main entry points: [`backend/app/api/reports.py`](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/api/reports.py) (Reports API), [`backend/app/main.py`](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/main.py) (API entry), [`frontend/src/Dashboard.jsx`](https://github.com/prince200510/business-operations-erp/blob/main/frontend/src/Dashboard.jsx) (Dashboard), [`backend/app/api/auth.py`](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/api/auth.py) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_app["App routing<br/>[App.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_pos_ui["POS checkout<br/>[NewSale.jsx]"]
  node_inventory_ui["Inventory UI<br/>[Product.jsx]"]
  node_purchase_ui["Purchases UI<br/>[Purchase.jsx]"]
  node_reports_ui["Reports UI<br/>[Report1.jsx]"]
  node_invoice_ui["Invoice UI<br/>[Invoices.jsx]"]
end

subgraph group_api["API workflows"]
  node_api_entry["API entry<br/>[main.py]"]
  node_auth_api["Authentication<br/>[auth.py]"]
  node_sales_api["Sales API<br/>[sales.py]"]
  node_products_api["Products API<br/>[products.py]"]
  node_purchases_api["Purchases API<br/>[purchases.py]"]
  node_reports_api["Reports API<br/>[reports.py]"]
  node_other_api["Other workflows"]
end

subgraph group_domain["Business domain"]
  node_sales_data["Sales records<br/>[sale_order.py]"]
  node_product_data["Product inventory<br/>[product.py]"]
  node_purchase_data["Purchase records<br/>[purchase.py]"]
  node_supplier_data["Supplier records<br/>[supplier.py]"]
  node_user_data["User accounts<br/>[user.py]"]
end

subgraph group_platform["Backend platform"]
  node_database[("SQL database<br/>[database.py]")]
  node_redis[("Redis cache<br/>[redis.py]")]
  node_security["JWT security<br/>[security.py]"]
  node_dependencies["Auth dependencies<br/>[dependencies.py]"]
  node_config["Configuration<br/>[config.py]"]
end

node_user(("Business user"))
node_email_service["EmailJS"]
node_postgres[("PostgreSQL")]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_dashboard
node_dashboard -->|"opens"| node_pos_ui
node_dashboard -->|"opens"| node_inventory_ui
node_dashboard -->|"opens"| node_purchase_ui
node_dashboard -->|"opens"| node_reports_ui
node_dashboard -->|"opens"| node_invoice_ui
node_app -.->|"requests"| node_auth_api
node_pos_ui -.->|"submits sale"| node_sales_api
node_inventory_ui -.->|"manages products"| node_products_api
node_purchase_ui -.->|"records purchase"| node_purchases_api
node_reports_ui -.->|"requests analytics"| node_reports_api
node_invoice_ui -.->|"requests invoice data"| node_sales_api
node_api_entry -->|"registers"| node_auth_api
node_api_entry -->|"registers"| node_sales_api
node_api_entry -->|"registers"| node_products_api
node_api_entry -->|"registers"| node_purchases_api
node_api_entry -->|"registers"| node_reports_api
node_api_entry -->|"registers"| node_other_api
node_auth_api -->|"queries"| node_user_data
node_auth_api -->|"tracks attempts"| node_redis
node_auth_api -->|"hashes and signs"| node_security
node_auth_api -->|"sends OTP"| node_email_service
node_sales_api -->|"creates and reads"| node_sales_data
node_sales_api -->|"updates stock"| node_product_data
node_sales_api -.->|"uses"| node_supplier_data
node_products_api -->|"manages"| node_product_data
node_products_api -->|"references"| node_supplier_data
node_purchases_api -->|"records"| node_purchase_data
node_purchases_api -->|"updates stock"| node_product_data
node_purchases_api -->|"references"| node_supplier_data
node_reports_api -->|"aggregates"| node_sales_data
node_reports_api -->|"aggregates"| node_product_data
node_reports_api -->|"aggregates"| node_purchase_data
node_reports_api -->|"aggregates"| node_supplier_data
node_reports_api -->|"caches results"| node_redis
node_database -.->|"connects"| node_postgres
node_database -->|"loads settings"| node_config
node_security -->|"loads secret"| node_config
node_dependencies -->|"uses JWT rules"| node_security
node_redis -->|"loads URL"| node_config

click node_app "https://github.com/prince200510/business-operations-erp/blob/main/frontend/src/App.jsx"
click node_dashboard "https://github.com/prince200510/business-operations-erp/blob/main/frontend/src/Dashboard.jsx"
click node_pos_ui "https://github.com/prince200510/business-operations-erp/blob/main/frontend/src/NewSale.jsx"
click node_inventory_ui "https://github.com/prince200510/business-operations-erp/blob/main/frontend/src/Product.jsx"
click node_purchase_ui "https://github.com/prince200510/business-operations-erp/blob/main/frontend/src/Purchase.jsx"
click node_reports_ui "https://github.com/prince200510/business-operations-erp/blob/main/frontend/src/Report1.jsx"
click node_invoice_ui "https://github.com/prince200510/business-operations-erp/blob/main/frontend/src/Invoices.jsx"
click node_api_entry "https://github.com/prince200510/business-operations-erp/blob/main/backend/app/main.py"
click node_auth_api "https://github.com/prince200510/business-operations-erp/blob/main/backend/app/api/auth.py"
click node_sales_api "https://github.com/prince200510/business-operations-erp/blob/main/backend/app/api/sales.py"
click node_products_api "https://github.com/prince200510/business-operations-erp/blob/main/backend/app/api/products.py"
click node_purchases_api "https://github.com/prince200510/business-operations-erp/blob/main/backend/app/api/purchases.py"
click node_reports_api "https://github.com/prince200510/business-operations-erp/blob/main/backend/app/api/reports.py"
click node_other_api "https://github.com/prince200510/business-operations-erp/tree/main/backend/app/api"
click node_sales_data "https://github.com/prince200510/business-operations-erp/blob/main/backend/app/modules/sale_order.py"
click node_product_data "https://github.com/prince200510/business-operations-erp/blob/main/backend/app/modules/product.py"
click node_purchase_data "https://github.com/prince200510/business-operations-erp/blob/main/backend/app/modules/purchase.py"
click node_supplier_data "https://github.com/prince200510/business-operations-erp/blob/main/backend/app/modules/supplier.py"
click node_user_data "https://github.com/prince200510/business-operations-erp/blob/main/backend/app/modules/user.py"
click node_database "https://github.com/prince200510/business-operations-erp/blob/main/backend/app/core/database.py"
click node_redis "https://github.com/prince200510/business-operations-erp/blob/main/backend/app/core/redis.py"
click node_security "https://github.com/prince200510/business-operations-erp/blob/main/backend/app/core/security.py"
click node_dependencies "https://github.com/prince200510/business-operations-erp/blob/main/backend/app/core/dependencies.py"
click node_config "https://github.com/prince200510/business-operations-erp/blob/main/backend/app/core/config.py"

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_dashboard,node_pos_ui,node_inventory_ui,node_purchase_ui,node_reports_ui,node_invoice_ui,node_user toneBlue
class node_api_entry,node_auth_api,node_sales_api,node_products_api,node_purchases_api,node_reports_api,node_other_api,node_postgres toneAmber
class node_sales_data,node_product_data,node_purchase_data,node_supplier_data,node_user_data toneMint
class node_database,node_redis,node_security,node_dependencies,node_config toneRose
class node_email_service toneIndigo
```

## Components

### Frontend

- [App routing](https://github.com/prince200510/business-operations-erp/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Dashboard](https://github.com/prince200510/business-operations-erp/blob/main/frontend/src/Dashboard.jsx): `frontend/src/Dashboard.jsx`
- [POS checkout](https://github.com/prince200510/business-operations-erp/blob/main/frontend/src/NewSale.jsx): `frontend/src/NewSale.jsx`
- [Inventory UI](https://github.com/prince200510/business-operations-erp/blob/main/frontend/src/Product.jsx): `frontend/src/Product.jsx`
- [Purchases UI](https://github.com/prince200510/business-operations-erp/blob/main/frontend/src/Purchase.jsx): `frontend/src/Purchase.jsx`
- [Reports UI](https://github.com/prince200510/business-operations-erp/blob/main/frontend/src/Report1.jsx): `frontend/src/Report1.jsx`
- [Invoice UI](https://github.com/prince200510/business-operations-erp/blob/main/frontend/src/Invoices.jsx): `frontend/src/Invoices.jsx`

### API workflows

- [API entry](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/api/auth.py): `backend/app/api/auth.py`
- [Sales API](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/api/sales.py): `backend/app/api/sales.py`
- [Products API](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/api/products.py): `backend/app/api/products.py`
- [Purchases API](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/api/purchases.py): `backend/app/api/purchases.py`
- [Reports API](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/api/reports.py): `backend/app/api/reports.py`
- [Other workflows](https://github.com/prince200510/business-operations-erp/tree/main/backend/app/api): `backend/app/api`

### Business domain

- [Sales records](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/modules/sale_order.py): `backend/app/modules/sale_order.py`
- [Product inventory](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/modules/product.py): `backend/app/modules/product.py`
- [Purchase records](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/modules/purchase.py): `backend/app/modules/purchase.py`
- [Supplier records](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/modules/supplier.py): `backend/app/modules/supplier.py`
- [User accounts](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/modules/user.py): `backend/app/modules/user.py`

### Backend platform

- [SQL database](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- [Redis cache](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/core/redis.py): `backend/app/core/redis.py`
- [JWT security](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/core/security.py): `backend/app/core/security.py`
- [Auth dependencies](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/core/dependencies.py): `backend/app/core/dependencies.py`
- [Configuration](https://github.com/prince200510/business-operations-erp/blob/main/backend/app/core/config.py): `backend/app/core/config.py`

### Other components

- **Business user**
- **EmailJS**
- **PostgreSQL**

## Connections

- Business user → App routing: uses
- App routing → Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Dashboard → POS checkout: opens (evidence: `frontend/src/Dashboard.jsx`)
- Dashboard → Inventory UI: opens (evidence: `frontend/src/Dashboard.jsx`)
- Dashboard → Purchases UI: opens (evidence: `frontend/src/Dashboard.jsx`)
- Dashboard → Reports UI: opens (evidence: `frontend/src/Dashboard.jsx`)
- Dashboard → Invoice UI: opens (evidence: `frontend/src/Dashboard.jsx`)
- App routing → Authentication: requests
- POS checkout → Sales API: submits sale
- Inventory UI → Products API: manages products
- Purchases UI → Purchases API: records purchase
- Reports UI → Reports API: requests analytics
- Invoice UI → Sales API: requests invoice data
- API entry → Authentication: registers (evidence: `backend/app/main.py`)
- API entry → Sales API: registers (evidence: `backend/app/main.py`)
- API entry → Products API: registers (evidence: `backend/app/main.py`)
- API entry → Purchases API: registers (evidence: `backend/app/main.py`)
- API entry → Reports API: registers (evidence: `backend/app/main.py`)
- API entry → Other workflows: registers (evidence: `backend/app/main.py`)
- Authentication → User accounts: queries (evidence: `backend/app/api/auth.py`)
- Authentication → Redis cache: tracks attempts (evidence: `backend/app/api/auth.py`)
- Authentication → JWT security: hashes and signs (evidence: `backend/app/api/auth.py`)
- Authentication → EmailJS: sends OTP (evidence: `backend/app/api/auth.py`)
- Sales API → Sales records: creates and reads (evidence: `backend/app/api/sales.py`)
- Sales API → Product inventory: updates stock (evidence: `backend/app/api/sales.py`)
- Sales API → Supplier records: uses
- Products API → Product inventory: manages (evidence: `backend/app/api/products.py`)
- Products API → Supplier records: references (evidence: `backend/app/api/products.py`)
- Purchases API → Purchase records: records (evidence: `backend/app/api/purchases.py`)
- Purchases API → Product inventory: updates stock (evidence: `backend/app/api/purchases.py`)
- Purchases API → Supplier records: references (evidence: `backend/app/api/purchases.py`)
- Reports API → Sales records: aggregates (evidence: `backend/app/api/reports.py`)
- Reports API → Product inventory: aggregates (evidence: `backend/app/api/reports.py`)
- Reports API → Purchase records: aggregates (evidence: `backend/app/api/reports.py`)
- Reports API → Supplier records: aggregates (evidence: `backend/app/api/reports.py`)
- Reports API → Redis cache: caches results (evidence: `backend/app/api/reports.py`)
- SQL database → PostgreSQL: connects
- SQL database → Configuration: loads settings (evidence: `backend/app/core/database.py`)
- JWT security → Configuration: loads secret (evidence: `backend/app/core/security.py`)
- Auth dependencies → JWT security: uses JWT rules (evidence: `backend/app/core/dependencies.py`)
- Redis cache → Configuration: loads URL (evidence: `backend/app/core/redis.py`)
