How codexanuj012/retail-inventory-management-system works
This repository is a Retail Inventory Management System (RIMS): a Node/Express backend with a MySQL connection and a React frontend. The intended domain surface includes authentication, products, inventory, orders, reporting, and supporting catalog, supplier, warehouse, and user management. The sampled frontend currently renders an initialization message; the sampled backend app exposes health checks and error handling, but does not show domain routes being mounted. Dashed links indicate inferred, unverified domain-layer relationships; no domain-flow links are claimed as observed.
Main entry points: app.js Express app · server.js Server startup · db.js MySQL pool · errorMiddleware.js Error middleware
Components 30
Backend runtime
- Server startup
backend/server.js - Express app
backend/app.js - Environment config
backend/config/env.js - MySQL pool
backend/config/db.js - Logger
backend/config/logger.js - Error middleware
backend/middleware/errorMiddleware.js - Response helpers
backend/utils/response.js
Retail operations
- Product management
backend/controllers/productController.js - Product routes
backend/routes/productRoutes.js - Product services
backend/services/productService.js - Inventory management
backend/controllers/inventoryController.js - Inventory routes
backend/routes/inventoryRoutes.js - Inventory services
backend/services/inventoryService.js - Order management
backend/controllers/orderController.js - Order routes
backend/routes/orderRoutes.js - Order services
backend/services/orderService.js - Domain models
backend/models
Administration
- Authentication
backend/controllers/authController.js - Auth routes
backend/routes/authRoutes.js - Reporting
backend/controllers/reportController.js - Report routes
backend/routes/reportRoutes.js - Report services
backend/services/reportService.js - Catalog and access
backend/controllers - Supporting routes
backend/routes
Frontend
- React entry
frontend/src/main.jsx - Frontend app
frontend/src/App.jsx - Application pages
frontend/src/pages - API client
frontend/src/services/api.js
Other components
- User
- Browser user
Connections 29
- Server startup → Express app: starts
backend/server.js - Server startup → MySQL pool: tests connection
backend/server.js - Server startup → Environment config: reads config
backend/server.js - Server startup → Logger: logs events
backend/server.js - Express app → Environment config: reads config
backend/app.js - Express app → Error middleware: registers handlers
backend/app.js - Express app → Response helpers: uses
backend/app.js - Error middleware → Logger: logs errors
backend/middleware/errorMiddleware.js - Error middleware → Response helpers: formats errors
backend/middleware/errorMiddleware.js - MySQL pool → Environment config: reads settings
backend/config/db.js - MySQL pool → Logger: logs connection
backend/config/db.js - Browser user → React entry: opens
- React entry → Frontend app: renders
frontend/src/main.jsx - User → Auth routes: authenticates
- Auth routes → Authentication: dispatches to
- Product routes → Product management: dispatches to
- Product management → Product services: uses
- Inventory routes → Inventory management: dispatches to
- Inventory management → Inventory services: uses
- Order routes → Order management: dispatches to
- Order management → Order services: uses
- Report routes → Reporting: dispatches to
- Reporting → Report services: uses
- Supporting routes → Catalog and access: dispatches to
- Application pages → API client: requests data
- API client → Express app: calls API
- Product services → Domain models: uses
- Inventory services → Domain models: uses
- Order services → Domain models: uses