Files
HealthLog/src/lib/cycle/today-verdict.ts
T
Marc-André Bombeck 4bb03600b3 perf(dashboard): cache today's cycle read and run the vitals reads together
The digest is polled every 120 seconds. Its cycle line read the whole
cycle history, 90 days of day logs and wrist temperature on every poll,
outside any cache, and the coincident-deviation engine walked its eleven
vitals one after another, two queries each.

The cycle read now rides the digest extras cell, which every cycle write
already hard-evicts; the cycle preferences route evicts it too, and a
module switch does through the health-score invalidator. A record without
a cycle profile stops after one point read. The per-vital reads run
together and are folded in registry order, so the result does not depend
on which finished first.

On a seeded four-year account (1.25M measurements, 52 cycles) under a
792 MB heap, the warm digest went from 9.9 to 5.0 ms and the vitals engine
from 11.1 to 4.6 ms (medians of four interleaved rounds).
2026-10-05 08:34:28 +02:00

126 lines
4.2 KiB
TypeScript

/**
* Today's place in the cycle, for the dashboard's Today overview.
*
* The cycle page is the one place that decides what may be said about today
* (`resolveCycleVerdict` over the calendar grid). This read runs the same two
* steps over the same rows, narrowed to what a one-line summary needs, so the
* dashboard can never call a day something the cycle page does not: the same
* still-learning gate withholds the phase, the same ceiling stops the count
* once a cycle runs past its typical length.
*
* Read-only: no profile upsert, no forecast write. The caller has already
* confirmed the cycle module is on for the record.
*/
import { prisma } from "@/lib/db";
import { buildCalendar, type CalendarDayLogRow } from "./engine-adapter";
import { addDays, dayDiff } from "./day-math";
import { goalAllowsFertileWindow } from "./dto";
import { BBT_WINDOW, type CyclePhase } from "./types";
import { resolveCycleVerdict } from "./verdict";
import { moodDateKey } from "@/lib/mood/date-key";
import { startOfLocalDayKey } from "@/lib/tz/local-day";
/** How far back the grid reaches; the calendar route's default span. */
const PAST_DAYS = 90;
export interface TodayCycleRead {
dayOfCycle: number;
/** Null while the engine is still learning the cycle. */
phase: CyclePhase | null;
}
export async function readTodayCycle(
userId: string,
timezone: string,
now: Date,
): Promise<TodayCycleRead | null> {
const today = moodDateKey(now, timezone);
const from = addDays(today, -PAST_DAYS);
const logFrom =
dayDiff(from, addDays(today, -BBT_WINDOW)) <= 0
? from
: addDays(today, -BBT_WINDOW);
// A record that never set up cycle tracking has no profile: one point read
// and done, rather than three history reads that cannot be used.
const profile = await prisma.cycleProfile.findUnique({ where: { userId } });
if (!profile) return null;
// The whole history, as the calendar route reads it: the forecast rests on
// every observed cycle, and this read must agree with the cycle page.
const [cycles, dayLogRows, nightlyTemps] = await Promise.all([
prisma.menstrualCycle.findMany({
where: { userId, deletedAt: null },
orderBy: { startDate: "asc" },
}),
prisma.cycleDayLog.findMany({
where: { userId, deletedAt: null, date: { gte: logFrom } },
orderBy: { date: "asc" },
select: {
date: true,
flow: true,
basalBodyTempC: true,
temperatureExcluded: true,
ovulationTest: true,
cervicalMucus: true,
cervixPosition: true,
cervixFirmness: true,
cervixOpening: true,
intermenstrualBleeding: true,
},
}),
prisma.measurement.findMany({
where: {
userId,
deletedAt: null,
type: "WRIST_TEMPERATURE",
measuredAt: { gte: startOfLocalDayKey(addDays(today, -90), timezone) },
},
orderBy: { measuredAt: "asc" },
select: { measuredAt: true, value: true },
}),
]);
if (cycles.length === 0) return null;
// The intent fields and the presence flags never reach a phase or a day
// count; the grid carries them for the calendar's own overlay only.
const dayLogs: CalendarDayLogRow[] = dayLogRows.map((row) => ({
...row,
hasSymptoms: false,
hasNote: false,
sexualActivity: false,
pregnancyTest: null,
progesteroneTest: null,
contraceptive: null,
}));
const nights = nightlyTemps.map((m) => ({
date: moodDateKey(m.measuredAt, timezone),
valueC: m.value,
}));
const { prediction, days } = buildCalendar(
profile,
cycles,
dayLogs,
nights,
from,
today,
today,
goalAllowsFertileWindow(profile.goal),
);
const verdict = resolveCycleVerdict({
days,
today,
profile: {
typicalCycleLength: profile.typicalCycleLength,
typicalPeriodLength: profile.typicalPeriodLength,
lutealPhaseLength: profile.lutealPhaseLength,
},
nextPeriodStart: prediction?.nextPeriodStart ?? null,
lastPeriodStart:
cycles.filter((c) => c.startDate <= today).at(-1)?.startDate ?? null,
});
if (verdict.state !== "IN_CYCLE" || verdict.dayOfCycle === null) return null;
return { dayOfCycle: verdict.dayOfCycle, phase: verdict.phase };
}