How mdraihan2010/inventory-management-system works
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: api.ts API client · page.tsx Dashboard navigation · sales-page.tsx Sales screen · server.js Express API
Components 34
Web application
- Dashboard navigation
app/page.tsx - Catalog screens
components/catalog-page.tsx - Products screen
components/products-page.tsx - Inventory screen
components/inventory-page.tsx - Sales screen
components/sales-page.tsx - Product picker
components/product-picker.tsx - Sales helpers
components/sales-shared.ts - Purchases screen
components/purchases-page.tsx - Purchase helpers
components/purchases-shared.ts - Customers screen
components/customers-page.tsx - Suppliers screen
components/suppliers-page.tsx - Payments and dues
components/payments-page.tsx - Returns screen
components/returns-page.tsx - Reports screen
components/reports-page.tsx - Users and audit
components/users-page.tsx - CSV utilities
lib/csv.ts - Money formatting
lib/money.ts
Business operations
- Sales and payment logic
server/src/controllers/saleController.js - Purchasing and supplier payments
server/src/controllers/purchaseController.js - Stock management
server/src/controllers/inventoryController.js - Customer and supplier returns
server/src/controllers/returnController.js - Reporting
server/src/controllers/reportController.js - Product management
server/src/controllers/productController.js
API and access
- API client
lib/api.ts - Express API
server/src/server.js - Authentication and roles
server/src/middleware/authMiddleware.js
Persistence and records
- Sales records
server/src/models/Sale.js - Purchase records
server/src/models/Purchase.js - Product records
server/src/models/Product.js - Stock movements
server/src/models/StockMovement.js - Return records
server/src/models/Return.js - Payment records
server/src/models/Payment.js - Audit logging
server/src/utils/auditLogger.js
Other components
- Staff or manager
Connections 39
- Staff or manager → Dashboard navigation: opens app
README.md - Dashboard navigation → Products screen: renders
app/page.tsx - Dashboard navigation → Sales screen: renders
app/page.tsx - Dashboard navigation → Purchases screen: renders
app/page.tsx - Dashboard navigation → Inventory screen: renders
app/page.tsx - Dashboard navigation → Catalog screens: renders
app/page.tsx - Sales screen → Product picker: uses
components/sales-page.tsx - Purchases screen → Product picker: uses
components/purchases-page.tsx - Sales screen → API client: requests data
components/sales-page.tsx - Products screen → API client: requests data
components/products-page.tsx - Purchases screen → API client: requests data
components/purchases-page.tsx - Customers screen → API client: requests data
- Suppliers screen → API client: requests data
components/suppliers-page.tsx - Payments and dues → API client: requests data
components/payments-page.tsx - Sales screen → Sales helpers: uses
components/sales-page.tsx - Payments and dues → Purchase helpers: uses
components/payments-page.tsx - Sales screen → CSV utilities: exports CSV
components/sales-page.tsx - Sales screen → Money formatting: formats amounts
components/sales-page.tsx - API client → Express API: sends requests
- Express API → Sales and payment logic: routes sales
server/src/server.js - Express API → Purchasing and supplier payments: routes purchases
server/src/server.js - Express API → Reporting: routes reports
server/src/server.js - Express API → Product management: routes products
server/src/server.js - Express API → Authentication and roles: uses access checks
- Sales and payment logic → Sales records: reads and writes
server/src/controllers/saleController.js - Sales and payment logic → Product records: reads products
server/src/controllers/saleController.js - Sales and payment logic → Stock movements: records stock
server/src/controllers/saleController.js - Sales and payment logic → Payment records: creates payments
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
server/src/controllers/returnController.js - Customer and supplier returns → Product records: updates stock
server/src/controllers/returnController.js - Customer and supplier returns → Stock movements: records movement
server/src/controllers/returnController.js - Reporting → Sales records: reads sales
server/src/controllers/reportController.js - Reporting → Purchase records: reads purchases
server/src/controllers/reportController.js - Reporting → Product records: reads products
server/src/controllers/reportController.js - Reporting → Return records: reads returns
server/src/controllers/reportController.js - Product management → Product records: manages products
server/src/controllers/productController.js - Product management → Audit logging: logs changes
server/src/controllers/productController.js