# nathy-dev/vendaq architecture

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

- Interactive diagram: https://gitdiagram.com/nathy-dev/vendaq
- Repository: https://github.com/nathy-dev/vendaq

## Overview

PIPELIXR is a WhatsApp-centered sales CRM: business owners connect messaging, review customer activity and leads, and use pipeline and revenue views to monitor follow-up and outcomes. Its visible workflow runs from dashboard interactions to Convex-backed data and WhatsApp operations; the priority-board and funnel queries provide a distinct measurement stage. The tree also shows AI, status, orders, and account capabilities. Several backend modules are unsampled, so those capabilities are represented without speculative call-level links.

Main entry points: [`convex/_generated/api.js`](https://github.com/nathy-dev/vendaq/blob/main/convex/_generated/api.js) (Convex Function API), [`src/app/dashboard/page.tsx`](https://github.com/nathy-dev/vendaq/blob/main/src/app/dashboard/page.tsx) (Dashboard), [`convex/evolutionGoClient.ts`](https://github.com/nathy-dev/vendaq/blob/main/convex/evolutionGoClient.ts) (Evolution Go Client), [`src/components/onboarding.tsx`](https://github.com/nathy-dev/vendaq/blob/main/src/components/onboarding.tsx) (Business Onboarding)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Workspace UI"]
  node_dashboard["Dashboard<br/>[page.tsx]"]
  node_onboarding["Business Onboarding<br/>[onboarding.tsx]"]
  node_leadview["Lead Pipeline View<br/>[LeadPipeline.tsx]"]
  node_pipelineview["Priority And Funnel View<br/>[PipelineBoard.tsx]"]
  node_revenueview["Revenue Workspace"]
  node_statusview["Status Viewer<br/>[StatusViewer.tsx]"]
  node_settings["Business Settings<br/>[page.tsx]"]
  node_activity["AI Activity Feed<br/>[AIActivityFeed.tsx]"]
end

subgraph group_domain["CRM Domain"]
  node_business["Business Records<br/>[businesses.ts]"]
  node_pipeline["Lead Prioritization And Metrics<br/>[pipeline.ts]"]
  node_ai["AI Conversation Processing<br/>[ai.ts]"]
  node_interactions["Customer Interactions<br/>[interactions.ts]"]
  node_orders["Orders<br/>[orders.ts]"]
end

subgraph group_messaging["WhatsApp Messaging"]
  node_whatsapp["WhatsApp Operations<br/>[whatsapp.ts]"]
  node_adapter["Evolution Go Adapter"]
  node_evolutionclient["Evolution Go Client"]
  node_cloudinary["Media Storage Integration<br/>[cloudinary.ts]"]
end

subgraph group_infra["Identity And Data"]
  node_authroute["Auth Route<br/>[route.ts]"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_schema[("Convex Data Model<br/>[schema.ts]")]
  node_convexapi["Convex Function API<br/>[api.js]"]
end

node_owner(("Business Owner"))
node_evolution{{"Evolution Go Service"}}

node_owner -->|"uses"| node_dashboard
node_dashboard -->|"renders"| node_activity
node_dashboard -->|"renders"| node_leadview
node_dashboard -->|"checks and reconnects"| node_whatsapp
node_onboarding -->|"calls mutations"| node_convexapi
node_onboarding -->|"creates or updates"| node_business
node_pipelineview -->|"queries metrics"| node_pipeline
node_revenueview -->|"queries data"| node_convexapi
node_statusview -->|"queries data"| node_convexapi
node_settings -->|"uses functions"| node_convexapi
node_activity -->|"uses functions"| node_convexapi
node_authroute -->|"routes to"| node_auth
node_adapter -->|"delegates to"| node_evolutionclient
node_evolutionclient -->|"sends API requests"| node_evolution
node_ai -->|"uses messaging client"| node_evolutionclient
node_ai -->|"uses media integration"| node_cloudinary

click node_dashboard "https://github.com/nathy-dev/vendaq/blob/main/src/app/dashboard/page.tsx"
click node_onboarding "https://github.com/nathy-dev/vendaq/blob/main/src/components/onboarding.tsx"
click node_leadview "https://github.com/nathy-dev/vendaq/blob/main/src/components/LeadPipeline.tsx"
click node_pipelineview "https://github.com/nathy-dev/vendaq/blob/main/src/components/PipelineBoard.tsx"
click node_revenueview "https://github.com/nathy-dev/vendaq/blob/main/src/components/RevenueWorkspace.tsx"
click node_statusview "https://github.com/nathy-dev/vendaq/blob/main/src/components/StatusViewer.tsx"
click node_settings "https://github.com/nathy-dev/vendaq/blob/main/src/app/settings/page.tsx"
click node_activity "https://github.com/nathy-dev/vendaq/blob/main/src/components/AIActivityFeed.tsx"
click node_business "https://github.com/nathy-dev/vendaq/blob/main/convex/businesses.ts"
click node_pipeline "https://github.com/nathy-dev/vendaq/blob/main/convex/pipeline.ts"
click node_ai "https://github.com/nathy-dev/vendaq/blob/main/convex/ai.ts"
click node_interactions "https://github.com/nathy-dev/vendaq/blob/main/convex/interactions.ts"
click node_orders "https://github.com/nathy-dev/vendaq/blob/main/convex/orders.ts"
click node_whatsapp "https://github.com/nathy-dev/vendaq/blob/main/convex/whatsapp.ts"
click node_adapter "https://github.com/nathy-dev/vendaq/blob/main/convex/adapters/evolutionGoAdapter.ts"
click node_evolutionclient "https://github.com/nathy-dev/vendaq/blob/main/convex/evolutionGoClient.ts"
click node_cloudinary "https://github.com/nathy-dev/vendaq/blob/main/convex/cloudinary.ts"
click node_authroute "https://github.com/nathy-dev/vendaq/blob/main/src/app/api/auth/%5B...nextauth%5D/route.ts"
click node_auth "https://github.com/nathy-dev/vendaq/blob/main/auth.ts"
click node_schema "https://github.com/nathy-dev/vendaq/blob/main/convex/schema.ts"
click node_convexapi "https://github.com/nathy-dev/vendaq/blob/main/convex/_generated/api.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_dashboard,node_onboarding,node_leadview,node_pipelineview,node_revenueview,node_statusview,node_settings,node_activity toneBlue
class node_business,node_pipeline,node_ai,node_interactions,node_orders toneAmber
class node_whatsapp,node_adapter,node_evolutionclient,node_cloudinary toneMint
class node_authroute,node_auth,node_schema,node_convexapi toneRose
class node_owner,node_evolution toneIndigo
```

## Components

### Workspace UI

- [Dashboard](https://github.com/nathy-dev/vendaq/blob/main/src/app/dashboard/page.tsx): `src/app/dashboard/page.tsx`
- [Business Onboarding](https://github.com/nathy-dev/vendaq/blob/main/src/components/onboarding.tsx): `src/components/onboarding.tsx`
- [Lead Pipeline View](https://github.com/nathy-dev/vendaq/blob/main/src/components/LeadPipeline.tsx): `src/components/LeadPipeline.tsx`
- [Priority And Funnel View](https://github.com/nathy-dev/vendaq/blob/main/src/components/PipelineBoard.tsx): `src/components/PipelineBoard.tsx`
- [Revenue Workspace](https://github.com/nathy-dev/vendaq/blob/main/src/components/RevenueWorkspace.tsx): `src/components/RevenueWorkspace.tsx`
- [Status Viewer](https://github.com/nathy-dev/vendaq/blob/main/src/components/StatusViewer.tsx): `src/components/StatusViewer.tsx`
- [Business Settings](https://github.com/nathy-dev/vendaq/blob/main/src/app/settings/page.tsx): `src/app/settings/page.tsx`
- [AI Activity Feed](https://github.com/nathy-dev/vendaq/blob/main/src/components/AIActivityFeed.tsx): `src/components/AIActivityFeed.tsx`

### CRM Domain

- [Business Records](https://github.com/nathy-dev/vendaq/blob/main/convex/businesses.ts): `convex/businesses.ts`
- [Lead Prioritization And Metrics](https://github.com/nathy-dev/vendaq/blob/main/convex/pipeline.ts): `convex/pipeline.ts`
- [AI Conversation Processing](https://github.com/nathy-dev/vendaq/blob/main/convex/ai.ts): `convex/ai.ts`
- [Customer Interactions](https://github.com/nathy-dev/vendaq/blob/main/convex/interactions.ts): `convex/interactions.ts`
- [Orders](https://github.com/nathy-dev/vendaq/blob/main/convex/orders.ts): `convex/orders.ts`

### WhatsApp Messaging

- [WhatsApp Operations](https://github.com/nathy-dev/vendaq/blob/main/convex/whatsapp.ts): `convex/whatsapp.ts`
- [Evolution Go Adapter](https://github.com/nathy-dev/vendaq/blob/main/convex/adapters/evolutionGoAdapter.ts): `convex/adapters/evolutionGoAdapter.ts`
- [Evolution Go Client](https://github.com/nathy-dev/vendaq/blob/main/convex/evolutionGoClient.ts): `convex/evolutionGoClient.ts`
- [Media Storage Integration](https://github.com/nathy-dev/vendaq/blob/main/convex/cloudinary.ts): `convex/cloudinary.ts`

### Identity And Data

- [Auth Route](https://github.com/nathy-dev/vendaq/blob/main/src/app/api/auth/%5B...nextauth%5D/route.ts): `src/app/api/auth/[...nextauth]/route.ts`
- [Authentication](https://github.com/nathy-dev/vendaq/blob/main/auth.ts): `auth.ts`
- [Convex Data Model](https://github.com/nathy-dev/vendaq/blob/main/convex/schema.ts): `convex/schema.ts`
- [Convex Function API](https://github.com/nathy-dev/vendaq/blob/main/convex/_generated/api.js): `convex/_generated/api.js`

### Other components

- **Business Owner**
- **Evolution Go Service**

## Connections

- Business Owner → Dashboard: uses (evidence: `src/app/dashboard/page.tsx`)
- Dashboard → AI Activity Feed: renders (evidence: `src/app/dashboard/page.tsx`)
- Dashboard → Lead Pipeline View: renders (evidence: `src/app/dashboard/page.tsx`)
- Dashboard → WhatsApp Operations: checks and reconnects (evidence: `src/app/dashboard/page.tsx`)
- Business Onboarding → Convex Function API: calls mutations (evidence: `src/components/onboarding.tsx`)
- Business Onboarding → Business Records: creates or updates
- Priority And Funnel View → Lead Prioritization And Metrics: queries metrics (evidence: `src/components/PipelineBoard.tsx`)
- Revenue Workspace → Convex Function API: queries data (evidence: `src/components/RevenueWorkspace.tsx`)
- Status Viewer → Convex Function API: queries data (evidence: `src/app/status/page.tsx`)
- Business Settings → Convex Function API: uses functions (evidence: `src/app/settings/page.tsx`)
- AI Activity Feed → Convex Function API: uses functions (evidence: `src/components/AIActivityFeed.tsx`)
- Auth Route → Authentication: routes to (evidence: `src/app/api/auth/[...nextauth]/route.ts`)
- Evolution Go Adapter → Evolution Go Client: delegates to (evidence: `convex/adapters/evolutionGoAdapter.ts`)
- Evolution Go Client → Evolution Go Service: sends API requests (evidence: `convex/evolutionGoClient.ts`)
- AI Conversation Processing → Evolution Go Client: uses messaging client (evidence: `convex/ai.ts`)
- AI Conversation Processing → Media Storage Integration: uses media integration (evidence: `convex/ai.ts`)
