mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-08 20:42:43 +00:00
Marc-André Bombeck
635e64ace7
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).
docs/ — internal reference + operator playbooks
The user-facing documentation lives at https://docs.healthlog.dev — that's the canonical surface for self-hosting guides, integration walkthroughs, AI-provider setup, and the doctor-report workflow.
The files in this directory are the internal operator playbooks, audit notes, and machine-readable specs that ship alongside the source:
api/— the OpenAPI 3.1 spec for the native-client subset (iOS DTO codegen target). Seeapi/README.mdfor the preview commands.ops/— backup / restore + encryption-key-rotation playbooks. These are the runbooks an operator reaches for during an incident.self-hosting/— horizontal-scaling notes (HEALTHLOG_PROCESS_TYPE=web|worker|all) and the deploy-pipeline recipe. Routine install steps stay ondocs.healthlog.dev.migration/— release-by-release migration notes. Read the entry for the version you're upgrading from.audit/— per-release audit summaries archived for forensic traceability.apple-store-connect-checklist.md— the iOS submission gate.doctor-report.md— PDF generator design notes.codex-protocol-spec.md— Codex / ChatGPT OAuth protocol reverse-engineering notes.ui-guidelines.md— UI / a11y house style.
If you're a self-hoster looking to spin up an instance, start at https://docs.healthlog.dev or jump to the Quick Start in the project README.