# 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