feat(doctor-report): practice name on cover page (persisted as user preference)

Marc wanted the addressee visible at first glance on the printout —
"Praxis Dr. Müller" should be the first thing the GP sees, so the
report doubles as a polite opening line.

- New optional free-text field "Praxis / clinic name" in the export
  dialog. The dialog pre-fills it with the user's last-used value so
  recurring exports don't require re-typing.
- Persisted as a user preference: new `User.lastReportPracticeName`
  column (migration `0031_user_last_report_practice_name`). The value
  is updated only on a successful POST that supplied a non-empty
  string — passing `null` does NOT clear the stored preference so the
  value sticks across years of follow-ups. Best-effort write: a DB
  failure here MUST NOT break the report (caught + ignored).
- `sanitisePracticeName()` enforces a strict envelope upstream: strips
  ASCII C0 + DEL controls (which jsPDF can't render), collapses
  whitespace, and hard-caps at 120 characters. Defends the PDF layout
  from runaway input + protects the PDF text stream from
  control-character corruption.
- PDF cover prints the line in 11pt bold above the separator when set;
  omitted entirely when `null` so the cover stays compact for
  self-archive use. Both client (`doctor-report-pdf.ts`) and server
  (`doctor-report-pdf-core.ts`) renderers carry the change so the
  visual output matches whichever path the user takes (browser
  download vs iOS Safari fallback).
- `/api/auth/me` now echoes `lastReportPracticeName` so the dialog
  pre-fills without an extra round-trip.
- Audit-log + Wide-Event annotations record `practiceNameProvided:
  boolean` (NOT the value itself — practice names are personal and we
  already store one canonical copy on the user record).

i18n: 6 new keys (`doctorReport.practiceLabel`, `doctorReport.dialog.{practiceLabel,practicePlaceholder}`)
in EN + DE.

Tests: 12 new unit cases covering sanitisation (whitespace, controls,
length cap, type guard), PDF cover rendering (DE label "Praxis:", EN
"Practice:", omission when null), API persistence (prisma.user.update
called with the right shape, audit detail flag set). 965 / 965 unit
pass, 31 / 31 integration pass. Lint 0 errors. Typecheck clean for B6
files (pre-existing dashboard-layout.test.ts errors are A4 territory).
v1.4.15 phase B6.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Marc-André BombeckandClaude Opus 4.7 committed 2026-05-09 21:36:47 +02:00
1 parent d692119454
commit 28467b2590
15 files changed
+249 -19

No files matched your search

+1
View File
@@ -23,5 +23,6 @@ export const GET = apiHandler(async () => {
onboardingTourCompleted: user.onboardingTourCompleted,
gravatarUrl: user.email ? getGravatarUrl(user.email) : null,
glucoseUnit: user.glucoseUnit ?? null,
lastReportPracticeName: user.lastReportPracticeName ?? null,
});
});
@@ -9,7 +9,7 @@ vi.mock("@/lib/db", () => ({
medication: { findMany: vi.fn() },
medicationIntakeEvent: { findMany: vi.fn() },
moodEntry: { findMany: vi.fn() },
user: { findUnique: vi.fn() },
user: { findUnique: vi.fn(), update: vi.fn() },
auditLog: { create: vi.fn() },
},
}));
@@ -241,4 +241,30 @@ describe("POST /api/doctor-report/pdf", () => {
);
});
it("persists practiceName as a user preference and includes it in audit", async () => {
vi.mocked(getSession).mockResolvedValue(SESSION_OK as never);
vi.mocked(checkRateLimit).mockResolvedValue({
allowed: true,
remaining: 9,
resetAt: Date.now() + 3600_000,
});
vi.mocked(auditLog).mockResolvedValue(undefined as never);
setEmptyDataMocks();
vi.mocked(prisma.user.update).mockResolvedValue({} as never);
const res = await POST(
makeRequest({ days: 30, practiceName: "Praxis Dr. Müller" }),
);
expect(res.status).toBe(200);
expect(prisma.user.update).toHaveBeenCalledWith({
where: { id: "user-1" },
data: { lastReportPracticeName: "Praxis Dr. Müller" },
});
expect(auditLog).toHaveBeenCalledWith(
"doctor-report.pdf.generate",
expect.objectContaining({
details: expect.objectContaining({ practiceNameProvided: true }),
}),
);
});
});
+19 -1
View File
@@ -7,7 +7,9 @@ import { checkRateLimit } from "@/lib/rate-limit";
import {
collectDoctorReportData,
normaliseDateRange,
sanitisePracticeName,
} from "@/lib/doctor-report-data";
import { prisma } from "@/lib/db";
import { renderDoctorReportPdfBytes } from "@/lib/doctor-report-pdf-core";
import { getServerTranslator } from "@/lib/i18n/server-translator";
import { parseLocaleFromAcceptLanguage } from "@/lib/format-locale";
@@ -42,8 +44,21 @@ export const POST = apiHandler(async (request: NextRequest) => {
body?.locale,
request.headers.get("accept-language"),
);
const rawPracticeName = body?.practiceName;
const practiceName = sanitisePracticeName(rawPracticeName);
const data = await collectDoctorReportData(user.id, range);
if (typeof rawPracticeName === "string" && practiceName !== null) {
try {
await prisma.user.update({
where: { id: user.id },
data: { lastReportPracticeName: practiceName },
});
} catch {
// Best-effort; never let preference persistence break the report.
}
}
const data = await collectDoctorReportData(user.id, range, { practiceName });
const { t } = getServerTranslator(locale);
const pdfBytes = renderDoctorReportPdfBytes(data, { t, locale });
@@ -56,6 +71,7 @@ export const POST = apiHandler(async (request: NextRequest) => {
startDate: range.start.toISOString(),
endDate: range.end.toISOString(),
locale,
practiceNameProvided: practiceName !== null,
},
});
@@ -66,6 +82,7 @@ export const POST = apiHandler(async (request: NextRequest) => {
report_end: range.end.toISOString(),
locale,
bytes: pdfBytes.byteLength,
practice_name_provided: practiceName !== null,
},
});
@@ -89,6 +106,7 @@ interface PdfRequestBody {
startDate?: unknown;
endDate?: unknown;
locale?: unknown;
practiceName?: unknown;
}
/**
+29 -4
View File
@@ -12,7 +12,9 @@ import { NextRequest } from "next/server";
import {
collectDoctorReportData,
normaliseDateRange,
sanitisePracticeName,
} from "@/lib/doctor-report-data";
import { prisma } from "@/lib/db";
/**
* Collect data for doctor report PDF generation (client-side).
@@ -20,9 +22,10 @@ import {
*
* Body shape (all fields optional — sensible defaults apply):
* {
* startDate?: string, // ISO timestamp, inclusive
* endDate?: string, // ISO timestamp, inclusive
* days?: number // legacy "last N days" fallback (1..365)
* startDate?: string, // ISO timestamp, inclusive
* endDate?: string, // ISO timestamp, inclusive
* days?: number, // legacy "last N days" fallback (1..365)
* practiceName?: string // free-text, persisted as user preference
* }
*
* Resolution: explicit range wins; otherwise `days` (default 90) is applied.
@@ -44,7 +47,27 @@ export const POST = apiHandler(async (request: NextRequest) => {
if (jsonError) return jsonError;
const range = normaliseDateRange(body);
const data = await collectDoctorReportData(user.id, range);
const rawPracticeName = (body as Record<string, unknown> | null)
?.practiceName;
const practiceName = sanitisePracticeName(rawPracticeName);
// Persist the most-recent practice name as a user preference so the
// dialog can pre-fill it next time. We only write when the caller
// actually supplied a non-empty string — passing `null`/empty does NOT
// clear the stored preference (use the dedicated profile endpoint for
// that). Best-effort: a write failure here MUST NOT break the report.
if (typeof rawPracticeName === "string" && practiceName !== null) {
try {
await prisma.user.update({
where: { id: user.id },
data: { lastReportPracticeName: practiceName },
});
} catch {
// Non-fatal — preference persistence is a UX nicety, not a contract.
}
}
const data = await collectDoctorReportData(user.id, range, { practiceName });
await auditLog("doctor-report.generate", {
userId: user.id,
@@ -53,6 +76,7 @@ export const POST = apiHandler(async (request: NextRequest) => {
days: range.days,
startDate: range.start.toISOString(),
endDate: range.end.toISOString(),
practiceNameProvided: practiceName !== null,
},
});
@@ -61,6 +85,7 @@ export const POST = apiHandler(async (request: NextRequest) => {
report_days: range.days,
report_start: range.start.toISOString(),
report_end: range.end.toISOString(),
practice_name_provided: practiceName !== null,
},
});