Panel/docs/modules/dashboard.md
2026-06-17 09:15:42 -05:00

2.5 KiB

Dashboard

Workspace reference: GSP-WORKSPACE.md

Purpose

Main landing dashboard with widgets and quick server overview.

Current Status

  • Functional
  • Uses a fixed four-card customer dashboard layout

Dependencies

  • user permissions
  • shared Panel URL helpers

Database Tables

  • none required for the active customer dashboard card layout

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

  • legacy widget infrastructure still exists in the module for historical compatibility, but the active customer dashboard no longer depends on it

Missing Functionality

  • richer status and alert surfaces
  • deeper account summaries if a future design needs per-user metrics beyond the Game Monitor link

Suggested Future Improvements

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

Recommendation

  • Keep / Improve

Current Dashboard Cards

  • 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
  • Theme base: active SimpleBootstrap icon set

Rendered cards:

  • Account Overview
    • button: View My Servers
    • route: home.php?m=gamemanager&p=game_monitor
  • Custom Server Code
    • button: Request Custom Development
    • URL: https://runlevelsystems.com/start-project.php
    • opens in a new tab
  • Support
    • buttons:
      • Create Support Ticket
      • Join Discord
    • support route: home.php?m=tickets&p=submitticket
    • Discord URL: https://discord.gg/qt9Hnkj6cv
  • Server Status
    • button: View Server Status
    • route: server_status.php
    • opens separately so dashboard rendering does not wait on remote checks

Support versus custom development:

  • support is for routine troubleshooting, service issues, and help using included features
  • custom development is for scripts, integrations, automation, migrations, mods, and new tooling

Behavior change:

  • collapsible behavior was removed from the active customer dashboard blocks
  • the old blank-space-prone widget columns are no longer used for the four main customer actions