mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-18 16:12:11 +00:00
The insights alert cards computed medication compliance with the naive `schedules.length × days` denominator, so a fully-adherent weekly injectable read ~14% and fired a false low-compliance alert (and a paused medication mis-fired the same way). Route the alert path through the canonical `calculateCompliance` engine like every other compliance surface — pause eras, schedule revisions and dose windows honoured. Document confirm: committing a numeric observation against an existing biomarker silently replaced the stated unit with the catalog's, with no conversion — a stated "6.1 mmol/L" against a mg/dL marker committed "6.1 mg/dL". Reject on a unit mismatch (fail closed) so the user reconciles on the review screen, the same posture as the unit-required guard. Wire grip strength, waist (with waist-to-height) and pain into the briefing feature set and the grounding allow-set so the clinical-depth signals reach the daily narrative; the mental-health screeners stay excluded by construction. Biomarker detail: fall back to a generic description for catalog-less markers, and keep the heading + description with a retry on the error state. Collapse the medication External-API and Lifecycle groups by default. Re-enable the insights scroll-to-top regression and assert the shipped main-content reset. Align the EN haemoglobin/haematocrit display names to British spelling. Drop the redundant `(userId, deletedAt)` index on inbound documents — a strict prefix of the new three-column index. Trim the dead MedicalDisclaimer variants to the one live `dataPosture`. Move the crisis-resources card off the retired amber tint to a calm destructive-subtle border. Add a registry invariant asserting every biomarker signal key resolves to a real catalog slug.
249 lines
8.1 KiB
TypeScript
249 lines
8.1 KiB
TypeScript
/**
|
||
* GET /api/insights/cards — iOS adapter over `/api/insights/comprehensive`.
|
||
*
|
||
* Reuses the same data sources (measurements, mood, intake events) and the
|
||
* shared `generateAlerts()` rule engine, then re-shapes each `HealthAlert`
|
||
* to the iOS Insight model (id, title, summary, severity, recommendations,
|
||
* provider).
|
||
*/
|
||
import { apiHandler, requireAuth } from "@/lib/api-handler";
|
||
import { requireAssistantSurface } from "@/lib/feature-flags";
|
||
import { requireModuleEnabled } from "@/lib/modules/gate";
|
||
import { apiSuccess } from "@/lib/api-response";
|
||
import { annotate } from "@/lib/logging/context";
|
||
import { prisma } from "@/lib/db";
|
||
import { summarize, type DataPoint } from "@/lib/analytics/trends";
|
||
import { getBpTargets } from "@/lib/analytics/bp-targets";
|
||
import { isBpReadingInTarget } from "@/lib/analytics/bp-in-target";
|
||
import {
|
||
generateAlerts,
|
||
type HealthAlert,
|
||
} from "@/lib/analytics/classifications";
|
||
import { pairByTimestamp } from "@/lib/analytics/correlations";
|
||
import {
|
||
buildComplianceMedicationContext,
|
||
calculateCompliance,
|
||
lastNonSkippedTakenAt,
|
||
SCHEDULE_COMPLIANCE_SELECT,
|
||
} from "@/lib/analytics/compliance";
|
||
import type { MeasurementType } from "@/generated/prisma/client";
|
||
|
||
type Severity = "alert" | "caution" | "info" | "good";
|
||
|
||
function toSeverity(level: HealthAlert["level"]): Severity {
|
||
switch (level) {
|
||
case "danger":
|
||
return "alert";
|
||
case "warning":
|
||
return "caution";
|
||
case "success":
|
||
return "good";
|
||
default:
|
||
return "info";
|
||
}
|
||
}
|
||
|
||
interface InsightRecommendation {
|
||
id: string;
|
||
label: string;
|
||
actionURL: string | null;
|
||
}
|
||
|
||
interface InsightCard {
|
||
id: string;
|
||
title: string;
|
||
summary: string;
|
||
body: string | null;
|
||
severity: Severity;
|
||
recommendations: InsightRecommendation[];
|
||
generatedAt: string;
|
||
provider: string;
|
||
}
|
||
|
||
export const dynamic = "force-dynamic";
|
||
|
||
export const GET = apiHandler(async () => {
|
||
const { user } = await requireAuth();
|
||
const m = await requireModuleEnabled(user.id, "insights");
|
||
if (!m.enabled) return m.response;
|
||
// v1.4.31 — the iOS cards adapter feeds the same per-metric
|
||
// insight surfaces the web `<InsightStatusCard>` mounts on each
|
||
// /insights/<metric> sub-page. Both share the operator gate.
|
||
await requireAssistantSurface("insightStatus");
|
||
annotate({ action: { name: "insights.cards" } });
|
||
|
||
const ninetyDaysAgo = new Date(Date.now() - 90 * 86_400_000);
|
||
|
||
const [dbUser, allMeasurements, medications] = await Promise.all([
|
||
prisma.user.findUnique({
|
||
where: { id: user.id },
|
||
select: { heightCm: true, dateOfBirth: true, aiProvider: true },
|
||
}),
|
||
prisma.measurement.findMany({
|
||
where: {
|
||
userId: user.id,
|
||
type: {
|
||
in: ["WEIGHT", "BLOOD_PRESSURE_SYS", "BLOOD_PRESSURE_DIA", "PULSE"],
|
||
},
|
||
measuredAt: { gte: ninetyDaysAgo },
|
||
deletedAt: null,
|
||
},
|
||
orderBy: { measuredAt: "asc" },
|
||
select: { type: true, value: true, measuredAt: true },
|
||
}),
|
||
prisma.medication.findMany({
|
||
// v1.16.11 — as-needed (PRN) medications never surface a compliance
|
||
// rate (no expected doses).
|
||
where: { userId: user.id, active: true, asNeeded: false },
|
||
include: {
|
||
// Schedules through the shared compliance select so the configured
|
||
// per-dose windows reach the engine like every other surface.
|
||
schedules: { select: SCHEDULE_COMPLIANCE_SELECT },
|
||
// v1.16.3 — archived schedule eras for era-aware expected counts.
|
||
scheduleRevisions: { orderBy: { validFrom: "asc" } },
|
||
// v1.25 H-MED1 — pause eras so paused days drop out of the denominator.
|
||
pauseEras: { select: { pausedAt: true, resumedAt: true } },
|
||
},
|
||
}),
|
||
]);
|
||
|
||
const byType = (t: MeasurementType): DataPoint[] =>
|
||
allMeasurements
|
||
.filter((m) => m.type === t)
|
||
.map((m) => ({ date: m.measuredAt, value: m.value }));
|
||
|
||
const summaries: Partial<
|
||
Record<MeasurementType, ReturnType<typeof summarize>>
|
||
> = {};
|
||
for (const t of [
|
||
"WEIGHT",
|
||
"BLOOD_PRESSURE_SYS",
|
||
"BLOOD_PRESSURE_DIA",
|
||
"PULSE",
|
||
] as MeasurementType[]) {
|
||
const data = byType(t);
|
||
if (data.length > 0) summaries[t] = summarize(data);
|
||
}
|
||
|
||
let bmi: number | null = null;
|
||
if (dbUser?.heightCm && summaries.WEIGHT?.latest) {
|
||
const heightM = dbUser.heightCm / 100;
|
||
bmi = Math.round((summaries.WEIGHT.latest / (heightM * heightM)) * 10) / 10;
|
||
}
|
||
|
||
let bpPctInTarget: number | null = null;
|
||
const bpTargets = getBpTargets(dbUser?.dateOfBirth ?? null);
|
||
if (bpTargets) {
|
||
const sysData = byType("BLOOD_PRESSURE_SYS");
|
||
const diaData = byType("BLOOD_PRESSURE_DIA");
|
||
const pairs = pairByTimestamp(sysData, diaData, 5 * 60_000);
|
||
if (pairs.length > 0) {
|
||
// v1.4.16 A2 — one-sided ceiling semantics with hypotension
|
||
// floor. See lib/analytics/bp-in-target.ts.
|
||
const inTarget = pairs.filter((p) =>
|
||
isBpReadingInTarget(p.a, p.b, bpTargets),
|
||
).length;
|
||
bpPctInTarget = Math.round((inTarget / pairs.length) * 100);
|
||
}
|
||
}
|
||
|
||
// Medication compliance for alert input — routed through the canonical
|
||
// cadence-aware engine (`calculateCompliance`), the same single source of
|
||
// truth the comprehensive insights, dashboard pillar, Coach snapshot and
|
||
// doctor report use. The naive `schedules.length × days` denominator was a
|
||
// #214 regression that falsely flagged weekly injectables and paused meds
|
||
// as low-adherence on this user-facing alert path.
|
||
const medicationCompliance: Array<{
|
||
name: string;
|
||
compliance7: number;
|
||
compliance30: number;
|
||
}> = [];
|
||
// Single batched query — bucket by medicationId in JS (fix N+1).
|
||
const activeMeds = medications.filter((m) => m.schedules.length > 0);
|
||
if (activeMeds.length > 0) {
|
||
const allEvents = await prisma.medicationIntakeEvent.findMany({
|
||
where: {
|
||
userId: user.id,
|
||
// v1.7.0 sync — exclude tombstoned rows.
|
||
deletedAt: null,
|
||
medicationId: { in: activeMeds.map((m) => m.id) },
|
||
// 90-day window: the rolling-cadence gap-walk re-anchors on prior
|
||
// intakes outside the 30-day rate window.
|
||
scheduledFor: { gte: ninetyDaysAgo },
|
||
},
|
||
orderBy: { scheduledFor: "desc" },
|
||
select: {
|
||
medicationId: true,
|
||
takenAt: true,
|
||
skipped: true,
|
||
scheduledFor: true,
|
||
},
|
||
});
|
||
const eventsByMed = new Map<string, typeof allEvents>();
|
||
for (const e of allEvents) {
|
||
const arr = eventsByMed.get(e.medicationId) ?? [];
|
||
arr.push(e);
|
||
eventsByMed.set(e.medicationId, arr);
|
||
}
|
||
const tz = user.timezone || "Europe/Berlin";
|
||
for (const med of activeMeds) {
|
||
const events = eventsByMed.get(med.id) ?? [];
|
||
const mapped = events.map((e) => ({
|
||
takenAt: e.takenAt,
|
||
skipped: e.skipped,
|
||
scheduledFor: e.scheduledFor,
|
||
}));
|
||
// v1.7.0 SB-SCHED-2 — engine-routed denominator.
|
||
const medicationContext = buildComplianceMedicationContext(
|
||
med,
|
||
lastNonSkippedTakenAt(mapped),
|
||
tz,
|
||
);
|
||
const c7 = calculateCompliance(mapped, med.schedules, 7, med.createdAt, {
|
||
medicationContext,
|
||
});
|
||
const c30 = calculateCompliance(
|
||
mapped,
|
||
med.schedules,
|
||
30,
|
||
med.createdAt,
|
||
{
|
||
medicationContext,
|
||
},
|
||
);
|
||
medicationCompliance.push({
|
||
name: med.name,
|
||
compliance7: c7.rate,
|
||
compliance30: c30.rate,
|
||
});
|
||
}
|
||
}
|
||
|
||
const alerts = generateAlerts({
|
||
bmi,
|
||
bpAvgSys: summaries.BLOOD_PRESSURE_SYS?.avg30 ?? null,
|
||
bpAvgDia: summaries.BLOOD_PRESSURE_DIA?.avg30 ?? null,
|
||
bpPctInTarget,
|
||
weightSlope30: summaries.WEIGHT?.slope30?.slope ?? null,
|
||
pulseAvg30: summaries.PULSE?.avg30 ?? null,
|
||
pulseAnomalyCount: summaries.PULSE?.anomalyCount,
|
||
medications: medicationCompliance,
|
||
});
|
||
|
||
const provider = dbUser?.aiProvider?.toLowerCase() ?? "claude";
|
||
const generatedAt = new Date().toISOString();
|
||
|
||
const cards: InsightCard[] = alerts.map((alert, idx) => ({
|
||
id: `alert-${idx + 1}`,
|
||
title: alert.title,
|
||
summary: alert.message,
|
||
body: null,
|
||
severity: toSeverity(alert.level),
|
||
recommendations: [],
|
||
generatedAt,
|
||
provider,
|
||
}));
|
||
|
||
return apiSuccess(cards);
|
||
});
|