feat(insights): add a cited reference-range backbone and richer metric explainers

Introduce src/lib/reference-ranges.ts: a structured, citation-backed
per-metric reference-range backbone (band + source body + year) with a
deterministic four-state placement helper, read by the UI surfaces. Each
band traces to the medical-citations registry, which gains the supporting
sources (ACC/AHA 2017 and ESC 2024 blood pressure, StatPearls pulse
pressure and mean arterial pressure, ESC/ESH 2018 pulse-wave velocity,
FDA 2024 and StatPearls pulse oximetry, J Gen Intern Med 2019 temperature,
RCP NEWS2 and American Lung Association respiratory rate, visceral-fat
imaging literature, AHA 2024 resting heart rate, ESC/NASPE 1996 HRV,
Wilcox 2000, ACOG 651, Phillips 2017 and CDC 2024 sleep).

Blood pressure keeps ESH 2023 as the labelled default; ACC/AHA 2017 and
ESC 2024 appear only as displayed placement context. Enrich the metric
explainers with concise cited reference bands and a general-guidance
tooltip on every metric page: a darker-skin pulse-oximeter over-read
caveat, device-proxy honesty for readiness/recovery/strain/stress, an
HRV day-to-day-noise note, and a resting-heart-rate clarification. Fill
the empty registry normal ranges, reconcile the steps green floor to
8,000, and tighten the body-temperature band below the fever line. Add
free pulse-pressure and mean-arterial-pressure context on the blood-
pressure detail page, plus cycle-physiology and sleep-hygiene copy across
all six locales. Cycle thresholds carry a verification marker pending an
ACOG source check.
This commit is contained in:
Marc-André Bombeck committed 2026-06-18 20:17:04 +02:00
1 parent 1d83e10764
commit 9be30897fa
12 files changed
+985 -29

No files matched your search

+26
View File
@@ -170,6 +170,32 @@ export default function InsightsBlutdruckPage() {
average). */}
<MetricTargetSummary slug="blood-pressure" />
{/* v1.18.6 — free derived BP context: pulse pressure (SBP − DBP) and
mean arterial pressure ((SBP + 2·DBP)/3), computed from the most
recent reading. Pure derivation of stored BP — no schema, no extra
fetch. Calm, cited, non-alarming. */}
{(() => {
const sbp = sysSummary?.latest ?? null;
const dbp = diaSummary?.latest ?? null;
if (sbp == null || dbp == null || sbp <= dbp) return null;
const pp = Math.round(sbp - dbp);
const map = Math.round((sbp + 2 * dbp) / 3);
return (
<p
data-slot="bp-derived-caption"
className="text-muted-foreground text-sm leading-relaxed"
>
{t("insights.subPage.bpDerived.pulsePressure", {
value: pp,
})}{" "}
{t("insights.subPage.bpDerived.meanArterialPressure", {
value: map,
})}{" "}
{t("insights.subPage.bpDerived.caveat")}
</p>
);
})()}
{/* v1.12.4 — Einschätzung is the last content block; the stat strip
(rendered by the shell) closes the spine below it. */}
<SlugInsightStatusCard