# sanjaynesan-05/meetingbuddy architecture

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

- Interactive diagram: https://gitdiagram.com/sanjaynesan-05/meetingbuddy
- Repository: https://github.com/sanjaynesan-05/meetingbuddy

## Overview

AI Meeting Intelligence is a full-stack application that turns uploaded meeting recordings into searchable transcripts and actionable insights. The main workflow is authenticated upload, local speech transcription with progress persisted to meeting records, AI analysis, and embedding/indexing for later search and cited RAG chat. The client also presents meeting management, analytics, tasks, calendar export, and notifications. The graph combines the supplied source excerpts and index with README-documented capabilities; several UI-to-API and auxiliary backend implementations were not sampled, so those relationships are documented rather than source-verified.

Main entry points: [`server/controllers/meetingController.js`](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/controllers/meetingController.js) (Meeting controller), [`client/src/App.jsx`](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/client/src/App.jsx) (App routing), [`server/services/embeddings/embedding.service.js`](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/services/embeddings/embedding.service.js) (Transcript embedding), [`server/services/ai/ragRetrieval.service.js`](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/services/ai/ragRetrieval.service.js) (RAG retrieval)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App routing<br/>[App.jsx]"]
  node_authui["Authentication UI<br/>[AuthContext.jsx]"]
  node_meetingui["Meetings and transcript UI"]
  node_chatui["Chat UI<br/>[AIChatPage.jsx]"]
  node_workspaceui["Workspace dashboards"]
end

subgraph group_meeting["Meeting processing"]
  node_meetingapi["Meeting controller"]
  node_transcription["Speech transcription"]
  node_analysis["Meeting analysis"]
end

subgraph group_ai["AI and retrieval"]
  node_embeddings["Transcript embedding"]
  node_chatapi["Chat controller<br/>[chatController.js]"]
  node_rag["RAG retrieval"]
  node_semantic["Semantic retrieval"]
  node_search["Meeting search<br/>[search.service.js]"]
  node_vectordb[("Qdrant vectors<br/>[qdrantStorage.js]")]
end

subgraph group_workspace["Workspace features"]
  node_workspaceapi["Workspace APIs"]
  node_calendar["Calendar integrations"]
  node_notifications["Notifications"]
end

subgraph group_identity["Identity and data"]
  node_authapi["Authentication API<br/>[authController.js]"]
  node_authguard["JWT guard<br/>[auth.js]"]
  node_meetingdb[("Meeting records<br/>[Meeting.js]")]
  node_chunkdb[("Transcript chunks<br/>[MeetingChunk.js]")]
end

node_user(("Meeting user"))
node_ollama{{"Local Ollama"}}
node_transcriber{{"Local Whisper"}}

node_user -->|"uses"| node_app
node_app -->|"provides auth"| node_authui
node_app -->|"routes to"| node_meetingui
node_app -->|"routes to"| node_chatui
node_app -->|"routes to"| node_workspaceui
node_authui -.->|"authenticates with"| node_authapi
node_meetingui -.->|"uploads and requests"| node_meetingapi
node_meetingapi -->|"creates and updates"| node_meetingdb
node_meetingapi -->|"transcribes media"| node_transcription
node_transcription -->|"runs locally"| node_transcriber
node_meetingapi -->|"processes transcript"| node_analysis
node_meetingapi -->|"indexes transcript"| node_embeddings
node_embeddings -->|"updates status"| node_meetingdb
node_embeddings -->|"persists chunks"| node_chunkdb
node_embeddings -->|"upserts vectors"| node_vectordb
node_chatui -.->|"asks questions"| node_chatapi
node_chatapi -->|"retrieves context"| node_rag
node_rag -->|"tries hybrid search"| node_search
node_rag -->|"fallback reads"| node_meetingdb
node_rag -->|"fallback reads"| node_chunkdb
node_search -.->|"uses vector search"| node_vectordb
node_chatapi -.->|"generates answers"| node_ollama
node_meetingapi -.->|"requires identity"| node_authguard
node_workspaceui -.->|"loads analytics"| node_workspaceapi
node_user -.->|"exports events"| node_calendar
node_user -.->|"receives reminders"| node_notifications

click node_app "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/client/src/App.jsx"
click node_authui "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/client/src/context/AuthContext.jsx"
click node_meetingui "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/client/src/pages/MeetingTranscript.jsx"
click node_chatui "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/client/src/pages/AIChatPage.jsx"
click node_workspaceui "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/client/src/pages/AnalyticsDashboard.jsx"
click node_authapi "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/controllers/authController.js"
click node_authguard "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/middleware/auth.js"
click node_meetingapi "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/controllers/meetingController.js"
click node_transcription "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/services/transcriptionService.js"
click node_analysis "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/services/ai/processors/meeting.processor.js"
click node_embeddings "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/services/embeddings/embedding.service.js"
click node_chatapi "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/controllers/chatController.js"
click node_rag "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/services/ai/ragRetrieval.service.js"
click node_semantic "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/src/modules/ai/services/retrievalService.js"
click node_search "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/services/search/search.service.js"
click node_meetingdb "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/models/Meeting.js"
click node_chunkdb "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/models/MeetingChunk.js"
click node_vectordb "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/services/embeddings/qdrantStorage.js"
click node_workspaceapi "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/controllers/analyticsController.js"
click node_calendar "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/controllers/calendarController.js"
click node_notifications "https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/controllers/notificationController.js"

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_app,node_authui,node_meetingui,node_chatui,node_workspaceui,node_user toneBlue
class node_meetingapi,node_transcription,node_analysis toneAmber
class node_embeddings,node_chatapi,node_rag,node_semantic,node_search,node_vectordb toneMint
class node_workspaceapi,node_calendar,node_notifications toneRose
class node_authapi,node_authguard,node_meetingdb,node_chunkdb,node_ollama,node_transcriber toneIndigo
```

## Components

### Web client

- [App routing](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Authentication UI](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Meetings and transcript UI](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/client/src/pages/MeetingTranscript.jsx): `client/src/pages/MeetingTranscript.jsx`
- [Chat UI](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/client/src/pages/AIChatPage.jsx): `client/src/pages/AIChatPage.jsx`
- [Workspace dashboards](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/client/src/pages/AnalyticsDashboard.jsx): `client/src/pages/AnalyticsDashboard.jsx`

### Meeting processing

- [Meeting controller](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/controllers/meetingController.js): `server/controllers/meetingController.js`
- [Speech transcription](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/services/transcriptionService.js): `server/services/transcriptionService.js`
- [Meeting analysis](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/services/ai/processors/meeting.processor.js): `server/services/ai/processors/meeting.processor.js`

### AI and retrieval

- [Transcript embedding](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/services/embeddings/embedding.service.js): `server/services/embeddings/embedding.service.js`
- [Chat controller](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/controllers/chatController.js): `server/controllers/chatController.js`
- [RAG retrieval](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/services/ai/ragRetrieval.service.js): `server/services/ai/ragRetrieval.service.js`
- [Semantic retrieval](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/src/modules/ai/services/retrievalService.js): `server/src/modules/ai/services/retrievalService.js`
- [Meeting search](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/services/search/search.service.js): `server/services/search/search.service.js`
- [Qdrant vectors](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/services/embeddings/qdrantStorage.js): `server/services/embeddings/qdrantStorage.js`

### Workspace features

- [Workspace APIs](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/controllers/analyticsController.js): `server/controllers/analyticsController.js`
- [Calendar integrations](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/controllers/calendarController.js): `server/controllers/calendarController.js`
- [Notifications](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/controllers/notificationController.js): `server/controllers/notificationController.js`

### Identity and data

- [Authentication API](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [JWT guard](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/middleware/auth.js): `server/middleware/auth.js`
- [Meeting records](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/models/Meeting.js): `server/models/Meeting.js`
- [Transcript chunks](https://github.com/sanjaynesan-05/meetingbuddy/blob/main/server/models/MeetingChunk.js): `server/models/MeetingChunk.js`

### Other components

- **Meeting user**
- **Local Ollama**
- **Local Whisper**

## Connections

- Meeting user → App routing: uses
- App routing → Authentication UI: provides auth (evidence: `client/src/App.jsx`)
- App routing → Meetings and transcript UI: routes to (evidence: `client/src/App.jsx`)
- App routing → Chat UI: routes to (evidence: `client/src/App.jsx`)
- App routing → Workspace dashboards: routes to (evidence: `client/src/App.jsx`)
- Authentication UI → Authentication API: authenticates with
- Meetings and transcript UI → Meeting controller: uploads and requests
- Meeting controller → Meeting records: creates and updates (evidence: `server/controllers/meetingController.js`)
- Meeting controller → Speech transcription: transcribes media (evidence: `server/controllers/meetingController.js`)
- Speech transcription → Local Whisper: runs locally
- Meeting controller → Meeting analysis: processes transcript (evidence: `server/controllers/meetingController.js`)
- Meeting controller → Transcript embedding: indexes transcript (evidence: `server/controllers/meetingController.js`)
- Transcript embedding → Meeting records: updates status (evidence: `server/services/embeddings/embedding.service.js`)
- Transcript embedding → Transcript chunks: persists chunks (evidence: `server/services/embeddings/embedding.service.js`)
- Transcript embedding → Qdrant vectors: upserts vectors (evidence: `server/services/embeddings/embedding.service.js`)
- Chat UI → Chat controller: asks questions
- Chat controller → RAG retrieval: retrieves context
- RAG retrieval → Meeting search: tries hybrid search (evidence: `server/services/ai/ragRetrieval.service.js`)
- RAG retrieval → Meeting records: fallback reads (evidence: `server/services/ai/ragRetrieval.service.js`)
- RAG retrieval → Transcript chunks: fallback reads (evidence: `server/services/ai/ragRetrieval.service.js`)
- Meeting search → Qdrant vectors: uses vector search
- Chat controller → Local Ollama: generates answers
- Meeting controller → JWT guard: requires identity
- Workspace dashboards → Workspace APIs: loads analytics
- Meeting user → Calendar integrations: exports events
- Meeting user → Notifications: receives reminders
