# infra-neo/cloud-neosc architecture

> Architecture diagram of the GitHub repository infra-neo/cloud-neosc, 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/infra-neo/cloud-neosc
- Repository: https://github.com/infra-neo/cloud-neosc

## Overview

PNLCS is a self-hosted hosting billing platform. Customers use the portal to shop, place orders, pay invoices, manage hosting, domains and SSL, and get support; staff administer the catalog and customer lifecycle. The README documents provisioning through server modules and integrations for payment gateways and registrars. Source excerpts confirm hosting self-service dispatch and core model relationships. Several major subsystems are represented by their exact enclosing directories because their implementation files were not sampled, so their internal calls are not inferred.

Main entry points: [`app/Http/Controllers/Client`](https://github.com/infra-neo/cloud-neosc/tree/main/app/Http/Controllers/Client) (Client Portal), [`app/Http/Controllers/Admin`](https://github.com/infra-neo/cloud-neosc/tree/main/app/Http/Controllers/Admin) (Admin Panel), [`app/Models/Order.php`](https://github.com/infra-neo/cloud-neosc/blob/main/app/Models/Order.php) (Orders), [`app/Http/Controllers/Client/CartController.php`](https://github.com/infra-neo/cloud-neosc/blob/main/app/Http/Controllers/Client/CartController.php) (Cart and Checkout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Customer Portal"]
  node_portal["Client Portal"]
  node_clientdata[("Client Accounts<br/>[Client.php]")]
end

subgraph group_commerce["Commerce and Billing"]
  node_catalog["Product Catalog<br/>[Product.php]"]
  node_checkout["Cart and Checkout<br/>[CartController.php]"]
  node_orders[("Orders<br/>[Order.php]")]
  node_billing[("Invoices and Payments<br/>[Invoice.php]")]
  node_gateway{{"Payment Gateways"}}
end

subgraph group_hosting["Hosting Operations"]
  node_services[("Hosting Services<br/>[Service.php]")]
  node_provisioning["Provisioning"]
  node_servermodules{{"Server Modules"}}
  node_hostingtools["Hosting Self-Service"]
  node_domains[("Domain Management<br/>[Domain.php]")]
  node_registrars{{"Domain Registrars"}}
  node_ssl["SSL Management"]
end

subgraph group_operations["Administration and Support"]
  node_support[("Tickets and Knowledge Base<br/>[Ticket.php]")]
  node_admin["Admin Panel"]
  node_api["System API"]
  node_modules{{"Add-ons and Extensions"}}
  node_themes["Themes and Localization<br/>[ThemeManager.php]"]
  node_reports["Reports"]
end

node_customer(("Customer"))

node_customer -->|"uses"| node_portal
node_portal -->|"browses"| node_catalog
node_portal -->|"places orders"| node_checkout
node_checkout -.->|"creates"| node_orders
node_orders -->|"invoiced through"| node_billing
node_billing -->|"accepts payments"| node_gateway
node_portal -->|"manages account"| node_clientdata
node_orders -->|"activates service"| node_services
node_services -->|"provisioned by"| node_provisioning
node_provisioning -->|"dispatches to"| node_servermodules
node_portal -->|"manages hosting"| node_hostingtools
node_hostingtools -->|"calls module"| node_servermodules
node_portal -->|"manages domains"| node_domains
node_domains -->|"registered through"| node_registrars
node_portal -->|"manages certificates"| node_ssl
node_customer -->|"opens tickets"| node_support
node_admin -->|"handles tickets"| node_support
node_admin -.->|"configures products"| node_catalog
node_admin -.->|"offers API"| node_api
node_admin -.->|"configures extensions"| node_modules
node_admin -->|"customizes appearance"| node_themes
node_admin -.->|"views reports"| node_reports

click node_portal "https://github.com/infra-neo/cloud-neosc/tree/main/app/Http/Controllers/Client"
click node_catalog "https://github.com/infra-neo/cloud-neosc/blob/main/app/Models/Product.php"
click node_checkout "https://github.com/infra-neo/cloud-neosc/blob/main/app/Http/Controllers/Client/CartController.php"
click node_orders "https://github.com/infra-neo/cloud-neosc/blob/main/app/Models/Order.php"
click node_billing "https://github.com/infra-neo/cloud-neosc/blob/main/app/Models/Invoice.php"
click node_gateway "https://github.com/infra-neo/cloud-neosc/tree/main/modules/Gateways"
click node_clientdata "https://github.com/infra-neo/cloud-neosc/blob/main/app/Models/Client.php"
click node_services "https://github.com/infra-neo/cloud-neosc/blob/main/app/Models/Service.php"
click node_provisioning "https://github.com/infra-neo/cloud-neosc/blob/main/app/Services/ProvisioningService.php"
click node_servermodules "https://github.com/infra-neo/cloud-neosc/tree/main/modules/Servers"
click node_hostingtools "https://github.com/infra-neo/cloud-neosc/blob/main/app/Http/Controllers/Client/ServiceController.php"
click node_domains "https://github.com/infra-neo/cloud-neosc/blob/main/app/Models/Domain.php"
click node_registrars "https://github.com/infra-neo/cloud-neosc/tree/main/modules/Registrars"
click node_ssl "https://github.com/infra-neo/cloud-neosc/blob/main/app/Services/SslProvisioningService.php"
click node_support "https://github.com/infra-neo/cloud-neosc/blob/main/app/Models/Ticket.php"
click node_admin "https://github.com/infra-neo/cloud-neosc/tree/main/app/Http/Controllers/Admin"
click node_api "https://github.com/infra-neo/cloud-neosc/tree/main/app/Http/Controllers/Api"
click node_modules "https://github.com/infra-neo/cloud-neosc/tree/main/modules/Addons"
click node_themes "https://github.com/infra-neo/cloud-neosc/blob/main/app/Services/ThemeManager.php"
click node_reports "https://github.com/infra-neo/cloud-neosc/tree/main/modules/Reports"

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_portal,node_clientdata toneBlue
class node_catalog,node_checkout,node_orders,node_billing,node_gateway toneAmber
class node_services,node_provisioning,node_servermodules,node_hostingtools,node_domains,node_registrars,node_ssl toneMint
class node_support,node_admin,node_api,node_modules,node_themes,node_reports toneRose
class node_customer toneIndigo
```

## Components

### Customer Portal

- [Client Portal](https://github.com/infra-neo/cloud-neosc/tree/main/app/Http/Controllers/Client): `app/Http/Controllers/Client`
- [Client Accounts](https://github.com/infra-neo/cloud-neosc/blob/main/app/Models/Client.php): `app/Models/Client.php`

### Commerce and Billing

- [Product Catalog](https://github.com/infra-neo/cloud-neosc/blob/main/app/Models/Product.php): `app/Models/Product.php`
- [Cart and Checkout](https://github.com/infra-neo/cloud-neosc/blob/main/app/Http/Controllers/Client/CartController.php): `app/Http/Controllers/Client/CartController.php`
- [Orders](https://github.com/infra-neo/cloud-neosc/blob/main/app/Models/Order.php): `app/Models/Order.php`
- [Invoices and Payments](https://github.com/infra-neo/cloud-neosc/blob/main/app/Models/Invoice.php): `app/Models/Invoice.php`
- [Payment Gateways](https://github.com/infra-neo/cloud-neosc/tree/main/modules/Gateways): `modules/Gateways`

### Hosting Operations

- [Hosting Services](https://github.com/infra-neo/cloud-neosc/blob/main/app/Models/Service.php): `app/Models/Service.php`
- [Provisioning](https://github.com/infra-neo/cloud-neosc/blob/main/app/Services/ProvisioningService.php): `app/Services/ProvisioningService.php`
- [Server Modules](https://github.com/infra-neo/cloud-neosc/tree/main/modules/Servers): `modules/Servers`
- [Hosting Self-Service](https://github.com/infra-neo/cloud-neosc/blob/main/app/Http/Controllers/Client/ServiceController.php): `app/Http/Controllers/Client/ServiceController.php`
- [Domain Management](https://github.com/infra-neo/cloud-neosc/blob/main/app/Models/Domain.php): `app/Models/Domain.php`
- [Domain Registrars](https://github.com/infra-neo/cloud-neosc/tree/main/modules/Registrars): `modules/Registrars`
- [SSL Management](https://github.com/infra-neo/cloud-neosc/blob/main/app/Services/SslProvisioningService.php): `app/Services/SslProvisioningService.php`

### Administration and Support

- [Tickets and Knowledge Base](https://github.com/infra-neo/cloud-neosc/blob/main/app/Models/Ticket.php): `app/Models/Ticket.php`
- [Admin Panel](https://github.com/infra-neo/cloud-neosc/tree/main/app/Http/Controllers/Admin): `app/Http/Controllers/Admin`
- [System API](https://github.com/infra-neo/cloud-neosc/tree/main/app/Http/Controllers/Api): `app/Http/Controllers/Api`
- [Add-ons and Extensions](https://github.com/infra-neo/cloud-neosc/tree/main/modules/Addons): `modules/Addons`
- [Themes and Localization](https://github.com/infra-neo/cloud-neosc/blob/main/app/Services/ThemeManager.php): `app/Services/ThemeManager.php`
- [Reports](https://github.com/infra-neo/cloud-neosc/tree/main/modules/Reports): `modules/Reports`

### Other components

- **Customer**

## Connections

- Customer → Client Portal: uses
- Client Portal → Product Catalog: browses (evidence: `app/Http/Controllers/Client/ServiceController.php`)
- Client Portal → Cart and Checkout: places orders
- Cart and Checkout → Orders: creates
- Orders → Invoices and Payments: invoiced through (evidence: `app/Models/Order.php`)
- Invoices and Payments → Payment Gateways: accepts payments
- Client Portal → Client Accounts: manages account (evidence: `app/Http/Controllers/Client/ServiceController.php`)
- Orders → Hosting Services: activates service (evidence: `app/Models/Order.php`)
- Hosting Services → Provisioning: provisioned by (evidence: `app/Models/Service.php`)
- Provisioning → Server Modules: dispatches to
- Client Portal → Hosting Self-Service: manages hosting
- Hosting Self-Service → Server Modules: calls module (evidence: `app/Http/Controllers/Client/ServiceController.php`)
- Client Portal → Domain Management: manages domains
- Domain Management → Domain Registrars: registered through
- Client Portal → SSL Management: manages certificates
- Customer → Tickets and Knowledge Base: opens tickets
- Admin Panel → Tickets and Knowledge Base: handles tickets
- Admin Panel → Product Catalog: configures products (evidence: `app/Http/Controllers/Admin/ClientController.php`)
- Admin Panel → System API: offers API
- Admin Panel → Add-ons and Extensions: configures extensions
- Admin Panel → Themes and Localization: customizes appearance
- Admin Panel → Reports: views reports
