Brainversum · tuxametrics Graph Admin

konzept vertraulich owner: matus

„Fällige Kontrollen"-Kachel auf „Auswertungen" — **super wichtig** (Nutzervorgabe 2026-08-17)

„Fällige Kontrollen"-Kachel auf „Auswertungen" — super wichtig (Nutzervorgabe 2026-08-17)

Status: erledigt 2026-08-18 — die Annahme unten ("dafür gibt es im Datenmodell heute nichts") war falsch. Es gab bereits ein echtes, fachlich belegtes Fälligkeitssignal: Empfehlung.reevaluationszeitpunkt (EmpfehlungEntity, FACH-074/FACH-081/FACH-091), aggregiert von EmpfehlungRepository#naechsteReevaluation zu PatientUebersichtZeile.naechsteKontrolle / .naechsteKontrolleUeberfaellig, erreichbar über den REST-Filter kontrolle-faellig auf GET .../patienten — und bereits als Kachel gebaut, nur auf der Patienten- statt der Auswertungen-Übersicht (PatientUebersichtPage.tsx). Diese Kachel wurde nach domains/patient/components/FaelligeKontrollenTile.tsx extrahiert und zusätzlich auf AuswertungUebersichtRoute.tsx eingebunden — keine neue Entität, keine neue Capability, keine erfundene Zahl (insbesondere kein "Besuch protokollieren + N-Tage-Fenster", das war der ursprünglich diskutierte, jetzt hinfällige Plan B).

Weiterhin offen: die Pro-Analyt-Variante aus dem Mockup ("Kalium — überfällig", "Vitamin D 10/2026") ist damit nicht gebaut — das bräuchte einen strukturierten, abfragbaren Kontrollplan je Analyt (FACH-091), den es weiterhin nur als Berichttext gibt. Die neue Kachel zeigt daher pro Patient/Fall, nicht pro Analyt. Der Rest dieses Dokuments (Stand 2026-08-17) bleibt als Herkunfts- und Alternativen-Aufzeichnung stehen.

Ursprünglicher Status: offen, ungebaut · Aufwand: unklar, hängt an einer Fachentscheidung, nicht nur an UI

Herkunft

Vorgabe des Nutzers am 2026-08-17: TODO-raw/LETZTE_DAELLE.png zeigt die Zielseite „Letzte Fälle" - deren Tabs/Filter/Tabelle sind mittlerweile in tuxametrics-ui/src/routes/AuswertungUebersichtRoute.tsx eingebaut (zuerst als eigene Seite, am selben Tag zur bestehenden Auswertungsübersicht zusammengelegt, siehe deren Javadoc). Das Mockup trägt rechts unten eine Kachel „Fällige Kontrollen (4)" mit Zeilen wie „Ludwig, 47 J. · Kalium — überfällig", „Kern, 61 J. · Zink — 09/2026". Diese Kachel ist nicht mitgebaut — absichtlich, nicht vergessen.

Warum sie fehlt

Eine Kontrolle braucht ein Fälligkeitsdatum: Analyt X bei Patient Y soll bis Datum Z erneut gemessen werden. Dafür gibt es im Datenmodell heute nichts:

Eine Kachel ohne diese Quelle zu bauen hieße, Zahlen zu erfinden — das schließt CLAUDE.md ausdrücklich aus ("Wo das Material keine Zahl hat, hat der Code auch keine").

Was es bräuchte

  1. Fachentscheidung, ob/wie FACH-091 (Kontrollplan) über den Bericht hinaus als strukturierte, abfragbare Angabe geführt wird — mit Fälligkeitsdatum pro Analyt/Patient, nicht nur als Text im PDF/Report.
  2. Falls ja: ein Feld/eine Tabelle in tuxametrics-laborauswertung-service (z. B. an Messwert oder als eigene Entität Kontrollplaneintrag), plus ein Such-Endpunkt („fällig in den nächsten N Tagen", tenantweit).
  3. Erst dann eine UI-Kachel, die das anzeigt — kein größerer Aufwand als die bereits gebaute Tabelle.

Alternativer, vom Nutzer skizzierter Mechanismus (2026-08-17)

Statt eines Kontrollintervalls je Analyt (Retest-Erinnerung) schlägt der Nutzer einen einfacheren, patientenseitigen Mechanismus vor: in der Patientenakte einen Besuch mit Ereignistyp „Blut abgenommen" protokollieren; daraus lässt sich ein erwartetes Auswertungsdatum (z. B. Blutabnahme + 3 Tage) ableiten, und Fälle, bei denen dieses Fenster verstrichen ist, ohne dass eine Auswertung vorliegt, wären „überfällig".

Das ist ein anderes Konzept als die Mockup-Kachel (Retest-Fälligkeit je Analyt), löst aber denselben Zweck ("was hängt fest") mit weniger neuem Datenmodell: nur ein Zeitstempel je Besuch, keine Kontrollintervalle je Analyt. Bräuchte trotzdem entschieden zu werden:

Noch nicht umgesetzt — der Nutzer hat diese Skizze genannt, dann aber den Fokus auf das Zusammenlegen von „Letzte Fälle" in die Auswertungsübersicht gelenkt (siehe Agent-Log 2026-08-17).

Nicht verwechseln mit

„Zuletzt von Ihnen geöffnet" — die zweite Kachel desselben Mockups — ist mitgebaut (tuxametrics-ui/src/shell/recentCases.ts), weil sie ohne Erfindung auskommt: sie zeigt echte, lokal beobachtete Navigation (localStorage, mandantengescoped), kein Backend-Zähler.