How agastya-nath123/csl559_csd_group_project works
Dark Store Prototype is a modular-monolith quick-commerce backend with customer, picker, and store-ops screens. The main workflow is location-based store selection and availability, an all-or-nothing inventory hold at checkout, then order picking, packing, and rider handoff; inbound receiving and replenishment restore stock. Forecasting, assortment, slotting, network planning, and operational dashboards are additional product capabilities. The README and source index document these boundaries and several cross-module calls; unsampled implementation details are not inferred.
Main entry points: inventory/service.py Inventory Service · main.py FastAPI Application · assortment/service.py Assortment · background.py Scheduled Jobs
Components 21
Experience and API
- Demo Screens
web/app.js - FastAPI Application
app/main.py
Store and Inventory
- Assortment
app/modules/assortment/service.py - Inventory API
app/modules/inventory/router.py - Inventory Service
app/modules/inventory/service.py - Serviceability
app/modules/serviceability/service.py - Inbound Receiving
app/modules/inbound/service.py
Order Fulfilment
- Fulfilment
app/modules/fulfilment/service.py - Pick and Pack
app/modules/pickpack/service.py - Rider Handoff
app/modules/fulfilment/riders.py
Planning and Replenishment
- Demand Forecasting
app/modules/forecasting/service.py - Replenishment
app/modules/replenishment/service.py - Bin Slotting
app/modules/slotting/service.py - Network Planning
app/modules/network_planning/service.py - Ops Dashboard
app/modules/dashboard/service.py
Shared Platform
- Relational Database
app/db.py - Event Bus
app/events.py - Scheduled Jobs
app/background.py - Staff Authentication
app/auth.py - Domain Models
app/models.py
Other components
- Customer and Staff
Connections 31
- Customer and Staff → Demo Screens: uses
- Demo Screens → FastAPI Application: requests
- FastAPI Application → Assortment: routes to
app/main.py - FastAPI Application → Inventory API: routes to
app/main.py - FastAPI Application → Staff Authentication: registers
app/main.py - FastAPI Application → Scheduled Jobs: starts
app/main.py - FastAPI Application → Event Bus: starts relay
app/main.py - Assortment → Inventory Service: checks stock
app/modules/assortment/service.py - Assortment → Demand Forecasting: uses forecasts
app/modules/assortment/service.py - Assortment → Replenishment: uses reorder data
app/modules/assortment/service.py - Inventory API → Inventory Service: calls
app/modules/inventory/router.py - Inbound Receiving → Inventory Service: records receipts
app/modules/inbound/service.py - Inbound Receiving → Bin Slotting: requests placement
app/modules/inbound/service.py - Fulfilment → Inventory Service: updates stock
app/modules/fulfilment/service.py - Pick and Pack → Fulfilment: updates jobs
app/modules/pickpack/service.py - Pick and Pack → Inventory Service: adjusts stock
app/modules/pickpack/service.py - Pick and Pack → Rider Handoff: uses handoff
- Replenishment → Demand Forecasting: reads forecasts
app/modules/replenishment/service.py - Replenishment → Inventory Service: reads stock
app/modules/replenishment/service.py - Demand Forecasting → Inventory Service: reads stock history
app/modules/forecasting/service.py - Bin Slotting → Demand Forecasting: uses demand
app/modules/slotting/service.py - Bin Slotting → Inventory Service: reads stock
app/modules/slotting/service.py - Network Planning → Serviceability: uses coverage
app/modules/network_planning/service.py - Ops Dashboard → Inventory Service: reads stock
app/modules/dashboard/service.py - Ops Dashboard → Serviceability: reads coverage
app/modules/dashboard/service.py - Ops Dashboard → Event Bus: uses event feed
app/modules/dashboard/service.py - Scheduled Jobs → Inventory Service: sweeps holds
app/background.py - Scheduled Jobs → Fulfilment: sweeps jobs
app/background.py - Scheduled Jobs → Replenishment: runs reorder
app/background.py - Inventory Service → Event Bus: publishes events
app/modules/inventory/service.py - Relational Database → Domain Models: stores
app/db.py