How karthi-as-dev/vanigan-ai works
VANIGAN AI is an enterprise assistant whose main workflow is employee chat: the backend routes a message through intent and sentiment analysis to a specialist agent, which retrieves permission-filtered enterprise knowledge and generates a cited response. The product also includes authentication and RBAC, document ingestion, conversation memory, workflow automation, and analytics. The API-to-module links below are supported by the excerpts or SOURCE INDEX; frontend-to-backend wiring is not shown, so that connection is left unverified.
Main entry points: supervisor.py Supervisor Routing · main.py FastAPI Application · chat.py Chat API · permissions.py RBAC
Components 26
User Experience
- Chat Interface
frontend/src/components/chat/ChatInterface.tsx - Documents Page
frontend/src/app/documents/page.tsx - Workflows Page
frontend/src/app/workflows/page.tsx - Dashboard
frontend/src/app/dashboard/page.tsx
API and Access
- FastAPI Application
backend/app/main.py - Chat API
backend/app/api/v1/chat.py - Authentication API
backend/app/api/v1/auth.py - RBAC
backend/app/auth/permissions.py - Relational Data
backend/app/core/database.py
Conversation Intelligence
- Supervisor Routing
backend/app/agents/supervisor.py - Specialist Agents
backend/app/agents - Intent Analysis
backend/app/models/intent.py - Sentiment Analysis
backend/app/models/sentiment.py - Agent Processing
backend/app/agents/base.py - LLM Client
backend/app/models/llm.py
Knowledge and Memory
- Document API
backend/app/api/v1/documents.py - Document Loaders
backend/app/rag/loaders.py - RAG Retrieval
backend/app/rag/pipeline.py - Embeddings
backend/app/rag/embeddings.py - Reranker
backend/app/rag/reranker.py - Conversation Memory
backend/app/memory/manager.py
Automation and Analytics
- Workflow API
backend/app/api/v1/workflows.py - Task Worker
backend/app/worker.py - Workflow Tasks
backend/app/workflows/tasks.py - Analytics API
backend/app/api/v1/analytics.py
Other components
- Employee
Connections 36
- Employee → Chat Interface: asks
- Employee → Documents Page: manages documents
- Employee → Workflows Page: views workflows
- Employee → Dashboard: views metrics
- Chat Interface → Chat API: sends messages
- Documents Page → Document API: uses API
- Workflows Page → Workflow API: uses API
- Dashboard → Analytics API: uses API
- FastAPI Application → Authentication API: mounts route
backend/app/main.py - FastAPI Application → Chat API: mounts route
backend/app/main.py - FastAPI Application → Document API: mounts route
backend/app/main.py - FastAPI Application → Workflow API: mounts route
backend/app/main.py - FastAPI Application → Analytics API: mounts route
backend/app/main.py - Authentication API → Relational Data: queries users
backend/app/api/v1/auth.py - Authentication API → RBAC: uses dependency
backend/app/api/v1/auth.py - RBAC → Relational Data: loads user
backend/app/auth/permissions.py - RBAC → Authentication API: decodes tokens
backend/app/auth/permissions.py - Chat API → Supervisor Routing: delegates message
backend/app/api/v1/chat.py - Chat API → Conversation Memory: uses memory
backend/app/api/v1/chat.py - Chat API → RBAC: checks access
backend/app/api/v1/chat.py - Supervisor Routing → Agent Processing: processes with
backend/app/agents/supervisor.py - Supervisor Routing → Specialist Agents: routes to
backend/app/agents/supervisor.py - Supervisor Routing → Intent Analysis: classifies intent
backend/app/agents/supervisor.py - Supervisor Routing → Sentiment Analysis: analyzes sentiment
backend/app/agents/supervisor.py - Supervisor Routing → Conversation Memory: loads context
backend/app/agents/supervisor.py - Agent Processing → RAG Retrieval: retrieves documents
backend/app/agents/base.py - Agent Processing → LLM Client: generates response
backend/app/agents/base.py - Document API → Document Loaders: loads documents
backend/app/api/v1/documents.py - Document API → RAG Retrieval: indexes documents
backend/app/api/v1/documents.py - RAG Retrieval → Embeddings: creates embeddings
backend/app/rag/pipeline.py - RAG Retrieval → Reranker: reranks results
backend/app/rag/pipeline.py - Workflow API → Task Worker: dispatches tasks
backend/app/api/v1/workflows.py - Task Worker → Workflow Tasks: registers tasks
backend/app/worker.py - Workflow Tasks → Relational Data: uses persistence
backend/app/workflows/tasks.py - Analytics API → Relational Data: queries metrics
backend/app/api/v1/analytics.py - Analytics API → RBAC: checks access
backend/app/api/v1/analytics.py