# karthi-as-dev/vanigan-ai architecture

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

- Interactive diagram: https://gitdiagram.com/karthi-as-dev/vanigan-ai
- Repository: https://github.com/karthi-as-dev/vanigan-ai

## Overview

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: [`backend/app/agents/supervisor.py`](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/agents/supervisor.py) (Supervisor Routing), [`backend/app/main.py`](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/main.py) (FastAPI Application), [`backend/app/api/v1/chat.py`](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/api/v1/chat.py) (Chat API), [`backend/app/auth/permissions.py`](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/auth/permissions.py) (RBAC)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Experience"]
  node_chat_ui["Chat Interface<br/>[ChatInterface.tsx]"]
  node_documents_ui["Documents Page<br/>[page.tsx]"]
  node_workflows_ui["Workflows Page<br/>[page.tsx]"]
  node_dashboard_ui["Dashboard<br/>[page.tsx]"]
end

subgraph group_api["API and Access"]
  node_api_app["FastAPI Application<br/>[main.py]"]
  node_chat_api["Chat API<br/>[chat.py]"]
  node_auth_api["Authentication API<br/>[auth.py]"]
  node_rbac["RBAC<br/>[permissions.py]"]
  node_database[("Relational Data<br/>[database.py]")]
end

subgraph group_intelligence["Conversation Intelligence"]
  node_supervisor["Supervisor Routing<br/>[supervisor.py]"]
  node_specialists["Specialist Agents"]
  node_intent["Intent Analysis<br/>[intent.py]"]
  node_sentiment["Sentiment Analysis<br/>[sentiment.py]"]
  node_agent_base["Agent Processing<br/>[base.py]"]
  node_llm["LLM Client<br/>[llm.py]"]
end

subgraph group_knowledge["Knowledge and Memory"]
  node_documents_api["Document API<br/>[documents.py]"]
  node_loaders["Document Loaders<br/>[loaders.py]"]
  node_rag["RAG Retrieval<br/>[pipeline.py]"]
  node_embeddings["Embeddings<br/>[embeddings.py]"]
  node_reranker["Reranker<br/>[reranker.py]"]
  node_memory["Conversation Memory<br/>[manager.py]"]
end

subgraph group_operations["Automation and Analytics"]
  node_workflow_api["Workflow API<br/>[workflows.py]"]
  node_worker["Task Worker<br/>[worker.py]"]
  node_workflow_tasks["Workflow Tasks<br/>[tasks.py]"]
  node_analytics["Analytics API<br/>[analytics.py]"]
end

node_employee(("Employee"))

node_employee -.->|"asks"| node_chat_ui
node_employee -.->|"manages documents"| node_documents_ui
node_employee -.->|"views workflows"| node_workflows_ui
node_employee -.->|"views metrics"| node_dashboard_ui
node_chat_ui -.->|"sends messages"| node_chat_api
node_documents_ui -.->|"uses API"| node_documents_api
node_workflows_ui -.->|"uses API"| node_workflow_api
node_dashboard_ui -.->|"uses API"| node_analytics
node_api_app -->|"mounts route"| node_auth_api
node_api_app -->|"mounts route"| node_chat_api
node_api_app -->|"mounts route"| node_documents_api
node_api_app -->|"mounts route"| node_workflow_api
node_api_app -->|"mounts route"| node_analytics
node_auth_api -->|"queries users"| node_database
node_auth_api -->|"uses dependency"| node_rbac
node_rbac -->|"loads user"| node_database
node_rbac -->|"decodes tokens"| node_auth_api
node_chat_api -->|"delegates message"| node_supervisor
node_chat_api -->|"uses memory"| node_memory
node_chat_api -->|"checks access"| node_rbac
node_supervisor -->|"processes with"| node_agent_base
node_supervisor -->|"routes to"| node_specialists
node_supervisor -->|"classifies intent"| node_intent
node_supervisor -->|"analyzes sentiment"| node_sentiment
node_supervisor -->|"loads context"| node_memory
node_agent_base -->|"retrieves documents"| node_rag
node_agent_base -->|"generates response"| node_llm
node_documents_api -->|"loads documents"| node_loaders
node_documents_api -->|"indexes documents"| node_rag
node_rag -->|"creates embeddings"| node_embeddings
node_rag -->|"reranks results"| node_reranker
node_workflow_api -->|"dispatches tasks"| node_worker
node_worker -->|"registers tasks"| node_workflow_tasks
node_workflow_tasks -->|"uses persistence"| node_database
node_analytics -->|"queries metrics"| node_database
node_analytics -->|"checks access"| node_rbac

click node_chat_ui "https://github.com/karthi-as-dev/vanigan-ai/blob/main/frontend/src/components/chat/ChatInterface.tsx"
click node_documents_ui "https://github.com/karthi-as-dev/vanigan-ai/blob/main/frontend/src/app/documents/page.tsx"
click node_workflows_ui "https://github.com/karthi-as-dev/vanigan-ai/blob/main/frontend/src/app/workflows/page.tsx"
click node_dashboard_ui "https://github.com/karthi-as-dev/vanigan-ai/blob/main/frontend/src/app/dashboard/page.tsx"
click node_api_app "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/main.py"
click node_chat_api "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/api/v1/chat.py"
click node_auth_api "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/api/v1/auth.py"
click node_rbac "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/auth/permissions.py"
click node_database "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/core/database.py"
click node_supervisor "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/agents/supervisor.py"
click node_specialists "https://github.com/karthi-as-dev/vanigan-ai/tree/main/backend/app/agents"
click node_intent "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/models/intent.py"
click node_sentiment "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/models/sentiment.py"
click node_agent_base "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/agents/base.py"
click node_llm "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/models/llm.py"
click node_documents_api "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/api/v1/documents.py"
click node_loaders "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/rag/loaders.py"
click node_rag "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/rag/pipeline.py"
click node_embeddings "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/rag/embeddings.py"
click node_reranker "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/rag/reranker.py"
click node_memory "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/memory/manager.py"
click node_workflow_api "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/api/v1/workflows.py"
click node_worker "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/worker.py"
click node_workflow_tasks "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/workflows/tasks.py"
click node_analytics "https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/api/v1/analytics.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_chat_ui,node_documents_ui,node_workflows_ui,node_dashboard_ui toneBlue
class node_api_app,node_chat_api,node_auth_api,node_rbac,node_database toneAmber
class node_supervisor,node_specialists,node_intent,node_sentiment,node_agent_base,node_llm toneMint
class node_documents_api,node_loaders,node_rag,node_embeddings,node_reranker,node_memory toneRose
class node_workflow_api,node_worker,node_workflow_tasks,node_analytics,node_employee toneIndigo
```

## Components

### User Experience

- [Chat Interface](https://github.com/karthi-as-dev/vanigan-ai/blob/main/frontend/src/components/chat/ChatInterface.tsx): `frontend/src/components/chat/ChatInterface.tsx`
- [Documents Page](https://github.com/karthi-as-dev/vanigan-ai/blob/main/frontend/src/app/documents/page.tsx): `frontend/src/app/documents/page.tsx`
- [Workflows Page](https://github.com/karthi-as-dev/vanigan-ai/blob/main/frontend/src/app/workflows/page.tsx): `frontend/src/app/workflows/page.tsx`
- [Dashboard](https://github.com/karthi-as-dev/vanigan-ai/blob/main/frontend/src/app/dashboard/page.tsx): `frontend/src/app/dashboard/page.tsx`

### API and Access

- [FastAPI Application](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/main.py): `backend/app/main.py`
- [Chat API](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/api/v1/chat.py): `backend/app/api/v1/chat.py`
- [Authentication API](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/api/v1/auth.py): `backend/app/api/v1/auth.py`
- [RBAC](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/auth/permissions.py): `backend/app/auth/permissions.py`
- [Relational Data](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/core/database.py): `backend/app/core/database.py`

### Conversation Intelligence

- [Supervisor Routing](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/agents/supervisor.py): `backend/app/agents/supervisor.py`
- [Specialist Agents](https://github.com/karthi-as-dev/vanigan-ai/tree/main/backend/app/agents): `backend/app/agents`
- [Intent Analysis](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/models/intent.py): `backend/app/models/intent.py`
- [Sentiment Analysis](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/models/sentiment.py): `backend/app/models/sentiment.py`
- [Agent Processing](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/agents/base.py): `backend/app/agents/base.py`
- [LLM Client](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/models/llm.py): `backend/app/models/llm.py`

### Knowledge and Memory

- [Document API](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/api/v1/documents.py): `backend/app/api/v1/documents.py`
- [Document Loaders](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/rag/loaders.py): `backend/app/rag/loaders.py`
- [RAG Retrieval](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/rag/pipeline.py): `backend/app/rag/pipeline.py`
- [Embeddings](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/rag/embeddings.py): `backend/app/rag/embeddings.py`
- [Reranker](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/rag/reranker.py): `backend/app/rag/reranker.py`
- [Conversation Memory](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/memory/manager.py): `backend/app/memory/manager.py`

### Automation and Analytics

- [Workflow API](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/api/v1/workflows.py): `backend/app/api/v1/workflows.py`
- [Task Worker](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/worker.py): `backend/app/worker.py`
- [Workflow Tasks](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/workflows/tasks.py): `backend/app/workflows/tasks.py`
- [Analytics API](https://github.com/karthi-as-dev/vanigan-ai/blob/main/backend/app/api/v1/analytics.py): `backend/app/api/v1/analytics.py`

### Other components

- **Employee**

## Connections

- 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 (evidence: `backend/app/main.py`)
- FastAPI Application → Chat API: mounts route (evidence: `backend/app/main.py`)
- FastAPI Application → Document API: mounts route (evidence: `backend/app/main.py`)
- FastAPI Application → Workflow API: mounts route (evidence: `backend/app/main.py`)
- FastAPI Application → Analytics API: mounts route (evidence: `backend/app/main.py`)
- Authentication API → Relational Data: queries users (evidence: `backend/app/api/v1/auth.py`)
- Authentication API → RBAC: uses dependency (evidence: `backend/app/api/v1/auth.py`)
- RBAC → Relational Data: loads user (evidence: `backend/app/auth/permissions.py`)
- RBAC → Authentication API: decodes tokens (evidence: `backend/app/auth/permissions.py`)
- Chat API → Supervisor Routing: delegates message (evidence: `backend/app/api/v1/chat.py`)
- Chat API → Conversation Memory: uses memory (evidence: `backend/app/api/v1/chat.py`)
- Chat API → RBAC: checks access (evidence: `backend/app/api/v1/chat.py`)
- Supervisor Routing → Agent Processing: processes with (evidence: `backend/app/agents/supervisor.py`)
- Supervisor Routing → Specialist Agents: routes to (evidence: `backend/app/agents/supervisor.py`)
- Supervisor Routing → Intent Analysis: classifies intent (evidence: `backend/app/agents/supervisor.py`)
- Supervisor Routing → Sentiment Analysis: analyzes sentiment (evidence: `backend/app/agents/supervisor.py`)
- Supervisor Routing → Conversation Memory: loads context (evidence: `backend/app/agents/supervisor.py`)
- Agent Processing → RAG Retrieval: retrieves documents (evidence: `backend/app/agents/base.py`)
- Agent Processing → LLM Client: generates response (evidence: `backend/app/agents/base.py`)
- Document API → Document Loaders: loads documents (evidence: `backend/app/api/v1/documents.py`)
- Document API → RAG Retrieval: indexes documents (evidence: `backend/app/api/v1/documents.py`)
- RAG Retrieval → Embeddings: creates embeddings (evidence: `backend/app/rag/pipeline.py`)
- RAG Retrieval → Reranker: reranks results (evidence: `backend/app/rag/pipeline.py`)
- Workflow API → Task Worker: dispatches tasks (evidence: `backend/app/api/v1/workflows.py`)
- Task Worker → Workflow Tasks: registers tasks (evidence: `backend/app/worker.py`)
- Workflow Tasks → Relational Data: uses persistence (evidence: `backend/app/workflows/tasks.py`)
- Analytics API → Relational Data: queries metrics (evidence: `backend/app/api/v1/analytics.py`)
- Analytics API → RBAC: checks access (evidence: `backend/app/api/v1/analytics.py`)
