How princeverma73/resolvex works
ResolveX is an AI customer-support and ticket-automation platform. A customer sends a message through the web client or API; the API invokes the LangGraph orchestrator, which routes the inquiry to policy, order/payment, action, diagnostics, or escalation handling, then returns a response. The documented policy workflow uses retrieval and reranking to ground answers; other major capabilities include WebSocket streaming, session history, caching, guardrails, and domain-service persistence. The README documents capabilities and some integrations; source-index references and excerpts support the cited implementation links, but unsampled modules are not treated as inspected.
Main entry points: nodes.py Specialist nodes · graph.py Graph orchestrator · supabase_client.py Supabase database · routes.py REST routes
Components 25
Customer interface
- Chat client
frontend/script.js
API gateway
- FastAPI app
Backend/main.py - REST routes
Backend/api/routes.py - WebSocket chat
Backend/api/websocket.py - Response cache
Backend/services/redis_cache.py
Agent orchestration
- Graph orchestrator
Backend/agent/graph.py - Intent router
Backend/agent/router.py - Specialist nodes
Backend/agent/nodes.py - Conversation state
Backend/agent/state.py - Diagnostics agent
Backend/agent/technical_support.py - Input guardrails
Backend/core/guardrails.py
Policy knowledge
- Policy chunking
Backend/rag/chunking.py - Vector ingestion
Backend/rag/ingestion.py - Hybrid retrieval
Backend/rag/retrieval.py - RRF reranking
Backend/rag/reranking.py - Answer generation
Backend/rag/generation.py - Qdrant vectors
Backend/db/qdrant_client.py
Support domain
- Supabase database
Backend/db/supabase_client.py - Order service
Backend/services/order_service.py - Payment service
Backend/services/payment_service.py - Customer service
Backend/services/customer_service.py - Ticket service
Backend/services/ticket_service.py - Chat history
Backend/services/chat_service.py - Domain schemas
Backend/schemas/common.py
Other components
- Customer
Connections 35
- Customer → Chat client: sends inquiry
- Chat client → WebSocket chat: streams chat
- Chat client → REST routes: calls REST
- FastAPI app → REST routes: registers routes
Backend/main.py - FastAPI app → WebSocket chat: registers route
Backend/main.py - REST routes → Graph orchestrator: invokes graph
Backend/api/routes.py - WebSocket chat → Graph orchestrator: invokes graph
Backend/api/websocket.py - REST routes → Response cache: checks cache
Backend/api/routes.py - WebSocket chat → Response cache: uses cache
Backend/api/websocket.py - REST routes → Chat history: logs messages
Backend/api/routes.py - Graph orchestrator → Intent router: classifies intent
Backend/agent/graph.py - Graph orchestrator → Specialist nodes: dispatches work
Backend/agent/graph.py - Graph orchestrator → Conversation state: maintains state
Backend/agent/graph.py - Graph orchestrator → Diagnostics agent: dispatches diagnostics
Backend/agent/graph.py - Graph orchestrator → Input guardrails: applies checks
Backend/agent/graph.py - Specialist nodes → Hybrid retrieval: retrieves policy
Backend/agent/nodes.py - Specialist nodes → RRF reranking: ranks evidence
Backend/agent/nodes.py - Specialist nodes → Answer generation: generates answer
Backend/agent/nodes.py - Diagnostics agent → Hybrid retrieval: uses knowledge
Backend/agent/technical_support.py - Diagnostics agent → Answer generation: generates guidance
Backend/agent/technical_support.py - Hybrid retrieval → Qdrant vectors: searches vectors
Backend/rag/retrieval.py - Hybrid retrieval → Supabase database: queries embeddings
Backend/rag/retrieval.py - RRF reranking → Hybrid retrieval: ranks candidates
Backend/rag/reranking.py - Policy chunking → Vector ingestion: provides chunks
Backend/rag/ingest.py - Vector ingestion → Supabase database: persists vectors
Backend/rag/ingestion.py - Specialist nodes → Order service: looks up orders
Backend/agent/nodes.py - Specialist nodes → Payment service: looks up payments
Backend/agent/nodes.py - Specialist nodes → Customer service: looks up customers
Backend/agent/nodes.py - Specialist nodes → Ticket service: creates tickets
Backend/agent/nodes.py - Order service → Supabase database: reads and updates
Backend/services/order_service.py - Payment service → Supabase database: persists records
- Customer service → Supabase database: persists records
- Ticket service → Supabase database: creates and updates
Backend/services/ticket_service.py - Chat history → Supabase database: stores history
- Specialist nodes → Domain schemas: validates payloads
Backend/agent/nodes.py