Panel/docs/modules/dashboard.md

Dashboard

Workspace reference: GSP-WORKSPACE.md

Purpose

Main landing dashboard with widgets and quick server overview.

Current Status

• Functional
• Uses the existing collapsible widget layout for customer-facing quick actions

Dependencies

• Panel dashboard widgets
• user permissions

Database Tables

• widgets
• widgets_users

Agent Interaction

• indirect through monitor widgets and server summaries

User Workflow

• view server summary widgets
• access quick links

Admin Workflow

• manage dashboard widgets and layout

Security Concerns

• widget visibility should respect permissions

Known Issues

• some default widget IDs are legacy and limit how far the collapsible layout can be expanded without a schema change

Missing Functionality

• richer status and alert surfaces
• deeper async server-status embedding without adding remote checks to normal dashboard loads

Suggested Future Improvements

• surface lifecycle state, support, billing, and docs more prominently

Recommendation

• Keep / Improve

Runlevel Systems Project Request Integration

• Dashboard render file: Panel/modules/dashboard/dashboard.php
• Dashboard styles: Panel/modules/dashboard/dashboard.css
• Shared Panel project URL helper: Panel/includes/functions.php
• Shared Discord invite helper: Panel/includes/functions.php
• Shared server-status route helper: Panel/includes/functions.php

Current project request URL:

• https://runlevelsystems.com/start-project.php

Dashboard behavior:

• retained collapsible sections:
  • Account Overview
  • Custom Server Code
  • Support
• removed duplicate standalone sections:
  • Custom Server Development
  • Support and Troubleshooting
• support remains the path for routine troubleshooting, service issues, and existing features
• the custom-development CTA points users at Runlevel Systems for project work such as custom scripts, mods, integrations, automation, migrations, dashboards, and advanced server tooling
• the Discord support invite should use:
  • https://discord.gg/qt9Hnkj6cv
• Custom Server Code should open the Runlevel project request in a new tab
• Support should keep ticketing and Discord support separate from paid project work
• Server Status stays available from the dashboard, but remote checks are intentionally deferred to the separate status page so normal dashboard loads do not block on agent/network timeouts