# codespheretechnologies/crm-ai architecture

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

- Interactive diagram: https://gitdiagram.com/codespheretechnologies/crm-ai
- Repository: https://github.com/codespheretechnologies/crm-ai

## Overview

This Laravel CRM supports client hunting: users sign in, manage and qualify leads, track lead activity and reminders, configure outreach channels, and record outreach against leads. The sampled lead controller shows search, status/source filtering, dashboard counts, status changes, and image handling; the README identifies lead generation as the product. Outreach and authentication capabilities are represented from their sampled controllers, while routes and other unsampled modules are shown only where their paths are present in the tree.

Main entry points: [`app/Http/Controllers/Auth/RegisteredUserController.php`](https://github.com/codespheretechnologies/crm-ai/blob/main/app/Http/Controllers/Auth/RegisteredUserController.php) (Registration), [`app/Http/Controllers/LeadController.php`](https://github.com/codespheretechnologies/crm-ai/blob/main/app/Http/Controllers/LeadController.php) (Lead Workflow), [`app/Http/Controllers/OutreachController.php`](https://github.com/codespheretechnologies/crm-ai/blob/main/app/Http/Controllers/OutreachController.php) (Outreach Workflow), [`routes/web.php`](https://github.com/codespheretechnologies/crm-ai/blob/main/routes/web.php) (Web Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Accounts"]
  node_user[("User<br/>[User.php]")]
  node_auth["Authentication"]
  node_registration["Registration"]
  node_welcome_mail["Welcome Email<br/>[WelcomeUser.php]"]
end

subgraph group_lead["Lead Management"]
  node_leads[("Lead Records<br/>[Lead.php]")]
  node_lead_controller["Lead Workflow<br/>[LeadController.php]"]
  node_activity[("Lead Activity<br/>[LeadActivity.php]")]
  node_reminder[("Lead Reminders<br/>[LeadReminder.php]")]
end

subgraph group_outreach["Outreach Tracking"]
  node_outreach_controller["Outreach Workflow"]
  node_outreach[("Outreach Records<br/>[Outreach.php]")]
  node_channel_controller["Channel Management"]
  node_channel[("Outreach Channels")]
end

subgraph group_presentation["Web Interface"]
  node_web_routes["Web Routes<br/>[web.php]"]
  node_auth_routes["Auth Routes<br/>[auth.php]"]
  node_lead_views["Lead Screens"]
  node_outreach_views["Outreach Screens<br/>[index.blade.php]"]
  node_channel_views["Channel Screens<br/>[index.blade.php]"]
  node_auth_views["Account Screens<br/>[login.blade.php]"]
end

node_visitor(("User"))
node_mail_service{{"Mail Service"}}

node_visitor -->|"sends requests"| node_web_routes
node_visitor -->|"sends requests"| node_auth_routes
node_web_routes -->|"dispatches"| node_lead_controller
node_web_routes -->|"dispatches"| node_outreach_controller
node_web_routes -->|"dispatches"| node_channel_controller
node_auth_routes -->|"dispatches"| node_auth
node_auth_routes -->|"dispatches"| node_registration
node_lead_controller -->|"reads and writes"| node_leads
node_lead_controller -->|"records activity"| node_activity
node_lead_controller -->|"reads reminders"| node_reminder
node_lead_controller -->|"renders"| node_lead_views
node_outreach_controller -->|"reads leads"| node_leads
node_outreach_controller -->|"reads channels"| node_channel
node_outreach_controller -->|"reads and writes"| node_outreach
node_outreach_controller -->|"renders"| node_outreach_views
node_channel_controller -->|"reads and writes"| node_channel
node_channel_controller -->|"renders"| node_channel_views
node_auth -->|"renders"| node_auth_views
node_registration -->|"creates account"| node_user
node_registration -->|"sends"| node_welcome_mail
node_registration -->|"delivers email"| node_mail_service
node_registration -->|"renders"| node_auth_views

click node_user "https://github.com/codespheretechnologies/crm-ai/blob/main/app/Models/User.php"
click node_auth "https://github.com/codespheretechnologies/crm-ai/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php"
click node_registration "https://github.com/codespheretechnologies/crm-ai/blob/main/app/Http/Controllers/Auth/RegisteredUserController.php"
click node_welcome_mail "https://github.com/codespheretechnologies/crm-ai/blob/main/app/Mail/WelcomeUser.php"
click node_leads "https://github.com/codespheretechnologies/crm-ai/blob/main/app/Models/Lead.php"
click node_lead_controller "https://github.com/codespheretechnologies/crm-ai/blob/main/app/Http/Controllers/LeadController.php"
click node_activity "https://github.com/codespheretechnologies/crm-ai/blob/main/app/Models/LeadActivity.php"
click node_reminder "https://github.com/codespheretechnologies/crm-ai/blob/main/app/Models/LeadReminder.php"
click node_outreach_controller "https://github.com/codespheretechnologies/crm-ai/blob/main/app/Http/Controllers/OutreachController.php"
click node_outreach "https://github.com/codespheretechnologies/crm-ai/blob/main/app/Models/Outreach.php"
click node_channel_controller "https://github.com/codespheretechnologies/crm-ai/blob/main/app/Http/Controllers/OutreachchannelController.php"
click node_channel "https://github.com/codespheretechnologies/crm-ai/blob/main/app/Models/Outreachchannel.php"
click node_web_routes "https://github.com/codespheretechnologies/crm-ai/blob/main/routes/web.php"
click node_auth_routes "https://github.com/codespheretechnologies/crm-ai/blob/main/routes/auth.php"
click node_lead_views "https://github.com/codespheretechnologies/crm-ai/blob/main/resources/views/admin/lead/dashboard.blade.php"
click node_outreach_views "https://github.com/codespheretechnologies/crm-ai/blob/main/resources/views/admin/outreach/index.blade.php"
click node_channel_views "https://github.com/codespheretechnologies/crm-ai/blob/main/resources/views/admin/outreachchannel/index.blade.php"
click node_auth_views "https://github.com/codespheretechnologies/crm-ai/blob/main/resources/views/auth/login.blade.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_user,node_auth,node_registration,node_welcome_mail,node_visitor toneBlue
class node_leads,node_lead_controller,node_activity,node_reminder toneAmber
class node_outreach_controller,node_outreach,node_channel_controller,node_channel toneMint
class node_web_routes,node_auth_routes,node_lead_views,node_outreach_views,node_channel_views,node_auth_views toneRose
class node_mail_service toneIndigo
```

## Components

### Accounts

- [User](https://github.com/codespheretechnologies/crm-ai/blob/main/app/Models/User.php): `app/Models/User.php`
- [Authentication](https://github.com/codespheretechnologies/crm-ai/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php): `app/Http/Controllers/Auth/AuthenticatedSessionController.php`
- [Registration](https://github.com/codespheretechnologies/crm-ai/blob/main/app/Http/Controllers/Auth/RegisteredUserController.php): `app/Http/Controllers/Auth/RegisteredUserController.php`
- [Welcome Email](https://github.com/codespheretechnologies/crm-ai/blob/main/app/Mail/WelcomeUser.php): `app/Mail/WelcomeUser.php`

### Lead Management

- [Lead Records](https://github.com/codespheretechnologies/crm-ai/blob/main/app/Models/Lead.php): `app/Models/Lead.php`
- [Lead Workflow](https://github.com/codespheretechnologies/crm-ai/blob/main/app/Http/Controllers/LeadController.php): `app/Http/Controllers/LeadController.php`
- [Lead Activity](https://github.com/codespheretechnologies/crm-ai/blob/main/app/Models/LeadActivity.php): `app/Models/LeadActivity.php`
- [Lead Reminders](https://github.com/codespheretechnologies/crm-ai/blob/main/app/Models/LeadReminder.php): `app/Models/LeadReminder.php`

### Outreach Tracking

- [Outreach Workflow](https://github.com/codespheretechnologies/crm-ai/blob/main/app/Http/Controllers/OutreachController.php): `app/Http/Controllers/OutreachController.php`
- [Outreach Records](https://github.com/codespheretechnologies/crm-ai/blob/main/app/Models/Outreach.php): `app/Models/Outreach.php`
- [Channel Management](https://github.com/codespheretechnologies/crm-ai/blob/main/app/Http/Controllers/OutreachchannelController.php): `app/Http/Controllers/OutreachchannelController.php`
- [Outreach Channels](https://github.com/codespheretechnologies/crm-ai/blob/main/app/Models/Outreachchannel.php): `app/Models/Outreachchannel.php`

### Web Interface

- [Web Routes](https://github.com/codespheretechnologies/crm-ai/blob/main/routes/web.php): `routes/web.php`
- [Auth Routes](https://github.com/codespheretechnologies/crm-ai/blob/main/routes/auth.php): `routes/auth.php`
- [Lead Screens](https://github.com/codespheretechnologies/crm-ai/blob/main/resources/views/admin/lead/dashboard.blade.php): `resources/views/admin/lead/dashboard.blade.php`
- [Outreach Screens](https://github.com/codespheretechnologies/crm-ai/blob/main/resources/views/admin/outreach/index.blade.php): `resources/views/admin/outreach/index.blade.php`
- [Channel Screens](https://github.com/codespheretechnologies/crm-ai/blob/main/resources/views/admin/outreachchannel/index.blade.php): `resources/views/admin/outreachchannel/index.blade.php`
- [Account Screens](https://github.com/codespheretechnologies/crm-ai/blob/main/resources/views/auth/login.blade.php): `resources/views/auth/login.blade.php`

### Other components

- **User**
- **Mail Service**

## Connections

- User → Web Routes: sends requests
- User → Auth Routes: sends requests
- Web Routes → Lead Workflow: dispatches
- Web Routes → Outreach Workflow: dispatches
- Web Routes → Channel Management: dispatches
- Auth Routes → Authentication: dispatches
- Auth Routes → Registration: dispatches
- Lead Workflow → Lead Records: reads and writes
- Lead Workflow → Lead Activity: records activity
- Lead Workflow → Lead Reminders: reads reminders
- Lead Workflow → Lead Screens: renders
- Outreach Workflow → Lead Records: reads leads
- Outreach Workflow → Outreach Channels: reads channels
- Outreach Workflow → Outreach Records: reads and writes
- Outreach Workflow → Outreach Screens: renders
- Channel Management → Outreach Channels: reads and writes
- Channel Management → Channel Screens: renders
- Authentication → Account Screens: renders
- Registration → User: creates account
- Registration → Welcome Email: sends
- Registration → Mail Service: delivers email
- Registration → Account Screens: renders