Race planning wizard tour

What the wizard does

The race planning wizard is a 7-step dashboard that walks you through running the right calculators in the right order for one race. Each step launches a calculator pre-scoped to the athlete and the race. The result of each calculator is saved as a CalculatorResult linked to the race, so when you come back the wizard shows which steps are complete and what the latest values are.

URL: /admin/race-planning-wizard/<race_id>/.

The 7 steps

1. Swim Pace (CSS). Runs the CSS calculator from a 400 m and 200 m test. Outputs: CSS pace, SDI score.
2. Critical Power. Runs the CP calculator from a 3-minute and 12-minute power test. Outputs: CP and W' (kJ).
3. Aerodynamics (CdA). Measures drag coefficient from a field test or FIT file. Outputs: CdA.
4. Bike Power Plan. Predicts the bike split from power, CdA, weight, and the course profile. Outputs: bike time, average watts.
5. Finish Time. Combines swim, bike, and run leg estimates into a total race finish time. Outputs: total time and per-leg times.
6. Calorie Estimate. Estimates total energy expenditure per leg. Outputs: total calories.
7. Race Fueling Plan. Builds an hour-by-hour nutrition strategy. Outputs: a summary plan.

How completion is tracked

The wizard dashboard reads the most recent active CalculatorResult for each calculator scoped to this race. If one exists, the step shows as completed with the last run date and key output values. If not, the step shows as pending.

You can re-run any step at any time; the new result becomes the active one (the older runs stay in history).

After the wizard

Once the wizard is far enough along, run the readiness check (see Race readiness checklist) to confirm the athlete's underlying threshold metrics are recent enough for the projections to be trustworthy.

Coming back later

Every step's calculator saves its own state. The wizard is the dashboard; the calculators are the work surface. Leave any step mid-way and the work persists in the calculator's saved result.