How shekharpaatni007/support-ticket-ai works
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: AskService.java Ask Service · TicketIngestionService.java Ticket Ingestion · client.ts Web API Client · App.tsx React App
Components 21
Web UI
- React App
frontend/src/App.tsx - Ticket Pages
frontend/src/pages - Ask Panel
frontend/src/components/AskPanel.tsx - Web API Client
frontend/src/api/client.ts - Ticket API
frontend/src/api/tickets.ts - Assistant API
frontend/src/api/assistant.ts
Ticket Management
- Ticket Controller
backend/src/main/java/com/supportticket/ticket/api/TicketController.java - Ticket Services
backend/src/main/java/com/supportticket/ticket/application - Ticket Domain
backend/src/main/java/com/supportticket/ticket/domain/Ticket.java - Ticket Repository
backend/src/main/java/com/supportticket/ticket/persistence/TicketRepository.java
Knowledge RAG
- Ticket Ingestion
backend/src/main/java/com/supportticket/assistant/ingestion/TicketIngestionService.java - Embedding Client
backend/src/main/java/com/supportticket/assistant/embedding/EmbeddingClient.java - Assistant Controller
backend/src/main/java/com/supportticket/assistant/api/AssistantController.java - Ask Service
backend/src/main/java/com/supportticket/assistant/ask/AskService.java - Chunk Retriever
backend/src/main/java/com/supportticket/assistant/retrieval/ChunkRetriever.java - Chat Completion
backend/src/main/java/com/supportticket/assistant/ask/ChatCompletionClient.java - Grounding Check
backend/src/main/java/com/supportticket/assistant/ask/GroundingChecker.java
Runtime Storage
- Ticket Database
backend/src/main/java/com/supportticket/ticket/persistence/JdbcTicketRepository.java - Vector Index
backend/src/main/java/com/supportticket/assistant/vector/VectorIndex.java
Other components
- Support User
- Ollama Models
Connections 22
- Support User → React App: uses
frontend/src/App.tsx - React App → Ticket Pages: routes to
frontend/src/App.tsx - React App → Ask Panel: routes to
frontend/src/App.tsx - Ticket Pages → Web API Client: calls
frontend/src/pages/TicketDetailPage.tsx - Ask Panel → Assistant API: calls
frontend/src/components/AskPanel.tsx - Ticket API → Web API Client: uses
frontend/src/api/tickets.ts - Assistant API → Web API Client: uses
- Web API Client → Ticket Controller: sends API requests
- Ticket Controller → Ticket Services: dispatches
backend/src/main/java/com/supportticket/ticket/api/TicketController.java - Ticket Controller → Ticket Ingestion: invokes refresh
backend/src/main/java/com/supportticket/ticket/api/TicketController.java - Ticket Services → Ticket Repository: reads and writes
backend/src/main/java/com/supportticket/ticket/application/UpdateTicketService.java - Ticket Repository → Ticket Database: persists
backend/src/main/java/com/supportticket/ticket/persistence/JdbcTicketRepository.java - Ticket Ingestion → Ticket Repository: loads ticket data
backend/src/main/java/com/supportticket/assistant/ingestion/TicketIngestionService.java - Ticket Ingestion → Embedding Client: embeds chunks
backend/src/main/java/com/supportticket/assistant/ingestion/TicketIngestionService.java - Ticket Ingestion → Vector Index: replaces chunks
backend/src/main/java/com/supportticket/assistant/ingestion/TicketIngestionService.java - Assistant Controller → Ask Service: dispatches
backend/src/main/java/com/supportticket/assistant/api/AssistantController.java - Ask Service → Embedding Client: embeds question
backend/src/main/java/com/supportticket/assistant/ask/AskService.java - Ask Service → Chunk Retriever: searches chunks
backend/src/main/java/com/supportticket/assistant/ask/AskService.java - Ask Service → Chat Completion: requests completion
backend/src/main/java/com/supportticket/assistant/ask/AskService.java - Ask Service → Grounding Check: checks answer
backend/src/main/java/com/supportticket/assistant/ask/AskService.java - Chat Completion → Ollama Models: generates answer
- Embedding Client → Ollama Models: creates vectors