# faizan-7890/resolve-ai architecture

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

- Interactive diagram: https://gitdiagram.com/faizan-7890/resolve-ai
- Repository: https://github.com/faizan-7890/resolve-ai

## Overview

ResolveAI is a support-ticket triage product: users authenticate, submit or select tickets, run AI diagnosis, and receive an answer, clarification request, or escalation. Its backend combines document ingestion and retrieval with a LangGraph agent; resolved ticket content is logged back into the knowledge base. The React app also provides ticket management, knowledge-base administration, settings, and analytics. The graph reflects documented capabilities and shown calls; some frontend-to-API links are supported by the README rather than sampled page request code.

Main entry points: [`frontend/src/App.tsx`](https://github.com/faizan-7890/resolve-ai/blob/main/frontend/src/App.tsx) (App routing), [`backend/app/api/routes/ingest.py`](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/api/routes/ingest.py) (Document ingestion API), [`backend/app/api/routes/query.py`](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/api/routes/query.py) (Query and triage API), [`backend/app/models/ticket.py`](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/models/ticket.py) (Ticket records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["App routing<br/>[App.tsx]"]
  node_auth_ui["Login and session<br/>[AuthContext.tsx]"]
  node_dashboard["Ticket dashboard<br/>[Dashboard.tsx]"]
  node_workspace["Ticket workspace<br/>[Workspace.tsx]"]
  node_knowledge_ui["Knowledge base UI<br/>[KnowledgeBase.tsx]"]
  node_settings_ui["User settings UI<br/>[Settings.tsx]"]
end

subgraph group_api["Backend API"]
  node_analytics_api["Analytics API<br/>[analytics.py]"]
  node_auth_api["Authentication API<br/>[auth.py]"]
  node_ticket_api["Ticket lifecycle API<br/>[tickets.py]"]
  node_ingest_api["Document ingestion API<br/>[ingest.py]"]
  node_query_api["Query and triage API<br/>[query.py]"]
  node_settings_api["Settings API<br/>[settings.py]"]
end

subgraph group_knowledge["Knowledge and triage"]
  node_retrieval["Similarity retrieval"]
  node_chunking["Text chunking<br/>[chunking.py]"]
  node_extractor["File extraction<br/>[file_extractor.py]"]
  node_embeddings["Embedding service"]
  node_agent["LangGraph triage<br/>[agent_service.py]"]
  node_llm["LLM gateway<br/>[llm_service.py]"]
  node_solver["OpenAI problem solver<br/>[ai_service.py]"]
end

subgraph group_identity["Identity and data"]
  node_security["JWT and password security<br/>[security.py]"]
  node_deps["User authorization<br/>[deps.py]"]
  node_users[("User records<br/>[user.py]")]
  node_tickets[("Ticket records<br/>[ticket.py]")]
  node_documents[("Document and chunk records<br/>[document.py]")]
  node_db[("SQLAlchemy sessions<br/>[database.py]")]
end

node_browser(("Support user"))
node_postgres[("PostgreSQL")]

node_browser -->|"uses"| node_app
node_app -->|"provides session"| node_auth_ui
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_workspace
node_app -->|"routes to"| node_knowledge_ui
node_app -->|"routes to"| node_settings_ui
node_auth_ui -->|"requests auth"| node_auth_api
node_dashboard -->|"manages tickets"| node_ticket_api
node_workspace -->|"runs diagnosis"| node_ticket_api
node_knowledge_ui -->|"manages documents"| node_ingest_api
node_settings_ui -->|"updates settings"| node_settings_api
node_dashboard -->|"loads metrics"| node_analytics_api
node_auth_api -->|"issues tokens"| node_security
node_deps -->|"validates token"| node_security
node_deps -->|"loads user"| node_users
node_auth_api -->|"reads and writes"| node_users
node_ticket_api -->|"manages tickets"| node_tickets
node_analytics_api -->|"queries metrics"| node_tickets
node_ingest_api -->|"extracts uploads"| node_extractor
node_ingest_api -->|"chunks content"| node_chunking
node_ingest_api -->|"embeds chunks"| node_embeddings
node_ingest_api -->|"stores documents"| node_documents
node_query_api -->|"retrieves context"| node_retrieval
node_query_api -->|"runs triage"| node_agent
node_query_api -->|"updates ticket"| node_tickets
node_query_api -->|"logs resolutions"| node_documents
node_retrieval -->|"embeds query"| node_embeddings
node_retrieval -->|"reads chunks"| node_documents
node_agent -->|"generates drafts"| node_llm
node_solver -.->|"uses gateway"| node_llm
node_db -->|"connects"| node_postgres
node_users -->|"uses base"| node_db
node_tickets -->|"uses base"| node_db
node_documents -->|"uses base"| node_db

click node_app "https://github.com/faizan-7890/resolve-ai/blob/main/frontend/src/App.tsx"
click node_auth_ui "https://github.com/faizan-7890/resolve-ai/blob/main/frontend/src/context/AuthContext.tsx"
click node_dashboard "https://github.com/faizan-7890/resolve-ai/blob/main/frontend/src/pages/Dashboard.tsx"
click node_workspace "https://github.com/faizan-7890/resolve-ai/blob/main/frontend/src/pages/Workspace.tsx"
click node_knowledge_ui "https://github.com/faizan-7890/resolve-ai/blob/main/frontend/src/pages/KnowledgeBase.tsx"
click node_settings_ui "https://github.com/faizan-7890/resolve-ai/blob/main/frontend/src/pages/Settings.tsx"
click node_analytics_api "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/api/routes/analytics.py"
click node_auth_api "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/api/routes/auth.py"
click node_ticket_api "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/api/routes/tickets.py"
click node_ingest_api "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/api/routes/ingest.py"
click node_query_api "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/api/routes/query.py"
click node_settings_api "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/api/routes/settings.py"
click node_retrieval "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/services/retrieval_service.py"
click node_chunking "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/services/chunking.py"
click node_extractor "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/services/file_extractor.py"
click node_embeddings "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/services/embedding_service.py"
click node_agent "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/services/agent_service.py"
click node_llm "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/services/llm_service.py"
click node_solver "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/services/ai_service.py"
click node_security "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/core/security.py"
click node_deps "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/api/deps.py"
click node_users "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/models/user.py"
click node_tickets "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/models/ticket.py"
click node_documents "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/models/document.py"
click node_db "https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/core/database.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_auth_ui,node_dashboard,node_workspace,node_knowledge_ui,node_settings_ui,node_browser toneBlue
class node_analytics_api,node_auth_api,node_ticket_api,node_ingest_api,node_query_api,node_settings_api,node_postgres toneAmber
class node_retrieval,node_chunking,node_extractor,node_embeddings,node_agent,node_llm,node_solver toneMint
class node_security,node_deps,node_users,node_tickets,node_documents,node_db toneRose
```

## Components

### Web application

- [App routing](https://github.com/faizan-7890/resolve-ai/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Login and session](https://github.com/faizan-7890/resolve-ai/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Ticket dashboard](https://github.com/faizan-7890/resolve-ai/blob/main/frontend/src/pages/Dashboard.tsx): `frontend/src/pages/Dashboard.tsx`
- [Ticket workspace](https://github.com/faizan-7890/resolve-ai/blob/main/frontend/src/pages/Workspace.tsx): `frontend/src/pages/Workspace.tsx`
- [Knowledge base UI](https://github.com/faizan-7890/resolve-ai/blob/main/frontend/src/pages/KnowledgeBase.tsx): `frontend/src/pages/KnowledgeBase.tsx`
- [User settings UI](https://github.com/faizan-7890/resolve-ai/blob/main/frontend/src/pages/Settings.tsx): `frontend/src/pages/Settings.tsx`

### Backend API

- [Analytics API](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/api/routes/analytics.py): `backend/app/api/routes/analytics.py`
- [Authentication API](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/api/routes/auth.py): `backend/app/api/routes/auth.py`
- [Ticket lifecycle API](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/api/routes/tickets.py): `backend/app/api/routes/tickets.py`
- [Document ingestion API](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/api/routes/ingest.py): `backend/app/api/routes/ingest.py`
- [Query and triage API](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/api/routes/query.py): `backend/app/api/routes/query.py`
- [Settings API](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/api/routes/settings.py): `backend/app/api/routes/settings.py`

### Knowledge and triage

- [Similarity retrieval](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/services/retrieval_service.py): `backend/app/services/retrieval_service.py`
- [Text chunking](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/services/chunking.py): `backend/app/services/chunking.py`
- [File extraction](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/services/file_extractor.py): `backend/app/services/file_extractor.py`
- [Embedding service](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/services/embedding_service.py): `backend/app/services/embedding_service.py`
- [LangGraph triage](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/services/agent_service.py): `backend/app/services/agent_service.py`
- [LLM gateway](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/services/llm_service.py): `backend/app/services/llm_service.py`
- [OpenAI problem solver](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/services/ai_service.py): `backend/app/services/ai_service.py`

### Identity and data

- [JWT and password security](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/core/security.py): `backend/app/core/security.py`
- [User authorization](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/api/deps.py): `backend/app/api/deps.py`
- [User records](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/models/user.py): `backend/app/models/user.py`
- [Ticket records](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/models/ticket.py): `backend/app/models/ticket.py`
- [Document and chunk records](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/models/document.py): `backend/app/models/document.py`
- [SQLAlchemy sessions](https://github.com/faizan-7890/resolve-ai/blob/main/backend/app/core/database.py): `backend/app/core/database.py`

### Other components

- **Support user**
- **PostgreSQL**

## Connections

- Support user → App routing: uses
- App routing → Login and session: provides session (evidence: `frontend/src/App.tsx`)
- App routing → Ticket dashboard: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Ticket workspace: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Knowledge base UI: routes to (evidence: `frontend/src/App.tsx`)
- App routing → User settings UI: routes to (evidence: `frontend/src/App.tsx`)
- Login and session → Authentication API: requests auth (evidence: `frontend/src/context/AuthContext.tsx`)
- Ticket dashboard → Ticket lifecycle API: manages tickets
- Ticket workspace → Ticket lifecycle API: runs diagnosis
- Knowledge base UI → Document ingestion API: manages documents
- User settings UI → Settings API: updates settings
- Ticket dashboard → Analytics API: loads metrics
- Authentication API → JWT and password security: issues tokens (evidence: `backend/app/api/routes/auth.py`)
- User authorization → JWT and password security: validates token (evidence: `backend/app/api/deps.py`)
- User authorization → User records: loads user (evidence: `backend/app/api/deps.py`)
- Authentication API → User records: reads and writes (evidence: `backend/app/api/routes/auth.py`)
- Ticket lifecycle API → Ticket records: manages tickets (evidence: `backend/app/api/routes/tickets.py`)
- Analytics API → Ticket records: queries metrics (evidence: `backend/app/api/routes/analytics.py`)
- Document ingestion API → File extraction: extracts uploads (evidence: `backend/app/api/routes/ingest.py`)
- Document ingestion API → Text chunking: chunks content (evidence: `backend/app/api/routes/ingest.py`)
- Document ingestion API → Embedding service: embeds chunks (evidence: `backend/app/api/routes/ingest.py`)
- Document ingestion API → Document and chunk records: stores documents (evidence: `backend/app/api/routes/ingest.py`)
- Query and triage API → Similarity retrieval: retrieves context (evidence: `backend/app/api/routes/query.py`)
- Query and triage API → LangGraph triage: runs triage (evidence: `backend/app/api/routes/query.py`)
- Query and triage API → Ticket records: updates ticket (evidence: `backend/app/api/routes/query.py`)
- Query and triage API → Document and chunk records: logs resolutions (evidence: `backend/app/api/routes/query.py`)
- Similarity retrieval → Embedding service: embeds query (evidence: `backend/app/services/retrieval_service.py`)
- Similarity retrieval → Document and chunk records: reads chunks (evidence: `backend/app/services/retrieval_service.py`)
- LangGraph triage → LLM gateway: generates drafts (evidence: `backend/app/services/agent_service.py`)
- OpenAI problem solver → LLM gateway: uses gateway
- SQLAlchemy sessions → PostgreSQL: connects (evidence: `backend/app/core/database.py`)
- User records → SQLAlchemy sessions: uses base (evidence: `backend/app/models/user.py`)
- Ticket records → SQLAlchemy sessions: uses base (evidence: `backend/app/models/ticket.py`)
- Document and chunk records → SQLAlchemy sessions: uses base (evidence: `backend/app/models/document.py`)
