How chinmayeeparida/retail-multi-agent works
This is a retail replenishment operations system: store requests are reviewed into a packing list, warehouse staff label and pack goods, a trip is approved and dispatched, stores record receipts, and a manager receives a trip report. Separate branches cover dashboard visibility, new-product approval, and distributing new-item stock. The README documents the main workflow; source-index references support several internal calls, but unsampled modules are not treated as inspected.
Main entry points: agent1_packing.py Packing Agent · agent3_report.py Report Agent · agent2_trip.py Trip Agent · schema.sql SQLite Database
Components 24
Store Operations
- Stock Request App
stock_request_app.py - Replenishment App
store_app.py - Store Receiving
store_receiving.py
Warehouse Logistics
- Packaging App
packing_app.py - Warehouse View
warehouse_view.py
Agents and Controls
- Packing Agent
agent1_packing.py - Stock Allocation
allocation.py - Trip Agent
agent2_trip.py - Report Agent
agent3_report.py - New Product Agent
agent4_new_product.py - Guardrails
guardrails.py - Warehouse Alerts
alerts.py - New Stock Distribution
distribute_new_stock.py - Weekly Pipeline
pipeline.py
Dashboard and Data
- Control Room
app.py - Screen Logic
screen_logic.py - Shared UI Theme
ui_theme.py - SQLite Database
schema.sql
Other components
- Store Staff
- Warehouse Staff
- Vendor
- Operations Head
- Email / Outbox
- Gemini AI
Connections 36
- Store Staff → Stock Request App: submits requests
README.md - Stock Request App → Packing Agent: creates requests for
README.md - Packing Agent → Stock Allocation: allocates stock
agent1_packing.py - Packing Agent → Guardrails: checks rules
agent1_packing.py - Packing Agent → SQLite Database: saves packing decisions
README.md - Packing Agent → Warehouse Staff: requests barcode labels
README.md - Warehouse Staff → Packaging App: records packing
README.md - Packaging App → Trip Agent: provides packed stock
README.md - Trip Agent → Guardrails: checks rules
agent2_trip.py - Trip Agent → SQLite Database: records trip and stock
README.md - Trip Agent → Replenishment App: dispatches deliveries to
README.md - Store Staff → Replenishment App: checks deliveries
README.md - Replenishment App → Store Receiving: records receipt
README.md - Store Receiving → SQLite Database: saves receipt
store_receiving.py - Store Receiving → Warehouse Alerts: raises alerts
store_receiving.py - Store Receiving → Report Agent: completes trip data for
README.md - Report Agent → SQLite Database: reads and saves report data
README.md - Report Agent → Gemini AI: drafts summary with
README.md - Report Agent → Email / Outbox: sends report
agent3_report.py - Report Agent → Operations Head: reports to
README.md - Vendor → New Product Agent: supplies product details
README.md - New Product Agent → SQLite Database: saves approved product
README.md - New Product Agent → Store Staff: enables product requests
README.md - New Stock Distribution → Stock Allocation: uses stock rules
distribute_new_stock.py - Warehouse Staff → Warehouse View: reviews alerts and work
README.md - Warehouse View → Warehouse Alerts: shows alerts
warehouse_view.py - Control Room → Screen Logic: uses screen logic
app.py - Control Room → Shared UI Theme: applies shared styling
app.py - Screen Logic → SQLite Database: reads operational data
screen_logic.py - Screen Logic → Packing Agent: invokes packing workflow
screen_logic.py - Screen Logic → Trip Agent: invokes trip workflow
screen_logic.py - Screen Logic → New Product Agent: invokes product workflow
screen_logic.py - Weekly Pipeline → Packing Agent: runs weekly step
pipeline.py - Weekly Pipeline → Trip Agent: runs daily trips
pipeline.py - Weekly Pipeline → Report Agent: runs trip reports
pipeline.py - Weekly Pipeline → Store Receiving: runs store check
pipeline.py