How yarrowtech/rms-2 works
This is a multi-tenant retail and vendor management system: a React departmental interface calls a FastAPI backend whose route modules implement operations over MongoDB. A representative buying workflow is vendor catalogue discovery, purchase planning and purchase-order handling, then goods receipt and stock management. The repository also exposes production/job-work, finance, analytics, onboarding, subscriptions, and internal collaboration features. The README is only the Vite template; feature identification comes from the tree and sampled source. Unsampled subsystems are included where their paths are clear, but their internal connections are not assumed.
Main entry points: db.py MongoDB collections · main.py FastAPI application · App.jsx Department app · grn_routes.py Goods receipt
Components 25
Web interface
- Department app
src/App.jsx - API configuration
src/config/api.js - Buyer workspace
src/components/Mbuyer/mbuyer.jsx - Vendor workspace
src/components/Merchandiser_Seller/MSeller.jsx - Inventory workspace
src/components/InventoryManagement/InventoryManagement.jsx - Production workspace
src/components/Production/ProductionJobWork.jsx - Finance workspace
src/components/Finance/Finance.jsx - Internal chat
src/components/InternalChatPanel.jsx - Notification bell
src/components/InternalNotificationBell.jsx
API and access
- FastAPI application
rms_backend/app/main.py - Tenant access
rms_backend/app/routes/deps.py
Buying and vendors
- Vendor catalogue
rms_backend/app/routes/catalogue_routes.py - Vendor management
rms_backend/app/routes/vendor_routes.py - Purchase orders
rms_backend/app/routes/purchaseorder_routes.py - Purchase planning
rms_backend/app/routes/mbuyer_routes.py - Procurement notices
rms_backend/app/routes/procurement_notification_routes.py
Stock and production
- Goods receipt
rms_backend/app/routes/grn_routes.py - Product management
rms_backend/app/routes/products.py - Inventory operations
rms_backend/app/routes/inventoryroutes.py - Production and job work
rms_backend/app/routes/job_work_routes.py
Shared services
- MongoDB collections
rms_backend/app/db.py - Product identity
rms_backend/app/product_identity.py - Subscriptions
rms_backend/app/routes/subscription_routes.py - Analytics routes
rms_backend/app/routes/analytics_routes.py
Other components
- Retail staff
Connections 33
- Retail staff → Department app: uses
src/App.jsx - Department app → Buyer workspace: routes to
src/App.jsx - Department app → Vendor workspace: routes to
src/App.jsx - Department app → Inventory workspace: routes to
src/App.jsx - Department app → Production workspace: routes to
src/App.jsx - Department app → Finance workspace: routes to
src/App.jsx - Buyer workspace → API configuration: uses API base
- Vendor workspace → API configuration: uses API base
- Production workspace → API configuration: uses API base
src/components/Production/ProductionJobWork.jsx - FastAPI application → Vendor catalogue: registers routes
rms_backend/app/main.py - FastAPI application → Vendor management: registers routes
rms_backend/app/main.py - FastAPI application → Purchase orders: registers routes
rms_backend/app/main.py - FastAPI application → Procurement notices: registers routes
rms_backend/app/main.py - FastAPI application → Subscriptions: registers routes
rms_backend/app/main.py - FastAPI application → Goods receipt: registers routes
rms_backend/app/main.py - FastAPI application → Tenant access: uses access checks
rms_backend/app/main.py - Vendor catalogue → Vendor management: references vendor routes
rms_backend/app/routes/catalogue_routes.py - Vendor catalogue → MongoDB collections: reads and writes
rms_backend/app/routes/catalogue_routes.py - Vendor management → MongoDB collections: reads and writes
rms_backend/app/routes/vendor_routes.py - Purchase orders → MongoDB collections: reads and writes
rms_backend/app/routes/purchaseorder_routes.py - Purchase orders → Procurement notices: uses notice routes
rms_backend/app/routes/purchaseorder_routes.py - Purchase planning → MongoDB collections: reads purchase data
rms_backend/app/routes/mbuyer_routes.py - Goods receipt → MongoDB collections: reads and writes
rms_backend/app/routes/grn_routes.py - Goods receipt → Product identity: uses identity helpers
rms_backend/app/routes/grn_routes.py - Product management → MongoDB collections: reads and writes
rms_backend/app/routes/products.py - Product management → Goods receipt: uses receipt logic
rms_backend/app/routes/products.py - Inventory operations → MongoDB collections: reads and writes
rms_backend/app/routes/inventoryroutes.py - Inventory operations → Product identity: uses identity helpers
rms_backend/app/routes/inventoryroutes.py - Production and job work → MongoDB collections: reads stock
rms_backend/app/routes/job_work_routes.py - Production and job work → Purchase orders: references purchasing
rms_backend/app/routes/job_work_routes.py - Production and job work → Goods receipt: references receipt workflow
rms_backend/app/routes/job_work_routes.py - Subscriptions → MongoDB collections: reads and writes
rms_backend/app/routes/subscription_routes.py - Analytics routes → MongoDB collections: reads data