Files
HealthLog/prisma/migrations/0500_lab_result_external_id/migration.sql
T
Marc-André Bombeck 5994762c74 feat(labs): map FHIR lab observations into lab readings
A shared mapper and writer for lab results arriving as FHIR resources
(DSTU2 and R4 Observations): final results only, laboratory category,
quantity / string / coded values, comparator results kept as printed
text, the report's own reference range in the reading's unit, panel
headers naming their members, notes sealed at rest. UCUM units map onto
the spellings the labs feature uses, and a LOINC code hints the catalog
analyte when the account's markers are matched.

Readings carry an identity (lab_results.external_id, a digest of the
issuer and the record identifier) so the same result is recognised
whether it arrives again from an export or from a phone, and a deleted
result stays deleted. A reading the record already holds by value is
skipped as well.
2026-11-17 18:37:56 +01:00

26 lines
1.2 KiB
SQL

-- The identity a lab reading arrived under from Apple Health's Health Records
-- (#1400): a SHA-256 digest over the issuing institution and the FHIR
-- Observation's identifier, never the identifier itself. It lets the same
-- result, arriving again from the export or from the iOS app, be recognised
-- and left alone, and a result the person deleted stay deleted.
--
-- Nullable, no default: every existing reading reads as "no external
-- identity", and adding the column rewrites nothing. The unique index is on
-- (user_id, source, external_id); NULLs never collide, so the readings typed,
-- scanned or imported from CSV are unaffected. IF NOT EXISTS keeps a replay
-- on a database that already ran a build carrying the column harmless.
-- Reversibility: dropping the index and the column restores the previous
-- schema.
--
-- @retry-on-lock-timeout
DO $migration$
BEGIN
PERFORM set_config('lock_timeout', '5s', true);
ALTER TABLE "lab_results"
ADD COLUMN IF NOT EXISTS "external_id" TEXT;
CREATE UNIQUE INDEX IF NOT EXISTS "lab_results_user_id_source_external_id_key"
ON "lab_results" ("user_id", "source", "external_id");
END
$migration$;