# mokshamehta06/embedded-voice-assistant architecture

> Architecture diagram of the GitHub repository mokshamehta06/embedded-voice-assistant, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mokshamehta06/embedded-voice-assistant
- Repository: https://github.com/mokshamehta06/embedded-voice-assistant

## Overview

This repository provides a web dashboard for configuring an embeddable voice/browser assistant, with a Node/Express API for accounts, assistant sessions, and paid plans. The main workflow is dashboard setup, visitor interaction through the widget, server-side Gemini reasoning and browser-tool steps, then plan-based usage and billing. The graph includes documented dashboard pages and server subsystems; several runtime integrations are represented only where sampled source or the source index supports their connections.

Main entry points: [`server/app.js`](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/app.js) (Express application), [`client/vite-project/src/App.jsx`](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/client/vite-project/src/App.jsx) (Dashboard router), [`server/Controllers/assistant.controller.js`](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Controllers/assistant.controller.js) (Assistant controller), [`server/Services/agentService.js`](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Services/agentService.js) (Agent reasoning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard"]
  node_app["Dashboard router<br/>[App.jsx]"]
  node_home["Home page<br/>[Home.jsx]"]
  node_services["Service showcase"]
  node_preview["Assistant preview"]
  node_builder["Assistant builder<br/>[Buider.jsx]"]
  node_login["Login page<br/>[Login.jsx]"]
end

subgraph group_assistant["Assistant Runtime"]
  node_widget["Embeddable widget<br/>[assistant.js]"]
  node_assistantroute["Assistant routes<br/>[assistant.route.js]"]
  node_assistantcontroller["Assistant controller"]
  node_agent["Agent reasoning<br/>[agentService.js]"]
  node_gemini["Gemini integration<br/>[gemini.js]"]
  node_tools["Browser tool catalog<br/>[tools.js]"]
  node_bridge["Browser session bridge<br/>[browserBridge.js]"]
  node_mcp["MCP server<br/>[mcpServer.js]"]
  node_encrypt["Key encryption<br/>[encryption.js]"]
end

subgraph group_api["API and Accounts"]
  node_server["Express application<br/>[app.js]"]
  node_authroutes["Auth routes<br/>[auth.routes.js]"]
  node_auth["Account auth<br/>[auth.controller.js]"]
  node_useroutes["User routes<br/>[user.routes.js]"]
  node_usercontroller["User settings<br/>[user.controller.js]"]
  node_guard["Session guard<br/>[isAuth.js]"]
  node_users[("User records<br/>[user.model.js]")]
end

subgraph group_billing["Billing"]
  node_billingui["Billing page<br/>[Billing.jsx]"]
  node_billingroute["Billing routes<br/>[billing.route.js]"]
  node_billingcontroller["Billing operations"]
  node_billingrecords[("Billing records<br/>[billing.model.js]")]
end

node_user(("Dashboard user"))
node_web(("Visitor website"))
node_razorpay["Razorpay gateway"]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_builder
node_app -->|"routes to"| node_billingui
node_home -->|"renders"| node_services
node_home -->|"renders"| node_preview
node_web -.->|"loads"| node_widget
node_server -->|"serves static"| node_widget
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_useroutes
node_server -->|"mounts"| node_assistantroute
node_server -->|"mounts"| node_billingroute
node_authroutes -->|"dispatches"| node_auth
node_auth -->|"reads and writes"| node_users
node_useroutes -->|"guards requests"| node_guard
node_useroutes -->|"dispatches"| node_usercontroller
node_usercontroller -->|"reads and writes"| node_users
node_assistantroute -->|"dispatches"| node_assistantcontroller
node_assistantcontroller -->|"reads and updates"| node_users
node_assistantcontroller -->|"decrypts key"| node_encrypt
node_assistantcontroller -->|"delegates turns"| node_agent
node_assistantcontroller -->|"handles MCP"| node_mcp
node_agent -->|"requests model turns"| node_gemini
node_agent -->|"loads tools"| node_tools
node_agent -->|"manages sessions"| node_bridge
node_agent -->|"decrypts key"| node_encrypt
node_mcp -->|"uses tools"| node_tools
node_mcp -->|"uses bridge"| node_bridge
node_billingroute -->|"guards requests"| node_guard
node_billingroute -->|"dispatches"| node_billingcontroller
node_billingcontroller -->|"creates orders"| node_razorpay
node_billingcontroller -->|"reads and writes"| node_billingrecords
node_billingcontroller -->|"updates plan"| node_users

click node_app "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/client/vite-project/src/App.jsx"
click node_home "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/client/vite-project/src/pages/Home.jsx"
click node_services "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/client/vite-project/src/components/AccordionServices.jsx"
click node_preview "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/client/vite-project/src/components/AssistantPreview.jsx"
click node_builder "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/client/vite-project/src/pages/Buider.jsx"
click node_login "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/client/vite-project/src/pages/Login.jsx"
click node_billingui "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/client/vite-project/src/pages/Billing.jsx"
click node_widget "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/public/assistant.js"
click node_server "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/app.js"
click node_authroutes "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Routes/auth.routes.js"
click node_auth "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Controllers/auth.controller.js"
click node_useroutes "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Routes/user.routes.js"
click node_usercontroller "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Controllers/user.controller.js"
click node_guard "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Middleware/isAuth.js"
click node_users "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Models/user.model.js"
click node_assistantroute "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Routes/assistant.route.js"
click node_assistantcontroller "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Controllers/assistant.controller.js"
click node_agent "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Services/agentService.js"
click node_gemini "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Config/gemini.js"
click node_tools "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/mcp/tools.js"
click node_bridge "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/mcp/browserBridge.js"
click node_mcp "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/mcp/mcpServer.js"
click node_encrypt "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Utils/encryption.js"
click node_billingroute "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Routes/billing.route.js"
click node_billingcontroller "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Controllers/billing.controller.js"
click node_billingrecords "https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Models/billing.model.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_home,node_services,node_preview,node_builder,node_login,node_user toneBlue
class node_widget,node_assistantroute,node_assistantcontroller,node_agent,node_gemini,node_tools,node_bridge,node_mcp,node_encrypt toneAmber
class node_server,node_authroutes,node_auth,node_useroutes,node_usercontroller,node_guard,node_users toneMint
class node_billingui,node_billingroute,node_billingcontroller,node_billingrecords toneRose
class node_web,node_razorpay toneIndigo
```

## Components

### Dashboard

- [Dashboard router](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/client/vite-project/src/App.jsx): `client/vite-project/src/App.jsx`
- [Home page](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/client/vite-project/src/pages/Home.jsx): `client/vite-project/src/pages/Home.jsx`
- [Service showcase](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/client/vite-project/src/components/AccordionServices.jsx): `client/vite-project/src/components/AccordionServices.jsx`
- [Assistant preview](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/client/vite-project/src/components/AssistantPreview.jsx): `client/vite-project/src/components/AssistantPreview.jsx`
- [Assistant builder](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/client/vite-project/src/pages/Buider.jsx): `client/vite-project/src/pages/Buider.jsx`
- [Login page](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/client/vite-project/src/pages/Login.jsx): `client/vite-project/src/pages/Login.jsx`

### Assistant Runtime

- [Embeddable widget](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/public/assistant.js): `server/public/assistant.js`
- [Assistant routes](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Routes/assistant.route.js): `server/Routes/assistant.route.js`
- [Assistant controller](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Controllers/assistant.controller.js): `server/Controllers/assistant.controller.js`
- [Agent reasoning](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Services/agentService.js): `server/Services/agentService.js`
- [Gemini integration](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Config/gemini.js): `server/Config/gemini.js`
- [Browser tool catalog](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/mcp/tools.js): `server/mcp/tools.js`
- [Browser session bridge](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/mcp/browserBridge.js): `server/mcp/browserBridge.js`
- [MCP server](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/mcp/mcpServer.js): `server/mcp/mcpServer.js`
- [Key encryption](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Utils/encryption.js): `server/Utils/encryption.js`

### API and Accounts

- [Express application](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/app.js): `server/app.js`
- [Auth routes](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Routes/auth.routes.js): `server/Routes/auth.routes.js`
- [Account auth](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Controllers/auth.controller.js): `server/Controllers/auth.controller.js`
- [User routes](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Routes/user.routes.js): `server/Routes/user.routes.js`
- [User settings](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Controllers/user.controller.js): `server/Controllers/user.controller.js`
- [Session guard](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Middleware/isAuth.js): `server/Middleware/isAuth.js`
- [User records](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Models/user.model.js): `server/Models/user.model.js`

### Billing

- [Billing page](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/client/vite-project/src/pages/Billing.jsx): `client/vite-project/src/pages/Billing.jsx`
- [Billing routes](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Routes/billing.route.js): `server/Routes/billing.route.js`
- [Billing operations](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Controllers/billing.controller.js): `server/Controllers/billing.controller.js`
- [Billing records](https://github.com/mokshamehta06/embedded-voice-assistant/blob/main/server/Models/billing.model.js): `server/Models/billing.model.js`

### Other components

- **Dashboard user**
- **Visitor website**
- **Razorpay gateway**

## Connections

- Dashboard user → Dashboard router: uses
- Dashboard router → Home page: routes to (evidence: `client/vite-project/src/App.jsx`)
- Dashboard router → Login page: routes to (evidence: `client/vite-project/src/App.jsx`)
- Dashboard router → Assistant builder: routes to (evidence: `client/vite-project/src/App.jsx`)
- Dashboard router → Billing page: routes to (evidence: `client/vite-project/src/App.jsx`)
- Home page → Service showcase: renders (evidence: `client/vite-project/src/pages/Home.jsx`)
- Home page → Assistant preview: renders (evidence: `client/vite-project/src/pages/Home.jsx`)
- Visitor website → Embeddable widget: loads
- Express application → Embeddable widget: serves static (evidence: `server/app.js`)
- Express application → Auth routes: mounts (evidence: `server/app.js`)
- Express application → User routes: mounts (evidence: `server/app.js`)
- Express application → Assistant routes: mounts (evidence: `server/app.js`)
- Express application → Billing routes: mounts (evidence: `server/app.js`)
- Auth routes → Account auth: dispatches (evidence: `server/Routes/auth.routes.js`)
- Account auth → User records: reads and writes (evidence: `server/Controllers/auth.controller.js`)
- User routes → Session guard: guards requests (evidence: `server/Routes/user.routes.js`)
- User routes → User settings: dispatches (evidence: `server/Routes/user.routes.js`)
- User settings → User records: reads and writes (evidence: `server/Controllers/user.controller.js`)
- Assistant routes → Assistant controller: dispatches (evidence: `server/Routes/assistant.route.js`)
- Assistant controller → User records: reads and updates (evidence: `server/Controllers/assistant.controller.js`)
- Assistant controller → Key encryption: decrypts key (evidence: `server/Controllers/assistant.controller.js`)
- Assistant controller → Agent reasoning: delegates turns (evidence: `server/Controllers/assistant.controller.js`)
- Assistant controller → MCP server: handles MCP (evidence: `server/Controllers/assistant.controller.js`)
- Agent reasoning → Gemini integration: requests model turns (evidence: `server/Services/agentService.js`)
- Agent reasoning → Browser tool catalog: loads tools (evidence: `server/Services/agentService.js`)
- Agent reasoning → Browser session bridge: manages sessions (evidence: `server/Services/agentService.js`)
- Agent reasoning → Key encryption: decrypts key (evidence: `server/Services/agentService.js`)
- MCP server → Browser tool catalog: uses tools (evidence: `server/mcp/mcpServer.js`)
- MCP server → Browser session bridge: uses bridge (evidence: `server/mcp/mcpServer.js`)
- Billing routes → Session guard: guards requests (evidence: `server/Routes/billing.route.js`)
- Billing routes → Billing operations: dispatches (evidence: `server/Routes/billing.route.js`)
- Billing operations → Razorpay gateway: creates orders (evidence: `server/Controllers/billing.controller.js`)
- Billing operations → Billing records: reads and writes (evidence: `server/Controllers/billing.controller.js`)
- Billing operations → User records: updates plan (evidence: `server/Controllers/billing.controller.js`)
