# vrishbhansingh/crm architecture

> Architecture diagram of the GitHub repository vrishbhansingh/crm, 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/vrishbhansingh/crm
- Repository: https://github.com/vrishbhansingh/crm

## Overview

This Laravel application appears to be a multi-tenant CRM with a platform-admin control plane. A representative workflow is lead management: a user submits or updates a lead, the controller coordinates lead services and models, and tenant scoping and lead scoring apply during persistence. The tree also documents sales pipelines, campaign messaging, WhatsApp, and tenant provisioning/administration. Source excerpts are limited, so several capability nodes are included based on the file tree, but their internal relationships are not asserted.

Main entry points: [`app/Http/Controllers/LeadController.php`](https://github.com/vrishbhansingh/crm/blob/main/app/Http/Controllers/LeadController.php) (Lead Workflow), [`app/Console/Commands/ProvisionTenantDatabases.php`](https://github.com/vrishbhansingh/crm/blob/main/app/Console/Commands/ProvisionTenantDatabases.php) (Provision Command), [`app/Models/Lead.php`](https://github.com/vrishbhansingh/crm/blob/main/app/Models/Lead.php) (Lead Records), [`app/Tenancy/TenantConnectionManager.php`](https://github.com/vrishbhansingh/crm/blob/main/app/Tenancy/TenantConnectionManager.php) (Tenant Connection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_crm["CRM and Sales"]
  node_leads["Lead Workflow<br/>[LeadController.php]"]
  node_leadmodel[("Lead Records<br/>[Lead.php]")]
  node_scoring["Lead Scoring"]
  node_uniqueness["Duplicate Checks"]
  node_leadimport["Lead Import<br/>[LeadsImport.php]"]
  node_leadreport["Import Report"]
  node_pipeline[("Sales Pipeline<br/>[Pipeline.php]")]
  node_stages[("Pipeline Stages<br/>[PipelineStage.php]")]
  node_deals[("Deals<br/>[Deal.php]")]
  node_webhooks["Lead Webhooks"]
end

subgraph group_platform["Tenant Platform"]
  node_tenantcontext["Tenant Context<br/>[TenantContext.php]"]
  node_tenant[("Tenant Registry<br/>[Tenant.php]")]
  node_tenantconnection["Tenant Connection"]
  node_provisioning["Database Provisioning"]
  node_provisioncommand["Provision Command"]
  node_tenantadmin["Tenant Administration"]
end

subgraph group_messaging["Campaign Messaging"]
  node_campaigns["Email Campaigns"]
  node_campaignsender["Campaign Sender<br/>[CampaignSender.php]"]
  node_campaignjob["Email Job"]
  node_whatsapp["WhatsApp Messaging"]
end

subgraph group_runtime["Web Runtime"]
  node_routes["Application Routes<br/>[app.php]"]
  node_framework["Laravel Runtime<br/>[Controller.php]"]
end

node_user(("CRM User"))

node_user -.->|"submits requests"| node_routes
node_routes -->|"routes requests"| node_leads
node_leads -->|"creates and updates"| node_leadmodel
node_leads -->|"scores leads"| node_scoring
node_leads -->|"checks duplicates"| node_uniqueness
node_leadmodel -->|"scopes by tenant"| node_tenantcontext
node_leads -->|"imports leads"| node_leadimport
node_leads -->|"exports results"| node_leadreport
node_pipeline -->|"creates stages"| node_stages
node_provisioncommand -->|"provisions database"| node_provisioning
node_provisioncommand -->|"loads tenant"| node_tenant
node_provisioning -->|"activates connection"| node_tenantconnection
node_tenantconnection -->|"loads tenant details"| node_tenant
node_campaigns -.->|"sends campaigns"| node_campaignsender
node_campaignsender -.->|"dispatches email"| node_campaignjob
node_whatsapp -.->|"sends messages"| node_user

click node_routes "https://github.com/vrishbhansingh/crm/blob/main/routes/app.php"
click node_leads "https://github.com/vrishbhansingh/crm/blob/main/app/Http/Controllers/LeadController.php"
click node_leadmodel "https://github.com/vrishbhansingh/crm/blob/main/app/Models/Lead.php"
click node_scoring "https://github.com/vrishbhansingh/crm/blob/main/app/Domain/Leads/LeadScoringService.php"
click node_uniqueness "https://github.com/vrishbhansingh/crm/blob/main/app/Services/LeadUniquenessService.php"
click node_leadimport "https://github.com/vrishbhansingh/crm/blob/main/app/Imports/LeadsImport.php"
click node_leadreport "https://github.com/vrishbhansingh/crm/blob/main/app/Exports/LeadImportReportExport.php"
click node_pipeline "https://github.com/vrishbhansingh/crm/blob/main/app/Models/Pipeline.php"
click node_stages "https://github.com/vrishbhansingh/crm/blob/main/app/Models/PipelineStage.php"
click node_deals "https://github.com/vrishbhansingh/crm/blob/main/app/Models/Deal.php"
click node_tenantcontext "https://github.com/vrishbhansingh/crm/blob/main/app/Support/TenantContext.php"
click node_tenant "https://github.com/vrishbhansingh/crm/blob/main/app/Models/Tenant.php"
click node_tenantconnection "https://github.com/vrishbhansingh/crm/blob/main/app/Tenancy/TenantConnectionManager.php"
click node_provisioning "https://github.com/vrishbhansingh/crm/blob/main/app/Tenancy/TenantDatabaseProvisioner.php"
click node_provisioncommand "https://github.com/vrishbhansingh/crm/blob/main/app/Console/Commands/ProvisionTenantDatabases.php"
click node_tenantadmin "https://github.com/vrishbhansingh/crm/blob/main/app/Http/Controllers/Admin/TenantController.php"
click node_campaigns "https://github.com/vrishbhansingh/crm/blob/main/app/Http/Controllers/Admin/EmailCampaignController.php"
click node_campaignsender "https://github.com/vrishbhansingh/crm/blob/main/app/Services/CampaignSender.php"
click node_campaignjob "https://github.com/vrishbhansingh/crm/blob/main/app/Jobs/SendCampaignEmailJob.php"
click node_whatsapp "https://github.com/vrishbhansingh/crm/blob/main/app/Services/WhatsApp/WhatsAppMessageService.php"
click node_webhooks "https://github.com/vrishbhansingh/crm/blob/main/app/Http/Controllers/WebhookLeadController.php"
click node_framework "https://github.com/vrishbhansingh/crm/blob/main/app/Http/Controllers/Controller.php"

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_leads,node_leadmodel,node_scoring,node_uniqueness,node_leadimport,node_leadreport,node_pipeline,node_stages,node_deals,node_webhooks,node_user toneBlue
class node_tenantcontext,node_tenant,node_tenantconnection,node_provisioning,node_provisioncommand,node_tenantadmin toneAmber
class node_campaigns,node_campaignsender,node_campaignjob,node_whatsapp toneMint
class node_routes,node_framework toneRose
```

## Components

### CRM and Sales

- [Lead Workflow](https://github.com/vrishbhansingh/crm/blob/main/app/Http/Controllers/LeadController.php): `app/Http/Controllers/LeadController.php`
- [Lead Records](https://github.com/vrishbhansingh/crm/blob/main/app/Models/Lead.php): `app/Models/Lead.php`
- [Lead Scoring](https://github.com/vrishbhansingh/crm/blob/main/app/Domain/Leads/LeadScoringService.php): `app/Domain/Leads/LeadScoringService.php`
- [Duplicate Checks](https://github.com/vrishbhansingh/crm/blob/main/app/Services/LeadUniquenessService.php): `app/Services/LeadUniquenessService.php`
- [Lead Import](https://github.com/vrishbhansingh/crm/blob/main/app/Imports/LeadsImport.php): `app/Imports/LeadsImport.php`
- [Import Report](https://github.com/vrishbhansingh/crm/blob/main/app/Exports/LeadImportReportExport.php): `app/Exports/LeadImportReportExport.php`
- [Sales Pipeline](https://github.com/vrishbhansingh/crm/blob/main/app/Models/Pipeline.php): `app/Models/Pipeline.php`
- [Pipeline Stages](https://github.com/vrishbhansingh/crm/blob/main/app/Models/PipelineStage.php): `app/Models/PipelineStage.php`
- [Deals](https://github.com/vrishbhansingh/crm/blob/main/app/Models/Deal.php): `app/Models/Deal.php`
- [Lead Webhooks](https://github.com/vrishbhansingh/crm/blob/main/app/Http/Controllers/WebhookLeadController.php): `app/Http/Controllers/WebhookLeadController.php`

### Tenant Platform

- [Tenant Context](https://github.com/vrishbhansingh/crm/blob/main/app/Support/TenantContext.php): `app/Support/TenantContext.php`
- [Tenant Registry](https://github.com/vrishbhansingh/crm/blob/main/app/Models/Tenant.php): `app/Models/Tenant.php`
- [Tenant Connection](https://github.com/vrishbhansingh/crm/blob/main/app/Tenancy/TenantConnectionManager.php): `app/Tenancy/TenantConnectionManager.php`
- [Database Provisioning](https://github.com/vrishbhansingh/crm/blob/main/app/Tenancy/TenantDatabaseProvisioner.php): `app/Tenancy/TenantDatabaseProvisioner.php`
- [Provision Command](https://github.com/vrishbhansingh/crm/blob/main/app/Console/Commands/ProvisionTenantDatabases.php): `app/Console/Commands/ProvisionTenantDatabases.php`
- [Tenant Administration](https://github.com/vrishbhansingh/crm/blob/main/app/Http/Controllers/Admin/TenantController.php): `app/Http/Controllers/Admin/TenantController.php`

### Campaign Messaging

- [Email Campaigns](https://github.com/vrishbhansingh/crm/blob/main/app/Http/Controllers/Admin/EmailCampaignController.php): `app/Http/Controllers/Admin/EmailCampaignController.php`
- [Campaign Sender](https://github.com/vrishbhansingh/crm/blob/main/app/Services/CampaignSender.php): `app/Services/CampaignSender.php`
- [Email Job](https://github.com/vrishbhansingh/crm/blob/main/app/Jobs/SendCampaignEmailJob.php): `app/Jobs/SendCampaignEmailJob.php`
- [WhatsApp Messaging](https://github.com/vrishbhansingh/crm/blob/main/app/Services/WhatsApp/WhatsAppMessageService.php): `app/Services/WhatsApp/WhatsAppMessageService.php`

### Web Runtime

- [Application Routes](https://github.com/vrishbhansingh/crm/blob/main/routes/app.php): `routes/app.php`
- [Laravel Runtime](https://github.com/vrishbhansingh/crm/blob/main/app/Http/Controllers/Controller.php): `app/Http/Controllers/Controller.php`

### Other components

- **CRM User**

## Connections

- CRM User → Application Routes: submits requests
- Application Routes → Lead Workflow: routes requests (evidence: `routes/app.php`)
- Lead Workflow → Lead Records: creates and updates (evidence: `app/Http/Controllers/LeadController.php`)
- Lead Workflow → Lead Scoring: scores leads
- Lead Workflow → Duplicate Checks: checks duplicates (evidence: `app/Http/Controllers/LeadController.php`)
- Lead Records → Tenant Context: scopes by tenant
- Lead Workflow → Lead Import: imports leads (evidence: `app/Http/Controllers/LeadController.php`)
- Lead Workflow → Import Report: exports results (evidence: `app/Http/Controllers/LeadController.php`)
- Sales Pipeline → Pipeline Stages: creates stages (evidence: `app/Models/Pipeline.php`)
- Provision Command → Database Provisioning: provisions database (evidence: `app/Console/Commands/ProvisionTenantDatabases.php`)
- Provision Command → Tenant Registry: loads tenant (evidence: `app/Console/Commands/ProvisionTenantDatabases.php`)
- Database Provisioning → Tenant Connection: activates connection (evidence: `app/Tenancy/TenantDatabaseProvisioner.php`)
- Tenant Connection → Tenant Registry: loads tenant details (evidence: `app/Tenancy/TenantConnectionManager.php`)
- Email Campaigns → Campaign Sender: sends campaigns
- Campaign Sender → Email Job: dispatches email
- WhatsApp Messaging → CRM User: sends messages
