feat(healthkit): ingest seven additive HealthKit signals end-to-end

Wire seven previously-deferred HealthKit quantity identifiers through
the full pipeline — enum, mapping, plausibility range, category, list-UI
metadata, FHIR coding, and the generic metric-status assessment:

  CARDIO_RECOVERY          heartRateRecoveryOneMinute   bpm
  WRIST_TEMPERATURE        appleSleepingWristTemperature celsius
  FALL_COUNT               numberOfTimesFallen           count
  SIX_MINUTE_WALK_DISTANCE sixMinuteWalkTestDistance     m
  STAIR_ASCENT_SPEED       stairAscentSpeed              m/s
  STAIR_DESCENT_SPEED      stairDescentSpeed             m/s
  BREATHING_DISTURBANCES   appleSleepingBreathingDisturbances count

Each value rides raw on the wire (identity conversion). Fall count is
cumulative (daily SUM); the stair speeds drain to a daily mean; the rest
store as latest per-workout / per-night spot readings. Wrist temperature
and breathing disturbances are flagged privacy-sensitive. The category
sleep-apnea and walking-steadiness EVENT identifiers stay deferred — they
are events, not quantities.

Each new metric gains an Insights sub-page on the shared scaffold with the
generic assessment card, localised across all six locales. Cardio fitness
(VO2 max) — ingested since v1.4.23 but assessment-less — gains its own
/insights/cardio-fitness page so it picks up the assessment instead of
riding as a bare chart-row on the pulse page.

Normal-range anchors are cited where defensible (six-minute walk 400-700 m,
ATS guideline + population reference); the rest defer to the user's own
baseline rather than fabricate a band.

Migration 0104 appends the enum values additively (IF NOT EXISTS, forward-only).
This commit is contained in:
Marc-André Bombeck committed 2026-06-02 22:02:50 +02:00
1 parent 30be0c4e0d
commit 635e64ace7
33 files changed
+1596 -34

No files matched your search

+58
View File
@@ -376,6 +376,13 @@ paths:
- WALKING_DOUBLE_SUPPORT
- WALKING_STEP_LENGTH
- WALKING_SPEED
- CARDIO_RECOVERY
- WRIST_TEMPERATURE
- FALL_COUNT
- SIX_MINUTE_WALK_DISTANCE
- STAIR_ASCENT_SPEED
- STAIR_DESCENT_SPEED
- BREATHING_DISTURBANCES
- in: query
name: from
schema:
@@ -509,6 +516,13 @@ paths:
- WALKING_DOUBLE_SUPPORT
- WALKING_STEP_LENGTH
- WALKING_SPEED
- CARDIO_RECOVERY
- WRIST_TEMPERATURE
- FALL_COUNT
- SIX_MINUTE_WALK_DISTANCE
- STAIR_ASCENT_SPEED
- STAIR_DESCENT_SPEED
- BREATHING_DISTURBANCES
value:
type: number
measuredAt:
@@ -2069,6 +2083,13 @@ paths:
- WALKING_DOUBLE_SUPPORT
- WALKING_STEP_LENGTH
- WALKING_SPEED
- CARDIO_RECOVERY
- WRIST_TEMPERATURE
- FALL_COUNT
- SIX_MINUTE_WALK_DISTANCE
- STAIR_ASCENT_SPEED
- STAIR_DESCENT_SPEED
- BREATHING_DISTURBANCES
description: "The measurement type to read (single metric — no fan-out). Closed enum: an unknown type 422s."
required: true
description: "The measurement type to read (single metric — no fan-out). Closed enum: an unknown type 422s."
@@ -2312,6 +2333,13 @@ paths:
- AUDIO_EXPOSURE_HEADPHONE
- AUDIO_EXPOSURE_EVENT
- SLEEP_DURATION
- CARDIO_RECOVERY
- WRIST_TEMPERATURE
- FALL_COUNT
- SIX_MINUTE_WALK_DISTANCE
- STAIR_ASCENT_SPEED
- STAIR_DESCENT_SPEED
- BREATHING_DISTURBANCES
description: "HealthKit metric id to assess (e.g. RESTING_HEART_RATE, SLEEP_DURATION). Closed enum: an unknown id 422s.
The seven specialised metrics are served by their own routes and are not accepted here."
required: true
@@ -3165,17 +3193,25 @@ components:
- double-support-time
- step-length
- walking-speed
- cardio-fitness
- falls
- six-minute-walk
- stair-ascent-speed
- stair-descent-speed
- sleep
- breathing-disturbances
- resting-pulse
- hrv
- pulse-wave-velocity
- vascular-age
- cardio-recovery
- environmental-audio
- headphone-audio
- audio-events
- daylight
- blood-glucose
- skin-temperature
- wrist-temperature
- mood
- medications
- blutdruck
@@ -3715,6 +3751,13 @@ components:
- WALKING_DOUBLE_SUPPORT
- WALKING_STEP_LENGTH
- WALKING_SPEED
- CARDIO_RECOVERY
- WRIST_TEMPERATURE
- FALL_COUNT
- SIX_MINUTE_WALK_DISTANCE
- STAIR_ASCENT_SPEED
- STAIR_DESCENT_SPEED
- BREATHING_DISTURBANCES
value:
type: number
unit:
@@ -4005,6 +4048,13 @@ components:
- WALKING_DOUBLE_SUPPORT
- WALKING_STEP_LENGTH
- WALKING_SPEED
- CARDIO_RECOVERY
- WRIST_TEMPERATURE
- FALL_COUNT
- SIX_MINUTE_WALK_DISTANCE
- STAIR_ASCENT_SPEED
- STAIR_DESCENT_SPEED
- BREATHING_DISTURBANCES
value:
type: number
unit:
@@ -7766,17 +7816,25 @@ components:
- double-support-time
- step-length
- walking-speed
- cardio-fitness
- falls
- six-minute-walk
- stair-ascent-speed
- stair-descent-speed
- sleep
- breathing-disturbances
- resting-pulse
- hrv
- pulse-wave-velocity
- vascular-age
- cardio-recovery
- environmental-audio
- headphone-audio
- audio-events
- daylight
- blood-glucose
- skin-temperature
- wrist-temperature
- mood
- medications
- blutdruck