# mdraihan2010/inventory-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/mdraihan2010/inventory-management-system
- Repository: https://github.com/mdraihan2010/inventory-management-system

## Overview

StockPilot is an inventory, purchasing, and sales management application. Users enter through the dashboard, open operational screens, and use them to manage catalog and stock, create sales or purchases, record payments and returns, and review reports. The frontend calls a versioned API; backend routes dispatch to business controllers, which persist domain records in MongoDB. The README documents additional capabilities such as CSV imports, invoices, audit history, and role-based access. Some subsystem links are documented rather than visible in sampled calls, so they are shown only where supported.

Main entry points: [`lib/api.ts`](https://github.com/mdraihan2010/inventory-management-system/blob/main/lib/api.ts) (API client), [`app/page.tsx`](https://github.com/mdraihan2010/inventory-management-system/blob/main/app/page.tsx) (Dashboard navigation), [`components/sales-page.tsx`](https://github.com/mdraihan2010/inventory-management-system/blob/main/components/sales-page.tsx) (Sales screen), [`server/src/server.js`](https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/server.js) (Express API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_dashboard["Dashboard navigation<br/>[page.tsx]"]
  node_catalog_ui["Catalog screens<br/>[catalog-page.tsx]"]
  node_products_ui["Products screen<br/>[products-page.tsx]"]
  node_inventory_ui["Inventory screen<br/>[inventory-page.tsx]"]
  node_sales_ui["Sales screen<br/>[sales-page.tsx]"]
  node_sales_picker["Product picker<br/>[product-picker.tsx]"]
  node_sales_shared["Sales helpers<br/>[sales-shared.ts]"]
  node_purchases_ui["Purchases screen<br/>[purchases-page.tsx]"]
  node_purchase_helpers["Purchase helpers"]
  node_customers_ui["Customers screen<br/>[customers-page.tsx]"]
  node_suppliers_ui["Suppliers screen<br/>[suppliers-page.tsx]"]
  node_payments_ui["Payments and dues<br/>[payments-page.tsx]"]
  node_returns_ui["Returns screen<br/>[returns-page.tsx]"]
  node_reports_ui["Reports screen<br/>[reports-page.tsx]"]
  node_users_ui["Users and audit<br/>[users-page.tsx]"]
  node_csv["CSV utilities<br/>[csv.ts]"]
  node_money["Money formatting<br/>[money.ts]"]
end

subgraph group_operations["Business operations"]
  node_sales_logic["Sales and payment logic<br/>[saleController.js]"]
  node_purchase_logic["Purchasing and supplier payments"]
  node_inventory_logic["Stock management"]
  node_returns_logic["Customer and supplier returns"]
  node_report_logic["Reporting"]
  node_product_logic["Product management"]
end

subgraph group_platform["API and access"]
  node_api_client["API client<br/>[api.ts]"]
  node_api_server["Express API<br/>[server.js]"]
  node_auth["Authentication and roles<br/>[authMiddleware.js]"]
end

subgraph group_data["Persistence and records"]
  node_models_sales[("Sales records<br/>[Sale.js]")]
  node_models_purchase[("Purchase records<br/>[Purchase.js]")]
  node_models_product[("Product records<br/>[Product.js]")]
  node_models_stock[("Stock movements<br/>[StockMovement.js]")]
  node_models_return[("Return records<br/>[Return.js]")]
  node_models_payment[("Payment records<br/>[Payment.js]")]
  node_audit["Audit logging<br/>[auditLogger.js]"]
end

node_user(("Staff or manager"))

node_user -->|"opens app"| node_dashboard
node_dashboard -->|"renders"| node_products_ui
node_dashboard -->|"renders"| node_sales_ui
node_dashboard -->|"renders"| node_purchases_ui
node_dashboard -->|"renders"| node_inventory_ui
node_dashboard -->|"renders"| node_catalog_ui
node_sales_ui -->|"uses"| node_sales_picker
node_purchases_ui -->|"uses"| node_sales_picker
node_sales_ui -->|"requests data"| node_api_client
node_products_ui -->|"requests data"| node_api_client
node_purchases_ui -->|"requests data"| node_api_client
node_customers_ui -->|"requests data"| node_api_client
node_suppliers_ui -->|"requests data"| node_api_client
node_payments_ui -->|"requests data"| node_api_client
node_sales_ui -->|"uses"| node_sales_shared
node_payments_ui -->|"uses"| node_purchase_helpers
node_sales_ui -->|"exports CSV"| node_csv
node_sales_ui -->|"formats amounts"| node_money
node_api_client -.->|"sends requests"| node_api_server
node_api_server -->|"routes sales"| node_sales_logic
node_api_server -->|"routes purchases"| node_purchase_logic
node_api_server -->|"routes reports"| node_report_logic
node_api_server -->|"routes products"| node_product_logic
node_api_server -.->|"uses access checks"| node_auth
node_sales_logic -->|"reads and writes"| node_models_sales
node_sales_logic -->|"reads products"| node_models_product
node_sales_logic -->|"records stock"| node_models_stock
node_sales_logic -->|"creates payments"| node_models_payment
node_purchase_logic -->|"reads and writes"| node_models_purchase
node_inventory_logic -.->|"updates stock"| node_models_product
node_returns_logic -->|"creates returns"| node_models_return
node_returns_logic -->|"updates stock"| node_models_product
node_returns_logic -->|"records movement"| node_models_stock
node_report_logic -->|"reads sales"| node_models_sales
node_report_logic -->|"reads purchases"| node_models_purchase
node_report_logic -->|"reads products"| node_models_product
node_report_logic -->|"reads returns"| node_models_return
node_product_logic -->|"manages products"| node_models_product
node_product_logic -->|"logs changes"| node_audit

click node_dashboard "https://github.com/mdraihan2010/inventory-management-system/blob/main/app/page.tsx"
click node_catalog_ui "https://github.com/mdraihan2010/inventory-management-system/blob/main/components/catalog-page.tsx"
click node_products_ui "https://github.com/mdraihan2010/inventory-management-system/blob/main/components/products-page.tsx"
click node_inventory_ui "https://github.com/mdraihan2010/inventory-management-system/blob/main/components/inventory-page.tsx"
click node_sales_ui "https://github.com/mdraihan2010/inventory-management-system/blob/main/components/sales-page.tsx"
click node_sales_picker "https://github.com/mdraihan2010/inventory-management-system/blob/main/components/product-picker.tsx"
click node_sales_shared "https://github.com/mdraihan2010/inventory-management-system/blob/main/components/sales-shared.ts"
click node_purchases_ui "https://github.com/mdraihan2010/inventory-management-system/blob/main/components/purchases-page.tsx"
click node_purchase_helpers "https://github.com/mdraihan2010/inventory-management-system/blob/main/components/purchases-shared.ts"
click node_customers_ui "https://github.com/mdraihan2010/inventory-management-system/blob/main/components/customers-page.tsx"
click node_suppliers_ui "https://github.com/mdraihan2010/inventory-management-system/blob/main/components/suppliers-page.tsx"
click node_payments_ui "https://github.com/mdraihan2010/inventory-management-system/blob/main/components/payments-page.tsx"
click node_returns_ui "https://github.com/mdraihan2010/inventory-management-system/blob/main/components/returns-page.tsx"
click node_reports_ui "https://github.com/mdraihan2010/inventory-management-system/blob/main/components/reports-page.tsx"
click node_users_ui "https://github.com/mdraihan2010/inventory-management-system/blob/main/components/users-page.tsx"
click node_api_client "https://github.com/mdraihan2010/inventory-management-system/blob/main/lib/api.ts"
click node_api_server "https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/server.js"
click node_auth "https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/middleware/authMiddleware.js"
click node_sales_logic "https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/controllers/saleController.js"
click node_purchase_logic "https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/controllers/purchaseController.js"
click node_inventory_logic "https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/controllers/inventoryController.js"
click node_returns_logic "https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/controllers/returnController.js"
click node_report_logic "https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/controllers/reportController.js"
click node_product_logic "https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/controllers/productController.js"
click node_models_sales "https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/models/Sale.js"
click node_models_purchase "https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/models/Purchase.js"
click node_models_product "https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/models/Product.js"
click node_models_stock "https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/models/StockMovement.js"
click node_models_return "https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/models/Return.js"
click node_models_payment "https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/models/Payment.js"
click node_audit "https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/utils/auditLogger.js"
click node_csv "https://github.com/mdraihan2010/inventory-management-system/blob/main/lib/csv.ts"
click node_money "https://github.com/mdraihan2010/inventory-management-system/blob/main/lib/money.ts"

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_dashboard,node_catalog_ui,node_products_ui,node_inventory_ui,node_sales_ui,node_sales_picker,node_sales_shared,node_purchases_ui,node_purchase_helpers,node_customers_ui,node_suppliers_ui,node_payments_ui,node_returns_ui,node_reports_ui,node_users_ui,node_csv,node_money toneBlue
class node_sales_logic,node_purchase_logic,node_inventory_logic,node_returns_logic,node_report_logic,node_product_logic toneAmber
class node_api_client,node_api_server,node_auth toneMint
class node_models_sales,node_models_purchase,node_models_product,node_models_stock,node_models_return,node_models_payment,node_audit toneRose
class node_user toneIndigo
```

## Components

### Web application

- [Dashboard navigation](https://github.com/mdraihan2010/inventory-management-system/blob/main/app/page.tsx): `app/page.tsx`
- [Catalog screens](https://github.com/mdraihan2010/inventory-management-system/blob/main/components/catalog-page.tsx): `components/catalog-page.tsx`
- [Products screen](https://github.com/mdraihan2010/inventory-management-system/blob/main/components/products-page.tsx): `components/products-page.tsx`
- [Inventory screen](https://github.com/mdraihan2010/inventory-management-system/blob/main/components/inventory-page.tsx): `components/inventory-page.tsx`
- [Sales screen](https://github.com/mdraihan2010/inventory-management-system/blob/main/components/sales-page.tsx): `components/sales-page.tsx`
- [Product picker](https://github.com/mdraihan2010/inventory-management-system/blob/main/components/product-picker.tsx): `components/product-picker.tsx`
- [Sales helpers](https://github.com/mdraihan2010/inventory-management-system/blob/main/components/sales-shared.ts): `components/sales-shared.ts`
- [Purchases screen](https://github.com/mdraihan2010/inventory-management-system/blob/main/components/purchases-page.tsx): `components/purchases-page.tsx`
- [Purchase helpers](https://github.com/mdraihan2010/inventory-management-system/blob/main/components/purchases-shared.ts): `components/purchases-shared.ts`
- [Customers screen](https://github.com/mdraihan2010/inventory-management-system/blob/main/components/customers-page.tsx): `components/customers-page.tsx`
- [Suppliers screen](https://github.com/mdraihan2010/inventory-management-system/blob/main/components/suppliers-page.tsx): `components/suppliers-page.tsx`
- [Payments and dues](https://github.com/mdraihan2010/inventory-management-system/blob/main/components/payments-page.tsx): `components/payments-page.tsx`
- [Returns screen](https://github.com/mdraihan2010/inventory-management-system/blob/main/components/returns-page.tsx): `components/returns-page.tsx`
- [Reports screen](https://github.com/mdraihan2010/inventory-management-system/blob/main/components/reports-page.tsx): `components/reports-page.tsx`
- [Users and audit](https://github.com/mdraihan2010/inventory-management-system/blob/main/components/users-page.tsx): `components/users-page.tsx`
- [CSV utilities](https://github.com/mdraihan2010/inventory-management-system/blob/main/lib/csv.ts): `lib/csv.ts`
- [Money formatting](https://github.com/mdraihan2010/inventory-management-system/blob/main/lib/money.ts): `lib/money.ts`

### Business operations

- [Sales and payment logic](https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/controllers/saleController.js): `server/src/controllers/saleController.js`
- [Purchasing and supplier payments](https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/controllers/purchaseController.js): `server/src/controllers/purchaseController.js`
- [Stock management](https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/controllers/inventoryController.js): `server/src/controllers/inventoryController.js`
- [Customer and supplier returns](https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/controllers/returnController.js): `server/src/controllers/returnController.js`
- [Reporting](https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/controllers/reportController.js): `server/src/controllers/reportController.js`
- [Product management](https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/controllers/productController.js): `server/src/controllers/productController.js`

### API and access

- [API client](https://github.com/mdraihan2010/inventory-management-system/blob/main/lib/api.ts): `lib/api.ts`
- [Express API](https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/server.js): `server/src/server.js`
- [Authentication and roles](https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/middleware/authMiddleware.js): `server/src/middleware/authMiddleware.js`

### Persistence and records

- [Sales records](https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/models/Sale.js): `server/src/models/Sale.js`
- [Purchase records](https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/models/Purchase.js): `server/src/models/Purchase.js`
- [Product records](https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/models/Product.js): `server/src/models/Product.js`
- [Stock movements](https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/models/StockMovement.js): `server/src/models/StockMovement.js`
- [Return records](https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/models/Return.js): `server/src/models/Return.js`
- [Payment records](https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/models/Payment.js): `server/src/models/Payment.js`
- [Audit logging](https://github.com/mdraihan2010/inventory-management-system/blob/main/server/src/utils/auditLogger.js): `server/src/utils/auditLogger.js`

### Other components

- **Staff or manager**

## Connections

- Staff or manager → Dashboard navigation: opens app (evidence: `README.md`)
- Dashboard navigation → Products screen: renders (evidence: `app/page.tsx`)
- Dashboard navigation → Sales screen: renders (evidence: `app/page.tsx`)
- Dashboard navigation → Purchases screen: renders (evidence: `app/page.tsx`)
- Dashboard navigation → Inventory screen: renders (evidence: `app/page.tsx`)
- Dashboard navigation → Catalog screens: renders (evidence: `app/page.tsx`)
- Sales screen → Product picker: uses (evidence: `components/sales-page.tsx`)
- Purchases screen → Product picker: uses (evidence: `components/purchases-page.tsx`)
- Sales screen → API client: requests data (evidence: `components/sales-page.tsx`)
- Products screen → API client: requests data (evidence: `components/products-page.tsx`)
- Purchases screen → API client: requests data (evidence: `components/purchases-page.tsx`)
- Customers screen → API client: requests data
- Suppliers screen → API client: requests data (evidence: `components/suppliers-page.tsx`)
- Payments and dues → API client: requests data (evidence: `components/payments-page.tsx`)
- Sales screen → Sales helpers: uses (evidence: `components/sales-page.tsx`)
- Payments and dues → Purchase helpers: uses (evidence: `components/payments-page.tsx`)
- Sales screen → CSV utilities: exports CSV (evidence: `components/sales-page.tsx`)
- Sales screen → Money formatting: formats amounts (evidence: `components/sales-page.tsx`)
- API client → Express API: sends requests
- Express API → Sales and payment logic: routes sales (evidence: `server/src/server.js`)
- Express API → Purchasing and supplier payments: routes purchases (evidence: `server/src/server.js`)
- Express API → Reporting: routes reports (evidence: `server/src/server.js`)
- Express API → Product management: routes products (evidence: `server/src/server.js`)
- Express API → Authentication and roles: uses access checks
- Sales and payment logic → Sales records: reads and writes (evidence: `server/src/controllers/saleController.js`)
- Sales and payment logic → Product records: reads products (evidence: `server/src/controllers/saleController.js`)
- Sales and payment logic → Stock movements: records stock (evidence: `server/src/controllers/saleController.js`)
- Sales and payment logic → Payment records: creates payments (evidence: `server/src/controllers/saleController.js`)
- Purchasing and supplier payments → Purchase records: reads and writes
- Stock management → Product records: updates stock
- Customer and supplier returns → Return records: creates returns (evidence: `server/src/controllers/returnController.js`)
- Customer and supplier returns → Product records: updates stock (evidence: `server/src/controllers/returnController.js`)
- Customer and supplier returns → Stock movements: records movement (evidence: `server/src/controllers/returnController.js`)
- Reporting → Sales records: reads sales (evidence: `server/src/controllers/reportController.js`)
- Reporting → Purchase records: reads purchases (evidence: `server/src/controllers/reportController.js`)
- Reporting → Product records: reads products (evidence: `server/src/controllers/reportController.js`)
- Reporting → Return records: reads returns (evidence: `server/src/controllers/reportController.js`)
- Product management → Product records: manages products (evidence: `server/src/controllers/productController.js`)
- Product management → Audit logging: logs changes (evidence: `server/src/controllers/productController.js`)
