Maintenance Dashboard¶
The Admin Maintenance Dashboard provides administrators with tools to monitor system health, clean up stale data, audit ERP synchronization, and track failed notifications.
Note: This page is available to administrators only. It is accessible from Bookings > Maintenance in the main navigation menu.
Overview¶
The dashboard is organized into four tabs, each with a KPI summary card at the top:
| Tab | KPI Card | What It Monitors |
|---|---|---|
| Carts | Stale Carts | Shopping carts that have been inactive beyond the cleanup threshold |
| Bookings | Zombie Bookings | Bookings stuck in unexpected states (e.g., ENQUIRY for too long, missed expiries) |
| ERP Sync | ERP Failures | Bookings that failed to synchronize with the ERP system |
| Notifications | Failed Notifications | Email and notification deliveries that did not succeed |
Carts Tab¶
Stale Cart Detection¶
A stale cart is one that has not been modified for an extended period and has not been checked out. The system identifies these based on the last-modified timestamp.
What You Can Do¶
- View the list of stale carts with their owner (agent), customer assignment, item count, and last activity date.
- Click Clean Up on individual carts to remove them and release any reserved inventory (e.g., offline tickets).
- Click Clean Up All to remove all stale carts at once.
Automatic Cleanup¶
A background job runs periodically to clean up carts that exceed the inactivity threshold. The maintenance dashboard shows when the last automatic cleanup ran and how many carts were removed.
Bookings Tab¶
Zombie Detection¶
Zombie bookings are those stuck in states that suggest something went wrong:
- Stale Enquiries -- Bookings in ENQUIRY status for an unusually long time with no activity
- Missed Expiries -- OPTION_HELD bookings whose expiry date has passed but were not automatically expired
- Orphaned Bookings -- Bookings with no service lines or no customer assignment
What You Can Do¶
- Review the list of flagged bookings.
- Click Force Expire on missed-expiry bookings to set them to EXPIRED status.
- Click through to individual booking detail pages to investigate and resolve issues.
ERP Sync Tab¶
Audit Missing ERP Records¶
The ERP Sync tab identifies bookings that should have corresponding ERP records (Sales Orders, invoices) but do not.
Common causes:
- Network errors during ERP API calls
- ERP system downtime during booking confirmation
- Data validation errors in the ERP
What You Can Do¶
- View the list of bookings with missing or failed ERP records.
- See the error details for each failure.
- Click Retry Sync on individual bookings to attempt synchronization again.
- Click Retry All to batch-retry all failed syncs.
Tip: If retries continue to fail, check the error details. Common issues include missing customer records in the ERP or invalid product codes on service lines.
Notifications Tab¶
Failed Notification Tracking¶
The Notifications tab shows email and notification deliveries that failed.
What You Can Do¶
- View failed notifications with the booking reference, recipient, notification type, error message, and timestamp.
- Click Retry to attempt redelivery.
- Investigate persistent failures (e.g., invalid email addresses, mail server issues).
Background Jobs¶
The maintenance dashboard also provides visibility into automated background jobs:
| Job | Purpose | Frequency |
|---|---|---|
| Cart Cleanup | Remove stale shopping carts | Runs periodically |
| Expiry Check | Expire past-deadline option holds | Runs periodically |
| Health Monitor | Detect zombie bookings and sync failures | Runs periodically |
The dashboard shows the last run time and result for each job.
Next Steps¶
- Managing Bookings -- Resolving flagged bookings
- Shopping Cart -- Understanding cart lifecycle
- Payments and Checkout -- ERP integration for payments