# titung77/ai-b2b-platform architecture

> Architecture diagram of the GitHub repository titung77/ai-b2b-platform, 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/titung77/ai-b2b-platform
- Repository: https://github.com/titung77/ai-b2b-platform

## Overview

This is a customer-support product: an organization configures a support widget in the web dashboard, embeds it on a site, and visitors can start a contact session and use chat or voice support. The repository also contains conversation management, files, billing, integrations, and Vapi plugin areas. Source evidence is limited to the README and indexed excerpts, so several documented or listed subsystems are shown without speculative call paths.

Main entry points: [`apps/widget/modules/widget/ui/screens`](https://github.com/titung77/ai-b2b-platform/tree/main/apps/widget/modules/widget/ui/screens) (Widget screens), [`packages/backend/convex/schema.ts`](https://github.com/titung77/ai-b2b-platform/blob/main/packages/backend/convex/schema.ts) (Convex data), [`apps/web/app/(dashboard)/page.tsx`](https://github.com/titung77/ai-b2b-platform/blob/main/apps/web/app/(dashboard)/page.tsx) (Dashboard app), [`apps/embed/embed.ts`](https://github.com/titung77/ai-b2b-platform/blob/main/apps/embed/embed.ts) (Embed launcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web dashboard"]
  node_web_app["Dashboard app<br/>[page.tsx]"]
  node_auth["Authentication"]
  node_conversations["Conversation management"]
  node_customization["Widget customization"]
  node_files["Knowledge files"]
  node_billing["Billing"]
  node_integrations["Integrations"]
  node_vapi_plugin["Vapi plugin"]
end

subgraph group_widget["Customer widget"]
  node_embed["Embed launcher<br/>[embed.ts]"]
  node_widget_app["Widget app<br/>[page.tsx]"]
  node_widget_flow["Widget screens"]
  node_widget_state["Widget state<br/>[widget-atoms.ts]"]
  node_vapi_client["Vapi voice client<br/>[use-vapi.ts]"]
end

subgraph group_backend["Backend services"]
  node_api_sessions["Public contact sessions<br/>[contactSessions.ts]"]
  node_system_sessions["Session lifecycle<br/>[contactSessions.ts]"]
  node_backend_data[("Convex data<br/>[schema.ts]")]
end

subgraph group_ai["AI support"]
  node_support_agent["Support agent<br/>[supportAgent.ts]"]
  node_rag["Retrieval setup<br/>[rag.ts]"]
  node_ai_search["Knowledge search<br/>[search.ts]"]
end

node_operator(("Organization operator"))
node_visitor(("Website visitor"))

node_operator -->|"manages support"| node_web_app
node_visitor -.->|"opens widget"| node_embed
node_embed -->|"loads iframe"| node_widget_app
node_web_app -->|"adds user"| node_backend_data
node_widget_app -.->|"starts widget"| node_widget_flow
node_widget_flow -->|"updates state"| node_widget_state
node_widget_flow -->|"creates session"| node_api_sessions
node_api_sessions -->|"writes session"| node_backend_data
node_system_sessions -->|"reads and updates"| node_backend_data
node_support_agent -.->|"invokes search"| node_ai_search
node_ai_search -.->|"uses retrieval"| node_rag
node_widget_flow -.->|"offers voice"| node_vapi_client

click node_web_app "https://github.com/titung77/ai-b2b-platform/blob/main/apps/web/app/(dashboard)/page.tsx"
click node_auth "https://github.com/titung77/ai-b2b-platform/tree/main/apps/web/modules/auth/ui"
click node_conversations "https://github.com/titung77/ai-b2b-platform/tree/main/apps/web/modules/dashboard/ui"
click node_customization "https://github.com/titung77/ai-b2b-platform/tree/main/apps/web/modules/customization/ui"
click node_files "https://github.com/titung77/ai-b2b-platform/tree/main/apps/web/modules/files/ui"
click node_billing "https://github.com/titung77/ai-b2b-platform/tree/main/apps/web/modules/billing/ui"
click node_integrations "https://github.com/titung77/ai-b2b-platform/tree/main/apps/web/modules/integrations/ui"
click node_vapi_plugin "https://github.com/titung77/ai-b2b-platform/tree/main/apps/web/modules/plugins/ui"
click node_embed "https://github.com/titung77/ai-b2b-platform/blob/main/apps/embed/embed.ts"
click node_widget_app "https://github.com/titung77/ai-b2b-platform/blob/main/apps/widget/app/page.tsx"
click node_widget_flow "https://github.com/titung77/ai-b2b-platform/tree/main/apps/widget/modules/widget/ui/screens"
click node_widget_state "https://github.com/titung77/ai-b2b-platform/blob/main/apps/widget/modules/widget/atoms/widget-atoms.ts"
click node_vapi_client "https://github.com/titung77/ai-b2b-platform/blob/main/apps/widget/modules/widget/hooks/use-vapi.ts"
click node_api_sessions "https://github.com/titung77/ai-b2b-platform/blob/main/packages/backend/convex/public/contactSessions.ts"
click node_system_sessions "https://github.com/titung77/ai-b2b-platform/blob/main/packages/backend/convex/system/contactSessions.ts"
click node_backend_data "https://github.com/titung77/ai-b2b-platform/blob/main/packages/backend/convex/schema.ts"
click node_support_agent "https://github.com/titung77/ai-b2b-platform/blob/main/packages/backend/convex/system/ai/agents/supportAgent.ts"
click node_rag "https://github.com/titung77/ai-b2b-platform/blob/main/packages/backend/convex/system/ai/rag.ts"
click node_ai_search "https://github.com/titung77/ai-b2b-platform/blob/main/packages/backend/convex/system/ai/tools/search.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_app,node_auth,node_conversations,node_customization,node_files,node_billing,node_integrations,node_vapi_plugin toneBlue
class node_embed,node_widget_app,node_widget_flow,node_widget_state,node_vapi_client toneAmber
class node_api_sessions,node_system_sessions,node_backend_data toneMint
class node_support_agent,node_rag,node_ai_search toneRose
class node_operator,node_visitor toneIndigo
```

## Components

### Web dashboard

- [Dashboard app](https://github.com/titung77/ai-b2b-platform/blob/main/apps/web/app/(dashboard)/page.tsx): `apps/web/app/(dashboard)/page.tsx`
- [Authentication](https://github.com/titung77/ai-b2b-platform/tree/main/apps/web/modules/auth/ui): `apps/web/modules/auth/ui`
- [Conversation management](https://github.com/titung77/ai-b2b-platform/tree/main/apps/web/modules/dashboard/ui): `apps/web/modules/dashboard/ui`
- [Widget customization](https://github.com/titung77/ai-b2b-platform/tree/main/apps/web/modules/customization/ui): `apps/web/modules/customization/ui`
- [Knowledge files](https://github.com/titung77/ai-b2b-platform/tree/main/apps/web/modules/files/ui): `apps/web/modules/files/ui`
- [Billing](https://github.com/titung77/ai-b2b-platform/tree/main/apps/web/modules/billing/ui): `apps/web/modules/billing/ui`
- [Integrations](https://github.com/titung77/ai-b2b-platform/tree/main/apps/web/modules/integrations/ui): `apps/web/modules/integrations/ui`
- [Vapi plugin](https://github.com/titung77/ai-b2b-platform/tree/main/apps/web/modules/plugins/ui): `apps/web/modules/plugins/ui`

### Customer widget

- [Embed launcher](https://github.com/titung77/ai-b2b-platform/blob/main/apps/embed/embed.ts): `apps/embed/embed.ts`
- [Widget app](https://github.com/titung77/ai-b2b-platform/blob/main/apps/widget/app/page.tsx): `apps/widget/app/page.tsx`
- [Widget screens](https://github.com/titung77/ai-b2b-platform/tree/main/apps/widget/modules/widget/ui/screens): `apps/widget/modules/widget/ui/screens`
- [Widget state](https://github.com/titung77/ai-b2b-platform/blob/main/apps/widget/modules/widget/atoms/widget-atoms.ts): `apps/widget/modules/widget/atoms/widget-atoms.ts`
- [Vapi voice client](https://github.com/titung77/ai-b2b-platform/blob/main/apps/widget/modules/widget/hooks/use-vapi.ts): `apps/widget/modules/widget/hooks/use-vapi.ts`

### Backend services

- [Public contact sessions](https://github.com/titung77/ai-b2b-platform/blob/main/packages/backend/convex/public/contactSessions.ts): `packages/backend/convex/public/contactSessions.ts`
- [Session lifecycle](https://github.com/titung77/ai-b2b-platform/blob/main/packages/backend/convex/system/contactSessions.ts): `packages/backend/convex/system/contactSessions.ts`
- [Convex data](https://github.com/titung77/ai-b2b-platform/blob/main/packages/backend/convex/schema.ts): `packages/backend/convex/schema.ts`

### AI support

- [Support agent](https://github.com/titung77/ai-b2b-platform/blob/main/packages/backend/convex/system/ai/agents/supportAgent.ts): `packages/backend/convex/system/ai/agents/supportAgent.ts`
- [Retrieval setup](https://github.com/titung77/ai-b2b-platform/blob/main/packages/backend/convex/system/ai/rag.ts): `packages/backend/convex/system/ai/rag.ts`
- [Knowledge search](https://github.com/titung77/ai-b2b-platform/blob/main/packages/backend/convex/system/ai/tools/search.ts): `packages/backend/convex/system/ai/tools/search.ts`

### Other components

- **Organization operator**
- **Website visitor**

## Connections

- Organization operator → Dashboard app: manages support
- Website visitor → Embed launcher: opens widget
- Embed launcher → Widget app: loads iframe (evidence: `apps/embed/embed.ts`)
- Dashboard app → Convex data: adds user (evidence: `apps/web/app/(dashboard)/page.tsx`)
- Widget app → Widget screens: starts widget
- Widget screens → Widget state: updates state (evidence: `apps/widget/modules/widget/ui/screens/widget-auth-screen.tsx`)
- Widget screens → Public contact sessions: creates session (evidence: `apps/widget/modules/widget/ui/screens/widget-auth-screen.tsx`)
- Public contact sessions → Convex data: writes session (evidence: `packages/backend/convex/public/contactSessions.ts`)
- Session lifecycle → Convex data: reads and updates (evidence: `packages/backend/convex/system/contactSessions.ts`)
- Support agent → Knowledge search: invokes search (evidence: `packages/backend/convex/system/ai/tools/search.ts`)
- Knowledge search → Retrieval setup: uses retrieval (evidence: `packages/backend/convex/system/ai/tools/search.ts`)
- Widget screens → Vapi voice client: offers voice
