How faizan-7890/resolve-ai works
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: App.tsx App routing · ingest.py Document ingestion API · query.py Query and triage API · ticket.py Ticket records
Components 27
Web application
- App routing
frontend/src/App.tsx - Login and session
frontend/src/context/AuthContext.tsx - Ticket dashboard
frontend/src/pages/Dashboard.tsx - Ticket workspace
frontend/src/pages/Workspace.tsx - Knowledge base UI
frontend/src/pages/KnowledgeBase.tsx - User settings UI
frontend/src/pages/Settings.tsx
Backend API
- Analytics API
backend/app/api/routes/analytics.py - Authentication API
backend/app/api/routes/auth.py - Ticket lifecycle API
backend/app/api/routes/tickets.py - Document ingestion API
backend/app/api/routes/ingest.py - Query and triage API
backend/app/api/routes/query.py - Settings API
backend/app/api/routes/settings.py
Knowledge and triage
- Similarity retrieval
backend/app/services/retrieval_service.py - Text chunking
backend/app/services/chunking.py - File extraction
backend/app/services/file_extractor.py - Embedding service
backend/app/services/embedding_service.py - LangGraph triage
backend/app/services/agent_service.py - LLM gateway
backend/app/services/llm_service.py - OpenAI problem solver
backend/app/services/ai_service.py
Identity and data
- JWT and password security
backend/app/core/security.py - User authorization
backend/app/api/deps.py - User records
backend/app/models/user.py - Ticket records
backend/app/models/ticket.py - Document and chunk records
backend/app/models/document.py - SQLAlchemy sessions
backend/app/core/database.py
Other components
- Support user
- PostgreSQL
Connections 34
- Support user → App routing: uses
- App routing → Login and session: provides session
frontend/src/App.tsx - App routing → Ticket dashboard: routes to
frontend/src/App.tsx - App routing → Ticket workspace: routes to
frontend/src/App.tsx - App routing → Knowledge base UI: routes to
frontend/src/App.tsx - App routing → User settings UI: routes to
frontend/src/App.tsx - Login and session → Authentication API: requests auth
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
backend/app/api/routes/auth.py - User authorization → JWT and password security: validates token
backend/app/api/deps.py - User authorization → User records: loads user
backend/app/api/deps.py - Authentication API → User records: reads and writes
backend/app/api/routes/auth.py - Ticket lifecycle API → Ticket records: manages tickets
backend/app/api/routes/tickets.py - Analytics API → Ticket records: queries metrics
backend/app/api/routes/analytics.py - Document ingestion API → File extraction: extracts uploads
backend/app/api/routes/ingest.py - Document ingestion API → Text chunking: chunks content
backend/app/api/routes/ingest.py - Document ingestion API → Embedding service: embeds chunks
backend/app/api/routes/ingest.py - Document ingestion API → Document and chunk records: stores documents
backend/app/api/routes/ingest.py - Query and triage API → Similarity retrieval: retrieves context
backend/app/api/routes/query.py - Query and triage API → LangGraph triage: runs triage
backend/app/api/routes/query.py - Query and triage API → Ticket records: updates ticket
backend/app/api/routes/query.py - Query and triage API → Document and chunk records: logs resolutions
backend/app/api/routes/query.py - Similarity retrieval → Embedding service: embeds query
backend/app/services/retrieval_service.py - Similarity retrieval → Document and chunk records: reads chunks
backend/app/services/retrieval_service.py - LangGraph triage → LLM gateway: generates drafts
backend/app/services/agent_service.py - OpenAI problem solver → LLM gateway: uses gateway
- SQLAlchemy sessions → PostgreSQL: connects
backend/app/core/database.py - User records → SQLAlchemy sessions: uses base
backend/app/models/user.py - Ticket records → SQLAlchemy sessions: uses base
backend/app/models/ticket.py - Document and chunk records → SQLAlchemy sessions: uses base
backend/app/models/document.py