# felipesantiaggo/mautic architecture

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

- Interactive diagram: https://gitdiagram.com/felipesantiaggo/mautic
- Repository: https://github.com/felipesantiaggo/mautic

## Overview

Mautic is a marketing-automation application: it manages contact and company records, captures form submissions, automates campaign membership and actions, and supports channel messaging and integrations. The graph emphasizes those domain stages and the API/content surfaces visible in the tree. Source excerpts and the SOURCE INDEX support only a subset of runtime links; dashed, uncited links indicate plausible but unverified interactions, and unsampled subsystems are represented by their existing directories.

Main entry points: [`app`](https://github.com/felipesantiaggo/mautic/tree/5.x/app) (Mautic application), [`plugins/MauticClearbitBundle/Helper/LookupHelper.php`](https://github.com/felipesantiaggo/mautic/blob/5.x/plugins/MauticClearbitBundle/Helper/LookupHelper.php) (Clearbit lookup), [`app/bundles/FormBundle/Entity/Form.php`](https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/FormBundle/Entity/Form.php) (Form definitions), [`app/bundles/CampaignBundle/EventCollector`](https://github.com/felipesantiaggo/mautic/tree/5.x/app/bundles/CampaignBundle/EventCollector) (Campaign design)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_contacts["Contacts and Capture"]
  node_lead[("Lead records<br/>[Lead.php]")]
  node_company[("Company records<br/>[Company.php]")]
  node_leadmodel["Lead management<br/>[LeadModel.php]"]
  node_form[("Form definitions<br/>[Form.php]")]
  node_formfields["Form fields<br/>[FieldModel.php]"]
end

subgraph group_automation["Campaign Automation"]
  node_campaign["Campaign design"]
  node_membership["Campaign membership"]
  node_execution["Campaign execution"]
  node_eventlogs[("Campaign event logs<br/>[LeadEventLog.php]")]
end

subgraph group_engagement["Content and Channels"]
  node_email[("Email content<br/>[Email.php]")]
  node_channels["Channel messaging"]
  node_assets["Asset management"]
  node_builder["Content builder"]
end

subgraph group_platform["API and Integrations"]
  node_api["REST API"]
  node_focusapi["Focus API"]
  node_socialapi["Social API"]
  node_integration[("Plugin integrations<br/>[Integration.php]")]
  node_lookup["Clearbit lookup<br/>[LookupHelper.php]"]
  node_webhook["Webhook services"]
end

node_marketer(("Marketer"))
node_webapp["Mautic application"]
node_clearbit["Clearbit service"]

node_marketer -.->|"uses"| node_webapp
node_webapp -.->|"manages"| node_form
node_webapp -.->|"configures"| node_campaign
node_form -.->|"uses fields"| node_formfields
node_form -.->|"captures contacts"| node_lead
node_leadmodel -.->|"manages"| node_lead
node_campaign -.->|"enrolls contacts"| node_membership
node_membership -->|"dispatches changes"| node_lead
node_membership -->|"dispatches changes"| node_campaign
node_execution -.->|"records events"| node_eventlogs
node_campaign -.->|"runs automation"| node_execution
node_webapp -.->|"manages content"| node_email
node_webapp -.->|"manages messaging"| node_channels
node_webapp -.->|"manages assets"| node_assets
node_builder -->|"edits content"| node_email
node_builder -->|"edits content"| node_form
node_focusapi -->|"extends API"| node_api
node_socialapi -->|"extends API"| node_api
node_lookup -->|"updates records"| node_lead
node_lookup -->|"updates records"| node_company
node_lookup -.->|"queries"| node_clearbit
node_lookup -->|"loads credentials"| node_integration
node_webapp -.->|"configures plugins"| node_integration
node_webapp -.->|"supports integrations"| node_webhook

click node_webapp "https://github.com/felipesantiaggo/mautic/tree/5.x/app"
click node_lead "https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/LeadBundle/Entity/Lead.php"
click node_company "https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/LeadBundle/Entity/Company.php"
click node_leadmodel "https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/LeadBundle/Model/LeadModel.php"
click node_form "https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/FormBundle/Entity/Form.php"
click node_formfields "https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/FormBundle/Model/FieldModel.php"
click node_campaign "https://github.com/felipesantiaggo/mautic/tree/5.x/app/bundles/CampaignBundle/EventCollector"
click node_membership "https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/CampaignBundle/Membership/EventDispatcher.php"
click node_execution "https://github.com/felipesantiaggo/mautic/tree/5.x/app/bundles/CampaignBundle/Executioner"
click node_eventlogs "https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/CampaignBundle/Entity/LeadEventLog.php"
click node_email "https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/EmailBundle/Entity/Email.php"
click node_channels "https://github.com/felipesantiaggo/mautic/tree/5.x/app/bundles/ChannelBundle"
click node_assets "https://github.com/felipesantiaggo/mautic/tree/5.x/app/bundles/AssetBundle"
click node_builder "https://github.com/felipesantiaggo/mautic/blob/5.x/plugins/GrapesJsBuilderBundle/Controller/GrapesJsController.php"
click node_api "https://github.com/felipesantiaggo/mautic/tree/5.x/app/bundles/ApiBundle"
click node_focusapi "https://github.com/felipesantiaggo/mautic/blob/5.x/plugins/MauticFocusBundle/Controller/Api/FocusApiController.php"
click node_socialapi "https://github.com/felipesantiaggo/mautic/blob/5.x/plugins/MauticSocialBundle/Controller/Api/TweetApiController.php"
click node_integration "https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/PluginBundle/Entity/Integration.php"
click node_lookup "https://github.com/felipesantiaggo/mautic/blob/5.x/plugins/MauticClearbitBundle/Helper/LookupHelper.php"
click node_webhook "https://github.com/felipesantiaggo/mautic/tree/5.x/app/bundles/WebhookBundle"

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_lead,node_company,node_leadmodel,node_form,node_formfields toneBlue
class node_campaign,node_membership,node_execution,node_eventlogs toneAmber
class node_email,node_channels,node_assets,node_builder toneMint
class node_api,node_focusapi,node_socialapi,node_integration,node_lookup,node_webhook toneRose
class node_marketer,node_clearbit toneIndigo
class node_webapp toneTeal
```

## Components

### Contacts and Capture

- [Lead records](https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/LeadBundle/Entity/Lead.php): `app/bundles/LeadBundle/Entity/Lead.php`
- [Company records](https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/LeadBundle/Entity/Company.php): `app/bundles/LeadBundle/Entity/Company.php`
- [Lead management](https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/LeadBundle/Model/LeadModel.php): `app/bundles/LeadBundle/Model/LeadModel.php`
- [Form definitions](https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/FormBundle/Entity/Form.php): `app/bundles/FormBundle/Entity/Form.php`
- [Form fields](https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/FormBundle/Model/FieldModel.php): `app/bundles/FormBundle/Model/FieldModel.php`

### Campaign Automation

- [Campaign design](https://github.com/felipesantiaggo/mautic/tree/5.x/app/bundles/CampaignBundle/EventCollector): `app/bundles/CampaignBundle/EventCollector`
- [Campaign membership](https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/CampaignBundle/Membership/EventDispatcher.php): `app/bundles/CampaignBundle/Membership/EventDispatcher.php`
- [Campaign execution](https://github.com/felipesantiaggo/mautic/tree/5.x/app/bundles/CampaignBundle/Executioner): `app/bundles/CampaignBundle/Executioner`
- [Campaign event logs](https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/CampaignBundle/Entity/LeadEventLog.php): `app/bundles/CampaignBundle/Entity/LeadEventLog.php`

### Content and Channels

- [Email content](https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/EmailBundle/Entity/Email.php): `app/bundles/EmailBundle/Entity/Email.php`
- [Channel messaging](https://github.com/felipesantiaggo/mautic/tree/5.x/app/bundles/ChannelBundle): `app/bundles/ChannelBundle`
- [Asset management](https://github.com/felipesantiaggo/mautic/tree/5.x/app/bundles/AssetBundle): `app/bundles/AssetBundle`
- [Content builder](https://github.com/felipesantiaggo/mautic/blob/5.x/plugins/GrapesJsBuilderBundle/Controller/GrapesJsController.php): `plugins/GrapesJsBuilderBundle/Controller/GrapesJsController.php`

### API and Integrations

- [REST API](https://github.com/felipesantiaggo/mautic/tree/5.x/app/bundles/ApiBundle): `app/bundles/ApiBundle`
- [Focus API](https://github.com/felipesantiaggo/mautic/blob/5.x/plugins/MauticFocusBundle/Controller/Api/FocusApiController.php): `plugins/MauticFocusBundle/Controller/Api/FocusApiController.php`
- [Social API](https://github.com/felipesantiaggo/mautic/blob/5.x/plugins/MauticSocialBundle/Controller/Api/TweetApiController.php): `plugins/MauticSocialBundle/Controller/Api/TweetApiController.php`
- [Plugin integrations](https://github.com/felipesantiaggo/mautic/blob/5.x/app/bundles/PluginBundle/Entity/Integration.php): `app/bundles/PluginBundle/Entity/Integration.php`
- [Clearbit lookup](https://github.com/felipesantiaggo/mautic/blob/5.x/plugins/MauticClearbitBundle/Helper/LookupHelper.php): `plugins/MauticClearbitBundle/Helper/LookupHelper.php`
- [Webhook services](https://github.com/felipesantiaggo/mautic/tree/5.x/app/bundles/WebhookBundle): `app/bundles/WebhookBundle`

### Other components

- **Marketer**
- [Mautic application](https://github.com/felipesantiaggo/mautic/tree/5.x/app): `app`
- **Clearbit service**

## Connections

- Marketer → Mautic application: uses
- Mautic application → Form definitions: manages (evidence: `app/bundles/EmailBundle/Controller/EmailController.php`)
- Mautic application → Campaign design: configures
- Form definitions → Form fields: uses fields
- Form definitions → Lead records: captures contacts (evidence: `app/bundles/LeadBundle/Entity/Lead.php`)
- Lead management → Lead records: manages
- Campaign design → Campaign membership: enrolls contacts
- Campaign membership → Lead records: dispatches changes (evidence: `app/bundles/CampaignBundle/Membership/EventDispatcher.php`)
- Campaign membership → Campaign design: dispatches changes (evidence: `app/bundles/CampaignBundle/Membership/EventDispatcher.php`)
- Campaign execution → Campaign event logs: records events
- Campaign design → Campaign execution: runs automation
- Mautic application → Email content: manages content (evidence: `app/bundles/LeadBundle/Controller/LeadController.php`)
- Mautic application → Channel messaging: manages messaging
- Mautic application → Asset management: manages assets (evidence: `app/bundles/EmailBundle/Controller/EmailController.php`)
- Content builder → Email content: edits content (evidence: `plugins/GrapesJsBuilderBundle/Controller/GrapesJsController.php`)
- Content builder → Form definitions: edits content (evidence: `plugins/GrapesJsBuilderBundle/Controller/GrapesJsController.php`)
- Focus API → REST API: extends API (evidence: `plugins/MauticFocusBundle/Controller/Api/FocusApiController.php`)
- Social API → REST API: extends API (evidence: `plugins/MauticSocialBundle/Controller/Api/TweetApiController.php`)
- Clearbit lookup → Lead records: updates records (evidence: `plugins/MauticClearbitBundle/Helper/LookupHelper.php`)
- Clearbit lookup → Company records: updates records (evidence: `plugins/MauticClearbitBundle/Helper/LookupHelper.php`)
- Clearbit lookup → Clearbit service: queries
- Clearbit lookup → Plugin integrations: loads credentials (evidence: `plugins/MauticClearbitBundle/Helper/LookupHelper.php`)
- Mautic application → Plugin integrations: configures plugins (evidence: `app/bundles/PluginBundle/Entity/Integration.php`)
- Mautic application → Webhook services: supports integrations (evidence: `app/bundles/WebhookBundle/Entity/Log.php`)
