# shekharpaatni007/support-ticket-ai architecture

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

- Interactive diagram: https://gitdiagram.com/shekharpaatni007/support-ticket-ai
- Repository: https://github.com/shekharpaatni007/support-ticket-ai

## Overview

SupportTicket AI combines ticket lifecycle management with a retrieval-grounded assistant. Users browse, create, and update tickets in the React UI; the backend exposes ticket APIs, persists ticket data, and refreshes knowledge chunks for the assistant. Assistant questions are embedded, searched, and answered with grounding checks and citations. The README documents local Ollama and PostgreSQL/PGVector integrations. Some frontend API and backend wiring is unsampled, so unverified connections are omitted or shown as optional.

Main entry points: [`backend/src/main/java/com/supportticket/assistant/ask/AskService.java`](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/ask/AskService.java) (Ask Service), [`backend/src/main/java/com/supportticket/assistant/ingestion/TicketIngestionService.java`](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/ingestion/TicketIngestionService.java) (Ticket Ingestion), [`frontend/src/api/client.ts`](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/frontend/src/api/client.ts) (Web API Client), [`frontend/src/App.tsx`](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/frontend/src/App.tsx) (React App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web UI"]
  node_app["React App<br/>[App.tsx]"]
  node_ticketpages["Ticket Pages"]
  node_askpanel["Ask Panel<br/>[AskPanel.tsx]"]
  node_webapi["Web API Client<br/>[client.ts]"]
  node_ticketapi["Ticket API<br/>[tickets.ts]"]
  node_assistantapi["Assistant API<br/>[assistant.ts]"]
end

subgraph group_tickets["Ticket Management"]
  node_ticketcontroller["Ticket Controller"]
  node_ticketservices["Ticket Services"]
  node_ticketdomain["Ticket Domain<br/>[Ticket.java]"]
  node_ticketrepository["Ticket Repository"]
end

subgraph group_knowledge["Knowledge RAG"]
  node_ingestion["Ticket Ingestion"]
  node_embedding["Embedding Client"]
  node_assistantcontroller["Assistant Controller"]
  node_askservice["Ask Service<br/>[AskService.java]"]
  node_retriever["Chunk Retriever"]
  node_chatclient["Chat Completion"]
  node_grounding["Grounding Check"]
end

subgraph group_runtime["Runtime Storage"]
  node_ticketdb[("Ticket Database")]
  node_vectorindex[("Vector Index<br/>[VectorIndex.java]")]
end

node_user(("Support User"))
node_ollama{{"Ollama Models"}}

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_ticketpages
node_app -->|"routes to"| node_askpanel
node_ticketpages -->|"calls"| node_webapi
node_askpanel -->|"calls"| node_assistantapi
node_ticketapi -.->|"uses"| node_webapi
node_assistantapi -.->|"uses"| node_webapi
node_webapi -.->|"sends API requests"| node_ticketcontroller
node_ticketcontroller -->|"dispatches"| node_ticketservices
node_ticketcontroller -->|"invokes refresh"| node_ingestion
node_ticketservices -.->|"reads and writes"| node_ticketrepository
node_ticketrepository -.->|"persists"| node_ticketdb
node_ingestion -->|"loads ticket data"| node_ticketrepository
node_ingestion -->|"embeds chunks"| node_embedding
node_ingestion -->|"replaces chunks"| node_vectorindex
node_assistantcontroller -->|"dispatches"| node_askservice
node_askservice -->|"embeds question"| node_embedding
node_askservice -->|"searches chunks"| node_retriever
node_askservice -->|"requests completion"| node_chatclient
node_askservice -->|"checks answer"| node_grounding
node_chatclient -.->|"generates answer"| node_ollama
node_embedding -.->|"creates vectors"| node_ollama

click node_app "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/frontend/src/App.tsx"
click node_ticketpages "https://github.com/shekharpaatni007/support-ticket-ai/tree/main/frontend/src/pages"
click node_askpanel "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/frontend/src/components/AskPanel.tsx"
click node_webapi "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/frontend/src/api/client.ts"
click node_ticketapi "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/frontend/src/api/tickets.ts"
click node_assistantapi "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/frontend/src/api/assistant.ts"
click node_ticketcontroller "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/ticket/api/TicketController.java"
click node_ticketservices "https://github.com/shekharpaatni007/support-ticket-ai/tree/main/backend/src/main/java/com/supportticket/ticket/application"
click node_ticketdomain "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/ticket/domain/Ticket.java"
click node_ticketrepository "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/ticket/persistence/TicketRepository.java"
click node_ticketdb "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/ticket/persistence/JdbcTicketRepository.java"
click node_ingestion "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/ingestion/TicketIngestionService.java"
click node_embedding "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/embedding/EmbeddingClient.java"
click node_vectorindex "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/vector/VectorIndex.java"
click node_assistantcontroller "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/api/AssistantController.java"
click node_askservice "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/ask/AskService.java"
click node_retriever "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/retrieval/ChunkRetriever.java"
click node_chatclient "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/ask/ChatCompletionClient.java"
click node_grounding "https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/ask/GroundingChecker.java"

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_ticketpages,node_askpanel,node_webapi,node_ticketapi,node_assistantapi,node_user toneBlue
class node_ticketcontroller,node_ticketservices,node_ticketdomain,node_ticketrepository toneAmber
class node_ingestion,node_embedding,node_assistantcontroller,node_askservice,node_retriever,node_chatclient,node_grounding toneMint
class node_ticketdb,node_vectorindex toneRose
class node_ollama toneIndigo
```

## Components

### Web UI

- [React App](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Ticket Pages](https://github.com/shekharpaatni007/support-ticket-ai/tree/main/frontend/src/pages): `frontend/src/pages`
- [Ask Panel](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/frontend/src/components/AskPanel.tsx): `frontend/src/components/AskPanel.tsx`
- [Web API Client](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Ticket API](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/frontend/src/api/tickets.ts): `frontend/src/api/tickets.ts`
- [Assistant API](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/frontend/src/api/assistant.ts): `frontend/src/api/assistant.ts`

### Ticket Management

- [Ticket Controller](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/ticket/api/TicketController.java): `backend/src/main/java/com/supportticket/ticket/api/TicketController.java`
- [Ticket Services](https://github.com/shekharpaatni007/support-ticket-ai/tree/main/backend/src/main/java/com/supportticket/ticket/application): `backend/src/main/java/com/supportticket/ticket/application`
- [Ticket Domain](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/ticket/domain/Ticket.java): `backend/src/main/java/com/supportticket/ticket/domain/Ticket.java`
- [Ticket Repository](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/ticket/persistence/TicketRepository.java): `backend/src/main/java/com/supportticket/ticket/persistence/TicketRepository.java`

### Knowledge RAG

- [Ticket Ingestion](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/ingestion/TicketIngestionService.java): `backend/src/main/java/com/supportticket/assistant/ingestion/TicketIngestionService.java`
- [Embedding Client](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/embedding/EmbeddingClient.java): `backend/src/main/java/com/supportticket/assistant/embedding/EmbeddingClient.java`
- [Assistant Controller](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/api/AssistantController.java): `backend/src/main/java/com/supportticket/assistant/api/AssistantController.java`
- [Ask Service](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/ask/AskService.java): `backend/src/main/java/com/supportticket/assistant/ask/AskService.java`
- [Chunk Retriever](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/retrieval/ChunkRetriever.java): `backend/src/main/java/com/supportticket/assistant/retrieval/ChunkRetriever.java`
- [Chat Completion](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/ask/ChatCompletionClient.java): `backend/src/main/java/com/supportticket/assistant/ask/ChatCompletionClient.java`
- [Grounding Check](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/ask/GroundingChecker.java): `backend/src/main/java/com/supportticket/assistant/ask/GroundingChecker.java`

### Runtime Storage

- [Ticket Database](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/ticket/persistence/JdbcTicketRepository.java): `backend/src/main/java/com/supportticket/ticket/persistence/JdbcTicketRepository.java`
- [Vector Index](https://github.com/shekharpaatni007/support-ticket-ai/blob/main/backend/src/main/java/com/supportticket/assistant/vector/VectorIndex.java): `backend/src/main/java/com/supportticket/assistant/vector/VectorIndex.java`

### Other components

- **Support User**
- **Ollama Models**

## Connections

- Support User → React App: uses (evidence: `frontend/src/App.tsx`)
- React App → Ticket Pages: routes to (evidence: `frontend/src/App.tsx`)
- React App → Ask Panel: routes to (evidence: `frontend/src/App.tsx`)
- Ticket Pages → Web API Client: calls (evidence: `frontend/src/pages/TicketDetailPage.tsx`)
- Ask Panel → Assistant API: calls (evidence: `frontend/src/components/AskPanel.tsx`)
- Ticket API → Web API Client: uses (evidence: `frontend/src/api/tickets.ts`)
- Assistant API → Web API Client: uses
- Web API Client → Ticket Controller: sends API requests
- Ticket Controller → Ticket Services: dispatches (evidence: `backend/src/main/java/com/supportticket/ticket/api/TicketController.java`)
- Ticket Controller → Ticket Ingestion: invokes refresh (evidence: `backend/src/main/java/com/supportticket/ticket/api/TicketController.java`)
- Ticket Services → Ticket Repository: reads and writes (evidence: `backend/src/main/java/com/supportticket/ticket/application/UpdateTicketService.java`)
- Ticket Repository → Ticket Database: persists (evidence: `backend/src/main/java/com/supportticket/ticket/persistence/JdbcTicketRepository.java`)
- Ticket Ingestion → Ticket Repository: loads ticket data (evidence: `backend/src/main/java/com/supportticket/assistant/ingestion/TicketIngestionService.java`)
- Ticket Ingestion → Embedding Client: embeds chunks (evidence: `backend/src/main/java/com/supportticket/assistant/ingestion/TicketIngestionService.java`)
- Ticket Ingestion → Vector Index: replaces chunks (evidence: `backend/src/main/java/com/supportticket/assistant/ingestion/TicketIngestionService.java`)
- Assistant Controller → Ask Service: dispatches (evidence: `backend/src/main/java/com/supportticket/assistant/api/AssistantController.java`)
- Ask Service → Embedding Client: embeds question (evidence: `backend/src/main/java/com/supportticket/assistant/ask/AskService.java`)
- Ask Service → Chunk Retriever: searches chunks (evidence: `backend/src/main/java/com/supportticket/assistant/ask/AskService.java`)
- Ask Service → Chat Completion: requests completion (evidence: `backend/src/main/java/com/supportticket/assistant/ask/AskService.java`)
- Ask Service → Grounding Check: checks answer (evidence: `backend/src/main/java/com/supportticket/assistant/ask/AskService.java`)
- Chat Completion → Ollama Models: generates answer
- Embedding Client → Ollama Models: creates vectors
