# shreyaskowshal/intelligent-support-ticket-resolution-assistant architecture

> Architecture diagram of the GitHub repository shreyaskowshal/intelligent-support-ticket-resolution-assistant, 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/shreyaskowshal/intelligent-support-ticket-resolution-assistant
- Repository: https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant

## Overview

This is an agent-facing telecom support assistant. An agent submits a complaint in the React workspace; FastAPI analyzes it, checks actionability, retrieves approved ticket and KB evidence for actionable issues, drafts a cited resolution, validates its citations, and returns the result for agent review. The graph also includes evidence maintenance and readiness reporting. README statements support several runtime relationships; source excerpts and the SOURCE INDEX support the implementation links. Unsampled internals are not expanded beyond documented capabilities.

Main entry points: [`backend/app/api_service.py`](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/api_service.py) (API services), [`frontend-react/src/App.tsx`](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/frontend-react/src/App.tsx) (Workspace app), [`backend/app/storage.py`](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/storage.py) (Support repository), [`backend/app/analysis.py`](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/analysis.py) (Complaint analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Agent workspace"]
  node_app["Workspace app<br/>[App.tsx]"]
  node_complaint_form["Complaint form<br/>[ComplaintForm.tsx]"]
  node_frontend_api["Frontend API client<br/>[api.ts]"]
  node_resolution_view["Resolution draft"]
  node_evidence_view["Evidence panel<br/>[EvidencePanel.tsx]"]
  node_status_hook["Backend status"]
end

subgraph group_api["API orchestration"]
  node_fastapi["FastAPI routes<br/>[main.py]"]
  node_services["API services<br/>[api_service.py]"]
end

subgraph group_resolution["Analysis and resolution"]
  node_analysis["Complaint analysis<br/>[analysis.py]"]
  node_actionability["Actionability check<br/>[actionability.py]"]
  node_semantic_search["Semantic retrieval<br/>[search.py]"]
  node_rag["Cited draft and validation<br/>[rag.py]"]
  node_llm_interface["LLM interface<br/>[llm.py]"]
end

subgraph group_evidence["Evidence and updates"]
  node_repository[("Support repository<br/>[storage.py]")]
  node_record_models["Support record models<br/>[models.py]"]
  node_ingestion["Reviewed data ingestion<br/>[ingestion.py]"]
  node_taxonomy["Taxonomy values<br/>[taxonomy.py]"]
end

node_agent(("Support agent"))
node_gemini(("Gemini"))

node_agent -->|"enters complaint"| node_app
node_app -->|"renders"| node_complaint_form
node_app -->|"submits through"| node_frontend_api
node_app -->|"renders result"| node_resolution_view
node_app -->|"renders evidence"| node_evidence_view
node_app -->|"checks status"| node_status_hook
node_frontend_api -->|"sends requests"| node_fastapi
node_fastapi -->|"routes requests"| node_services
node_services -->|"analyzes complaint"| node_analysis
node_services -->|"checks issue"| node_actionability
node_services -->|"searches evidence"| node_semantic_search
node_services -->|"generates draft"| node_rag
node_services -->|"updates evidence"| node_ingestion
node_services -->|"uses repository"| node_repository
node_analysis -->|"requests analysis"| node_llm_interface
node_rag -->|"requests resolution"| node_llm_interface
node_semantic_search -->|"reads approved records"| node_repository
node_repository -->|"validates records"| node_record_models
node_analysis -->|"loads taxonomy"| node_repository
node_ingestion -->|"writes reviewed data"| node_repository
node_ingestion -->|"refreshes indexes"| node_semantic_search
node_llm_interface -.->|"uses provider"| node_gemini
node_services -->|"returns result"| node_agent

click node_app "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/frontend-react/src/App.tsx"
click node_complaint_form "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/frontend-react/src/components/ComplaintForm.tsx"
click node_frontend_api "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/frontend-react/src/services/api.ts"
click node_resolution_view "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/frontend-react/src/components/ResolutionDraft.tsx"
click node_evidence_view "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/frontend-react/src/components/EvidencePanel.tsx"
click node_status_hook "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/frontend-react/src/hooks/useBackendStatus.ts"
click node_fastapi "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/main.py"
click node_services "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/api_service.py"
click node_analysis "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/analysis.py"
click node_actionability "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/actionability.py"
click node_semantic_search "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/search.py"
click node_rag "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/rag.py"
click node_llm_interface "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/llm.py"
click node_repository "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/storage.py"
click node_record_models "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/models.py"
click node_ingestion "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/ingestion.py"
click node_taxonomy "https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/taxonomy.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_app,node_complaint_form,node_frontend_api,node_resolution_view,node_evidence_view,node_status_hook toneBlue
class node_fastapi,node_services toneAmber
class node_analysis,node_actionability,node_semantic_search,node_rag,node_llm_interface toneMint
class node_repository,node_record_models,node_ingestion,node_taxonomy toneRose
class node_agent,node_gemini toneIndigo
```

## Components

### Agent workspace

- [Workspace app](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/frontend-react/src/App.tsx): `frontend-react/src/App.tsx`
- [Complaint form](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/frontend-react/src/components/ComplaintForm.tsx): `frontend-react/src/components/ComplaintForm.tsx`
- [Frontend API client](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/frontend-react/src/services/api.ts): `frontend-react/src/services/api.ts`
- [Resolution draft](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/frontend-react/src/components/ResolutionDraft.tsx): `frontend-react/src/components/ResolutionDraft.tsx`
- [Evidence panel](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/frontend-react/src/components/EvidencePanel.tsx): `frontend-react/src/components/EvidencePanel.tsx`
- [Backend status](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/frontend-react/src/hooks/useBackendStatus.ts): `frontend-react/src/hooks/useBackendStatus.ts`

### API orchestration

- [FastAPI routes](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/main.py): `backend/app/main.py`
- [API services](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/api_service.py): `backend/app/api_service.py`

### Analysis and resolution

- [Complaint analysis](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/analysis.py): `backend/app/analysis.py`
- [Actionability check](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/actionability.py): `backend/app/actionability.py`
- [Semantic retrieval](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/search.py): `backend/app/search.py`
- [Cited draft and validation](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/rag.py): `backend/app/rag.py`
- [LLM interface](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/llm.py): `backend/app/llm.py`

### Evidence and updates

- [Support repository](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/storage.py): `backend/app/storage.py`
- [Support record models](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/models.py): `backend/app/models.py`
- [Reviewed data ingestion](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/ingestion.py): `backend/app/ingestion.py`
- [Taxonomy values](https://github.com/shreyaskowshal/intelligent-support-ticket-resolution-assistant/blob/main/backend/app/taxonomy.py): `backend/app/taxonomy.py`

### Other components

- **Support agent**
- **Gemini**

## Connections

- Support agent → Workspace app: enters complaint (evidence: `README.md`)
- Workspace app → Complaint form: renders (evidence: `frontend-react/src/App.tsx`)
- Workspace app → Frontend API client: submits through (evidence: `frontend-react/src/App.tsx`)
- Workspace app → Resolution draft: renders result (evidence: `frontend-react/src/App.tsx`)
- Workspace app → Evidence panel: renders evidence (evidence: `frontend-react/src/App.tsx`)
- Workspace app → Backend status: checks status (evidence: `frontend-react/src/App.tsx`)
- Frontend API client → FastAPI routes: sends requests (evidence: `README.md`)
- FastAPI routes → API services: routes requests (evidence: `backend/app/main.py`)
- API services → Complaint analysis: analyzes complaint (evidence: `backend/app/api_service.py`)
- API services → Actionability check: checks issue (evidence: `backend/app/api_service.py`)
- API services → Semantic retrieval: searches evidence (evidence: `backend/app/api_service.py`)
- API services → Cited draft and validation: generates draft (evidence: `backend/app/api_service.py`)
- API services → Reviewed data ingestion: updates evidence (evidence: `backend/app/api_service.py`)
- API services → Support repository: uses repository (evidence: `backend/app/api_service.py`)
- Complaint analysis → LLM interface: requests analysis (evidence: `backend/app/analysis.py`)
- Cited draft and validation → LLM interface: requests resolution (evidence: `backend/app/rag.py`)
- Semantic retrieval → Support repository: reads approved records (evidence: `backend/app/search.py`)
- Support repository → Support record models: validates records (evidence: `backend/app/storage.py`)
- Complaint analysis → Support repository: loads taxonomy (evidence: `backend/app/analysis.py`)
- Reviewed data ingestion → Support repository: writes reviewed data (evidence: `backend/app/ingestion.py`)
- Reviewed data ingestion → Semantic retrieval: refreshes indexes (evidence: `backend/app/ingestion.py`)
- LLM interface → Gemini: uses provider
- API services → Support agent: returns result (evidence: `README.md`)
