# mattyeend/dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/mattyeend/dashboard
- Repository: https://github.com/mattyeend/dashboard

## Overview

Dashboard is a multi-tenant Laravel/Vue administration product: authenticated users work with organisation-scoped CRM, learning, billing and operational data through server-driven pages and APIs. The best-supported concrete workflow is pipeline administration: a request reaches a controller, which queries or manages pipeline records and renders Inertia pages; the README documents a shared service layer and audit logging for state changes. Several product areas are identified by the README and tree, but their internal call paths were not sampled, so those links are omitted or marked unverified.

Main entry points: [`app/Models/Pipeline.php`](https://github.com/mattyeend/dashboard/blob/main/app/Models/Pipeline.php) (Pipeline records), [`app/Http/Controllers/PipelineController.php`](https://github.com/mattyeend/dashboard/blob/main/app/Http/Controllers/PipelineController.php) (Pipeline controller), [`routes/web.php`](https://github.com/mattyeend/dashboard/blob/main/routes/web.php) (Web and API entry), [`app/Models/PipelineStage.php`](https://github.com/mattyeend/dashboard/blob/main/app/Models/PipelineStage.php) (Pipeline stages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and tenancy"]
  node_web["Web and API entry<br/>[web.php]"]
  node_auth["Authentication and roles"]
  node_tenant["Organisation tenancy"]
  node_user_model[("User accounts<br/>[User.php]")]
end

subgraph group_crm["CRM operations"]
  node_pipeline_ui["Pipeline interface"]
  node_pipeline_controller["Pipeline controller"]
  node_pipeline_services["Pipeline services"]
  node_pipeline_query["Pipeline queries<br/>[QueryService.php]"]
  node_pipeline_data[("Pipeline records<br/>[Pipeline.php]")]
  node_stage_controller["Stage controller"]
  node_stage_data[("Pipeline stages<br/>[PipelineStage.php]")]
  node_status_controller["Status controller"]
  node_status_data[("Pipeline statuses<br/>[PipelineStatus.php]")]
  node_deal_data[("Deals and sales<br/>[Deal.php]")]
end

subgraph group_learning["Learning"]
  node_learning_data[("Courses and assessments<br/>[Course.php]")]
end

subgraph group_platform["Platform services"]
  node_billing["Subscriptions and billing"]
  node_backup["Backup operations"]
  node_audit[("Audit logging<br/>[Log.php]")]
  node_reports["Reports and dashboard"]
end

node_user(("Dashboard user"))
node_stripe["Stripe"]

node_user -.->|"initiates requests"| node_web
node_web -.->|"authenticates"| node_auth
node_web -.->|"resolves organisation"| node_tenant
node_tenant -.->|"scopes records"| node_pipeline_data
node_user -.->|"uses"| node_pipeline_ui
node_pipeline_controller -->|"manages records"| node_pipeline_services
node_pipeline_controller -->|"queries records"| node_pipeline_query
node_pipeline_controller -->|"loads model"| node_pipeline_data
node_pipeline_controller -.->|"renders pages"| node_pipeline_ui
node_stage_controller -->|"loads stages"| node_stage_data
node_stage_controller -->|"accepts pipeline"| node_pipeline_data
node_status_controller -->|"loads status"| node_status_data
node_pipeline_data -->|"has stages"| node_stage_data
node_pipeline_data -->|"has status"| node_status_data
node_deal_data -->|"belongs to pipeline"| node_pipeline_data
node_deal_data -->|"belongs to stage"| node_stage_data
node_pipeline_services -.->|"records changes"| node_audit
node_billing -.->|"uses billing provider"| node_stripe
node_learning_data -.->|"records changes"| node_audit

click node_web "https://github.com/mattyeend/dashboard/blob/main/routes/web.php"
click node_auth "https://github.com/mattyeend/dashboard/blob/main/app/Providers/FortifyServiceProvider.php"
click node_tenant "https://github.com/mattyeend/dashboard/blob/main/app/Http/Middleware/ResolveCurrentOrganisation.php"
click node_user_model "https://github.com/mattyeend/dashboard/blob/main/app/Models/User.php"
click node_pipeline_ui "https://github.com/mattyeend/dashboard/blob/main/resources/js/pages/Pipelines/components/PipelineBasicDetailsForm.vue"
click node_pipeline_controller "https://github.com/mattyeend/dashboard/blob/main/app/Http/Controllers/PipelineController.php"
click node_pipeline_services "https://github.com/mattyeend/dashboard/blob/main/app/Services/Pipelines/ManagementService.php"
click node_pipeline_query "https://github.com/mattyeend/dashboard/blob/main/app/Services/Pipelines/QueryService.php"
click node_pipeline_data "https://github.com/mattyeend/dashboard/blob/main/app/Models/Pipeline.php"
click node_stage_controller "https://github.com/mattyeend/dashboard/blob/main/app/Http/Controllers/PipelineStageController.php"
click node_stage_data "https://github.com/mattyeend/dashboard/blob/main/app/Models/PipelineStage.php"
click node_status_controller "https://github.com/mattyeend/dashboard/blob/main/app/Http/Controllers/PipelineStatusController.php"
click node_status_data "https://github.com/mattyeend/dashboard/blob/main/app/Models/PipelineStatus.php"
click node_deal_data "https://github.com/mattyeend/dashboard/blob/main/app/Models/Deal.php"
click node_learning_data "https://github.com/mattyeend/dashboard/blob/main/app/Models/Course.php"
click node_billing "https://github.com/mattyeend/dashboard/tree/main/app/Actions/Payments"
click node_backup "https://github.com/mattyeend/dashboard/tree/main/app/Actions/Backups"
click node_audit "https://github.com/mattyeend/dashboard/blob/main/app/Models/Log.php"
click node_reports "https://github.com/mattyeend/dashboard/blob/main/app/Http/Controllers/ReportController.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_web,node_auth,node_tenant,node_user_model,node_user toneBlue
class node_pipeline_ui,node_pipeline_controller,node_pipeline_services,node_pipeline_query,node_pipeline_data,node_stage_controller,node_stage_data,node_status_controller,node_status_data,node_deal_data toneAmber
class node_learning_data toneMint
class node_billing,node_backup,node_audit,node_reports toneRose
class node_stripe toneIndigo
```

## Components

### Access and tenancy

- [Web and API entry](https://github.com/mattyeend/dashboard/blob/main/routes/web.php): `routes/web.php`
- [Authentication and roles](https://github.com/mattyeend/dashboard/blob/main/app/Providers/FortifyServiceProvider.php): `app/Providers/FortifyServiceProvider.php`
- [Organisation tenancy](https://github.com/mattyeend/dashboard/blob/main/app/Http/Middleware/ResolveCurrentOrganisation.php): `app/Http/Middleware/ResolveCurrentOrganisation.php`
- [User accounts](https://github.com/mattyeend/dashboard/blob/main/app/Models/User.php): `app/Models/User.php`

### CRM operations

- [Pipeline interface](https://github.com/mattyeend/dashboard/blob/main/resources/js/pages/Pipelines/components/PipelineBasicDetailsForm.vue): `resources/js/pages/Pipelines/components/PipelineBasicDetailsForm.vue`
- [Pipeline controller](https://github.com/mattyeend/dashboard/blob/main/app/Http/Controllers/PipelineController.php): `app/Http/Controllers/PipelineController.php`
- [Pipeline services](https://github.com/mattyeend/dashboard/blob/main/app/Services/Pipelines/ManagementService.php): `app/Services/Pipelines/ManagementService.php`
- [Pipeline queries](https://github.com/mattyeend/dashboard/blob/main/app/Services/Pipelines/QueryService.php): `app/Services/Pipelines/QueryService.php`
- [Pipeline records](https://github.com/mattyeend/dashboard/blob/main/app/Models/Pipeline.php): `app/Models/Pipeline.php`
- [Stage controller](https://github.com/mattyeend/dashboard/blob/main/app/Http/Controllers/PipelineStageController.php): `app/Http/Controllers/PipelineStageController.php`
- [Pipeline stages](https://github.com/mattyeend/dashboard/blob/main/app/Models/PipelineStage.php): `app/Models/PipelineStage.php`
- [Status controller](https://github.com/mattyeend/dashboard/blob/main/app/Http/Controllers/PipelineStatusController.php): `app/Http/Controllers/PipelineStatusController.php`
- [Pipeline statuses](https://github.com/mattyeend/dashboard/blob/main/app/Models/PipelineStatus.php): `app/Models/PipelineStatus.php`
- [Deals and sales](https://github.com/mattyeend/dashboard/blob/main/app/Models/Deal.php): `app/Models/Deal.php`

### Learning

- [Courses and assessments](https://github.com/mattyeend/dashboard/blob/main/app/Models/Course.php): `app/Models/Course.php`

### Platform services

- [Subscriptions and billing](https://github.com/mattyeend/dashboard/tree/main/app/Actions/Payments): `app/Actions/Payments`
- [Backup operations](https://github.com/mattyeend/dashboard/tree/main/app/Actions/Backups): `app/Actions/Backups`
- [Audit logging](https://github.com/mattyeend/dashboard/blob/main/app/Models/Log.php): `app/Models/Log.php`
- [Reports and dashboard](https://github.com/mattyeend/dashboard/blob/main/app/Http/Controllers/ReportController.php): `app/Http/Controllers/ReportController.php`

### Other components

- **Dashboard user**
- **Stripe**

## Connections

- Dashboard user → Web and API entry: initiates requests (evidence: `README.md`)
- Web and API entry → Authentication and roles: authenticates (evidence: `README.md`)
- Web and API entry → Organisation tenancy: resolves organisation (evidence: `README.md`)
- Organisation tenancy → Pipeline records: scopes records
- Dashboard user → Pipeline interface: uses (evidence: `README.md`)
- Pipeline controller → Pipeline services: manages records (evidence: `app/Http/Controllers/PipelineController.php`)
- Pipeline controller → Pipeline queries: queries records (evidence: `app/Http/Controllers/PipelineController.php`)
- Pipeline controller → Pipeline records: loads model (evidence: `app/Http/Controllers/PipelineController.php`)
- Pipeline controller → Pipeline interface: renders pages (evidence: `app/Http/Controllers/PipelineController.php`)
- Stage controller → Pipeline stages: loads stages (evidence: `app/Http/Controllers/PipelineStageController.php`)
- Stage controller → Pipeline records: accepts pipeline (evidence: `app/Http/Controllers/PipelineStageController.php`)
- Status controller → Pipeline statuses: loads status (evidence: `app/Http/Controllers/PipelineStatusController.php`)
- Pipeline records → Pipeline stages: has stages (evidence: `app/Models/Pipeline.php`)
- Pipeline records → Pipeline statuses: has status (evidence: `app/Models/Pipeline.php`)
- Deals and sales → Pipeline records: belongs to pipeline (evidence: `app/Models/Deal.php`)
- Deals and sales → Pipeline stages: belongs to stage (evidence: `app/Models/Deal.php`)
- Pipeline services → Audit logging: records changes (evidence: `README.md`)
- Subscriptions and billing → Stripe: uses billing provider (evidence: `README.md`)
- Courses and assessments → Audit logging: records changes (evidence: `README.md`)
