# tejaswinig06/teleassist-prodapt architecture

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

- Interactive diagram: https://gitdiagram.com/tejaswinig06/teleassist-prodapt
- Repository: https://github.com/tejaswinig06/teleassist-prodapt

## Overview

TeleAssist turns a complaint and any follow-up observations into a privacy-masked, evidence-backed troubleshooting draft, clarification, or escalation. The main workflow runs through the dashboard, resolution API and retrieval service; retrieval combines keyword and semantic results, while resolution accounts for tried fixes and validates citations. Separate product branches support case feedback, editor-reviewed evidence publication, emerging-topic review, and service health. The README documents several capabilities beyond the excerpts; links to those are included only where documented or evidenced by the source index.

Main entry points: [`teleassist/services/combined.py`](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/services/combined.py) (Retrieval API), [`frontend/client.py`](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/frontend/client.py) (Dashboard API client), [`teleassist/resolution/pipeline.py`](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/resolution/pipeline.py) (Drafting pipeline), [`frontend/app.py`](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/frontend/app.py) (Dashboard navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Agent dashboard"]
  node_agent["Support workspace<br/>[agent.py]"]
  node_cases_ui["Saved cases<br/>[cases.py]"]
  node_evidence_ui["Evidence workspaces<br/>[evidence.py]"]
  node_topics_ui["Topic review<br/>[topics.py]"]
  node_health_ui["Health view<br/>[health.py]"]
  node_client["Dashboard API client<br/>[client.py]"]
  node_app["Dashboard navigation<br/>[app.py]"]
end

subgraph group_resolve["Resolution workflow"]
  node_resolution_api["Resolution API<br/>[resolution.py]"]
  node_pipeline["Drafting pipeline<br/>[pipeline.py]"]
  node_llm["Model provider<br/>[llm.py]"]
  node_state["State clarification<br/>[state.py]"]
end

subgraph group_retrieval["Evidence retrieval"]
  node_retrieval_api["Retrieval API<br/>[combined.py]"]
  node_retrieval_service["Retrieval service entry<br/>[retrieval.py]"]
  node_query["Query enrichment<br/>[query.py]"]
  node_keyword["Keyword search<br/>[keyword.py]"]
  node_semantic["Semantic search<br/>[semantic.py]"]
  node_evidence["Evidence records<br/>[evidence.py]"]
end

subgraph group_operations["Knowledge operations"]
  node_catalog[("Versioned evidence catalog<br/>[catalog.py]")]
  node_case_store[("Case feedback store<br/>[store.py]")]
  node_case_routes["Case routes<br/>[case_routes.py]"]
  node_topics[("Emerging topics<br/>[topics.py]")]
end

subgraph group_platform["Shared services"]
  node_privacy["Privacy masking<br/>[privacy.py]"]
  node_access["Role access policy<br/>[access.py]"]
  node_monitoring["Health monitoring<br/>[monitoring.py]"]
  node_paths["Runtime paths<br/>[paths.py]"]
end

node_agent_actor(("Support agent"))
node_editor_actor(("Knowledge editor"))
node_provider{{"External LLM provider"}}

node_agent_actor -->|"uses"| node_agent
node_editor_actor -->|"reviews evidence"| node_evidence_ui
node_app -->|"routes to"| node_agent
node_app -->|"routes to"| node_cases_ui
node_app -->|"routes to"| node_evidence_ui
node_app -->|"routes to"| node_topics_ui
node_app -->|"routes to"| node_health_ui
node_agent -.->|"requests via"| node_client
node_cases_ui -.->|"requests via"| node_client
node_evidence_ui -.->|"requests via"| node_client
node_topics_ui -.->|"requests via"| node_client
node_health_ui -->|"requests via"| node_client
node_client -.->|"calls HTTP"| node_resolution_api
node_client -.->|"calls HTTP"| node_retrieval_api
node_resolution_api -->|"invokes"| node_pipeline
node_pipeline -->|"masks text"| node_privacy
node_pipeline -->|"checks state"| node_state
node_pipeline -->|"builds query"| node_query
node_pipeline -->|"generates draft"| node_llm
node_llm -->|"requests generation"| node_provider
node_pipeline -.->|"searches evidence"| node_retrieval_api
node_retrieval_service -->|"creates app"| node_retrieval_api
node_retrieval_api -->|"searches"| node_keyword
node_retrieval_api -->|"searches"| node_semantic
node_retrieval_api -.->|"loads records"| node_evidence
node_retrieval_api -->|"uses snapshots"| node_catalog
node_catalog -->|"builds index"| node_keyword
node_catalog -->|"prepares embeddings"| node_semantic
node_retrieval_api -->|"installs routes"| node_case_routes
node_case_routes -->|"uses store"| node_case_store
node_retrieval_api -->|"records observations"| node_topics
node_retrieval_api -->|"enforces roles"| node_access
node_retrieval_api -.->|"reports health"| node_monitoring
node_resolution_api -->|"enforces roles"| node_access
node_retrieval_api -->|"loads runtime paths"| node_paths
node_llm -.->|"loads configuration"| node_paths
node_evidence_ui -.->|"edits evidence"| node_retrieval_api
node_topics_ui -.->|"reviews topics"| node_retrieval_api
node_cases_ui -.->|"manages cases"| node_retrieval_api

click node_agent "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/frontend/views/agent.py"
click node_cases_ui "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/frontend/views/cases.py"
click node_evidence_ui "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/frontend/views/evidence.py"
click node_topics_ui "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/frontend/views/topics.py"
click node_health_ui "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/frontend/views/health.py"
click node_client "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/frontend/client.py"
click node_app "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/frontend/app.py"
click node_resolution_api "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/services/resolution.py"
click node_pipeline "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/resolution/pipeline.py"
click node_llm "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/resolution/llm.py"
click node_state "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/resolution/state.py"
click node_privacy "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/common/privacy.py"
click node_retrieval_api "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/services/combined.py"
click node_retrieval_service "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/services/retrieval.py"
click node_query "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/retrieval/query.py"
click node_keyword "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/retrieval/keyword.py"
click node_semantic "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/retrieval/semantic.py"
click node_evidence "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/retrieval/evidence.py"
click node_catalog "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/ingestion/catalog.py"
click node_case_store "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/cases/store.py"
click node_case_routes "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/services/case_routes.py"
click node_topics "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/topics.py"
click node_access "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/common/access.py"
click node_monitoring "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/common/monitoring.py"
click node_paths "https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/common/paths.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_agent,node_cases_ui,node_evidence_ui,node_topics_ui,node_health_ui,node_client,node_app toneBlue
class node_resolution_api,node_pipeline,node_llm,node_state toneAmber
class node_retrieval_api,node_retrieval_service,node_query,node_keyword,node_semantic,node_evidence toneMint
class node_catalog,node_case_store,node_case_routes,node_topics toneRose
class node_privacy,node_access,node_monitoring,node_paths,node_agent_actor,node_editor_actor,node_provider toneIndigo
```

## Components

### Agent dashboard

- [Support workspace](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/frontend/views/agent.py): `frontend/views/agent.py`
- [Saved cases](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/frontend/views/cases.py): `frontend/views/cases.py`
- [Evidence workspaces](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/frontend/views/evidence.py): `frontend/views/evidence.py`
- [Topic review](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/frontend/views/topics.py): `frontend/views/topics.py`
- [Health view](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/frontend/views/health.py): `frontend/views/health.py`
- [Dashboard API client](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/frontend/client.py): `frontend/client.py`
- [Dashboard navigation](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/frontend/app.py): `frontend/app.py`

### Resolution workflow

- [Resolution API](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/services/resolution.py): `teleassist/services/resolution.py`
- [Drafting pipeline](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/resolution/pipeline.py): `teleassist/resolution/pipeline.py`
- [Model provider](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/resolution/llm.py): `teleassist/resolution/llm.py`
- [State clarification](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/resolution/state.py): `teleassist/resolution/state.py`

### Evidence retrieval

- [Retrieval API](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/services/combined.py): `teleassist/services/combined.py`
- [Retrieval service entry](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/services/retrieval.py): `teleassist/services/retrieval.py`
- [Query enrichment](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/retrieval/query.py): `teleassist/retrieval/query.py`
- [Keyword search](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/retrieval/keyword.py): `teleassist/retrieval/keyword.py`
- [Semantic search](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/retrieval/semantic.py): `teleassist/retrieval/semantic.py`
- [Evidence records](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/retrieval/evidence.py): `teleassist/retrieval/evidence.py`

### Knowledge operations

- [Versioned evidence catalog](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/ingestion/catalog.py): `teleassist/ingestion/catalog.py`
- [Case feedback store](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/cases/store.py): `teleassist/cases/store.py`
- [Case routes](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/services/case_routes.py): `teleassist/services/case_routes.py`
- [Emerging topics](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/topics.py): `teleassist/topics.py`

### Shared services

- [Privacy masking](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/common/privacy.py): `teleassist/common/privacy.py`
- [Role access policy](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/common/access.py): `teleassist/common/access.py`
- [Health monitoring](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/common/monitoring.py): `teleassist/common/monitoring.py`
- [Runtime paths](https://github.com/tejaswinig06/teleassist-prodapt/blob/main/teleassist/common/paths.py): `teleassist/common/paths.py`

### Other components

- **Support agent**
- **Knowledge editor**
- **External LLM provider**

## Connections

- Support agent → Support workspace: uses
- Knowledge editor → Evidence workspaces: reviews evidence
- Dashboard navigation → Support workspace: routes to (evidence: `frontend/app.py`)
- Dashboard navigation → Saved cases: routes to (evidence: `frontend/app.py`)
- Dashboard navigation → Evidence workspaces: routes to (evidence: `frontend/app.py`)
- Dashboard navigation → Topic review: routes to (evidence: `frontend/app.py`)
- Dashboard navigation → Health view: routes to (evidence: `frontend/app.py`)
- Support workspace → Dashboard API client: requests via
- Saved cases → Dashboard API client: requests via
- Evidence workspaces → Dashboard API client: requests via
- Topic review → Dashboard API client: requests via
- Health view → Dashboard API client: requests via (evidence: `frontend/views/health.py`)
- Dashboard API client → Resolution API: calls HTTP
- Dashboard API client → Retrieval API: calls HTTP
- Resolution API → Drafting pipeline: invokes (evidence: `teleassist/services/resolution.py`)
- Drafting pipeline → Privacy masking: masks text (evidence: `teleassist/resolution/pipeline.py`)
- Drafting pipeline → State clarification: checks state (evidence: `teleassist/resolution/pipeline.py`)
- Drafting pipeline → Query enrichment: builds query (evidence: `teleassist/resolution/pipeline.py`)
- Drafting pipeline → Model provider: generates draft (evidence: `teleassist/resolution/pipeline.py`)
- Model provider → External LLM provider: requests generation (evidence: `teleassist/resolution/llm.py`)
- Drafting pipeline → Retrieval API: searches evidence (evidence: `teleassist/services/combined.py`)
- Retrieval service entry → Retrieval API: creates app (evidence: `teleassist/services/retrieval.py`)
- Retrieval API → Keyword search: searches (evidence: `teleassist/services/combined.py`)
- Retrieval API → Semantic search: searches (evidence: `teleassist/services/combined.py`)
- Retrieval API → Evidence records: loads records (evidence: `teleassist/services/combined.py`)
- Retrieval API → Versioned evidence catalog: uses snapshots (evidence: `teleassist/services/combined.py`)
- Versioned evidence catalog → Keyword search: builds index (evidence: `teleassist/ingestion/catalog.py`)
- Versioned evidence catalog → Semantic search: prepares embeddings (evidence: `teleassist/ingestion/catalog.py`)
- Retrieval API → Case routes: installs routes (evidence: `teleassist/services/combined.py`)
- Case routes → Case feedback store: uses store (evidence: `teleassist/services/case_routes.py`)
- Retrieval API → Emerging topics: records observations (evidence: `teleassist/services/combined.py`)
- Retrieval API → Role access policy: enforces roles (evidence: `teleassist/services/combined.py`)
- Retrieval API → Health monitoring: reports health (evidence: `teleassist/services/combined.py`)
- Resolution API → Role access policy: enforces roles (evidence: `teleassist/services/resolution.py`)
- Retrieval API → Runtime paths: loads runtime paths (evidence: `teleassist/services/combined.py`)
- Model provider → Runtime paths: loads configuration (evidence: `teleassist/common/paths.py`)
- Evidence workspaces → Retrieval API: edits evidence
- Topic review → Retrieval API: reviews topics
- Saved cases → Retrieval API: manages cases
