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

94 lines
2.5 KiB
Markdown

# Dashboard
Workspace reference: [`GSP-WORKSPACE.md`](../../../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