How sensational03/retail_inventory works
Richfield Fertilisers is a multi-agent pricing, inventory, and procurement system with a React dashboard and FastAPI backend. The primary workflow is to trigger pricing optimization, audit stock and log reorder recommendations, then process pending reorders into purchase orders; users can also inspect product, inventory, supplier, and price-history data and adjust configuration. The README documents the handoff and shared in-memory state. Source excerpts show representative agent logic and UI/API calls, but not every endpoint or agent execution detail.
Main entry points: api.py REST and SSE API · pricing_agent.py Pricing agent · inventory_agent.py Inventory agent · supplier_agent.py Supplier agent
Components 9
Dashboard
- React entry
frontend/src/main.tsx - Operations dashboard
frontend/src/PricingAgentUI.tsx
API
- REST and SSE API
backend/api.py
Operations agents
- Pricing agent
backend/pricing_agent.py - Inventory agent
backend/inventory_agent.py - Supplier agent
backend/supplier_agent.py
Runtime state
- Shared in-memory state
backend
Other components
- Dashboard user
- Groq LLM service
Connections 12
- Dashboard user → React entry: opens dashboard
README.md - React entry → Operations dashboard: renders
- Operations dashboard → REST and SSE API: REST and SSE
README.md - REST and SSE API → Pricing agent: runs optimization
README.md - REST and SSE API → Inventory agent: runs audit
README.md - REST and SSE API → Supplier agent: runs procurement
README.md - Pricing agent → Shared in-memory state: reads and updates
README.md - Inventory agent → Shared in-memory state: reads and logs reorders
README.md - Supplier agent → Shared in-memory state: reads reorders; logs POs
README.md - Pricing agent → Groq LLM service: suggests config
README.md - Inventory agent → Groq LLM service: suggests config
README.md - Supplier agent → Groq LLM service: suggests strategy
README.md