How kainaat-fida/localagent-crm-draft1 works
LocalAgent CRM is a web-based sales and support automation platform. A customer submits an inquiry through the dashboard or API; the backend runs it through safety, intake, knowledge retrieval, lead qualification, response drafting, and supervisor routing, with sensitive actions held for human approval. The dashboard also supports lead and conversation management, knowledge ingestion/search, approvals, and reports. The README documents the agent sequence and capabilities; sampled source and the source index support the API, workflow, persistence, and retrieval links shown here. Some API and workflow implementations were not sampled, so their internal links are documented rather than source-verified.
Main entry points: api.js API client · nodes.py Workflow nodes · main.py FastAPI application · knowledge.py Knowledge endpoints
Components 34
CRM Dashboard
- Dashboard and simulator
frontend/src/App.jsx - API client
frontend/src/services/api.js - Approval review
frontend/src/pages/Approvals.jsx - Lead management
frontend/src/pages/Leads.jsx - Conversations
frontend/src/pages/Conversations.jsx - Knowledge workspace
frontend/src/pages/KnowledgeBase.jsx - Reports
frontend/src/pages/Reports.jsx
Backend API
- FastAPI application
backend/app/main.py - Inquiry endpoint
backend/app/api/inquiries.py - Lead endpoints
backend/app/api/leads.py - Conversation endpoints
backend/app/api/conversations.py - Approval endpoints
backend/app/api/approvals.py - Knowledge endpoints
backend/app/api/knowledge.py - Report endpoints
backend/app/api/reports.py
Inquiry Workflow
- LangGraph workflow
backend/app/graph/workflow.py - Workflow nodes
backend/app/graph/nodes.py - Safety agent
backend/app/agents/safety_agent.py - Intake agent
backend/app/agents/intake_agent.py - Knowledge agent
backend/app/agents/knowledge_agent.py - Qualification agent
backend/app/agents/qualification_agent.py - Response agent
backend/app/agents/response_agent.py - Supervisor agent
backend/app/agents/supervisor_agent.py - Approval rules
backend/app/policies/approval_rules.py - Lead scoring policy
backend/app/policies/lead_scoring.py
Knowledge Retrieval
- Document loading
backend/app/rag/document_loader.py - Text chunking
backend/app/rag/chunker.py - Embedding generation
backend/app/rag/embeddings.py - Semantic retrieval
backend/app/rag/retriever.py - Vector index
backend/app/rag/qdrant_client.py
Persistence and Services
- Groq inference
backend/app/core/groq_client.py - CRUD repositories
backend/app/db/repositories.py - CRM data models
backend/app/db/models.py - SQL database
backend/app/db/database.py
Other components
- Customer or operator
Connections 48
- Customer or operator → Dashboard and simulator: submits inquiry
README.md - Dashboard and simulator → API client: calls
frontend/src/App.jsx - API client → Inquiry endpoint: submits inquiry
frontend/src/services/api.js - API client → Lead endpoints: requests leads
frontend/src/services/api.js - API client → Conversation endpoints: requests messages
frontend/src/services/api.js - API client → Approval endpoints: requests decisions
frontend/src/services/api.js - API client → Knowledge endpoints: manages knowledge
frontend/src/services/api.js - API client → Report endpoints: requests summary
frontend/src/services/api.js - Approval review → API client: uses
frontend/src/pages/Approvals.jsx - Lead management → API client: uses
frontend/src/pages/Leads.jsx - Conversations → API client: uses
frontend/src/pages/Conversations.jsx - Knowledge workspace → API client: uses
frontend/src/pages/KnowledgeBase.jsx - Reports → API client: uses
frontend/src/pages/Reports.jsx - FastAPI application → Inquiry endpoint: registers route
backend/app/main.py - FastAPI application → Lead endpoints: registers route
backend/app/main.py - FastAPI application → Conversation endpoints: registers route
backend/app/main.py - FastAPI application → Approval endpoints: registers route
backend/app/main.py - FastAPI application → Knowledge endpoints: registers route
backend/app/main.py - FastAPI application → Report endpoints: registers route
backend/app/main.py - Inquiry endpoint → LangGraph workflow: runs workflow
- LangGraph workflow → Workflow nodes: dispatches nodes
- Workflow nodes → Safety agent: executes
backend/app/graph/nodes.py - Workflow nodes → Intake agent: executes
backend/app/graph/nodes.py - Workflow nodes → Knowledge agent: executes
backend/app/graph/nodes.py - Workflow nodes → Qualification agent: executes
backend/app/graph/nodes.py - Workflow nodes → Response agent: executes
backend/app/graph/nodes.py - Workflow nodes → Supervisor agent: executes
backend/app/graph/nodes.py - Safety agent → Intake agent: passes safe inquiry
README.md - Intake agent → Knowledge agent: passes context
README.md - Knowledge agent → Qualification agent: passes findings
README.md - Qualification agent → Response agent: passes lead context
README.md - Response agent → Supervisor agent: passes draft
README.md - Safety agent → Approval rules: checks actions
backend/app/agents/safety_agent.py - Response agent → Approval rules: checks draft
backend/app/agents/response_agent.py - Qualification agent → Lead scoring policy: scores lead
backend/app/agents/qualification_agent.py - Knowledge agent → Semantic retrieval: retrieves context
backend/app/agents/knowledge_agent.py - Semantic retrieval → Embedding generation: embeds query
backend/app/rag/retriever.py - Semantic retrieval → Vector index: searches vectors
backend/app/rag/retriever.py - Knowledge endpoints → Document loading: loads uploads
backend/app/api/knowledge.py - Knowledge endpoints → Text chunking: chunks documents
backend/app/api/knowledge.py - Knowledge endpoints → Embedding generation: embeds chunks
backend/app/api/knowledge.py - Knowledge endpoints → Vector index: indexes chunks
backend/app/api/knowledge.py - Intake agent → Groq inference: requests inference
backend/app/agents/intake_agent.py - Response agent → Groq inference: requests inference
backend/app/agents/response_agent.py - Workflow nodes → CRUD repositories: persists workflow
backend/app/graph/nodes.py - CRUD repositories → CRM data models: queries entities
backend/app/db/repositories.py - Conversation endpoints → CRUD repositories: uses persistence
backend/app/api/conversations.py - Approval endpoints → CRUD repositories: uses persistence
backend/app/api/approvals.py