# kathirvbk/sales-operation architecture

> Architecture diagram of the GitHub repository kathirvbk/sales-operation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kathirvbk/sales-operation
- Repository: https://github.com/kathirvbk/sales-operation

## Overview

Lead-to-Delivery AI Agent is a chat-driven sales and operations application. A user message reaches the FastAPI chat endpoint, where the main workflow classifies intent and dispatches lead qualification or deal, status, and task handling. Sales qualification extracts and scores lead data, then stores it; a won deal can lead to onboarding tasks and later status or task updates. The React dashboard also exposes lead, deal, and task views. The README documents the frontend/backend and Groq setup; unsampled route and UI details are represented only where indexed or documented.

Main entry points: [`backend/app/main.py`](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/main.py) (FastAPI endpoints), [`frontend/src/App.jsx`](https://github.com/kathirvbk/sales-operation/blob/main/frontend/src/App.jsx) (Dashboard app), [`backend/app/agents/operations_agent.py`](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/agents/operations_agent.py) (Operations agent), [`backend/app/database/database.py`](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/database/database.py) (SQLite database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React dashboard"]
  node_react_app["Dashboard app<br/>[App.jsx]"]
  node_chat_ui["Chat panel<br/>[ChatPanel.jsx]"]
  node_leads_ui["Leads board<br/>[LeadsBoard.jsx]"]
  node_deals_ui["Deals board<br/>[DealsBoard.jsx]"]
  node_tasks_ui["Tasks board<br/>[TasksBoard.jsx]"]
  node_trace_ui["Execution trace<br/>[ExecutionTrace.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["API and routing"]
  node_fastapi["FastAPI endpoints<br/>[main.py]"]
  node_schemas["Request schemas<br/>[schemas.py]"]
  node_intent_router["Intent classifier<br/>[router.py]"]
end

subgraph group_workflow["Agent workflows"]
  node_main_flow["Main workflow<br/>[main_graph.py]"]
  node_sales_flow["Sales workflow<br/>[sales_workflow.py]"]
  node_ops_flow["Operations workflow"]
end

subgraph group_domain["Sales and operations"]
  node_sales_agent["Sales agent<br/>[sales_agent.py]"]
  node_ops_agent["Operations agent"]
  node_scoring["Lead scoring<br/>[scoring_tools.py]"]
  node_lead_tools["Lead records<br/>[lead_tools.py]"]
  node_deal_tools["Deal records<br/>[deal_tools.py]"]
  node_task_tools["Onboarding tasks<br/>[task_tools.py]"]
  node_status_tools["Status queries<br/>[status_tools.py]"]
  node_chat_tools["Chat history<br/>[chat_tools.py]"]
  node_llm["LLM service<br/>[llm_service.py]"]
  node_execution["Execution trace service"]
end

subgraph group_storage["Persistence"]
  node_sqlite[("SQLite database<br/>[database.py]")]
end

node_user(("User"))
node_groq["Groq LLM"]

node_user -->|"uses"| node_react_app
node_react_app -->|"renders"| node_chat_ui
node_react_app -->|"renders"| node_leads_ui
node_react_app -->|"renders"| node_deals_ui
node_react_app -->|"renders"| node_tasks_ui
node_chat_ui -->|"requests"| node_api_client
node_chat_ui -->|"renders"| node_trace_ui
node_react_app -->|"fetches data"| node_api_client
node_api_client -->|"calls API"| node_fastapi
node_fastapi -->|"validates with"| node_schemas
node_fastapi -->|"dispatches chat"| node_main_flow
node_main_flow -->|"classifies with"| node_intent_router
node_main_flow -->|"dispatches"| node_sales_flow
node_main_flow -->|"dispatches"| node_ops_flow
node_main_flow -->|"logs steps"| node_execution
node_sales_flow -->|"runs"| node_sales_agent
node_sales_flow -->|"logs steps"| node_execution
node_ops_flow -->|"runs"| node_ops_agent
node_ops_flow -->|"logs steps"| node_execution
node_sales_agent -->|"extracts with"| node_llm
node_sales_agent -->|"scores lead"| node_scoring
node_sales_agent -->|"saves lead"| node_lead_tools
node_ops_agent -->|"extracts with"| node_llm
node_ops_agent -->|"looks up leads"| node_lead_tools
node_ops_agent -->|"handles deals"| node_deal_tools
node_ops_agent -->|"handles tasks"| node_task_tools
node_ops_agent -->|"queries status"| node_status_tools
node_scoring -->|"uses"| node_llm
node_status_tools -->|"reads leads"| node_lead_tools
node_status_tools -->|"reads deals"| node_deal_tools
node_status_tools -->|"reads tasks"| node_task_tools
node_fastapi -->|"serves lead data"| node_lead_tools
node_fastapi -->|"updates deals"| node_deal_tools
node_fastapi -->|"updates tasks"| node_task_tools
node_fastapi -->|"gets status"| node_status_tools
node_fastapi -->|"stores messages"| node_chat_tools
node_llm -->|"invokes model"| node_groq
node_lead_tools -->|"reads and writes"| node_sqlite
node_deal_tools -->|"reads and writes"| node_sqlite
node_task_tools -->|"reads and writes"| node_sqlite
node_chat_tools -->|"reads and writes"| node_sqlite
node_execution -->|"persists steps"| node_sqlite
node_fastapi -->|"checks database"| node_sqlite

click node_react_app "https://github.com/kathirvbk/sales-operation/blob/main/frontend/src/App.jsx"
click node_chat_ui "https://github.com/kathirvbk/sales-operation/blob/main/frontend/src/components/ChatPanel.jsx"
click node_leads_ui "https://github.com/kathirvbk/sales-operation/blob/main/frontend/src/components/LeadsBoard.jsx"
click node_deals_ui "https://github.com/kathirvbk/sales-operation/blob/main/frontend/src/components/DealsBoard.jsx"
click node_tasks_ui "https://github.com/kathirvbk/sales-operation/blob/main/frontend/src/components/TasksBoard.jsx"
click node_trace_ui "https://github.com/kathirvbk/sales-operation/blob/main/frontend/src/components/ExecutionTrace.jsx"
click node_api_client "https://github.com/kathirvbk/sales-operation/blob/main/frontend/src/services/api.js"
click node_fastapi "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/main.py"
click node_schemas "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/schemas/schemas.py"
click node_intent_router "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/router/router.py"
click node_main_flow "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/workflows/main_graph.py"
click node_sales_flow "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/workflows/sales_workflow.py"
click node_ops_flow "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/workflows/operations_workflow.py"
click node_sales_agent "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/agents/sales_agent.py"
click node_ops_agent "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/agents/operations_agent.py"
click node_scoring "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/tools/scoring_tools.py"
click node_lead_tools "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/tools/lead_tools.py"
click node_deal_tools "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/tools/deal_tools.py"
click node_task_tools "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/tools/task_tools.py"
click node_status_tools "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/tools/status_tools.py"
click node_chat_tools "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/tools/chat_tools.py"
click node_llm "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/services/llm_service.py"
click node_execution "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/services/execution_service.py"
click node_sqlite "https://github.com/kathirvbk/sales-operation/blob/main/backend/app/database/database.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_react_app,node_chat_ui,node_leads_ui,node_deals_ui,node_tasks_ui,node_trace_ui,node_api_client,node_user toneBlue
class node_fastapi,node_schemas,node_intent_router toneAmber
class node_main_flow,node_sales_flow,node_ops_flow toneMint
class node_sales_agent,node_ops_agent,node_scoring,node_lead_tools,node_deal_tools,node_task_tools,node_status_tools,node_chat_tools,node_llm,node_execution toneRose
class node_sqlite,node_groq toneIndigo
```

## Components

### React dashboard

- [Dashboard app](https://github.com/kathirvbk/sales-operation/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Chat panel](https://github.com/kathirvbk/sales-operation/blob/main/frontend/src/components/ChatPanel.jsx): `frontend/src/components/ChatPanel.jsx`
- [Leads board](https://github.com/kathirvbk/sales-operation/blob/main/frontend/src/components/LeadsBoard.jsx): `frontend/src/components/LeadsBoard.jsx`
- [Deals board](https://github.com/kathirvbk/sales-operation/blob/main/frontend/src/components/DealsBoard.jsx): `frontend/src/components/DealsBoard.jsx`
- [Tasks board](https://github.com/kathirvbk/sales-operation/blob/main/frontend/src/components/TasksBoard.jsx): `frontend/src/components/TasksBoard.jsx`
- [Execution trace](https://github.com/kathirvbk/sales-operation/blob/main/frontend/src/components/ExecutionTrace.jsx): `frontend/src/components/ExecutionTrace.jsx`
- [API client](https://github.com/kathirvbk/sales-operation/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### API and routing

- [FastAPI endpoints](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/main.py): `backend/app/main.py`
- [Request schemas](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/schemas/schemas.py): `backend/app/schemas/schemas.py`
- [Intent classifier](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/router/router.py): `backend/app/router/router.py`

### Agent workflows

- [Main workflow](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/workflows/main_graph.py): `backend/app/workflows/main_graph.py`
- [Sales workflow](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/workflows/sales_workflow.py): `backend/app/workflows/sales_workflow.py`
- [Operations workflow](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/workflows/operations_workflow.py): `backend/app/workflows/operations_workflow.py`

### Sales and operations

- [Sales agent](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/agents/sales_agent.py): `backend/app/agents/sales_agent.py`
- [Operations agent](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/agents/operations_agent.py): `backend/app/agents/operations_agent.py`
- [Lead scoring](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/tools/scoring_tools.py): `backend/app/tools/scoring_tools.py`
- [Lead records](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/tools/lead_tools.py): `backend/app/tools/lead_tools.py`
- [Deal records](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/tools/deal_tools.py): `backend/app/tools/deal_tools.py`
- [Onboarding tasks](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/tools/task_tools.py): `backend/app/tools/task_tools.py`
- [Status queries](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/tools/status_tools.py): `backend/app/tools/status_tools.py`
- [Chat history](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/tools/chat_tools.py): `backend/app/tools/chat_tools.py`
- [LLM service](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/services/llm_service.py): `backend/app/services/llm_service.py`
- [Execution trace service](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/services/execution_service.py): `backend/app/services/execution_service.py`

### Persistence

- [SQLite database](https://github.com/kathirvbk/sales-operation/blob/main/backend/app/database/database.py): `backend/app/database/database.py`

### Other components

- **User**
- **Groq LLM**

## Connections

- User → Dashboard app: uses (evidence: `README.md`)
- Dashboard app → Chat panel: renders (evidence: `frontend/src/App.jsx`)
- Dashboard app → Leads board: renders (evidence: `frontend/src/App.jsx`)
- Dashboard app → Deals board: renders (evidence: `frontend/src/App.jsx`)
- Dashboard app → Tasks board: renders (evidence: `frontend/src/App.jsx`)
- Chat panel → API client: requests (evidence: `frontend/src/components/ChatPanel.jsx`)
- Chat panel → Execution trace: renders (evidence: `frontend/src/components/ChatPanel.jsx`)
- Dashboard app → API client: fetches data (evidence: `frontend/src/App.jsx`)
- API client → FastAPI endpoints: calls API (evidence: `README.md`)
- FastAPI endpoints → Request schemas: validates with (evidence: `backend/app/main.py`)
- FastAPI endpoints → Main workflow: dispatches chat (evidence: `backend/app/main.py`)
- Main workflow → Intent classifier: classifies with (evidence: `backend/app/workflows/main_graph.py`)
- Main workflow → Sales workflow: dispatches (evidence: `backend/app/workflows/main_graph.py`)
- Main workflow → Operations workflow: dispatches (evidence: `backend/app/workflows/main_graph.py`)
- Main workflow → Execution trace service: logs steps (evidence: `backend/app/workflows/main_graph.py`)
- Sales workflow → Sales agent: runs (evidence: `backend/app/workflows/sales_workflow.py`)
- Sales workflow → Execution trace service: logs steps (evidence: `backend/app/workflows/sales_workflow.py`)
- Operations workflow → Operations agent: runs (evidence: `backend/app/workflows/operations_workflow.py`)
- Operations workflow → Execution trace service: logs steps (evidence: `backend/app/workflows/operations_workflow.py`)
- Sales agent → LLM service: extracts with (evidence: `backend/app/agents/sales_agent.py`)
- Sales agent → Lead scoring: scores lead (evidence: `backend/app/agents/sales_agent.py`)
- Sales agent → Lead records: saves lead (evidence: `backend/app/agents/sales_agent.py`)
- Operations agent → LLM service: extracts with (evidence: `backend/app/agents/operations_agent.py`)
- Operations agent → Lead records: looks up leads (evidence: `backend/app/agents/operations_agent.py`)
- Operations agent → Deal records: handles deals (evidence: `backend/app/agents/operations_agent.py`)
- Operations agent → Onboarding tasks: handles tasks (evidence: `backend/app/agents/operations_agent.py`)
- Operations agent → Status queries: queries status (evidence: `backend/app/agents/operations_agent.py`)
- Lead scoring → LLM service: uses (evidence: `backend/app/tools/scoring_tools.py`)
- Status queries → Lead records: reads leads (evidence: `backend/app/tools/status_tools.py`)
- Status queries → Deal records: reads deals (evidence: `backend/app/tools/status_tools.py`)
- Status queries → Onboarding tasks: reads tasks (evidence: `backend/app/tools/status_tools.py`)
- FastAPI endpoints → Lead records: serves lead data (evidence: `backend/app/main.py`)
- FastAPI endpoints → Deal records: updates deals (evidence: `backend/app/main.py`)
- FastAPI endpoints → Onboarding tasks: updates tasks (evidence: `backend/app/main.py`)
- FastAPI endpoints → Status queries: gets status (evidence: `backend/app/main.py`)
- FastAPI endpoints → Chat history: stores messages (evidence: `backend/app/main.py`)
- LLM service → Groq LLM: invokes model (evidence: `backend/app/services/llm_service.py`)
- Lead records → SQLite database: reads and writes (evidence: `backend/app/tools/lead_tools.py`)
- Deal records → SQLite database: reads and writes (evidence: `backend/app/tools/deal_tools.py`)
- Onboarding tasks → SQLite database: reads and writes (evidence: `backend/app/tools/task_tools.py`)
- Chat history → SQLite database: reads and writes (evidence: `backend/app/tools/chat_tools.py`)
- Execution trace service → SQLite database: persists steps (evidence: `backend/app/services/execution_service.py`)
- FastAPI endpoints → SQLite database: checks database (evidence: `backend/app/main.py`)
