# sumanthmandava07/support-knowledge-copilot architecture

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

- Interactive diagram: https://gitdiagram.com/sumanthmandava07/support-knowledge-copilot
- Repository: https://github.com/sumanthmandava07/support-knowledge-copilot

## Overview

This is a support-knowledge copilot: a user uploads support documents, asks questions in a web chat, and receives an answer with source citations. The backend also offers document management and retrieval evaluation. The graph follows the visible chat and document flows; several frontend-to-backend links are evidenced by fetch calls, while internals not shown in the excerpts are omitted. The README content was empty, so product scope is inferred from the source tree and sampled code.

Main entry points: [`support-knowledge-frontend/src/App.jsx`](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/App.jsx) (Web app routes), [`src/main/java/com/copilot/service/ChatService.java`](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/service/ChatService.java) (Answer orchestration), [`src/main/java/com/copilot/controller/ChatController.java`](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/controller/ChatController.java) (Chat endpoints), [`support-knowledge-frontend/src/pages/Documents.jsx`](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/pages/Documents.jsx) (Document manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web interface"]
  node_webapp["Web app routes<br/>[App.jsx]"]
  node_chatui["Chat workspace<br/>[Dashboard.jsx]"]
  node_docui["Document manager<br/>[Documents.jsx]"]
  node_evalui["Evaluation screen<br/>[Evaluation.jsx]"]
  node_login["Login screen<br/>[Login.jsx]"]
  node_profile["Profile screen<br/>[Profile.jsx]"]
  node_sidebar["Workspace navigation<br/>[Sidebar.jsx]"]
  node_header["Page header<br/>[Header.jsx]"]
  node_citationcard["Citation display<br/>[CitationCard.jsx]"]
end

subgraph group_api["Backend API"]
  node_chatapi["Chat endpoints"]
  node_docapi["Document endpoints"]
  node_chatrequest["Chat request<br/>[ChatRequest.java]"]
  node_chatresponse["Answer and citations<br/>[ChatResponse.java]"]
end

subgraph group_knowledge["Knowledge and retrieval"]
  node_docservice["Document ingestion"]
  node_chunkstore[("Chunk and vector stores")]
  node_retrieval["Hybrid retrieval"]
  node_evaluation["Retrieval evaluation"]
  node_evaldata["Evaluation questions<br/>[evaluation.json]"]
end

subgraph group_answering["Answer generation"]
  node_chatservice["Answer orchestration<br/>[ChatService.java]"]
  node_citationverify["Citation verification"]
end

node_user(("User"))
node_llm{{"Chat model"}}

node_user -->|"opens"| node_webapp
node_webapp -->|"routes to"| node_chatui
node_webapp -->|"routes to"| node_docui
node_webapp -->|"routes to"| node_evalui
node_webapp -->|"routes to"| node_login
node_webapp -->|"routes to"| node_profile
node_chatui -.->|"requests chat"| node_chatapi
node_docui -->|"manages documents"| node_docapi
node_docui -->|"renders"| node_sidebar
node_docui -->|"renders"| node_header
node_evalui -.->|"renders"| node_sidebar
node_evalui -.->|"renders"| node_header
node_profile -.->|"renders"| node_sidebar
node_profile -.->|"renders"| node_header
node_chatapi -->|"accepts"| node_chatrequest
node_chatapi -->|"delegates to"| node_chatservice
node_chatapi -->|"invokes"| node_evaluation
node_chatservice -->|"searches"| node_retrieval
node_chatservice -->|"checks support"| node_citationverify
node_chatservice -->|"requests completion"| node_llm
node_chatservice -->|"constructs"| node_chatresponse
node_chatapi -->|"returns"| node_chatresponse
node_citationverify -->|"provides support"| node_chatservice
node_docapi -->|"delegates to"| node_docservice
node_docservice -->|"stores chunks"| node_chunkstore
node_retrieval -->|"searches"| node_chunkstore
node_evaluation -->|"evaluates results"| node_retrieval
node_evaluation -->|"loads questions"| node_evaldata

click node_webapp "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/App.jsx"
click node_chatui "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/pages/Dashboard.jsx"
click node_docui "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/pages/Documents.jsx"
click node_evalui "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/pages/Evaluation.jsx"
click node_login "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/pages/Login.jsx"
click node_profile "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/pages/Profile.jsx"
click node_sidebar "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/components/Sidebar.jsx"
click node_header "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/components/Header.jsx"
click node_citationcard "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/components/CitationCard.jsx"
click node_chatapi "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/controller/ChatController.java"
click node_docapi "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/controller/DocumentController.java"
click node_chatrequest "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/model/ChatRequest.java"
click node_chatresponse "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/model/ChatResponse.java"
click node_docservice "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/service/DocumentService.java"
click node_chunkstore "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/service/DocumentService.java"
click node_retrieval "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/service/RetrievalService.java"
click node_chatservice "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/service/ChatService.java"
click node_citationverify "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/service/CitationVerifierService.java"
click node_evaluation "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/service/EvaluationService.java"
click node_evaldata "https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/resources/evaluation/evaluation.json"

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_webapp,node_chatui,node_docui,node_evalui,node_login,node_profile,node_sidebar,node_header,node_citationcard,node_user toneBlue
class node_chatapi,node_docapi,node_chatrequest,node_chatresponse toneAmber
class node_docservice,node_chunkstore,node_retrieval,node_evaluation,node_evaldata toneMint
class node_chatservice,node_citationverify toneRose
class node_llm toneIndigo
```

## Components

### Web interface

- [Web app routes](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/App.jsx): `support-knowledge-frontend/src/App.jsx`
- [Chat workspace](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/pages/Dashboard.jsx): `support-knowledge-frontend/src/pages/Dashboard.jsx`
- [Document manager](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/pages/Documents.jsx): `support-knowledge-frontend/src/pages/Documents.jsx`
- [Evaluation screen](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/pages/Evaluation.jsx): `support-knowledge-frontend/src/pages/Evaluation.jsx`
- [Login screen](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/pages/Login.jsx): `support-knowledge-frontend/src/pages/Login.jsx`
- [Profile screen](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/pages/Profile.jsx): `support-knowledge-frontend/src/pages/Profile.jsx`
- [Workspace navigation](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/components/Sidebar.jsx): `support-knowledge-frontend/src/components/Sidebar.jsx`
- [Page header](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/components/Header.jsx): `support-knowledge-frontend/src/components/Header.jsx`
- [Citation display](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/support-knowledge-frontend/src/components/CitationCard.jsx): `support-knowledge-frontend/src/components/CitationCard.jsx`

### Backend API

- [Chat endpoints](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/controller/ChatController.java): `src/main/java/com/copilot/controller/ChatController.java`
- [Document endpoints](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/controller/DocumentController.java): `src/main/java/com/copilot/controller/DocumentController.java`
- [Chat request](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/model/ChatRequest.java): `src/main/java/com/copilot/model/ChatRequest.java`
- [Answer and citations](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/model/ChatResponse.java): `src/main/java/com/copilot/model/ChatResponse.java`

### Knowledge and retrieval

- [Document ingestion](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/service/DocumentService.java): `src/main/java/com/copilot/service/DocumentService.java`
- [Chunk and vector stores](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/service/DocumentService.java): `src/main/java/com/copilot/service/DocumentService.java`
- [Hybrid retrieval](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/service/RetrievalService.java): `src/main/java/com/copilot/service/RetrievalService.java`
- [Retrieval evaluation](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/service/EvaluationService.java): `src/main/java/com/copilot/service/EvaluationService.java`
- [Evaluation questions](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/resources/evaluation/evaluation.json): `src/main/resources/evaluation/evaluation.json`

### Answer generation

- [Answer orchestration](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/service/ChatService.java): `src/main/java/com/copilot/service/ChatService.java`
- [Citation verification](https://github.com/sumanthmandava07/support-knowledge-copilot/blob/main/src/main/java/com/copilot/service/CitationVerifierService.java): `src/main/java/com/copilot/service/CitationVerifierService.java`

### Other components

- **User**
- **Chat model**

## Connections

- User → Web app routes: opens (evidence: `support-knowledge-frontend/src/App.jsx`)
- Web app routes → Chat workspace: routes to (evidence: `support-knowledge-frontend/src/App.jsx`)
- Web app routes → Document manager: routes to (evidence: `support-knowledge-frontend/src/App.jsx`)
- Web app routes → Evaluation screen: routes to (evidence: `support-knowledge-frontend/src/App.jsx`)
- Web app routes → Login screen: routes to (evidence: `support-knowledge-frontend/src/App.jsx`)
- Web app routes → Profile screen: routes to (evidence: `support-knowledge-frontend/src/App.jsx`)
- Chat workspace → Chat endpoints: requests chat
- Document manager → Document endpoints: manages documents (evidence: `support-knowledge-frontend/src/pages/Documents.jsx`)
- Document manager → Workspace navigation: renders (evidence: `support-knowledge-frontend/src/pages/Documents.jsx`)
- Document manager → Page header: renders (evidence: `support-knowledge-frontend/src/pages/Documents.jsx`)
- Evaluation screen → Workspace navigation: renders (evidence: `support-knowledge-frontend/src/pages/Evaluation.jsx`)
- Evaluation screen → Page header: renders (evidence: `support-knowledge-frontend/src/pages/Evaluation.jsx`)
- Profile screen → Workspace navigation: renders (evidence: `support-knowledge-frontend/src/pages/Profile.jsx`)
- Profile screen → Page header: renders (evidence: `support-knowledge-frontend/src/pages/Profile.jsx`)
- Chat endpoints → Chat request: accepts (evidence: `src/main/java/com/copilot/controller/ChatController.java`)
- Chat endpoints → Answer orchestration: delegates to (evidence: `src/main/java/com/copilot/controller/ChatController.java`)
- Chat endpoints → Retrieval evaluation: invokes (evidence: `src/main/java/com/copilot/controller/ChatController.java`)
- Answer orchestration → Hybrid retrieval: searches (evidence: `src/main/java/com/copilot/service/ChatService.java`)
- Answer orchestration → Citation verification: checks support (evidence: `src/main/java/com/copilot/service/ChatService.java`)
- Answer orchestration → Chat model: requests completion (evidence: `src/main/java/com/copilot/service/ChatService.java`)
- Answer orchestration → Answer and citations: constructs (evidence: `src/main/java/com/copilot/service/ChatService.java`)
- Chat endpoints → Answer and citations: returns (evidence: `src/main/java/com/copilot/controller/ChatController.java`)
- Citation verification → Answer orchestration: provides support (evidence: `src/main/java/com/copilot/service/ChatService.java`)
- Document endpoints → Document ingestion: delegates to (evidence: `src/main/java/com/copilot/controller/DocumentController.java`)
- Document ingestion → Chunk and vector stores: stores chunks (evidence: `src/main/java/com/copilot/service/DocumentService.java`)
- Hybrid retrieval → Chunk and vector stores: searches (evidence: `src/main/java/com/copilot/service/RetrievalService.java`)
- Retrieval evaluation → Hybrid retrieval: evaluates results (evidence: `src/main/java/com/copilot/service/EvaluationService.java`)
- Retrieval evaluation → Evaluation questions: loads questions (evidence: `src/main/java/com/copilot/service/EvaluationService.java`)
