How shrivishal007/inventory-management works
This is a rice sales and fulfillment application: salespeople register or sign in, request quotes, place/manage orders, and retrieve invoices; owners review quotes, manage stock, and inspect orders and salespeople. The React client uses a shared authenticated API client, while Express routes dispatch requests through controllers to domain services backed by a database pool. Vehicle allocation and invoice retrieval are distinct fulfillment stages. Some service internals and the database implementation were not sampled, so their finer relationships are omitted.
Main entry points: salesperson.js Sales controller · App.jsx App routes · app.js Express app · api.js API client
Components 26
Web client
- App routes
Frontend/src/App.jsx - Homepage
Frontend/src/Homepage.jsx - Owner pages
Frontend/src/pages/owner - Salesperson pages
Frontend/src/pages/salesperson - Invoice download
Frontend/src/pages/salesperson/InvoiceDownload.jsx - API client
Frontend/src/api.js - Browser auth
Frontend/src/auth.js
API and access
- Express app
Backend/src/app.js - Salesperson routes
Backend/src/routes/userRoutes.js - Admin routes
Backend/src/routes/adminRoutes.js - Rice route
Backend/src/routes/riceRoute.js - Role auth
Backend/src/middleware/auth.js - Database pool
Backend/src/config/db.js
Sales workflow
- Sales controller
Backend/src/controllers/salesperson.js - Salesperson access
Backend/src/services/user/authenticateUser.js - Registration
Backend/src/services/user/registerUser.js - Sales dashboard data
Backend/src/services/user/userDetails.js - Quote requests
Backend/src/services/user/quoteLogic.js - Order processing
Backend/src/services/user/processOrder.js
Owner operations
- Owner controller
Backend/src/controllers/admin.js - Owner operations
Backend/src/services/admin - Rice details
Backend/src/services/riceDetails.js
Fulfillment
- Vehicle allocation
Backend/src/services/user/allocateVehicle.js - Invoice data
Backend/src/services/user/fetchInvoice.js
Other components
- Salesperson
- Owner
Connections 29
- Salesperson → App routes: uses
Frontend/src/App.jsx - Owner → App routes: uses
Frontend/src/App.jsx - App routes → Homepage: routes to
Frontend/src/App.jsx - App routes → Owner pages: routes to
Frontend/src/App.jsx - App routes → Salesperson pages: routes to
Frontend/src/App.jsx - Salesperson pages → Invoice download: uses
Frontend/src/pages/salesperson/SalespersonOrders.jsx - Owner pages → API client: requests through
Frontend/src/pages/owner/OwnerDashboard.jsx - Salesperson pages → API client: requests through
Frontend/src/pages/salesperson/SalespersonDashboard.jsx - API client → Browser auth: reads tokens
Frontend/src/api.js - API client → Express app: sends API requests
- Express app → Salesperson routes: mounts
Backend/src/app.js - Express app → Admin routes: mounts
Backend/src/app.js - Express app → Rice route: mounts
Backend/src/app.js - Salesperson routes → Sales controller: dispatches
Backend/src/routes/userRoutes.js - Admin routes → Owner controller: dispatches
Backend/src/routes/adminRoutes.js - Salesperson routes → Role auth: guards routes
Backend/src/routes/userRoutes.js - Admin routes → Role auth: guards routes
Backend/src/routes/adminRoutes.js - Sales controller → Database pool: passes pool
Backend/src/controllers/salesperson.js - Sales controller → Salesperson access: authenticates
Backend/src/controllers/salesperson.js - Sales controller → Registration: registers
Backend/src/controllers/salesperson.js - Sales controller → Sales dashboard data: loads dashboard
Backend/src/controllers/salesperson.js - Sales controller → Quote requests: creates quote
Backend/src/controllers/salesperson.js - Sales controller → Order processing: processes order
Backend/src/controllers/salesperson.js - Sales controller → Vehicle allocation: allocates vehicle
Backend/src/controllers/salesperson.js - Sales controller → Invoice data: fetches invoice
Backend/src/controllers/salesperson.js - Owner controller → Database pool: passes pool
Backend/src/controllers/admin.js - Owner controller → Owner operations: dispatches operations
Backend/src/controllers/admin.js - Rice route → Rice details: routes to
Backend/src/routes/riceRoute.js - Role auth → Salesperson access: verifies token