System Health

The System Health card lives on Admin → System Status, alongside the sync history. It shows whether each scheduled background job ran successfully on its last invocation. Each job has a coloured dot.

What the colours mean

• Green — last run succeeded within the expected window.
• Yellow — the last run succeeded but was late or processed fewer records than expected. Worth a glance, not urgent.
• Red — last run failed, or the job hasn't run for longer than its allowed window. Forecasts and briefs may be stale.

Jobs tracked

• DK daily sync — pulls products, customers, sales, and stock from DK every night around 03:00.
• Forecast snapshots — nightly forecast pass per item, around 03:30.
• DK weekly reconcile — Mondays around 04:00. Catches anything the daily sync missed and reconciles counts.
• Shopify orders — pulls new in-store pickup orders from Shopify every ~10 minutes so the pickup queue stays current. You can also tap Sync on that page to refresh on demand.
• DK transfers — pulls transfers created directly in DK into Store transfers every hour, so they appear for picking without a manual sync. You can still tap Sync DK on that page to pull them in right away.
• DK sales orders — pulls customer orders created in DK into Sales orders every hour for picking. You can also tap Sync DK on that page on demand.
• Product images — two nightly jobs pull product photos from Shopify into Stokk so floor pages like New products and Price changes show a thumbnail. One tops up recently-created items around 05:00; a second, broader pass around 06:00 backfills the rest of the catalogue a batch at a time until every active product has an image. A product with no match on Shopify keeps its placeholder.
• Loyalty pass updates — every 2 minutes, pushes pending loyalty card changes to phones that have the pass saved (Apple Wallet via push; Google cards update on their own). Only does work once Apple Wallet is set up and someone has saved a card.

Each row shows the timestamp of the last run, its duration, and a short status note. A yellow row labelled Partial failuremeans the job finished overall but at least one tenant inside it errored.

Drilling into a run

Click any row in System Health to open the run history for that job. You'll see the last 20 runs, and each row expands to show the per-company breakdown — which tenant succeeded, which failed, the error message, and counters like rows scored and snapshots written. This is where to look when a row is yellow or red.

When a dot goes red or yellow

1. Click the row to open the run history and expand the latest run.
2. Read the per-company error message. Most failures are scoped to one tenant.
3. For ERP sync issues, see Sync troubleshooting.
4. For other jobs, contact Stokk support — most are infrastructure issues we'd want to know about anyway.