# dhinakaran311/legal_research_assistant architecture

> Architecture diagram of the GitHub repository dhinakaran311/legal_research_assistant, 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/dhinakaran311/legal_research_assistant
- Repository: https://github.com/dhinakaran311/legal_research_assistant

## Overview

The product is an Indian-law research assistant: users search or chat in the web app, requests pass through the backend to the AI engine, and results combine legal-document retrieval, graph references, and answer synthesis. The documented data-ingestion branch collects and loads legal material into the retrieval stores. Source excerpts show the query pipeline and its agent stages; several broader capabilities, including adaptive RAG and GraphQL, are documented but their runtime internals were not sampled.

Main entry points: [`ai_engine/src/agents/agentic_pipeline.py`](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/agents/agentic_pipeline.py) (Agentic pipeline), [`backend/src/index.js`](https://github.com/dhinakaran311/legal_research_assistant/blob/main/backend/src/index.js) (Backend API), [`ai_engine/src/pipeline_factory.py`](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/pipeline_factory.py) (Pipeline factory), [`ai_engine/src/routes/chat.py`](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/routes/chat.py) (Chat route)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_webapp["Search and chat<br/>[page.tsx]"]
  node_chatui["Chat interface<br/>[page.tsx]"]
end

subgraph group_backend["Backend services"]
  node_backendapi["Backend API<br/>[index.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_chatservice["Chat service<br/>[chatService.js]"]
  node_aiclient["AI engine client<br/>[aiEngineClient.js]"]
  node_postgres[("User database<br/>[seed.js]")]
end

subgraph group_ai["AI research"]
  node_engine["AI API<br/>[main.py]"]
  node_queryroutes["Query routes<br/>[query.py]"]
  node_adaptive["Adaptive RAG<br/>[adaptive_rag.py]"]
  node_chatroute["Chat route<br/>[chat.py]"]
  node_factory["Pipeline factory"]
  node_orchestrator["Agentic pipeline"]
  node_planner["Query planning<br/>[planner_agent.py]"]
  node_localresearch["Local research"]
  node_webresearch["Web research"]
  node_conflict["Conflict checking"]
  node_synthesis["Answer synthesis<br/>[synthesis_agent.py]"]
  node_memory["Conversation memory<br/>[memory.py]"]
  node_resolver["Query resolver<br/>[query_resolver.py]"]
end

subgraph group_knowledge["Legal knowledge"]
  node_chroma[("Vector store<br/>[chroma_client.py]")]
  node_neo4j[("Legal knowledge graph<br/>[neo4j_client.py]")]
end

subgraph group_ingestion["Data ingestion"]
  node_scrapers["Legal sources"]
  node_vectorloader["Vector data loader"]
  node_graphloader["Graph data loader"]
end

node_user(("Researcher"))
node_legalweb["Legal websites"]

node_user -->|"searches"| node_webapp
node_user -->|"asks questions"| node_chatui
node_webapp -->|"sends requests"| node_backendapi
node_chatui -->|"sends requests"| node_backendapi
node_backendapi -.->|"authenticates"| node_auth
node_backendapi -.->|"handles chat"| node_chatservice
node_chatservice -.->|"requests answers"| node_aiclient
node_backendapi -.->|"stores user data"| node_postgres
node_backendapi -->|"calls over HTTP"| node_engine
node_engine -->|"registers routes"| node_queryroutes
node_engine -->|"registers routes"| node_chatroute
node_queryroutes -->|"gets pipeline"| node_factory
node_queryroutes -.->|"offers adaptive search"| node_adaptive
node_chatroute -->|"gets pipeline"| node_factory
node_chatroute -->|"uses history"| node_memory
node_chatroute -->|"resolves references"| node_resolver
node_resolver -->|"reads turns"| node_memory
node_factory -->|"creates pipeline"| node_orchestrator
node_factory -->|"creates client"| node_chroma
node_factory -->|"creates client"| node_neo4j
node_orchestrator -->|"plans query"| node_planner
node_orchestrator -->|"retrieves local evidence"| node_localresearch
node_orchestrator -->|"escalates research"| node_webresearch
node_orchestrator -->|"checks conflicts"| node_conflict
node_orchestrator -->|"synthesizes answer"| node_synthesis
node_localresearch -->|"searches documents"| node_chroma
node_localresearch -.->|"retrieves graph facts"| node_neo4j
node_webresearch -->|"fetches legal material"| node_legalweb
node_scrapers -.->|"collects documents"| node_legalweb
node_vectorloader -->|"loads documents"| node_chroma
node_graphloader -->|"loads relationships"| node_neo4j

click node_webapp "https://github.com/dhinakaran311/legal_research_assistant/blob/main/frontend/app/search/page.tsx"
click node_chatui "https://github.com/dhinakaran311/legal_research_assistant/blob/main/frontend/app/chat/page.tsx"
click node_backendapi "https://github.com/dhinakaran311/legal_research_assistant/blob/main/backend/src/index.js"
click node_auth "https://github.com/dhinakaran311/legal_research_assistant/blob/main/backend/src/api/auth.js"
click node_chatservice "https://github.com/dhinakaran311/legal_research_assistant/blob/main/backend/src/services/chatService.js"
click node_aiclient "https://github.com/dhinakaran311/legal_research_assistant/blob/main/backend/src/services/aiEngineClient.js"
click node_postgres "https://github.com/dhinakaran311/legal_research_assistant/blob/main/backend/prisma/seed.js"
click node_engine "https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/main.py"
click node_queryroutes "https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/routes/query.py"
click node_adaptive "https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/pipelines/adaptive_rag.py"
click node_chatroute "https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/routes/chat.py"
click node_factory "https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/pipeline_factory.py"
click node_orchestrator "https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/agents/agentic_pipeline.py"
click node_planner "https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/agents/planner_agent.py"
click node_localresearch "https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/agents/local_research_agent.py"
click node_webresearch "https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/agents/web_research_agent.py"
click node_conflict "https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/agents/conflict_checker_agent.py"
click node_synthesis "https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/agents/synthesis_agent.py"
click node_memory "https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/conversation/memory.py"
click node_resolver "https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/conversation/query_resolver.py"
click node_chroma "https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/vectorstore/chroma_client.py"
click node_neo4j "https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/graph/neo4j_client.py"
click node_scrapers "https://github.com/dhinakaran311/legal_research_assistant/blob/main/data_ingestion/sources/multi_act_scraper.py"
click node_vectorloader "https://github.com/dhinakaran311/legal_research_assistant/blob/main/data_ingestion/loaders/load_multi_act_data.py"
click node_graphloader "https://github.com/dhinakaran311/legal_research_assistant/blob/main/data_ingestion/loaders/load_multi_act_to_neo4j.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_webapp,node_chatui toneBlue
class node_backendapi,node_auth,node_chatservice,node_aiclient,node_postgres toneAmber
class node_engine,node_queryroutes,node_adaptive,node_chatroute,node_factory,node_orchestrator,node_planner,node_localresearch,node_webresearch,node_conflict,node_synthesis,node_memory,node_resolver toneMint
class node_chroma,node_neo4j toneRose
class node_scrapers,node_vectorloader,node_graphloader,node_user,node_legalweb toneIndigo
```

## Components

### Web experience

- [Search and chat](https://github.com/dhinakaran311/legal_research_assistant/blob/main/frontend/app/search/page.tsx): `frontend/app/search/page.tsx`
- [Chat interface](https://github.com/dhinakaran311/legal_research_assistant/blob/main/frontend/app/chat/page.tsx): `frontend/app/chat/page.tsx`

### Backend services

- [Backend API](https://github.com/dhinakaran311/legal_research_assistant/blob/main/backend/src/index.js): `backend/src/index.js`
- [Authentication](https://github.com/dhinakaran311/legal_research_assistant/blob/main/backend/src/api/auth.js): `backend/src/api/auth.js`
- [Chat service](https://github.com/dhinakaran311/legal_research_assistant/blob/main/backend/src/services/chatService.js): `backend/src/services/chatService.js`
- [AI engine client](https://github.com/dhinakaran311/legal_research_assistant/blob/main/backend/src/services/aiEngineClient.js): `backend/src/services/aiEngineClient.js`
- [User database](https://github.com/dhinakaran311/legal_research_assistant/blob/main/backend/prisma/seed.js): `backend/prisma/seed.js`

### AI research

- [AI API](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/main.py): `ai_engine/src/main.py`
- [Query routes](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/routes/query.py): `ai_engine/src/routes/query.py`
- [Adaptive RAG](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/pipelines/adaptive_rag.py): `ai_engine/src/pipelines/adaptive_rag.py`
- [Chat route](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/routes/chat.py): `ai_engine/src/routes/chat.py`
- [Pipeline factory](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/pipeline_factory.py): `ai_engine/src/pipeline_factory.py`
- [Agentic pipeline](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/agents/agentic_pipeline.py): `ai_engine/src/agents/agentic_pipeline.py`
- [Query planning](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/agents/planner_agent.py): `ai_engine/src/agents/planner_agent.py`
- [Local research](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/agents/local_research_agent.py): `ai_engine/src/agents/local_research_agent.py`
- [Web research](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/agents/web_research_agent.py): `ai_engine/src/agents/web_research_agent.py`
- [Conflict checking](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/agents/conflict_checker_agent.py): `ai_engine/src/agents/conflict_checker_agent.py`
- [Answer synthesis](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/agents/synthesis_agent.py): `ai_engine/src/agents/synthesis_agent.py`
- [Conversation memory](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/conversation/memory.py): `ai_engine/src/conversation/memory.py`
- [Query resolver](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/conversation/query_resolver.py): `ai_engine/src/conversation/query_resolver.py`

### Legal knowledge

- [Vector store](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/vectorstore/chroma_client.py): `ai_engine/src/vectorstore/chroma_client.py`
- [Legal knowledge graph](https://github.com/dhinakaran311/legal_research_assistant/blob/main/ai_engine/src/graph/neo4j_client.py): `ai_engine/src/graph/neo4j_client.py`

### Data ingestion

- [Legal sources](https://github.com/dhinakaran311/legal_research_assistant/blob/main/data_ingestion/sources/multi_act_scraper.py): `data_ingestion/sources/multi_act_scraper.py`
- [Vector data loader](https://github.com/dhinakaran311/legal_research_assistant/blob/main/data_ingestion/loaders/load_multi_act_data.py): `data_ingestion/loaders/load_multi_act_data.py`
- [Graph data loader](https://github.com/dhinakaran311/legal_research_assistant/blob/main/data_ingestion/loaders/load_multi_act_to_neo4j.py): `data_ingestion/loaders/load_multi_act_to_neo4j.py`

### Other components

- **Researcher**
- **Legal websites**

## Connections

- Researcher → Search and chat: searches
- Researcher → Chat interface: asks questions
- Search and chat → Backend API: sends requests
- Chat interface → Backend API: sends requests
- Backend API → Authentication: authenticates
- Backend API → Chat service: handles chat
- Chat service → AI engine client: requests answers
- Backend API → User database: stores user data
- Backend API → AI API: calls over HTTP
- AI API → Query routes: registers routes (evidence: `ai_engine/src/main.py`)
- AI API → Chat route: registers routes (evidence: `ai_engine/src/main.py`)
- Query routes → Pipeline factory: gets pipeline (evidence: `ai_engine/src/routes/query.py`)
- Query routes → Adaptive RAG: offers adaptive search
- Chat route → Pipeline factory: gets pipeline (evidence: `ai_engine/src/routes/chat.py`)
- Chat route → Conversation memory: uses history (evidence: `ai_engine/src/routes/chat.py`)
- Chat route → Query resolver: resolves references (evidence: `ai_engine/src/routes/chat.py`)
- Query resolver → Conversation memory: reads turns (evidence: `ai_engine/src/conversation/query_resolver.py`)
- Pipeline factory → Agentic pipeline: creates pipeline (evidence: `ai_engine/src/pipeline_factory.py`)
- Pipeline factory → Vector store: creates client (evidence: `ai_engine/src/pipeline_factory.py`)
- Pipeline factory → Legal knowledge graph: creates client (evidence: `ai_engine/src/pipeline_factory.py`)
- Agentic pipeline → Query planning: plans query (evidence: `ai_engine/src/agents/agentic_pipeline.py`)
- Agentic pipeline → Local research: retrieves local evidence (evidence: `ai_engine/src/agents/agentic_pipeline.py`)
- Agentic pipeline → Web research: escalates research (evidence: `ai_engine/src/agents/agentic_pipeline.py`)
- Agentic pipeline → Conflict checking: checks conflicts (evidence: `ai_engine/src/agents/agentic_pipeline.py`)
- Agentic pipeline → Answer synthesis: synthesizes answer (evidence: `ai_engine/src/agents/agentic_pipeline.py`)
- Local research → Vector store: searches documents (evidence: `ai_engine/src/agents/local_research_agent.py`)
- Local research → Legal knowledge graph: retrieves graph facts
- Web research → Legal websites: fetches legal material (evidence: `ai_engine/src/agents/web_research_agent.py`)
- Legal sources → Legal websites: collects documents
- Vector data loader → Vector store: loads documents
- Graph data loader → Legal knowledge graph: loads relationships (evidence: `data_ingestion/loaders/load_multi_act_to_neo4j.py`)
