Admin Dashboard Guide - softerfish/fyuhls GitHub Wiki

Admin Dashboard Guide

The admin dashboard is your daily triage page. It is meant to answer one question quickly:

"What needs attention right now?"

Use it as the first page you open, not as a replacement for the deeper admin screens behind it.

What the dashboard is for

Use the dashboard to:

  • spot health problems early
  • notice growth and storage pressure
  • jump into the correct admin page quickly
  • understand what changed today without scanning the whole platform

A good dashboard workflow

  1. check Attention Needed
  2. check What changed today
  3. scan the top headline cards
  4. open the deeper admin page only for the things that actually need follow-up

Top headline cards

Common top-level metrics include:

  • Total Users
  • Total Files
  • Storage Used
  • Cache Status

These are fast context cards, not the full story.

What Cache Status means

OPTIMIZED

The dashboard is reading precomputed totals from the internal system_stats row.

LIVE (SLOW)

The dashboard is not trusting or not finding that cached summary, so it is recalculating totals from live tables.

Common reasons:

  • stats cache does not exist yet
  • cron has not refreshed stats yet
  • cached file totals do not match live totals

This is usually a performance warning, not an outage.

Attention Needed

This strip is the most important part of the dashboard for day-to-day operations.

It is meant to surface issues before they turn into support pain, payout mistakes, or moderation backlog.

Typical items include:

  • recent errors
  • overdue automation tasks
  • SMTP missing or failing
  • moderation backlog
  • storage pressure
  • encryption key warnings
  • pending encryption migration items
  • database health or drift notices
  • Cloudflare IP sync warnings
  • leftover setup files
  • aged withdrawal pressure
  • fraud review queue pressure

How to read common notices

Recent Errors

This means recent error-level log entries were recorded. It is not a special review queue. Use it as a shortcut into the recent error section on System Status.

Overdue Tasks

This means one or more cron-managed tasks are behind schedule. Review the Cron Jobs area and heartbeat health.

SMTP Missing

This means email delivery is not configured, which affects verification mail, reset mail, and some support flows.

SMTP Failures

This means mail settings exist but delivery is still failing often enough to deserve attention.

Storage Pressure

This means you should review storage nodes and capacity before users hit failures.

Encryption Key

This points to security configuration that needs attention before you treat the install as cleanly migrated.

Encryption Migration

This means enterprise encryption still has pending items to migrate.

Database Health

This reflects schema drift or database-health warnings that also surface inside Config Hub.

Cloudflare IP Sync

This means trusted Cloudflare IP handling may be stale or unsynced.

Setup Files Present

This means install or post-install artifacts may still be present and should be reviewed or removed.

Aged Withdrawals

This is meant to catch payout work that is sitting too long instead of quietly becoming a support problem.

Fraud Review Queue

This means monetized activity is stacking up in manual review and deserves operator attention before withdrawals move forward.

What changed today

This strip is for fast orientation. It gives you a quick read on:

  • daily movement
  • uploads
  • users
  • download activity
  • operational drift

Use it to answer:

  • "Is today normal?"
  • "Did something spike?"
  • "Did something stall?"

Widget layout and saved state

The dashboard supports saved layout state in the browser.

That means admins can:

  • drag widgets into a preferred order
  • collapse widgets they do not need
  • keep that layout in browser storage

Reset layout

Use Reset layout to clear the saved client-side layout state and return to the default arrangement.

Important widgets

Support and Diagnostics

Use it to watch:

  • recent error count
  • SMTP availability
  • plugin count
  • support contact details

System Automation

Use it to spot:

  • overdue tasks
  • failed tasks
  • last run timing

If these drift, review cron before assuming the widget itself is wrong.

Storage Capacity

Use it to catch:

  • tight headroom
  • unhealthy distribution
  • capacity planning issues before uploads start failing

Requests and moderation widgets

Use them to stay ahead of:

  • compliance backlog
  • moderation delay
  • unanswered staff workflows

Clickable metrics

Many dashboard metric chips are intentionally clickable.

Examples:

  • recent errors -> System Status error section
  • SMTP missing -> email configuration
  • overdue tasks -> cron configuration
  • storage pressure -> file-server management

The dashboard should help you jump straight to the page that can actually fix the problem.

What the dashboard is not

The dashboard is not:

  • a replacement for System Status logs
  • a full moderation console
  • the best place for one-record forensic debugging
  • a permanent historical analytics suite

It is the control surface for fast triage and navigation.

Best practices

  • start here every day
  • use Attention Needed before lower-priority widgets
  • treat LIVE (SLOW) as a signal to check stats refresh and cron health
  • follow metric chips into their real detail pages
  • use Reset layout if the saved arrangement stops feeling useful

Short version

The dashboard is your first-stop triage page. It helps you notice problems early, understand what changed today, and jump straight to the page that can actually fix the issue.

⚠️ **GitHub.com Fallback** ⚠️