Health center.

The Health center is a read-only diagnostics dashboard available to super administrators. It runs real-time checks against your server environment, database, storage, and services, helping you identify and resolve configuration issues before they affect your users.

Accessing the health center

Navigate to Admin → Health center in the sidebar. The Health center is only visible to super administrators (role 1).

A JSON endpoint is also available at /{locale}/admin/health/json for programmatic monitoring or external uptime tools.

What gets checked

The Health center runs 20 diagnostic checks across 5 categories:

Environment

Application

Database

Storage

Services

The sweep and delivery rows always appear in the list. When a feature is not in use, the row reads OK with Not configured (birthday, win-back, and achievement rewards) or No active passes (pass expiry) instead of disappearing.

Status levels

Each check reports one of three statuses:

• OK: Check passed, no action needed
• Warning: Non-critical issue that should be reviewed
• Critical: Requires immediate attention

The summary cards at the top show the total count for each status level.

Cron / scheduler (recommended)

Reward Loyalty uses Laravel's task scheduler for background operations. All core loyalty features work without cron: it is recommended for automated maintenance, not required.

What the scheduler handles:

• OTP cleanup: Removes expired one-time passwords hourly
• Birthday vouchers: Issues birthday rewards daily at 02:30
• Win-back vouchers: Issues win-back rewards daily at 02:45
• Activation nudges: Sends the activation nudge to members who added a card but haven't visited yet, daily at 02:50
• Stamp card expiration: Processes expired stamps daily at 03:00
• Pass expiry: Closes out lapsed prepaid passes and sends expiry reminders daily at 03:15
• Points expiry: Closes out expired points and sends expiry reminders daily at 03:30
• Achievement reward delivery: Delivers pending achievement rewards every minute
• Demo refresh: Resets demo data daily (demo mode only)
• Health heartbeat: Writes a timestamp every minute for diagnostics

In the Health center itself, each of these maintenance tasks appears with a one-line description of what it does and a Run now button, so an operator sees what a task will do and can trigger it by hand when cron is not set up.

To enable the scheduler, add this cron entry to your server:

* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1

On cPanel, use the Cron Jobs interface to add this command with a "Once Per Minute" frequency.

If the scheduler is not configured, the Health center shows a warning. The daily loyalty tasks (birthday vouchers, win-back vouchers, activation nudges, stamp card expiration, pass expiry, and points expiry) still run: the first admin, partner, or staff activity of the day triggers them in the background, at most once per day. Achievement reward delivery falls back the same way, on normal traffic at most once per minute. OTP codes still expire on their own, but database cleanup runs only with cron, and the daily tasks may run later in the day than their scheduled time.

Scheduled tasks panel

Below the status banner, the Scheduled tasks panel shows the recurring maintenance tasks (birthday vouchers, win-back vouchers, activation nudges, stamp card expiration, pass expiry, voucher expiry reminders, points expiry, webhook log cleanup, and achievement reward delivery) with the date of their last run and the result. Each task has a Run now button that processes it right away. All tasks are safe to run more than once: members never receive duplicate birthday or win-back vouchers, no member is invited to activate more than once, stamps only expire when they are due, each expiry reminder sends at most once, and a reward is never delivered twice.

Use Run now after configuring a birthday or win-back reward to issue today's vouchers right away, or to verify a task works before relying on the schedule.

Achievement reward delivery

When any business runs an achievements program, the Health center adds an Achievement reward delivery panel with the numbers behind the services check:

• Needs attention (only while failed deliveries exist): every affected business by name, how many of its rewards failed, why in plain words ("Reward product is inactive", "Member account was removed"), and how long the oldest failure has waited. Open reward deliveries signs you into that business (a normal, logged impersonation) and lands on its reward deliveries, where you repair or release each one; see when delivery fails. The list shows the fifty busiest businesses and says how many more are affected. It names businesses and reasons only, never a member or a reward's settings.
• Rewards waiting and the Longest-waiting reward: rewards a member earned but that have not reached their wallet yet, and how long the oldest has waited. If these climb on an install with no cron and little traffic, that is expected; press the button below to deliver them at once, or set up cron.
• Rewards that failed: deliveries that stopped after repeated errors. Each one waits under Needs attention above until it is repaired and retried, or released.
• Active history imports, the Oldest import, last active time, and any Stalled or Failed history imports: the state of the past-activity recognition that runs when a business first starts its program. "Last active" is the last time the oldest running import showed progress.

Deliver pending rewards now delivers a small batch (up to 20 rewards) at once and also nudges a stalled history import along. It is safe to press as often as you like; a reward can never deliver twice. It moves rewards that are waiting. A delivery that already failed only moves again once its cause is repaired and it is retried (or released) from the business's reward deliveries, which is where Open reward deliveries takes you. A history import that stopped after repeated errors shows as failed here; an administrator repairs it by running the achievements:reconcile command for that business. See Achievements troubleshooting.

Queue driver guidance

Reward Loyalty uses queued jobs for email delivery, notifications, and integrations. The queue driver determines how these jobs are processed:

For most self-hosted installs, sync is fine. The application works with sync queues. Jobs run inline instead of later. If you notice slow page loads when sending email or processing large batches, switch to database and run a queue worker.

To start a queue worker (for database or Redis drivers):

php artisan queue:work --sleep=3 --tries=3

On production servers, use a process manager like Supervisor to keep the worker running.

JSON API

The Health center JSON endpoint returns structured diagnostic data:

GET /{locale}/admin/health/json

Response:

{
  "success": true,
  "data": {
    "checks": [
      {
        "category": "environment",
        "label": "PHP Version",
        "status": "ok",
        "value": "8.4.1",
        "detail": null
      }
    ],
    "summary": {
      "ok": 19,
      "warning": 1,
      "critical": 0,
      "total": 20
    }
  }
}

This endpoint requires admin authentication and super administrator role.