Race planning wizard or readiness check looks wrong

Symptom: A wizard step shows "not completed" after you ran the calc

The wizard checks for an active CalculatorResult linked to the race for that calculator type. Reasons it might not match:

• The calc was not run from inside the wizard: a calc run from the standalone catalog without the ?race_id=... URL parameter saves a CalculatorResult with no race attachment. The wizard cannot see it.

Fix: re-run the calc from the wizard step button itself, not from the public catalog.

• An older result is the latest active: if you have multiple results for the same calc + race, only the most recent active one shows. If you marked the most recent as inactive (intentionally or by accident), the wizard falls back to the previous one or reports the step as not completed.

Fix: confirm the most recent CalculatorResult for that race + calc has is_active = True.

Symptom: Wizard shows wrong values from a previous run

• You did not refresh after re-running the calc. The wizard page caches its snapshot at load time.

Fix: refresh the wizard page after each calc run.

• The calc saved to a different race: check the race ID on the saved result.

Symptom: Readiness page shows red even though zones are fresh

• The athlete's MetricHistory entry is dated wrong. Maybe you logged a recent test but accidentally set the date in the future or kept the default of 1989.

Fix: open the MetricHistory entry and correct the date.

• The metric is the right type but the value is unusually low, triggering a 20%-anomaly review (see Activity quality flags).

Fix: open the metric review queue and accept or decline the value.

• Required metric missing: the readiness check lists expected metrics by discipline (see Race readiness checklist). If one is missing entirely, the row shows as missing, not stale.

Fix: log the missing assessment, or run the corresponding calculator.

Symptom: Readiness page does not include a metric you expect

The expected metrics per discipline are fixed in the RACE_READINESS_METRICS dict. The Hub's set:

• Swim: CSS, swim HR threshold, sweat rate.
• Bike: CP, W', FTP, CdA, bike HR threshold, bike speed, sweat rate.
• Run: run threshold pace, run HR threshold, run CP, run W', RSI, sweat rate.
• Physiology: VO2max, gross efficiency, weight, body fat, RMR.

Other custom metrics you log to MetricHistory exist on the athlete profile but are not part of the readiness audit. That is by design.

Symptom: Athlete-side cannot see the wizard

Correct. The wizard is admin / coach only. Athletes see saved wizard outputs on the race detail page but they do not see the wizard dashboard itself.

See also: Race planning wizard tour, Race readiness checklist, Reviewing metric submissions.