Launch health check
Route: /org/ecom/health-check · Permission: view E-commerce health to Launch
Module: org_ecom_health · Menu: Menu Listing of Ecommerce Launch Health
1. What it is
E-commerce Launch Health Check — an on-demand audit that answers one question: is this store safe to open?
It groups individual checks into sections, rates each on a red/amber/green scale, and rolls them up into a single overall verdict. Where something fails, it offers a link straight to the screen that fixes it.
| Status | Label | Meaning |
|---|---|---|
GREEN | Ready | Nothing to do |
AMBER | Attention | Works, but should be looked at |
RED | Blocking | Would break the store for customers |
2. Where it fits
It is a read across other modules, not a settings screen of its own — which is why it is the last thing to run before launch and the first thing to run when a store misbehaves.
3. Reading the report — step by step
Step 1 · Run it
The report is generated on demand. A failure to run reports Failed to run health check.
Step 2 · Read the verdict
A banner states Storefront is launch-ready, or the overall status where it is not, alongside counts — "N ready" and the amber and red tallies.
Step 3 · Work the sections
Each section carries its own status and expands into individual checks, each with its own rating.
Step 4 · Follow the fix link
Any check that is not green and has a fix_link offers a direct jump to the screen that
resolves it.
Rather than walking the nine Store Settings sections looking for what is missing, run the health check and follow the links it gives you. It is the same instinct as Timeline Health in Orbit Ops — a computed list of things somebody has to decide about.
4. Field reference
| Element | Behaviour |
|---|---|
| Overall banner | Storefront is launch-ready, or the overall status |
| Counts | Ready / attention / blocking |
| Section | Status plus its own checks |
| Check | Status, description, and a fix link when not green |
Green checks carry no fix link — there is nothing to fix.
5. The admin contract
| Prerequisite | Without it |
|---|---|
| view E-commerce health to Launch | No access |
| Menu Listing of Ecommerce Launch Health | No sidebar entry |
| A selected project | Nothing to audit |
6. Downstream
The health check writes nothing. It reads configuration and reports.
7. Don't confuse this with…
| Thing | Where | Why |
|---|---|---|
| Launch health check (this page) | /org/ecom/health-check | Is the store safe to open? |
| Store Settings | /org/ecom/storesettings | Where most fixes are applied |
| Timeline Health | Orbit Ops | The same idea, for schedules |
8. Troubleshooting
| Symptom | Cause |
|---|---|
Failed to run health check | The report could not be generated — retry, then check project selection |
| Blocking items after launch | The store is live with a real defect; follow the fix links |
| A check has no fix link | It is green, or the fix is not a single screen |
| Status differs between projects | Each project is audited separately |