mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-08 12:32:43 +00:00
Marc-André Bombeck
17b8d8d2c2
Largest feature delta in the v1.4.x line. Insights expands into seven dedicated metric sub-pages; GLP-1 medication tracking lands end-to-end (drug-level chart with Research Mode acknowledgment, EMA titration ladder, cadence + compliance, side-effect taxonomy, pen/vial inventory); cross-source priority becomes a two-axis resolver; per-user timezone threads through ten analytics surfaces; Withings activity + sleep v2 sync; onboarding rebuilt as a nested-route wizard; Personal Records ship end-to-end; Health Score provenance accordion; Coach runs native first-party prompts across six locales with a 1800-assertion refusal-probe matrix; OpenAPI drift gate hard-fails; multi-arch GHCR image. Migrations 0043 through 0060 are additive and forward-only. PROMPT_VERSION 4.24.0 → 4.25.0 with GROUND RULE 9 (refuses dose recommendations) and GROUND RULE 15 (refuses drug-level estimates with MDR + MDCG 2021-24 cites). See CHANGELOG.md for the full per-section delta.
70 lines
3.3 KiB
SQL
70 lines
3.3 KiB
SQL
-- v1.4.25 W8d — Workout + WorkoutRoute schema.
|
|
--
|
|
-- Locks the workout-ingest contract before the v1.5 iOS-Swift session
|
|
-- so the iOS DTO can be generated against the table layout from day
|
|
-- one. v1.4.25 ships no UI surface for workouts beyond the VO2-max
|
|
-- tile (Migration 0052 + W8d.5); the ingest endpoint + chart row
|
|
-- land in a later release.
|
|
--
|
|
-- Shape rationale (see .planning/research/w8d-implementation-outline.md
|
|
-- §4):
|
|
-- * HKWorkout-aligned typed columns for every metric the analytics
|
|
-- / doctor-PDF / Coach evidence pipeline reads on the hot path.
|
|
-- * `metadata` JSONB blob for the long-tail (HK metadata key/value
|
|
-- pairs, Withings hr_zone_0..3, device bundle id) — keeps the
|
|
-- table thin while preserving the source representation.
|
|
-- * `sport_type` as TEXT (not a Postgres enum) — Apple alone has
|
|
-- 70+ HKWorkoutActivityType values; managing them as a Postgres
|
|
-- enum would force a migration for every new sport. The Zod
|
|
-- boundary in src/lib/validations/* keeps the surface tight.
|
|
-- * Dedup on (user_id, source, external_id) — Postgres treats NULL
|
|
-- external_id as distinct so manual entries never collide.
|
|
--
|
|
-- Route geometry uses GeoJSON LineString stored as JSONB rather than
|
|
-- Postgres `point[]` or PostGIS `geometry`. v1.4.20 set the same
|
|
-- precedent for correlations: no extension dependency on every
|
|
-- self-hosted Postgres install. JSONB also matches the GPX-import
|
|
-- target shape and Leaflet / MapLibre consume it directly.
|
|
|
|
CREATE TABLE "workouts" (
|
|
"id" TEXT PRIMARY KEY,
|
|
"user_id" TEXT NOT NULL REFERENCES "users"("id") ON DELETE CASCADE,
|
|
"sport_type" TEXT NOT NULL,
|
|
"started_at" TIMESTAMP(3) NOT NULL,
|
|
"ended_at" TIMESTAMP(3) NOT NULL,
|
|
"duration_sec" INTEGER NOT NULL,
|
|
"total_energy_kcal" DOUBLE PRECISION,
|
|
"total_distance_m" DOUBLE PRECISION,
|
|
"avg_heart_rate" INTEGER,
|
|
"max_heart_rate" INTEGER,
|
|
"min_heart_rate" INTEGER,
|
|
"step_count" INTEGER,
|
|
"elevation_m" DOUBLE PRECISION,
|
|
"pause_duration_sec" INTEGER,
|
|
"source" "measurement_source" NOT NULL DEFAULT 'MANUAL',
|
|
"external_id" TEXT,
|
|
"external_source_version" TEXT,
|
|
"metadata" JSONB,
|
|
"created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
|
"updated_at" TIMESTAMP(3) NOT NULL
|
|
);
|
|
|
|
CREATE UNIQUE INDEX "workouts_user_source_external_key"
|
|
ON "workouts" ("user_id", "source", "external_id");
|
|
CREATE INDEX "workouts_user_started_idx"
|
|
ON "workouts" ("user_id", "started_at");
|
|
CREATE INDEX "workouts_user_sport_started_idx"
|
|
ON "workouts" ("user_id", "sport_type", "started_at");
|
|
|
|
CREATE TABLE "workout_routes" (
|
|
"id" TEXT PRIMARY KEY,
|
|
"workout_id" TEXT NOT NULL UNIQUE REFERENCES "workouts"("id") ON DELETE CASCADE,
|
|
-- GeoJSON LineString: { type: "LineString", coordinates: [[lon, lat, alt?], ...] }
|
|
"geometry" JSONB NOT NULL,
|
|
-- Per-sample ISO timestamps + optional speeds / HR, one entry per
|
|
-- coordinate in `geometry`. NULL when the source only ships static
|
|
-- GPX (e.g. Withings).
|
|
"sample_timestamps" JSONB,
|
|
"created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP
|
|
);
|