# creasycomunidade/creasy-crm-community architecture

> Architecture diagram of the GitHub repository creasycomunidade/creasy-crm-community, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/creasycomunidade/creasy-crm-community
- Repository: https://github.com/creasycomunidade/creasy-crm-community

## Overview

CREASY CRM Community is a self-hosted CRM for managing customer conversations, contacts, automation, and related work. The documented workflow centers on bringing channel conversations into a shared inbox, managing contacts and follow-up, and using automations and AI to support service. Its broader capabilities include campaigns, sales pipelines, appointments, reporting, and integrations. The graph combines README-documented capabilities with sampled or indexed code relationships; links for unsampled subsystems are omitted where the evidence does not establish a caller.

Main entry points: [`app/Modules/Automation/Services/AutomationEngine.php`](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Automation/Services/AutomationEngine.php) (Automation engine), [`bootstrap/app.php`](https://github.com/creasycomunidade/creasy-crm-community/blob/main/bootstrap/app.php) (Web application), [`app/Models/Workspace.php`](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Models/Workspace.php) (Workspace), [`app/Http/Controllers/Api/V1/MobileConversationController.php`](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Http/Controllers/Api/V1/MobileConversationController.php) (Shared inbox)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace and access"]
  node_workspace[("Workspace<br/>[Workspace.php]")]
  node_client[("Client account<br/>[Client.php]")]
  node_user_model[("User and team<br/>[User.php]")]
  node_web_entry["Web application<br/>[app.php]"]
end

subgraph group_inbox["Inbox and channels"]
  node_inbox["Shared inbox"]
  node_conversation[("Conversations<br/>[Conversation.php]")]
  node_message[("Messages<br/>[Message.php]")]
  node_channel_account[("Channel accounts<br/>[ChannelAccount.php]")]
  node_channel_manager["Channel dispatch<br/>[ChannelManager.php]"]
end

subgraph group_crm["CRM and outreach"]
  node_contact[("Contacts<br/>[Contact.php]")]
  node_pipeline["Sales pipeline"]
  node_pipeline_stage[("Pipeline stages<br/>[PipelineStage.php]")]
  node_campaign[("Campaigns<br/>[Campaign.php]")]
end

subgraph group_automation["Automation and AI"]
  node_automation["Automation engine"]
  node_automation_run[("Automation runs<br/>[AutomationRun.php]")]
  node_chatbot["AI chatbots<br/>[ChatbotRunner.php]"]
  node_llm["Language models<br/>[LlmManager.php]"]
end

subgraph group_operations["Scheduling and integrations"]
  node_appointments["Appointments"]
  node_integrations["External integrations"]
  node_reporting["Reports and analytics"]
end

node_user(("CRM user"))

node_user -->|"uses"| node_web_entry
node_web_entry -->|"routes to"| node_inbox
node_web_entry -->|"routes to"| node_pipeline
node_client -->|"owns"| node_workspace
node_workspace -->|"has members"| node_user_model
node_inbox -->|"dispatches via"| node_channel_manager
node_conversation -->|"has messages"| node_message
node_contact -->|"has conversations"| node_conversation
node_pipeline -->|"manages stages"| node_pipeline_stage
node_automation -->|"executes runs"| node_automation_run
node_automation -->|"runs chatbot"| node_chatbot
node_automation -->|"uses campaigns"| node_campaign
node_automation -->|"handles appointments"| node_appointments
node_chatbot -.->|"uses models"| node_llm
node_user -->|"books appointments"| node_appointments
node_user -->|"views reports"| node_reporting
node_channel_manager -.->|"connects channels"| node_integrations

click node_workspace "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Models/Workspace.php"
click node_client "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Models/Client.php"
click node_user_model "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Models/User.php"
click node_web_entry "https://github.com/creasycomunidade/creasy-crm-community/blob/main/bootstrap/app.php"
click node_contact "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Shared/Models/Contact.php"
click node_pipeline "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Leads/Http/Controllers/PipelineController.php"
click node_pipeline_stage "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Leads/Models/PipelineStage.php"
click node_campaign "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Broadcasting/Models/Campaign.php"
click node_inbox "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Http/Controllers/Api/V1/MobileConversationController.php"
click node_conversation "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Shared/Models/Conversation.php"
click node_message "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Shared/Models/Message.php"
click node_channel_account "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Shared/Models/ChannelAccount.php"
click node_channel_manager "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Shared/Services/ChannelManager.php"
click node_automation "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Automation/Services/AutomationEngine.php"
click node_automation_run "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Automation/Models/AutomationRun.php"
click node_chatbot "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/AI/Services/ChatbotRunner.php"
click node_llm "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/AI/Services/Llm/LlmManager.php"
click node_appointments "https://github.com/creasycomunidade/creasy-crm-community/tree/main/app/Modules/Appointments"
click node_integrations "https://github.com/creasycomunidade/creasy-crm-community/tree/main/app/Modules/Integrations"
click node_reporting "https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Services/AnalyticsService.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_workspace,node_client,node_user_model,node_web_entry,node_user toneBlue
class node_inbox,node_conversation,node_message,node_channel_account,node_channel_manager toneAmber
class node_contact,node_pipeline,node_pipeline_stage,node_campaign toneMint
class node_automation,node_automation_run,node_chatbot,node_llm toneRose
class node_appointments,node_integrations,node_reporting toneIndigo
```

## Components

### Workspace and access

- [Workspace](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Models/Workspace.php): `app/Models/Workspace.php`
- [Client account](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Models/Client.php): `app/Models/Client.php`
- [User and team](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Models/User.php): `app/Models/User.php`
- [Web application](https://github.com/creasycomunidade/creasy-crm-community/blob/main/bootstrap/app.php): `bootstrap/app.php`

### Inbox and channels

- [Shared inbox](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Http/Controllers/Api/V1/MobileConversationController.php): `app/Http/Controllers/Api/V1/MobileConversationController.php`
- [Conversations](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Shared/Models/Conversation.php): `app/Modules/Shared/Models/Conversation.php`
- [Messages](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Shared/Models/Message.php): `app/Modules/Shared/Models/Message.php`
- [Channel accounts](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Shared/Models/ChannelAccount.php): `app/Modules/Shared/Models/ChannelAccount.php`
- [Channel dispatch](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Shared/Services/ChannelManager.php): `app/Modules/Shared/Services/ChannelManager.php`

### CRM and outreach

- [Contacts](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Shared/Models/Contact.php): `app/Modules/Shared/Models/Contact.php`
- [Sales pipeline](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Leads/Http/Controllers/PipelineController.php): `app/Modules/Leads/Http/Controllers/PipelineController.php`
- [Pipeline stages](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Leads/Models/PipelineStage.php): `app/Modules/Leads/Models/PipelineStage.php`
- [Campaigns](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Broadcasting/Models/Campaign.php): `app/Modules/Broadcasting/Models/Campaign.php`

### Automation and AI

- [Automation engine](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Automation/Services/AutomationEngine.php): `app/Modules/Automation/Services/AutomationEngine.php`
- [Automation runs](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/Automation/Models/AutomationRun.php): `app/Modules/Automation/Models/AutomationRun.php`
- [AI chatbots](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/AI/Services/ChatbotRunner.php): `app/Modules/AI/Services/ChatbotRunner.php`
- [Language models](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Modules/AI/Services/Llm/LlmManager.php): `app/Modules/AI/Services/Llm/LlmManager.php`

### Scheduling and integrations

- [Appointments](https://github.com/creasycomunidade/creasy-crm-community/tree/main/app/Modules/Appointments): `app/Modules/Appointments`
- [External integrations](https://github.com/creasycomunidade/creasy-crm-community/tree/main/app/Modules/Integrations): `app/Modules/Integrations`
- [Reports and analytics](https://github.com/creasycomunidade/creasy-crm-community/blob/main/app/Services/AnalyticsService.php): `app/Services/AnalyticsService.php`

### Other components

- **CRM user**

## Connections

- CRM user → Web application: uses (evidence: `README.md`)
- Web application → Shared inbox: routes to (evidence: `bootstrap/app.php`)
- Web application → Sales pipeline: routes to
- Client account → Workspace: owns (evidence: `app/Models/Client.php`)
- Workspace → User and team: has members (evidence: `app/Models/Workspace.php`)
- Shared inbox → Channel dispatch: dispatches via (evidence: `app/Http/Controllers/Api/V1/MobileConversationController.php`)
- Conversations → Messages: has messages (evidence: `app/Modules/Shared/Models/Conversation.php`)
- Contacts → Conversations: has conversations (evidence: `app/Modules/Shared/Models/Contact.php`)
- Sales pipeline → Pipeline stages: manages stages (evidence: `app/Modules/Leads/Http/Controllers/PipelineController.php`)
- Automation engine → Automation runs: executes runs (evidence: `app/Modules/Automation/Services/AutomationEngine.php`)
- Automation engine → AI chatbots: runs chatbot (evidence: `app/Modules/Automation/Services/AutomationEngine.php`)
- Automation engine → Campaigns: uses campaigns (evidence: `app/Modules/Automation/Services/AutomationEngine.php`)
- Automation engine → Appointments: handles appointments (evidence: `app/Modules/Automation/Services/AutomationEngine.php`)
- AI chatbots → Language models: uses models
- CRM user → Appointments: books appointments (evidence: `README.md`)
- CRM user → Reports and analytics: views reports (evidence: `README.md`)
- Channel dispatch → External integrations: connects channels
