# krishnahoccane/musicdesk-frontend architecture

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

## Overview

MusicDesk.tech is a Laravel storefront and customer portal for selling LabelDesk licenses, with integrated payments, invoicing, license administration, and a license-server API. The main workflow is plan selection and checkout, followed by payment, order fulfillment, invoice issuance, and license access. Customers then manage licensing and billing in the portal; LabelDesk installs activate and check in through the API. Admin and installation capabilities are included. Connections use README statements or sampled source references; unsampled implementation details are not inferred.

Main entry points: [`app/Http/Controllers/CheckoutController.php`](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Http/Controllers/CheckoutController.php) (Checkout), [`app/Licensing/ActivationService.php`](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Licensing/ActivationService.php) (Domain activation), [`app/Http/Controllers/Admin`](https://github.com/krishnahoccane/musicdesk-frontend/tree/main/app/Http/Controllers/Admin) (Site administration), [`app/Http/Controllers/InstallController.php`](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Http/Controllers/InstallController.php) (Web installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sales["Storefront and checkout"]
  node_storefront["Sales site<br/>[PageController.php]"]
  node_checkout["Checkout"]
  node_plan[("Plans and add-ons<br/>[Plan.php]")]
end

subgraph group_commerce["Orders and payments"]
  node_org[("Organisation<br/>[Organisation.php]")]
  node_orders[("Orders<br/>[Order.php]")]
  node_pricing["Order pricing<br/>[OrderPricer.php]"]
  node_gateways["Gateway manager<br/>[GatewayManager.php]"]
  node_gatewaydrivers["Payment gateways<br/>[StripeGateway.php]"]
  node_webhooks["Payment webhooks"]
  node_invoices["Invoices<br/>[InvoiceService.php]"]
  node_invoice_data[("Invoice records<br/>[Invoice.php]")]
end

subgraph group_licensing["Licensing platform"]
  node_licenses["License lifecycle<br/>[LicenseService.php]"]
  node_license_data[("License records<br/>[License.php]")]
  node_activation["Domain activation"]
  node_license_api["License server API"]
  node_token["Signed tokens<br/>[LicenseToken.php]"]
end

subgraph group_operations["Customer and site operations"]
  node_customer_portal["Customer portal"]
  node_license_actions["License actions"]
  node_admin["Site administration"]
  node_releases[("Software releases<br/>[Release.php]")]
  node_currency["Currency service"]
end

subgraph group_setup["Installation"]
  node_installer["Web installer"]
  node_installer_core["Installer support<br/>[Installer.php]"]
  node_settings[("Application settings<br/>[Settings.php]")]
end

node_buyer(("Buyer"))
node_labeldesk(("LabelDesk install"))

node_buyer -->|"browses"| node_storefront
node_storefront -->|"starts checkout"| node_checkout
node_checkout -->|"selects plan"| node_plan
node_checkout -->|"creates"| node_org
node_checkout -->|"creates order"| node_orders
node_checkout -->|"prices purchase"| node_pricing
node_checkout -->|"takes payment"| node_gateways
node_gateways -->|"selects driver"| node_gatewaydrivers
node_webhooks -->|"updates payment"| node_orders
node_checkout -->|"issues invoice"| node_invoices
node_invoices -->|"creates record"| node_invoice_data
node_checkout -->|"issues license"| node_licenses
node_licenses -->|"updates records"| node_license_data
node_buyer -->|"manages account"| node_customer_portal
node_customer_portal -->|"manages licenses"| node_license_actions
node_license_actions -->|"manages domains"| node_activation
node_labeldesk -->|"activates installs"| node_license_api
node_license_api -->|"checks activation"| node_activation
node_activation -->|"checks license"| node_licenses
node_activation -->|"issues token"| node_token
node_admin -->|"administers licenses"| node_license_data
node_admin -->|"manages releases"| node_releases
node_admin -->|"manages currencies"| node_currency
node_buyer -->|"installs site"| node_installer
node_installer -->|"records progress"| node_installer_core
node_installer -->|"writes settings"| node_settings

click node_storefront "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Http/Controllers/PageController.php"
click node_checkout "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Http/Controllers/CheckoutController.php"
click node_plan "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Models/Plan.php"
click node_org "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Models/Organisation.php"
click node_orders "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Models/Order.php"
click node_pricing "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Services/Orders/OrderPricer.php"
click node_gateways "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Payments/GatewayManager.php"
click node_gatewaydrivers "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Payments/Gateways/StripeGateway.php"
click node_webhooks "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Http/Controllers/WebhookController.php"
click node_invoices "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Services/Orders/InvoiceService.php"
click node_invoice_data "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Models/Invoice.php"
click node_licenses "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Licensing/LicenseService.php"
click node_license_data "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Models/License.php"
click node_activation "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Licensing/ActivationService.php"
click node_license_api "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Http/Controllers/Api/LicenseServerController.php"
click node_token "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Licensing/LicenseToken.php"
click node_customer_portal "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Http/Controllers/PortalController.php"
click node_license_actions "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Http/Controllers/LicenseActionController.php"
click node_admin "https://github.com/krishnahoccane/musicdesk-frontend/tree/main/app/Http/Controllers/Admin"
click node_releases "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Models/Release.php"
click node_currency "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Services/Currency/CurrencyService.php"
click node_installer "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Http/Controllers/InstallController.php"
click node_installer_core "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Support/Installer/Installer.php"
click node_settings "https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Support/Settings.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_storefront,node_checkout,node_plan toneBlue
class node_org,node_orders,node_pricing,node_gateways,node_gatewaydrivers,node_webhooks,node_invoices,node_invoice_data toneAmber
class node_licenses,node_license_data,node_activation,node_license_api,node_token toneMint
class node_customer_portal,node_license_actions,node_admin,node_releases,node_currency toneRose
class node_installer,node_installer_core,node_settings,node_buyer,node_labeldesk toneIndigo
```

## Components

### Storefront and checkout

- [Sales site](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Http/Controllers/PageController.php): `app/Http/Controllers/PageController.php`
- [Checkout](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Http/Controllers/CheckoutController.php): `app/Http/Controllers/CheckoutController.php`
- [Plans and add-ons](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Models/Plan.php): `app/Models/Plan.php`

### Orders and payments

- [Organisation](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Models/Organisation.php): `app/Models/Organisation.php`
- [Orders](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Models/Order.php): `app/Models/Order.php`
- [Order pricing](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Services/Orders/OrderPricer.php): `app/Services/Orders/OrderPricer.php`
- [Gateway manager](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Payments/GatewayManager.php): `app/Payments/GatewayManager.php`
- [Payment gateways](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Payments/Gateways/StripeGateway.php): `app/Payments/Gateways/StripeGateway.php`
- [Payment webhooks](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Http/Controllers/WebhookController.php): `app/Http/Controllers/WebhookController.php`
- [Invoices](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Services/Orders/InvoiceService.php): `app/Services/Orders/InvoiceService.php`
- [Invoice records](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Models/Invoice.php): `app/Models/Invoice.php`

### Licensing platform

- [License lifecycle](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Licensing/LicenseService.php): `app/Licensing/LicenseService.php`
- [License records](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Models/License.php): `app/Models/License.php`
- [Domain activation](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Licensing/ActivationService.php): `app/Licensing/ActivationService.php`
- [License server API](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Http/Controllers/Api/LicenseServerController.php): `app/Http/Controllers/Api/LicenseServerController.php`
- [Signed tokens](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Licensing/LicenseToken.php): `app/Licensing/LicenseToken.php`

### Customer and site operations

- [Customer portal](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Http/Controllers/PortalController.php): `app/Http/Controllers/PortalController.php`
- [License actions](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Http/Controllers/LicenseActionController.php): `app/Http/Controllers/LicenseActionController.php`
- [Site administration](https://github.com/krishnahoccane/musicdesk-frontend/tree/main/app/Http/Controllers/Admin): `app/Http/Controllers/Admin`
- [Software releases](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Models/Release.php): `app/Models/Release.php`
- [Currency service](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Services/Currency/CurrencyService.php): `app/Services/Currency/CurrencyService.php`

### Installation

- [Web installer](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Http/Controllers/InstallController.php): `app/Http/Controllers/InstallController.php`
- [Installer support](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Support/Installer/Installer.php): `app/Support/Installer/Installer.php`
- [Application settings](https://github.com/krishnahoccane/musicdesk-frontend/blob/main/app/Support/Settings.php): `app/Support/Settings.php`

### Other components

- **Buyer**
- **LabelDesk install**

## Connections

- Buyer → Sales site: browses
- Sales site → Checkout: starts checkout
- Checkout → Plans and add-ons: selects plan (evidence: `app/Http/Controllers/CheckoutController.php`)
- Checkout → Organisation: creates
- Checkout → Orders: creates order (evidence: `app/Http/Controllers/CheckoutController.php`)
- Checkout → Order pricing: prices purchase (evidence: `app/Http/Controllers/CheckoutController.php`)
- Checkout → Gateway manager: takes payment (evidence: `app/Http/Controllers/CheckoutController.php`)
- Gateway manager → Payment gateways: selects driver (evidence: `app/Payments/GatewayManager.php`)
- Payment webhooks → Orders: updates payment
- Checkout → Invoices: issues invoice
- Invoices → Invoice records: creates record (evidence: `app/Services/Orders/InvoiceService.php`)
- Checkout → License lifecycle: issues license
- License lifecycle → License records: updates records (evidence: `app/Licensing/LicenseService.php`)
- Buyer → Customer portal: manages account
- Customer portal → License actions: manages licenses
- License actions → Domain activation: manages domains (evidence: `app/Http/Controllers/LicenseActionController.php`)
- LabelDesk install → License server API: activates installs
- License server API → Domain activation: checks activation (evidence: `app/Http/Controllers/Api/LicenseServerController.php`)
- Domain activation → License lifecycle: checks license (evidence: `app/Licensing/ActivationService.php`)
- Domain activation → Signed tokens: issues token (evidence: `app/Licensing/ActivationService.php`)
- Site administration → License records: administers licenses (evidence: `app/Http/Controllers/Admin/LicenseAdminController.php`)
- Site administration → Software releases: manages releases (evidence: `app/Http/Controllers/Admin/ReleaseAdminController.php`)
- Site administration → Currency service: manages currencies
- Buyer → Web installer: installs site
- Web installer → Installer support: records progress (evidence: `app/Http/Controllers/InstallController.php`)
- Web installer → Application settings: writes settings (evidence: `app/Http/Controllers/InstallController.php`)
