Material- & Maßnahmen-Katalog

Der Katalog ist die eine, vom Admin gepflegte Liste, die bestimmt, was auf den Material- und Maßnahmen-Kacheln des Tablets erscheint. Diese Seite richtet sich an den Admin, der den Katalog pflegt — sie erklärt, was ein Katalog speist, was die Capability-Flags pro Eintrag bewirken und warum der Consumes-Link das Konzept ist, das am Ende dafür sorgt, dass die Zählung aufgeht.

Du bearbeitest den Katalog im Admin-Panel. Operatoren sehen ihn nie direkt — sie sehen nur die Kacheln, die er auf dem Tablet erzeugt. Hier pflegen; die Tablets synchronisieren ihn herunter.

Ein Katalog, zwei Tablet-Oberflächen

Es gibt einen serverseitigen Katalog. Er speist zwei getrennte Tablet-Oberflächen, und jeder Katalogeintrag legt über seine Flags fest, auf welche der beiden er gehört (er kann auf einer, der anderen oder auf beiden liegen):

Kleinstbehandlungen

Die Material-Zählung auf Dienst-Ebene. Sie zählt Kleinstbehandlungen und verbrauchte Artikel für den gesamten Dienst, nicht für einen einzelnen Patienten. Liegt im Material-Bereich des Dienstes. Siehe Dienst-Lebenszyklus.

Maßnahmen-Tab

Die Oberfläche auf Patienten-Ebene, pro Protokoll. Sie erfasst Maßnahmen, die an einem einzelnen Patienten durchgeführt wurden. Siehe Ein Protokoll schreiben.

Die beiden Oberflächen teilen sich nur den Katalog — niemals die erfassten Daten. Material ist niemals Patientendaten: ein verbrauchter Artikel wird gegen die Dienst-Zählung gezählt, nicht auf dem Protokoll eines Patienten gespeichert. Material aus dem Protokoll herauszuhalten ist Absicht — und der Consumes-Link (siehe unten) ist das, was eine Maßnahme auf Patienten-Ebene trotzdem als Material zählen lässt, ohne es doppelt auf den Patientendatensatz zu schreiben.

Wie aus einem Katalogeintrag eine Kachel wird

Das Tablet stellt den Katalog als Streamdeck dar — ein Raster farbiger Kacheln, eine pro Katalogeintrag, gruppiert nach den vom Admin definierten Gruppen. Die Capability-Flags pro Eintrag bestimmen den Erfassungsablauf:

  • Ein Eintrag ohne Flags (keine Dosis, kein Durchführender, keine Varianten, kein Consumes-Link) wird mit einem Tipp erfasst. Kachel antippen, sie wird sofort mit der aktuellen — editierbaren — Uhrzeit gebucht.

  • Ein reicherer Eintrag öffnet ein Modal, das nur nach dem fragt, was seine Flags festlegen: eine Variantenauswahl (PrimeVue SelectButton), einen Mengen-Stepper, eine Dosis und/oder einen Durchführenden.

Auf der Kleinstbehandlungen-Oberfläche erhöht eine variantenlose Kachel pro Tipp um +1; ein langer Druck öffnet den Mengendialog, um eine eigene Menge zu setzen (oder 0, um einen Fehl-Tipp zurückzunehmen). Kacheln mit Varianten reagieren nur auf Tippen und öffnen die Auswahl.

Halte alltägliche, eindeutige Artikel flag-frei, damit die Crew im Feld sie mit einem Tipp erfassen kann. Reserviere Flags für Artikel, die wirklich eine Auswahl, eine Dosis oder einen verantwortlichen Durchführenden brauchen — jedes Flag ist eine weitere Sache, die unter Druck ausgefüllt werden muss.

Capability-Flags

Jeder Katalogeintrag trägt diese Flags. Eine Best-Guess-Vorbelegung wird mit der App ausgeliefert; von dir wird erwartet, sie auf dein eigenes Material und deine Maßnahmen zuzuschneiden. Setze die Flags im Admin-Panel pro Eintrag.

Flag Bedeutung Wirkung auf die Kachel

Kleinstbehandlung

Diesen Eintrag auf der Material-Zählung des Dienstes anbieten.

Der Eintrag erscheint auf dem Kleinstbehandlungen-Streamdeck.

Maßnahme

Diesen Eintrag auf dem Protokoll-Tab (Patienten-Ebene) anbieten.

Der Eintrag erscheint auf dem Maßnahmen-Streamdeck.

Menge + Einheit

Jeder Eintrag wird in einer vom Admin gesetzten Einheit gezählt — Stück, cm, ml, mg oder Ampulle.

Bestimmt, was der Mengen-Stepper zählt. Die Einheit ist deine Wahl pro Eintrag — Pflaster in cm, ein Medikament in Ampulle.

Varianten

Vom Admin definierte Optionsgruppen (z. B. Größe: Klein, Groß).

Macht aus einer Ein-Tipp-Kachel ein Modal mit Variantenauswahl (SelectButton); jede gewählte Kombination wird als eigene Zeile gebucht.

Dosis (has_dose + dose_unit)

Nach einer klinischen Dosis fragen — Menge plus Dosis-Einheit (mg, ml, l/min, IE…). Patientenbezogen, getrennt von der Zähleinheit.

Das Modal zeigt ein Dosis-Feld.

Durchführender (records_performer)

Erfassen, wer die Maßnahme durchgeführt hat („durchgeführt von").

Das Modal fragt vor dem Buchen nach einem Durchführenden.

Abrechenbar

Den Eintrag als abrechenbar kennzeichnen.

Erscheint im abrechenbaren Materialbericht.

Consumes-Link

Diese Maßnahme verbraucht Material, das gegen die Dienst-Zählung zählen soll (siehe unten).

Beim Speichern bestätigt das Modal das vorgeschlagene verbrauchte Material; der Sani kann die Menge überschreiben.

Der Consumes-Link — warum nichts doppelt gezählt wird

Der Consumes-Link ist das zentrale Konzept. Wenn eine Maßnahme Material verbraucht — die Gabe eines Medikaments verbraucht eine Ampulle, das Versorgen einer Wunde verbraucht Pflaster — wird dieses verbrauchte Material automatisch nach oben in die Dienst-Material-Zählung geschrieben.

  Maßnahme (Patientenprotokoll)      Dienst-Material-Zählung
  ─────────────────────────          ───────────────────────
  „Medikament gegeben"  ──consumes──▶  1 × Ampulle
       ▲                                    ▲
   die AKTION wird im                 das MATERIAL wird in
   Protokoll gezählt                  der Dienst-Zählung gezählt

Die Aktion wird im Protokoll gezählt; das Material wird in der Dienst-Zählung gezählt — niemals beides. Die Doppelzählung löst sich auf. Der Link liefert eine vorgeschlagene Standardmenge, und der Sani kann sie überschreiben (eine Maßnahme kann zwei Ampullen verbrauchen oder nur eine Teilmenge einer Ampulle).

Das tiefste Prinzip: die Zähleinheit und ihre Semantik gehören der Domäne, sie sind keine Entwickler-Annahme. Ein Medikament wird in ganzen Ampulle gezählt (oder in mg, wenn dein Bestand so geführt wird); Pflaster wird in cm gezählt. Du setzt Einheit und Consumes-Menge pro Eintrag, damit die Zählung widerspiegelt, wie dein Material tatsächlich bevorratet und abgerechnet wird.

Den Katalog pflegen

Im Admin-Panel kannst du:

  • Einen Katalogeintrag anlegen und Bezeichnung, Gruppe, Einheit und Flags setzen.

  • Einen bestehenden Eintrag aktualisieren — seine Flags, Dosis, Varianten und Consumes-Links.

  • Einen Eintrag auf einer Oberfläche ein-/ausschalten, ohne ihn zu löschen.

  • Einen Eintrag löschen.

  • Gruppen anlegen und verwalten — die vom Admin definierte Taxonomie, nach der das Streamdeck angeordnet wird.

Eine nicht leere Gruppe kann nicht gelöscht werden. Verschiebe oder lösche zuerst ihre Einträge, dann lösche die Gruppe.

Noch nicht verfügbar

Folgendes ist geplant, aber nicht gebaut — verlasse dich nicht darauf:

  • Dosis-abhängige Skalierung des verbrauchten Materials (die Consumes-Menge ist eine feste vorgeschlagene Standardmenge, nicht nach der eingegebenen Dosis skaliert).

  • Maßnahme-löschen → Consumes-Abgleich (das Löschen einer erfassten Maßnahme nimmt das an die Zählung geschriebene Material noch nicht zurück).

  • Custom → Katalog-Übernahme (eine ad-hoc angelegte eigene Maßnahme kann noch nicht in den geteilten Katalog übernommen werden).

  • Erweiterte Abrechnung über das aktuelle Abrechenbar-Flag und den Bericht hinaus.

Verwandte Seiten