Soigneur FHIR Implementation Guide
0.1.0 - ci-build Germany flag

Soigneur FHIR Implementation Guide - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

CodeSystem: Soigneur Observation Codes (cycling metrics without LOINC)

Official URL: https://fhir.soigneur.coach/fhir/CodeSystem/cc-observations Version: 0.1.0
Active as of 2026-11-14 Computable Name: CcObservations

Copyright/Legal: Copyright (c) Soigneur. Licensed under CC0-1.0 (public domain dedication). FHIR(R) is the registered trademark of HL7 and is used with permission.

Cycling / training metrics that have no LOINC concept (05 14.4). The Code identifiers are internal, stable machine keys (np, if, tss, ctl, atl, tsb, …). The Display strings are the trademark-safe product vocabulary (15 1.1): Load, Weighted Power, Intensity, Fitness, Fatigue, Form — never the TrainingPeaks marks (TSS, NP, IF, TSB, PMC).

This Code system is referenced in the content logical definition of the following value sets:

This case-sensitive code system https://fhir.soigneur.coach/fhir/CodeSystem/cc-observations defines the following codes:

CodeDisplayDefinition
ftp Functional Threshold Power Athlete-set threshold-power anchor (W).
eftp Estimated FTP Ratchet-estimated FTP from the power-duration curve (W).
w-prime W-prime (anaerobic work capacity) Anaerobic work capacity above CP (J).
cp Critical power Morton 2-parameter critical-power estimate (W).
p-max Maximal aerobic power Maximal aerobic power (W).
avg-power Average power Per-activity mean power (W).
np Weighted Power 30 s-smoothed 4th-power power (W). Internal alias: NP.
if Intensity Weighted Power / FTP ratio. Internal alias: IF.
power-hr-model Power-HR model Per-athlete linear power↔HR model fitted from rides with both channels; components carry slope/intercept/R²/n/window (W per bpm).
power-hr-slope Power-HR model slope Slope of the power↔HR linear fit (W per bpm).
power-hr-intercept Power-HR model intercept Intercept of the power↔HR linear fit (W).
power-hr-r2 Power-HR model R-squared Coefficient of determination of the power↔HR fit (0-1).
power-hr-n Power-HR model sample count Number of paired power+HR samples in the fit.
power-hr-window-days Power-HR model window Trailing window the fit's samples were collected over (days).
lthr Heart rate threshold Athlete's lactate-threshold heart rate anchor (beats/min), from a field test or athlete acceptance (ADR 0090).
tss Load Per-activity training-load score. Internal alias: TSS.
ctl Fitness 42-day EWMA of daily Load. Internal alias: CTL.
atl Fatigue 7-day EWMA of daily Load. Internal alias: ATL.
tsb Form Fitness minus Fatigue. Internal alias: TSB.
ramp-rate Fitness ramp rate Change in Fitness per week.
pmc-series Load & Form series Weekly Fitness/Fatigue/Form/Load series (one Observation per ISO week, four components as valueSampledData). ADR 0059.
power-zone-time Time in power zone Measured seconds per fixed 5-% FTP bucket (pct-<floor> components; the FTP watts denominator rode as an ftp component).
hr-zone-time Time in heart-rate zone Measured seconds per fixed 5-% HRmax bucket (pct-<floor> components; the HRmax denominator rode as an hrmax component).
hrmax HRmax denominator The HRmax (beats/min) a percentage raster was computed against at ingest — pins the bucket edges so readers fold exactly.
cadence Cadence Pedalling cadence (rpm).
avg-cadence Average cadence Per-activity mean cadence (rpm).
distance Distance Per-activity distance (m).
elevation-gain Elevation gain Per-activity elevation gain (m).
carbs-used Carbohydrates oxidized Estimated carbohydrate oxidation (g).
variability-index Variability index Weighted Power / average power.
decoupling-pw-hr Pw:Hr decoupling Aerobic decoupling: first-half vs second-half power:HR drift (%).
polarization-index Polarization index Log-based intensity-distribution index.
efficiency-factor Efficiency factor Weighted Power / average HR.
wbal-depletion-max Max W-prime balance depletion Peak W-prime depletion over the ride (J).
lr-balance Left-right power balance Right-side power share (%).
lap Lap One provider lap as a component Observation (index, type, duration, and the per-lap metric values), derivedFrom the Activity Group. ADR 0176.
lap-index Lap index Zero-based provider lap index.
lap-type Lap type Provider lap type (e.g. ACTIVE, REST, lap_button).
durability-decline Fatigued power decline Matched-duration fresh-vs-fatigued mean-maximal power decline after the protocol kJ dose (%), one Observation per test duration, derivedFrom the test ride.
durability-test-duration Durability test duration The matched duration (s) the fresh/fatigued pair was measured at.
durability-dose-kj Durability test dose The accumulated mechanical work (kJ) that preceded the fatigued effort.
durability-fresh-w Durability fresh power The fresh-state matched-duration best power (W).
durability-fatigued-w Durability fatigued power The post-dose matched-duration best power (W).
lap-duration Lap duration Lap elapsed duration (s), including pauses.
lap-moving-time Lap moving time Lap moving duration (s), pauses excluded.
max-power Max power Per-lap (or per-window) maximum power (W).
temperature Temperature Per-sample air temperature (°C).
respiration Respiration rate Per-sample respiration rate (breaths/min).
elevation Elevation Per-sample altitude/elevation (m).
speed Speed Per-sample speed (m/s).
position Route Per-sample GPS position (latitude, longitude pairs, °). dimensions=2.
torque Torque Per-sample crank torque (N·m).
trainer-power Trainer power Per-sample power (W) reported by the trainer itself (z_trainer) — the power-match bias estimator's second observation.
command-power Commanded power Per-sample ERG target (W) the player's outer control loop wrote to the trainer.
route-fingerprint Route fingerprint The per-ride comparability record: outdoor resampled GPS track (dimensions=2) + scalar route facts, or the indoor interval-structure signature; derivedFrom the Activity Group. ADR 0225.
route-indoor Route indoor Whether the fingerprint's session was indoor (true) or outdoor (false).
route-distance-m Route distance The route's along-track length (m) from the resampled track.
route-start-lat Route start latitude The resampled track's first latitude (°).
route-start-lon Route start longitude The resampled track's first longitude (°).
route-end-lat Route end latitude The resampled track's last latitude (°).
route-end-lon Route end longitude The resampled track's last longitude (°).
route-lap-count Route lap count The indoor session's executed lap count.
route-structure Route structure The indoor session's quantized interval-structure signature (duration bucket × commanded-watts bucket per lap, ';'-joined).
mmp Mean maximal power Best mean-maximal power by duration for a ride; one component per standard duration (W).
mmp-60 MMP 1 min Best 1-minute mean power (W).
mmp-120 MMP 2 min Best 2-minute mean power (W).
mmp-180 MMP 3 min Best 3-minute mean power (W).
mmp-300 MMP 5 min Best 5-minute mean power (W).
mmp-480 MMP 8 min Best 8-minute mean power (W).
mmp-600 MMP 10 min Best 10-minute mean power (W).
mmp-720 MMP 12 min Best 12-minute mean power (W).
mmp-1200 MMP 20 min Best 20-minute mean power (W).
mmp-1800 MMP 30 min Best 30-minute mean power (W).
mmp-3600 MMP 60 min Best 60-minute mean power (W).
mmp-5400 MMP 90 min Best 90-minute mean power (W).
mmp-7200 MMP 120 min Best 120-minute mean power (W).
mmp-9000 MMP 150 min Best 150-minute mean power (W).
mmp-10800 MMP 180 min Best 180-minute mean power (W).
mmp-12600 MMP 210 min Best 210-minute mean power (W).
mmp-14400 MMP 240 min Best 240-minute mean power (W).
mmp-16200 MMP 270 min Best 270-minute mean power (W).
mmp-18000 MMP 300 min Best 300-minute mean power (W).
hrv-rmssd HRV rMSSD (overnight) Overnight rMSSD (ms); no LOINC exists, method = overnight-rmssd.
body-battery-charged Body Battery charged Garmin Body Battery charge gained (0-100).
body-battery-low Body Battery low Garmin Body Battery daily low (0-100).
body-battery-high Body Battery high Garmin Body Battery daily high (0-100).
body-battery-drained Body Battery drained Garmin Body Battery charge drained (0-100).
body-battery-most-recent Body Battery most recent Most recent Garmin Body Battery (0-100).
garmin-stress-avg Garmin stress (average) Garmin all-day stress average (0-100).
garmin-stress-max Garmin stress (max) Garmin all-day stress maximum (0-100).
garmin-stress-duration Garmin stress duration Garmin all-day stress duration (s).
garmin-sleep-score Garmin sleep score Garmin sleep score (0-100).
sleep-score Sleep score Source-agnostic sleep score (0-100). Garmin-ingested scores keep #garmin-sleep-score; intervals.icu and later sources use this code (ADR 0081).
garmin-hrv-status Garmin HRV status LEGACY (issue #641, ADR 0145): superseded by the source-agnostic #hrv-status. Kept so founder-era dev readings stay valid; new writes never use it.
hrv-status HRV status Provider-reported overnight-HRV status band in the provider's own vocabulary (BALANCED / UNBALANCED / LOW / HIGH for Garmin). A reconciled input beside Soigneur's own HRV-band classification (ADR 0145) — never the coach's verdict by itself.
readiness Readiness score Provider-computed daily readiness score (intervals.icu imports Polar's nightly-recharge status or an app score under this field) — a reconciled secondary input; Soigneur's leading readiness mechanics are its own HRV-band and Form-zone classifications (issue #641, ADR 0145).
body-water-pct Body water percentage Scale-derived body water (%).
muscle-mass Muscle mass Scale-derived muscle mass (kg).
bone-mass Bone mass Scale-derived bone mass (kg).
visceral-fat Visceral fat Scale-derived visceral-fat rating.
metabolic-age Metabolic age Scale-derived metabolic age (a).
training-block-review Training-block review Composed plan-outcome verdict over a training block.
truncated-block-review Truncated block review The deterministic abbreviated outcome for a block cut mid-flight by a structural supersession (ADR 0198): the athlete-confirmed mandate + executed summary, never a composed verdict — so read_plan_outcomes is never empty for a successor build.
experiment-review Experiment review Composed outcome verdict over a fueling/position/equipment experiment.
rolling-baseline Rolling baseline Rolling-baseline derived value (method marker).
life-log Life-log event A dated life event the coach records from chat (a new job, a crash, a stressful project) — episodic memory the timed reader returns, distinct from the physiological diary.
day-call Day call The briefing's machine-readable verdict for the athlete-local day — one per athlete-day; gates the home schedule CTA and grounds the workout designer.
day-call-headline Day call headline The briefing's decision in one sentence — the coach call card's headline (a CcDayCallObservation component).
day-call-reason Day call reason The short why behind the day call — the coach call card's reason line (a CcDayCallObservation component).
day-call-plan-action Day call plan action What the coach did about the plan behind the day call (ADR 0154) — `edited` (the session changed in the same turn), `suggest_add` (an open-day add the athlete's button triggers), or `hint` (a could-do said in prose only). Absent = no plan action.