# berkegenckaya/leadping architecture

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

- Interactive diagram: https://gitdiagram.com/berkegenckaya/leadping
- Repository: https://github.com/berkegenckaya/leadping

## Overview

LeadPing is a multi-tenant lead qualification platform: a website visitor chats with an embedded widget, the server streams an AI conversation, enabled skills capture and score a lead, and tenant users manage leads and conversations in a CRM. A separate operator interface manages customers, widgets, and platform analytics. The README and chat/skill excerpts support the capture path; several dashboard and admin relationships are documented but their handlers were not sampled, so those links cite the README.

Main entry points: [`apps/web/app/api/widget/chat/route.ts`](https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/api/widget/chat/route.ts) (Chat Endpoint), [`apps/web/app/(dashboard)/dashboard/leads/page.tsx`](https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/(dashboard)/dashboard/leads/page.tsx) (CRM Dashboard), [`apps/widget/src/index.ts`](https://github.com/berkegenckaya/leadping/blob/main/apps/widget/src/index.ts) (Chat Widget), [`packages/skills/src/registry.ts`](https://github.com/berkegenckaya/leadping/blob/main/packages/skills/src/registry.ts) (Skill Registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_embed["Embedded Chat"]
  node_widget["Chat Widget<br/>[index.ts]"]
  node_widget_config["Widget Config<br/>[route.ts]"]
  node_chat_api["Chat Endpoint<br/>[route.ts]"]
end

subgraph group_capture["AI Lead Capture"]
  node_ai{{"OpenAI Model"}}
  node_registry["Skill Registry<br/>[registry.ts]"]
  node_collect["Lead Capture Skill<br/>[collectLeadInfo.ts]"]
  node_calendly["Calendly Skill<br/>[calendly.ts]"]
end

subgraph group_crm["Tenant CRM"]
  node_dashboard["CRM Dashboard<br/>[page.tsx]"]
  node_lead_api["Lead Operations<br/>[route.ts]"]
  node_conversation_api["Conversation History<br/>[route.ts]"]
  node_metrics_api["Tenant Metrics<br/>[route.ts]"]
end

subgraph group_platform["Platform Admin"]
  node_admin_ui["Admin Console<br/>[page.tsx]"]
  node_admin_api["Admin Operations<br/>[route.ts]"]
end

subgraph group_data["Shared Data"]
  node_db_client["Database Client<br/>[index.ts]"]
  node_database[("Platform Database")]
  node_lead_types["Lead Types<br/>[lead.ts]"]
  node_sector_types["Sector Types<br/>[sector.ts]"]
  node_notifications["Email Notification"]
end

node_visitor(("Website Visitor"))
node_tenant(("Tenant User"))
node_operator(("Platform Operator"))

node_visitor -->|"opens chat"| node_widget
node_widget -.->|"loads settings"| node_widget_config
node_widget -->|"posts messages"| node_chat_api
node_chat_api -->|"loads widget"| node_db_client
node_chat_api -->|"selects tools"| node_registry
node_chat_api -->|"streams prompt"| node_ai
node_ai -->|"invokes tools"| node_registry
node_registry -->|"registers tool"| node_collect
node_registry -->|"registers tool"| node_calendly
node_collect -->|"persists lead"| node_db_client
node_collect -->|"queues email"| node_notifications
node_db_client -.->|"accesses records"| node_database
node_chat_api -->|"streams response"| node_widget
node_chat_api -->|"saves conversation"| node_database
node_tenant -->|"reviews leads"| node_dashboard
node_dashboard -.->|"manages leads"| node_lead_api
node_dashboard -->|"opens replay"| node_conversation_api
node_dashboard -->|"views trends"| node_metrics_api
node_operator -->|"manages platform"| node_admin_ui
node_admin_ui -.->|"manages tenants"| node_admin_api
node_admin_api -.->|"manages records"| node_database

click node_widget "https://github.com/berkegenckaya/leadping/blob/main/apps/widget/src/index.ts"
click node_widget_config "https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/api/widget/config/%5Btoken%5D/route.ts"
click node_chat_api "https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/api/widget/chat/route.ts"
click node_registry "https://github.com/berkegenckaya/leadping/blob/main/packages/skills/src/registry.ts"
click node_collect "https://github.com/berkegenckaya/leadping/blob/main/packages/skills/src/skills/collectLeadInfo.ts"
click node_calendly "https://github.com/berkegenckaya/leadping/blob/main/packages/skills/src/skills/calendly.ts"
click node_dashboard "https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/(dashboard)/dashboard/leads/page.tsx"
click node_lead_api "https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/api/leads/route.ts"
click node_conversation_api "https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/api/dashboard/conversations/%5Bid%5D/route.ts"
click node_metrics_api "https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/api/dashboard/metrics/route.ts"
click node_admin_ui "https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/admin/page.tsx"
click node_admin_api "https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/api/admin/customers/route.ts"
click node_db_client "https://github.com/berkegenckaya/leadping/blob/main/packages/db/index.ts"
click node_lead_types "https://github.com/berkegenckaya/leadping/blob/main/packages/types/lead.ts"
click node_sector_types "https://github.com/berkegenckaya/leadping/blob/main/packages/types/sector.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_widget,node_widget_config,node_chat_api,node_tenant toneBlue
class node_ai,node_registry,node_collect,node_calendly toneAmber
class node_dashboard,node_lead_api,node_conversation_api,node_metrics_api toneMint
class node_admin_ui,node_admin_api toneRose
class node_db_client,node_database,node_lead_types,node_sector_types,node_notifications,node_visitor,node_operator toneIndigo
```

## Components

### Embedded Chat

- [Chat Widget](https://github.com/berkegenckaya/leadping/blob/main/apps/widget/src/index.ts): `apps/widget/src/index.ts`
- [Widget Config](https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/api/widget/config/%5Btoken%5D/route.ts): `apps/web/app/api/widget/config/[token]/route.ts`
- [Chat Endpoint](https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/api/widget/chat/route.ts): `apps/web/app/api/widget/chat/route.ts`

### AI Lead Capture

- **OpenAI Model**
- [Skill Registry](https://github.com/berkegenckaya/leadping/blob/main/packages/skills/src/registry.ts): `packages/skills/src/registry.ts`
- [Lead Capture Skill](https://github.com/berkegenckaya/leadping/blob/main/packages/skills/src/skills/collectLeadInfo.ts): `packages/skills/src/skills/collectLeadInfo.ts`
- [Calendly Skill](https://github.com/berkegenckaya/leadping/blob/main/packages/skills/src/skills/calendly.ts): `packages/skills/src/skills/calendly.ts`

### Tenant CRM

- [CRM Dashboard](https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/(dashboard)/dashboard/leads/page.tsx): `apps/web/app/(dashboard)/dashboard/leads/page.tsx`
- [Lead Operations](https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/api/leads/route.ts): `apps/web/app/api/leads/route.ts`
- [Conversation History](https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/api/dashboard/conversations/%5Bid%5D/route.ts): `apps/web/app/api/dashboard/conversations/[id]/route.ts`
- [Tenant Metrics](https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/api/dashboard/metrics/route.ts): `apps/web/app/api/dashboard/metrics/route.ts`

### Platform Admin

- [Admin Console](https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/admin/page.tsx): `apps/web/app/admin/page.tsx`
- [Admin Operations](https://github.com/berkegenckaya/leadping/blob/main/apps/web/app/api/admin/customers/route.ts): `apps/web/app/api/admin/customers/route.ts`

### Shared Data

- [Database Client](https://github.com/berkegenckaya/leadping/blob/main/packages/db/index.ts): `packages/db/index.ts`
- **Platform Database**
- [Lead Types](https://github.com/berkegenckaya/leadping/blob/main/packages/types/lead.ts): `packages/types/lead.ts`
- [Sector Types](https://github.com/berkegenckaya/leadping/blob/main/packages/types/sector.ts): `packages/types/sector.ts`
- **Email Notification**

### Other components

- **Website Visitor**
- **Tenant User**
- **Platform Operator**

## Connections

- Website Visitor → Chat Widget: opens chat
- Chat Widget → Widget Config: loads settings
- Chat Widget → Chat Endpoint: posts messages
- Chat Endpoint → Database Client: loads widget (evidence: `apps/web/app/api/widget/chat/route.ts`)
- Chat Endpoint → Skill Registry: selects tools (evidence: `apps/web/app/api/widget/chat/route.ts`)
- Chat Endpoint → OpenAI Model: streams prompt (evidence: `apps/web/app/api/widget/chat/route.ts`)
- OpenAI Model → Skill Registry: invokes tools
- Skill Registry → Lead Capture Skill: registers tool (evidence: `packages/skills/src/registry.ts`)
- Skill Registry → Calendly Skill: registers tool (evidence: `packages/skills/src/registry.ts`)
- Lead Capture Skill → Database Client: persists lead (evidence: `packages/skills/src/skills/collectLeadInfo.ts`)
- Lead Capture Skill → Email Notification: queues email (evidence: `packages/skills/src/skills/collectLeadInfo.ts`)
- Database Client → Platform Database: accesses records
- Chat Endpoint → Chat Widget: streams response
- Chat Endpoint → Platform Database: saves conversation (evidence: `apps/web/app/api/widget/chat/route.ts`)
- Tenant User → CRM Dashboard: reviews leads
- CRM Dashboard → Lead Operations: manages leads
- CRM Dashboard → Conversation History: opens replay
- CRM Dashboard → Tenant Metrics: views trends
- Platform Operator → Admin Console: manages platform
- Admin Console → Admin Operations: manages tenants
- Admin Operations → Platform Database: manages records
