How aarthireddyyy/rto-guardian works
RTO Guardian is a pre-shipment COD risk-intervention system: an order is scored, routed to automatic approval or customer contact, then resolved or rescored into a final decision. The principal workflow is documented in the README and visible in the API and orchestrator excerpts. Chat and voice are separate interaction paths; voice additionally uses speech services and Groq parsing. The README also describes the ML training and explainability capabilities. Some subsystem paths and integrations are documented but their implementation was not sampled; those relationships cite the README or are omitted where evidence is insufficient.
Main entry points: main.py FastAPI · orchestrator.py Risk Router · whatsapp.py Chat Conversation · rescore.py Outcome Rescoring
Components 22
Customer Demo
- Demo UI
app.js
API Workflow
- FastAPI
backend/app/main.py - Order Contracts
backend/app/models/schemas.py - Order State Store
backend/app/main.py - Risk Router
backend/app/agents/orchestrator.py
Risk Engine
- Auto Approval
backend/app/agents/auto_approve.py - ML Risk Scoring
backend/app/main.py - Trained Model
backend/ml/models/rto_risk_model.pkl - Model Training
backend/ml/train.py - Synthetic Data
backend/ml/data_generator.py - Outcome Rescoring
backend/app/agents/rescore.py
Customer Intervention
- Chat Conversation
backend/app/agents/whatsapp.py - Chat Messages
backend/app/agents/message_generator.py - Chat WebSocket
backend/app/websockets/chat_handler.py - Voice WebSocket
backend/app/websockets/voice_ws_handler.py - Voice Conversation
backend/app/agents/voice_agent.py - Voice Workflow Prompt
backend/app/agents/voice.py - Intent And Landmark Parsing
backend/app/agents/groq_parser.py
External AI Services
- Speech Services
backend/app/services/sarvam_service.py - Groq LLM
- Sarvam AI
Other components
- Customer
Connections 26
- Customer → Demo UI: uses
README.md - Demo UI → FastAPI: submits order
README.md - FastAPI → Order Contracts: validates
backend/app/main.py - FastAPI → Risk Router: runs workflow
backend/app/main.py - FastAPI → Order State Store: stores state
backend/app/main.py - FastAPI → Outcome Rescoring: rescoring reply
backend/app/main.py - FastAPI → Chat WebSocket: registers route
backend/app/main.py - FastAPI → Voice WebSocket: registers route
backend/app/main.py - Risk Router → ML Risk Scoring: requests score
backend/app/agents/orchestrator.py - ML Risk Scoring → Trained Model: scores with
README.md - Risk Router → Auto Approval: routes low risk
backend/app/agents/orchestrator.py - Risk Router → Chat Conversation: routes medium risk
backend/app/agents/orchestrator.py - Risk Router → Voice Workflow Prompt: routes high risk
backend/app/agents/orchestrator.py - Risk Router → Outcome Rescoring: routes after contact
backend/app/agents/orchestrator.py - Chat Conversation → Outcome Rescoring: returns outcomes
backend/app/agents/orchestrator.py - Voice Workflow Prompt → Outcome Rescoring: returns outcomes
backend/app/agents/orchestrator.py - Chat WebSocket → Chat Conversation: handles conversation
backend/app/websockets/chat_handler.py - Chat WebSocket → Chat Messages: generates messages
backend/app/websockets/chat_handler.py - Chat Conversation → Chat Messages: generates nudge
backend/app/agents/whatsapp.py - Voice WebSocket → Voice Conversation: handles conversation
backend/app/websockets/voice_ws_handler.py - Voice Conversation → Speech Services: uses speech services
backend/app/agents/voice_agent.py - Voice Conversation → Intent And Landmark Parsing: parses replies
backend/app/agents/voice_agent.py - Intent And Landmark Parsing → Groq LLM: classifies and extracts
backend/app/agents/groq_parser.py - Speech Services → Sarvam AI: calls speech API
backend/app/services/sarvam_service.py - Model Training → Trained Model: produces model
README.md - Synthetic Data → Model Training: supplies training data
README.md