# aditya-strategix/bhashabridge architecture

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

## Overview

BhashaBridge is a multilingual meeting platform. Users authenticate, manage organizations and meetings from the dashboard, join a meeting for real-time audio/video and chat, and can access transcripts, translated summaries, analytics, and reports afterward. The source excerpts substantiate the API/controller paths, organization invitations, summary generation, and socket notifications. The README documents broader meeting and accessibility capabilities; their implementation links are omitted where source evidence was not provided.

Main entry points: [`backend/src/app.js`](https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/app.js) (Express server), [`frontend/src/services/api.js`](https://github.com/aditya-strategix/bhashabridge/blob/main/frontend/src/services/api.js) (API client), [`frontend/src/app/meeting/[id]/page.js`](https://github.com/aditya-strategix/bhashabridge/blob/main/frontend/src/app/meeting/%5Bid%5D/page.js) (Meeting room), [`backend/src/controllers/meeting.controller.js`](https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/controllers/meeting.controller.js) (Meeting management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web experience"]
  node_dashboard["Dashboard<br/>[page.js]"]
  node_meetingui["Meeting room<br/>[page.js]"]
  node_reportui["Meeting report<br/>[page.js]"]
  node_authstate["Auth state<br/>[authStore.js]"]
  node_notifications["Invitation notifications"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["API workflows"]
  node_server["Express server<br/>[app.js]"]
  node_auth["Authentication<br/>[auth.controller.js]"]
  node_meetings["Meeting management"]
  node_organizations["Organization management"]
  node_admin["Administration"]
  node_analytics["Meeting analytics"]
end

subgraph group_realtime["Live meeting"]
  node_socket_server["Socket events<br/>[index.js]"]
end

subgraph group_intelligence["AI and reporting"]
  node_translation["Translation service"]
  node_ai["AI summaries<br/>[ai.service.js]"]
  node_email["Invitation email<br/>[email.service.js]"]
  node_speech["Speech-to-text and captions<br/>[tts.routes.js]"]
end

subgraph group_state["Persistence"]
  node_database[("Relational data<br/>[schema.prisma]")]
  node_cache[("Valkey cache")]
end

node_user(("Meeting user"))
node_gemini["Gemini API"]
node_translation_api["Translation provider"]
node_mail_service["Email service"]
node_speech_service["Speech provider"]

node_user -->|"uses"| node_dashboard
node_dashboard -->|"initializes"| node_authstate
node_dashboard -->|"requests data"| node_api_client
node_authstate -->|"calls"| node_api_client
node_api_client -->|"HTTP requests"| node_server
node_server -->|"routes auth"| node_auth
node_server -->|"routes meetings"| node_meetings
node_server -->|"routes organizations"| node_organizations
node_server -->|"routes analytics"| node_analytics
node_server -->|"routes admin"| node_admin
node_user -->|"joins"| node_meetingui
node_meetingui -->|"uses"| node_api_client
node_meetingui -.->|"real-time events"| node_socket_server
node_meetingui -.->|"captions"| node_speech
node_meetings -->|"reads and writes"| node_database
node_meetings -->|"caches summaries"| node_cache
node_meetings -->|"generates summaries"| node_ai
node_ai -->|"requests summary"| node_gemini
node_ai -->|"translates summary"| node_translation
node_translation -.->|"translates text"| node_translation_api
node_organizations -->|"reads and writes"| node_database
node_organizations -->|"sends invitations"| node_email
node_email -.->|"sends mail"| node_mail_service
node_notifications -.->|"registers listener"| node_socket_server
node_notifications -.->|"loads invitations"| node_api_client
node_analytics -.->|"reads meeting data"| node_database
node_admin -->|"reads and writes"| node_database
node_user -->|"views report"| node_reportui
node_reportui -.->|"requests report"| node_api_client
node_speech -.->|"speech recognition"| node_speech_service

click node_dashboard "https://github.com/aditya-strategix/bhashabridge/blob/main/frontend/src/app/dashboard/page.js"
click node_meetingui "https://github.com/aditya-strategix/bhashabridge/blob/main/frontend/src/app/meeting/%5Bid%5D/page.js"
click node_reportui "https://github.com/aditya-strategix/bhashabridge/blob/main/frontend/src/app/meeting/%5Bid%5D/report/page.js"
click node_authstate "https://github.com/aditya-strategix/bhashabridge/blob/main/frontend/src/stores/authStore.js"
click node_notifications "https://github.com/aditya-strategix/bhashabridge/blob/main/frontend/src/components/NotificationBell.js"
click node_api_client "https://github.com/aditya-strategix/bhashabridge/blob/main/frontend/src/services/api.js"
click node_server "https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/app.js"
click node_auth "https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/controllers/auth.controller.js"
click node_meetings "https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/controllers/meeting.controller.js"
click node_organizations "https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/controllers/organization.controller.js"
click node_admin "https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/controllers/admin.controller.js"
click node_analytics "https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/controllers/analytics.controller.js"
click node_socket_server "https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/socket/index.js"
click node_translation "https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/services/translation.service.js"
click node_ai "https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/services/ai.service.js"
click node_email "https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/services/email.service.js"
click node_speech "https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/routes/tts.routes.js"
click node_database "https://github.com/aditya-strategix/bhashabridge/blob/main/backend/prisma/schema.prisma"

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_dashboard,node_meetingui,node_reportui,node_authstate,node_notifications,node_api_client,node_user toneBlue
class node_server,node_auth,node_meetings,node_organizations,node_admin,node_analytics toneAmber
class node_socket_server,node_gemini toneMint
class node_translation,node_ai,node_email,node_speech toneRose
class node_database,node_cache,node_translation_api,node_mail_service,node_speech_service toneIndigo
```

## Components

### Web experience

- [Dashboard](https://github.com/aditya-strategix/bhashabridge/blob/main/frontend/src/app/dashboard/page.js): `frontend/src/app/dashboard/page.js`
- [Meeting room](https://github.com/aditya-strategix/bhashabridge/blob/main/frontend/src/app/meeting/%5Bid%5D/page.js): `frontend/src/app/meeting/[id]/page.js`
- [Meeting report](https://github.com/aditya-strategix/bhashabridge/blob/main/frontend/src/app/meeting/%5Bid%5D/report/page.js): `frontend/src/app/meeting/[id]/report/page.js`
- [Auth state](https://github.com/aditya-strategix/bhashabridge/blob/main/frontend/src/stores/authStore.js): `frontend/src/stores/authStore.js`
- [Invitation notifications](https://github.com/aditya-strategix/bhashabridge/blob/main/frontend/src/components/NotificationBell.js): `frontend/src/components/NotificationBell.js`
- [API client](https://github.com/aditya-strategix/bhashabridge/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### API workflows

- [Express server](https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/app.js): `backend/src/app.js`
- [Authentication](https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/controllers/auth.controller.js): `backend/src/controllers/auth.controller.js`
- [Meeting management](https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/controllers/meeting.controller.js): `backend/src/controllers/meeting.controller.js`
- [Organization management](https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/controllers/organization.controller.js): `backend/src/controllers/organization.controller.js`
- [Administration](https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/controllers/admin.controller.js): `backend/src/controllers/admin.controller.js`
- [Meeting analytics](https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/controllers/analytics.controller.js): `backend/src/controllers/analytics.controller.js`

### Live meeting

- [Socket events](https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/socket/index.js): `backend/src/socket/index.js`

### AI and reporting

- [Translation service](https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/services/translation.service.js): `backend/src/services/translation.service.js`
- [AI summaries](https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/services/ai.service.js): `backend/src/services/ai.service.js`
- [Invitation email](https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/services/email.service.js): `backend/src/services/email.service.js`
- [Speech-to-text and captions](https://github.com/aditya-strategix/bhashabridge/blob/main/backend/src/routes/tts.routes.js): `backend/src/routes/tts.routes.js`

### Persistence

- [Relational data](https://github.com/aditya-strategix/bhashabridge/blob/main/backend/prisma/schema.prisma): `backend/prisma/schema.prisma`
- **Valkey cache**

### Other components

- **Meeting user**
- **Gemini API**
- **Translation provider**
- **Email service**
- **Speech provider**

## Connections

- Meeting user → Dashboard: uses (evidence: `README.md`)
- Dashboard → Auth state: initializes (evidence: `frontend/src/app/dashboard/page.js`)
- Dashboard → API client: requests data (evidence: `frontend/src/app/dashboard/page.js`)
- Auth state → API client: calls (evidence: `frontend/src/stores/authStore.js`)
- API client → Express server: HTTP requests (evidence: `frontend/src/services/api.js`)
- Express server → Authentication: routes auth (evidence: `backend/src/app.js`)
- Express server → Meeting management: routes meetings (evidence: `backend/src/app.js`)
- Express server → Organization management: routes organizations (evidence: `backend/src/app.js`)
- Express server → Meeting analytics: routes analytics (evidence: `backend/src/app.js`)
- Express server → Administration: routes admin (evidence: `backend/src/app.js`)
- Meeting user → Meeting room: joins (evidence: `README.md`)
- Meeting room → API client: uses (evidence: `frontend/src/app/meeting/[id]/page.js`)
- Meeting room → Socket events: real-time events
- Meeting room → Speech-to-text and captions: captions (evidence: `README.md`)
- Meeting management → Relational data: reads and writes (evidence: `backend/src/controllers/meeting.controller.js`)
- Meeting management → Valkey cache: caches summaries (evidence: `backend/src/controllers/meeting.controller.js`)
- Meeting management → AI summaries: generates summaries (evidence: `backend/src/controllers/meeting.controller.js`)
- AI summaries → Gemini API: requests summary (evidence: `backend/src/services/ai.service.js`)
- AI summaries → Translation service: translates summary (evidence: `backend/src/services/ai.service.js`)
- Translation service → Translation provider: translates text
- Organization management → Relational data: reads and writes (evidence: `backend/src/controllers/organization.controller.js`)
- Organization management → Invitation email: sends invitations (evidence: `backend/src/controllers/organization.controller.js`)
- Invitation email → Email service: sends mail
- Invitation notifications → Socket events: registers listener (evidence: `frontend/src/components/NotificationBell.js`)
- Invitation notifications → API client: loads invitations (evidence: `frontend/src/components/NotificationBell.js`)
- Meeting analytics → Relational data: reads meeting data
- Administration → Relational data: reads and writes (evidence: `backend/src/controllers/admin.controller.js`)
- Meeting user → Meeting report: views report (evidence: `README.md`)
- Meeting report → API client: requests report (evidence: `frontend/src/app/meeting/[id]/report/page.js`)
- Speech-to-text and captions → Speech provider: speech recognition (evidence: `README.md`)
