# opencom-org/opencom architecture

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

- Interactive diagram: https://gitdiagram.com/opencom-org/opencom
- Repository: https://github.com/opencom-org/opencom

## Overview

Opencom is a multi-client customer messaging and engagement platform: support teams configure workspace content and campaigns in the web dashboard, while visitors use the web widget or mobile SDKs to chat, find help, and receive in-product guidance. Those clients use Convex backend functions for sessions and product data. The graph highlights the documented product stages and sampled runtime links; many backend features are represented by their exact module paths but their internal calls were not sampled, so those links are omitted rather than inferred.

Main entry points: [`apps/web/src/app`](https://github.com/opencom-org/opencom/tree/dev/apps/web/src/app) (Web dashboard), [`apps/widget/src/Widget.tsx`](https://github.com/opencom-org/opencom/blob/dev/apps/widget/src/Widget.tsx) (Embedded widget), [`apps/widget/src/main.tsx`](https://github.com/opencom-org/opencom/blob/dev/apps/widget/src/main.tsx) (Widget bootstrap), [`apps/mobile/app/(app)/inbox.tsx`](https://github.com/opencom-org/opencom/blob/dev/apps/mobile/app/(app)/inbox.tsx) (Admin mobile app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Workspace administration"]
  node_dashboard["Web dashboard"]
  node_workspace["Workspace settings"]
  node_outbound["Outbound editor"]
  node_helpadmin["Help content admin"]
  node_inbox["Conversation inbox"]
  node_campaigns["Campaigns and series"]
  node_analytics["Reports and segments"]
end

subgraph group_engage["Visitor engagement"]
  node_widget["Embedded widget<br/>[Widget.tsx]"]
  node_widgetentry["Widget bootstrap<br/>[main.tsx]"]
  node_session["Visitor sessions"]
  node_tour["Tour runtime"]
  node_webhelp["Help center<br/>[HelpCenter.tsx]"]
  node_tickets["Visitor tickets<br/>[TicketCreate.tsx]"]
end

subgraph group_backend["Platform backend"]
  node_seriesbackend["Series runtime<br/>[runtime.ts]"]
  node_supportbackend["Conversations and tickets<br/>[conversations.ts]"]
  node_contentbackend["Knowledge and imports<br/>[syncPipeline.ts]"]
  node_settingsbackend["Workspace and identity<br/>[authConvex.ts]"]
  node_engagementbackend["Campaigns and surveys"]
  node_reportbackend["Reporting<br/>[reporting.ts]"]
  node_schema[("Convex data model<br/>[schema.ts]")]
end

subgraph group_sdks["Mobile SDKs"]
  node_mobileapp["Admin mobile app<br/>[inbox.tsx]"]
  node_rn["React Native SDK"]
  node_ios["iOS SDK"]
  node_android["Android SDK<br/>[SessionManager.kt]"]
end

node_agents(("Support agents"))
node_visitors(("Website visitors"))
node_convex[("Convex service")]
node_resend["Resend email"]

node_agents -->|"manage workspace"| node_dashboard
node_dashboard -->|"configure"| node_workspace
node_dashboard -->|"edit messages"| node_outbound
node_dashboard -->|"manage articles"| node_helpadmin
node_dashboard -->|"reply to chats"| node_inbox
node_dashboard -->|"author campaigns"| node_campaigns
node_dashboard -->|"review metrics"| node_analytics
node_outbound -->|"load workspace"| node_workspace
node_visitors -->|"open widget"| node_widgetentry
node_widgetentry -->|"renders"| node_widget
node_widgetentry -->|"provides client"| node_convex
node_widget -.->|"starts session"| node_session
node_session -->|"boots session"| node_convex
node_widget -.->|"runs tours"| node_tour
node_widget -.->|"shows help"| node_webhelp
node_widget -.->|"creates tickets"| node_tickets
node_widget -.->|"loads product data"| node_convex
node_mobileapp -.->|"uses backend"| node_convex
node_rn -->|"queries conversations"| node_convex
node_rn -.->|"submits surveys"| node_convex
node_ios -->|"boots session"| node_convex
node_android -->|"calls API"| node_convex
node_dashboard -.->|"uses backend"| node_convex
node_mobileapp -.->|"uses backend"| node_convex
node_convex -.->|"persists records"| node_schema
node_convex -.->|"serves conversations"| node_supportbackend
node_convex -.->|"serves knowledge"| node_contentbackend
node_convex -.->|"handles identity"| node_settingsbackend
node_convex -.->|"serves campaigns"| node_engagementbackend
node_convex -.->|"runs sequences"| node_seriesbackend
node_convex -.->|"computes reports"| node_reportbackend
node_convex -.->|"sends email"| node_resend

click node_dashboard "https://github.com/opencom-org/opencom/tree/dev/apps/web/src/app"
click node_workspace "https://github.com/opencom-org/opencom/blob/dev/apps/web/src/app/settings/hooks/useSettingsPageController.ts"
click node_outbound "https://github.com/opencom-org/opencom/blob/dev/apps/web/src/app/outbound/hooks/useOutboundMessageEditorController.ts"
click node_helpadmin "https://github.com/opencom-org/opencom/tree/dev/apps/web/src/app/articles"
click node_inbox "https://github.com/opencom-org/opencom/tree/dev/apps/web/src/app/inbox"
click node_campaigns "https://github.com/opencom-org/opencom/tree/dev/apps/web/src/app/campaigns"
click node_analytics "https://github.com/opencom-org/opencom/tree/dev/apps/web/src/app/reports"
click node_widget "https://github.com/opencom-org/opencom/blob/dev/apps/widget/src/Widget.tsx"
click node_widgetentry "https://github.com/opencom-org/opencom/blob/dev/apps/widget/src/main.tsx"
click node_session "https://github.com/opencom-org/opencom/blob/dev/apps/widget/src/hooks/useWidgetSession.ts"
click node_tour "https://github.com/opencom-org/opencom/blob/dev/apps/widget/src/tourOverlay/useTourOverlaySession.ts"
click node_webhelp "https://github.com/opencom-org/opencom/blob/dev/apps/widget/src/components/HelpCenter.tsx"
click node_tickets "https://github.com/opencom-org/opencom/blob/dev/apps/widget/src/components/TicketCreate.tsx"
click node_seriesbackend "https://github.com/opencom-org/opencom/blob/dev/packages/convex/convex/series/runtime.ts"
click node_supportbackend "https://github.com/opencom-org/opencom/blob/dev/packages/convex/convex/conversations.ts"
click node_contentbackend "https://github.com/opencom-org/opencom/blob/dev/packages/convex/convex/helpCenterImports/syncPipeline.ts"
click node_settingsbackend "https://github.com/opencom-org/opencom/blob/dev/packages/convex/convex/authConvex.ts"
click node_engagementbackend "https://github.com/opencom-org/opencom/blob/dev/packages/convex/convex/outboundMessages.ts"
click node_reportbackend "https://github.com/opencom-org/opencom/blob/dev/packages/convex/convex/reporting.ts"
click node_schema "https://github.com/opencom-org/opencom/blob/dev/packages/convex/convex/schema.ts"
click node_mobileapp "https://github.com/opencom-org/opencom/blob/dev/apps/mobile/app/(app)/inbox.tsx"
click node_rn "https://github.com/opencom-org/opencom/blob/dev/packages/react-native-sdk/src/hooks/useConversations.ts"
click node_ios "https://github.com/opencom-org/opencom/blob/dev/packages/ios-sdk/Sources/OpencomSDK/Core/SessionManager.swift"
click node_android "https://github.com/opencom-org/opencom/blob/dev/packages/android-sdk/sdk/src/main/kotlin/com/opencom/sdk/core/SessionManager.kt"

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_workspace,node_outbound,node_helpadmin,node_inbox,node_campaigns,node_analytics toneBlue
class node_widget,node_widgetentry,node_session,node_tour,node_webhelp,node_tickets,node_convex toneAmber
class node_seriesbackend,node_supportbackend,node_contentbackend,node_settingsbackend,node_engagementbackend,node_reportbackend,node_schema toneMint
class node_mobileapp,node_rn,node_ios,node_android toneRose
class node_agents,node_visitors,node_resend toneIndigo
```

## Components

### Workspace administration

- [Web dashboard](https://github.com/opencom-org/opencom/tree/dev/apps/web/src/app): `apps/web/src/app`
- [Workspace settings](https://github.com/opencom-org/opencom/blob/dev/apps/web/src/app/settings/hooks/useSettingsPageController.ts): `apps/web/src/app/settings/hooks/useSettingsPageController.ts`
- [Outbound editor](https://github.com/opencom-org/opencom/blob/dev/apps/web/src/app/outbound/hooks/useOutboundMessageEditorController.ts): `apps/web/src/app/outbound/hooks/useOutboundMessageEditorController.ts`
- [Help content admin](https://github.com/opencom-org/opencom/tree/dev/apps/web/src/app/articles): `apps/web/src/app/articles`
- [Conversation inbox](https://github.com/opencom-org/opencom/tree/dev/apps/web/src/app/inbox): `apps/web/src/app/inbox`
- [Campaigns and series](https://github.com/opencom-org/opencom/tree/dev/apps/web/src/app/campaigns): `apps/web/src/app/campaigns`
- [Reports and segments](https://github.com/opencom-org/opencom/tree/dev/apps/web/src/app/reports): `apps/web/src/app/reports`

### Visitor engagement

- [Embedded widget](https://github.com/opencom-org/opencom/blob/dev/apps/widget/src/Widget.tsx): `apps/widget/src/Widget.tsx`
- [Widget bootstrap](https://github.com/opencom-org/opencom/blob/dev/apps/widget/src/main.tsx): `apps/widget/src/main.tsx`
- [Visitor sessions](https://github.com/opencom-org/opencom/blob/dev/apps/widget/src/hooks/useWidgetSession.ts): `apps/widget/src/hooks/useWidgetSession.ts`
- [Tour runtime](https://github.com/opencom-org/opencom/blob/dev/apps/widget/src/tourOverlay/useTourOverlaySession.ts): `apps/widget/src/tourOverlay/useTourOverlaySession.ts`
- [Help center](https://github.com/opencom-org/opencom/blob/dev/apps/widget/src/components/HelpCenter.tsx): `apps/widget/src/components/HelpCenter.tsx`
- [Visitor tickets](https://github.com/opencom-org/opencom/blob/dev/apps/widget/src/components/TicketCreate.tsx): `apps/widget/src/components/TicketCreate.tsx`

### Platform backend

- [Series runtime](https://github.com/opencom-org/opencom/blob/dev/packages/convex/convex/series/runtime.ts): `packages/convex/convex/series/runtime.ts`
- [Conversations and tickets](https://github.com/opencom-org/opencom/blob/dev/packages/convex/convex/conversations.ts): `packages/convex/convex/conversations.ts`
- [Knowledge and imports](https://github.com/opencom-org/opencom/blob/dev/packages/convex/convex/helpCenterImports/syncPipeline.ts): `packages/convex/convex/helpCenterImports/syncPipeline.ts`
- [Workspace and identity](https://github.com/opencom-org/opencom/blob/dev/packages/convex/convex/authConvex.ts): `packages/convex/convex/authConvex.ts`
- [Campaigns and surveys](https://github.com/opencom-org/opencom/blob/dev/packages/convex/convex/outboundMessages.ts): `packages/convex/convex/outboundMessages.ts`
- [Reporting](https://github.com/opencom-org/opencom/blob/dev/packages/convex/convex/reporting.ts): `packages/convex/convex/reporting.ts`
- [Convex data model](https://github.com/opencom-org/opencom/blob/dev/packages/convex/convex/schema.ts): `packages/convex/convex/schema.ts`

### Mobile SDKs

- [Admin mobile app](https://github.com/opencom-org/opencom/blob/dev/apps/mobile/app/(app)/inbox.tsx): `apps/mobile/app/(app)/inbox.tsx`
- [React Native SDK](https://github.com/opencom-org/opencom/blob/dev/packages/react-native-sdk/src/hooks/useConversations.ts): `packages/react-native-sdk/src/hooks/useConversations.ts`
- [iOS SDK](https://github.com/opencom-org/opencom/blob/dev/packages/ios-sdk/Sources/OpencomSDK/Core/SessionManager.swift): `packages/ios-sdk/Sources/OpencomSDK/Core/SessionManager.swift`
- [Android SDK](https://github.com/opencom-org/opencom/blob/dev/packages/android-sdk/sdk/src/main/kotlin/com/opencom/sdk/core/SessionManager.kt): `packages/android-sdk/sdk/src/main/kotlin/com/opencom/sdk/core/SessionManager.kt`

### Other components

- **Support agents**
- **Website visitors**
- **Convex service**
- **Resend email**

## Connections

- Support agents → Web dashboard: manage workspace (evidence: `README.md`)
- Web dashboard → Workspace settings: configure (evidence: `README.md`)
- Web dashboard → Outbound editor: edit messages (evidence: `README.md`)
- Web dashboard → Help content admin: manage articles (evidence: `README.md`)
- Web dashboard → Conversation inbox: reply to chats (evidence: `README.md`)
- Web dashboard → Campaigns and series: author campaigns (evidence: `README.md`)
- Web dashboard → Reports and segments: review metrics (evidence: `README.md`)
- Outbound editor → Workspace settings: load workspace (evidence: `apps/web/src/app/outbound/hooks/useOutboundMessageEditorController.ts`)
- Website visitors → Widget bootstrap: open widget (evidence: `README.md`)
- Widget bootstrap → Embedded widget: renders (evidence: `apps/widget/src/main.tsx`)
- Widget bootstrap → Convex service: provides client (evidence: `apps/widget/src/main.tsx`)
- Embedded widget → Visitor sessions: starts session
- Visitor sessions → Convex service: boots session (evidence: `apps/widget/src/hooks/useWidgetSession.ts`)
- Embedded widget → Tour runtime: runs tours
- Embedded widget → Help center: shows help
- Embedded widget → Visitor tickets: creates tickets
- Embedded widget → Convex service: loads product data
- Admin mobile app → Convex service: uses backend
- React Native SDK → Convex service: queries conversations (evidence: `packages/react-native-sdk/src/hooks/useConversations.ts`)
- React Native SDK → Convex service: submits surveys
- iOS SDK → Convex service: boots session (evidence: `packages/ios-sdk/Sources/OpencomSDK/Core/SessionManager.swift`)
- Android SDK → Convex service: calls API (evidence: `packages/android-sdk/sdk/src/main/kotlin/com/opencom/sdk/core/SessionManager.kt`)
- Web dashboard → Convex service: uses backend
- Admin mobile app → Convex service: uses backend
- Convex service → Convex data model: persists records
- Convex service → Conversations and tickets: serves conversations
- Convex service → Knowledge and imports: serves knowledge
- Convex service → Workspace and identity: handles identity
- Convex service → Campaigns and surveys: serves campaigns
- Convex service → Series runtime: runs sequences
- Convex service → Reporting: computes reports
- Convex service → Resend email: sends email
