# sabarinath1805-loyal/vaultr-ai architecture

> Architecture diagram of the GitHub repository sabarinath1805-loyal/vaultr-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/sabarinath1805-loyal/vaultr-ai
- Repository: https://github.com/sabarinath1805-loyal/vaultr-ai

## Overview

Mike is a legal AI platform for document review, drafting, research, and reusable workflows. A typical user works in the web app or Word add-in, opens or uploads legal material, then chats with it, reviews suggested edits, or runs a tabular or assistant workflow. The backend routes requests through domain services and chat engines, with Supabase for application data and R2-compatible storage for files. The graph preserves README-documented capabilities; links between unsampled subsystems are omitted where their implementation relationship is not evidenced.

Main entry points: [`backend/src/lib/supabase.ts`](https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/lib/supabase.ts) (Supabase), [`backend/src/modules/chat/chat.routes.ts`](https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/modules/chat/chat.routes.ts) (Legal chat), [`backend/src/modules/chat/engine`](https://github.com/sabarinath1805-loyal/vaultr-ai/tree/main/backend/src/modules/chat/engine) (Chat engine), [`backend/src/modules/documents`](https://github.com/sabarinath1805-loyal/vaultr-ai/tree/main/backend/src/modules/documents) (Documents)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User experiences"]
  node_web["Web app"]
  node_word["Word add-in<br/>[App.tsx]"]
end

subgraph group_domain["Legal workspaces"]
  node_documents["Documents"]
  node_projects["Projects"]
  node_library["Library"]
  node_uploads["Uploads"]
end

subgraph group_assistant["AI and workflows"]
  node_chat["Legal chat<br/>[chat.routes.ts]"]
  node_chatengine["Chat engine"]
  node_tabular["Tabular review<br/>[tabular.routes.ts]"]
  node_workflows["Workflows"]
  node_wordchat["Word chat API<br/>[wordChat.routes.ts]"]
  node_research["Case research<br/>[courtlistener.ts]"]
  node_models["Model providers<br/>[providers.ts]"]
end

subgraph group_platform["Backend platform"]
  node_api["API routes<br/>[app.ts]"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_database[("Supabase<br/>[supabase.ts]")]
  node_storage[("Object storage<br/>[storage.ts]")]
  node_memory["Memory scheduling<br/>[schedule.ts]"]
end

node_user(("Legal user"))
node_externalmodels{{"Model services"}}
node_courtlistener{{"CourtListener"}}

node_user -->|"uses"| node_web
node_user -->|"uses"| node_word
node_web -.->|"requests"| node_api
node_word -.->|"chats through"| node_wordchat
node_auth -->|"authenticates with"| node_database
node_chat -->|"invokes"| node_chatengine
node_chat -->|"schedules"| node_memory
node_chat -->|"reads and writes"| node_database
node_tabular -->|"reads and writes"| node_database
node_workflows -->|"reads and writes"| node_database
node_documents -->|"reads and writes"| node_database
node_projects -->|"reads and writes"| node_database
node_documents -.->|"stores files"| node_storage
node_uploads -.->|"stores files"| node_storage
node_chatengine -.->|"selects providers"| node_models
node_models -.->|"calls"| node_externalmodels
node_chatengine -.->|"supports research"| node_research
node_research -.->|"queries cases"| node_courtlistener

click node_web "https://github.com/sabarinath1805-loyal/vaultr-ai/tree/main/frontend/src/app"
click node_word "https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/word-addin/src/taskpane/App.tsx"
click node_api "https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/app.ts"
click node_auth "https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/middleware/auth.ts"
click node_documents "https://github.com/sabarinath1805-loyal/vaultr-ai/tree/main/backend/src/modules/documents"
click node_projects "https://github.com/sabarinath1805-loyal/vaultr-ai/tree/main/backend/src/modules/projects"
click node_library "https://github.com/sabarinath1805-loyal/vaultr-ai/tree/main/backend/src/modules/library"
click node_uploads "https://github.com/sabarinath1805-loyal/vaultr-ai/tree/main/backend/src/modules/uploads"
click node_chat "https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/modules/chat/chat.routes.ts"
click node_chatengine "https://github.com/sabarinath1805-loyal/vaultr-ai/tree/main/backend/src/modules/chat/engine"
click node_tabular "https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/modules/tabular/tabular.routes.ts"
click node_workflows "https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/modules/workflows/workflows.routes.ts"
click node_wordchat "https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/modules/word-chat/wordChat.routes.ts"
click node_research "https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/lib/courtlistener.ts"
click node_models "https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/lib/llm/providers.ts"
click node_database "https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/lib/supabase.ts"
click node_storage "https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/lib/storage.ts"
click node_memory "https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/lib/memory/schedule.ts"

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_web,node_word,node_user toneBlue
class node_documents,node_projects,node_library,node_uploads toneAmber
class node_chat,node_chatengine,node_tabular,node_workflows,node_wordchat,node_research,node_models toneMint
class node_api,node_auth,node_database,node_storage,node_memory toneRose
class node_externalmodels,node_courtlistener toneIndigo
```

## Components

### User experiences

- [Web app](https://github.com/sabarinath1805-loyal/vaultr-ai/tree/main/frontend/src/app): `frontend/src/app`
- [Word add-in](https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/word-addin/src/taskpane/App.tsx): `word-addin/src/taskpane/App.tsx`

### Legal workspaces

- [Documents](https://github.com/sabarinath1805-loyal/vaultr-ai/tree/main/backend/src/modules/documents): `backend/src/modules/documents`
- [Projects](https://github.com/sabarinath1805-loyal/vaultr-ai/tree/main/backend/src/modules/projects): `backend/src/modules/projects`
- [Library](https://github.com/sabarinath1805-loyal/vaultr-ai/tree/main/backend/src/modules/library): `backend/src/modules/library`
- [Uploads](https://github.com/sabarinath1805-loyal/vaultr-ai/tree/main/backend/src/modules/uploads): `backend/src/modules/uploads`

### AI and workflows

- [Legal chat](https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/modules/chat/chat.routes.ts): `backend/src/modules/chat/chat.routes.ts`
- [Chat engine](https://github.com/sabarinath1805-loyal/vaultr-ai/tree/main/backend/src/modules/chat/engine): `backend/src/modules/chat/engine`
- [Tabular review](https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/modules/tabular/tabular.routes.ts): `backend/src/modules/tabular/tabular.routes.ts`
- [Workflows](https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/modules/workflows/workflows.routes.ts): `backend/src/modules/workflows/workflows.routes.ts`
- [Word chat API](https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/modules/word-chat/wordChat.routes.ts): `backend/src/modules/word-chat/wordChat.routes.ts`
- [Case research](https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/lib/courtlistener.ts): `backend/src/lib/courtlistener.ts`
- [Model providers](https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/lib/llm/providers.ts): `backend/src/lib/llm/providers.ts`

### Backend platform

- [API routes](https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Authentication](https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/middleware/auth.ts): `backend/src/middleware/auth.ts`
- [Supabase](https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/lib/supabase.ts): `backend/src/lib/supabase.ts`
- [Object storage](https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/lib/storage.ts): `backend/src/lib/storage.ts`
- [Memory scheduling](https://github.com/sabarinath1805-loyal/vaultr-ai/blob/main/backend/src/lib/memory/schedule.ts): `backend/src/lib/memory/schedule.ts`

### Other components

- **Legal user**
- **Model services**
- **CourtListener**

## Connections

- Legal user → Web app: uses (evidence: `README.md`)
- Legal user → Word add-in: uses (evidence: `README.md`)
- Web app → API routes: requests
- Word add-in → Word chat API: chats through
- Authentication → Supabase: authenticates with (evidence: `backend/src/middleware/auth.ts`)
- Legal chat → Chat engine: invokes (evidence: `backend/src/modules/chat/chat.routes.ts`)
- Legal chat → Memory scheduling: schedules (evidence: `backend/src/modules/chat/chat.routes.ts`)
- Legal chat → Supabase: reads and writes (evidence: `backend/src/modules/chat/chat.routes.ts`)
- Tabular review → Supabase: reads and writes (evidence: `backend/src/modules/tabular/tabular.routes.ts`)
- Workflows → Supabase: reads and writes (evidence: `backend/src/modules/workflows/workflows.routes.ts`)
- Documents → Supabase: reads and writes (evidence: `backend/src/modules/documents/documents.routes.ts`)
- Projects → Supabase: reads and writes (evidence: `backend/src/modules/projects/projects.routes.ts`)
- Documents → Object storage: stores files (evidence: `backend/src/modules/documents/documents.routes.ts`)
- Uploads → Object storage: stores files
- Chat engine → Model providers: selects providers
- Model providers → Model services: calls (evidence: `README.md`)
- Chat engine → Case research: supports research (evidence: `README.md`)
- Case research → CourtListener: queries cases (evidence: `README.md`)
