Files
HealthLog/src/lib/body-sites/dto.ts
T
Marc-André Bombeck 14f0fc4d4f feat(body-sites): record a body site on conditions and add a body-site view
A condition (illness episode) can carry where on the body it sits, in the
person's own words and encrypted at rest, plus an optional side (LEFT,
RIGHT, BOTH). Same enum, codec and reasoning as the procedure's site.

- migration 0354: two nullable columns on illness_episodes, reusing the
  laterality type from 0349
- create and edit accept bodySite and laterality; on PATCH an absent key
  keeps the stored value, so an edit from the shipped iPhone app, which
  never sends either field, leaves them untouched
- GET /api/body-sites: the sites the record holds across visits and
  conditions, folded after the decrypt and bounded per kind; with site
  (and laterality) the visits and conditions there, one hop to their
  documents, lab results and visits. Read in the profile section;
  conditions only under an illness grant with the module on, and links
  into ungranted sections come back as unlabelled placeholders
- the link service reads document and visit links from the condition's
  end of the two existing tables
- /checkups gains a Body sites tab; the visit and condition forms share
  one body-site field pair that suggests sites already used; a
  condition's page links its site into the view
- the doctor report, the clinician page and the MCP doctor-visit summary
  name the site on conditions; the Coach illness block carries it
  sanitised, and MCP get_illness_recovery returns it fenced
- backup and restore carry both fields in both file kinds; the site is
  registered as ciphertext and rotates with the key
- i18n in all seven locales, OpenAPI regenerated

Refs #1025
2026-09-25 21:55:14 +02:00

77 lines
2.4 KiB
TypeScript

/**
* Wire shapes of `GET /api/body-sites` (v1.39.2).
*
* Type-only, so the client imports it without pulling the loader's Prisma
* graph into a bundle.
*/
import type { Laterality } from "@/generated/prisma/client";
import type { EncounterDTO, EncounterLinkDTO } from "@/lib/encounters/dto";
/** How many records sit on one side of a site. `null` is "side not stated". */
export interface BodySiteSideDTO {
laterality: Laterality | null;
count: number;
}
/**
* One site the record holds, across procedures and conditions.
*
* Keyed on the folded text, so "Knee" and "knee " are one site; `bodySite` is
* the first spelling met, newest record first. The two counts are per kind so
* a client can say what is there without a second read.
*/
export interface BodySiteDTO {
bodySite: string;
procedures: number;
conditions: number;
sides: BodySiteSideDTO[];
}
/**
* A condition at the picked site, with what is filed against it.
*
* No note: the view answers "what is at this site", and the note is read on
* the condition's own page. `documents` are redacted per entry when the
* caller's grant does not cover the vault, like a visit's links.
*/
export interface BodySiteConditionDTO {
id: string;
label: string;
type: string;
lifecycle: string;
onsetAt: string;
resolvedAt: string | null;
bodySite: string | null;
laterality: Laterality | null;
links: {
documents: EncounterLinkDTO[];
visits: EncounterLinkDTO[];
};
}
/** What is filed at one site, when the request names one. */
export interface BodySiteSelectionDTO {
bodySite: string;
laterality: Laterality | null;
/**
* Visits carrying the site, newest first, each with its links. Procedures in
* practice: the visit form offers the site for a procedure and keeps it on
* any visit that already has one.
*/
visits: EncounterDTO[];
/**
* Conditions at the site, newest onset first. `null`, not `[]`, when the
* caller may not read conditions in this record (a grant without the
* illness section) or the record has the illness module off: the list was
* not consulted, which is different from a list that came back empty.
*/
conditions: BodySiteConditionDTO[] | null;
}
export interface BodySiteListDTO {
/** Every site the caller may see, most records first. */
sites: BodySiteDTO[];
/** Present only when the request named a site. */
selection?: BodySiteSelectionDTO;
}