diff --git a/11_kontroll_ui.md b/11_kontroll_ui.md new file mode 100644 index 0000000..7278f6c --- /dev/null +++ b/11_kontroll_ui.md @@ -0,0 +1,57 @@ +# Prompt 11 – Benutzeroberfläche für Mitarbeiter + +Bezug: [[02_prozess_kontrolle]], [[10_individuelle_beladung]], Karte [[06_geraet_pc_mobil]], [[10_qr_barcode]]. + +## 1. Grundprinzip +Minimaler Tippaufwand. Normalfall = ein Tap pro Position. Zusatzfragen nur bei Abweichung. Große Touchflächen, klare Farben, für Einsatzumfeld/Handschuhe geeignet. + +## 2. Screen-Ablauf + +### Screen 1 – Standort/Objekt wählen +- Liste zugewiesener Objekte zuerst (Karte 01), darunter „alle Objekte" durchsuchbar. +- Alternative: QR-/Barcode-Scan (Kamera, Karte 10) → Direktsprung zu Screen 3, sobald Feature verfügbar (Roadmap). +- Suchfeld, Filter nach Standort. + +### Screen 2 – Kontrollstart +- Objekt-Info (Name, Typ, Standort, letzte Kontrolle wann/von wem). +- Button „Kontrolle starten" → Status wechselt zu „in Bearbeitung", Objekt wird gesperrt (Prompt 02, Punkt 9). +- Hinweis, falls offene Fehlbestände aus vorheriger Kontrolle noch bestehen (informativ, kein Blocker). +- **Ist Objekt bereits gesperrt** (jemand kontrolliert es aktiv, per Scan/Start ausgelöst): statt „Kontrolle starten" erscheint Meldung „wird gerade von [Name] kontrolliert, seit [Zeitpunkt]" + Button „trotzdem übernehmen" (Prompt 02, Punkt 9). Übernahme erfordert Bestätigung (zweiter Tap), um versehentliches Entziehen zu vermeiden. + +### Screen 3 – Kategorien/Fächer-Übersicht +- Liste der Fächer/Kategorien der Vorlage (z. B. „Fach 1", „Fach 2"), mit Fortschrittsanzeige (X von Y Positionen erledigt) je Fach. +- Tap auf Fach → Screen 4. + +### Screen 4 – Materialpositionen (Kernscreen) +- Je Position: Name, Sollmenge, großer Bestätigungs-Button „passt" (ein Tap, entspricht Ist=Soll). +- Alternative: Zahlenfeld/Stepper für abweichende Ist-Menge, direkt sichtbar ohne extra Screen wechseln. +- Individuell angepasste Positionen (Prompt 10) mit eigenem Symbol markiert. +- Bereits bestätigte Positionen visuell abgehakt (grün), offene Positionen neutral, abweichende Positionen rot/gelb markiert. +- Bei Materialtyp „Gerät mit SN" (Prompt 07): zusätzliches Feld/Scan für Seriennummer, falls nicht bereits erfasst. +- Bei Materialtyp „Ablaufdatum/Charge": Anzeige Ablaufstatus (Prompt 14), Warnfarbe bei bald ablaufend/abgelaufen, auch wenn Menge stimmt. + +### Screen 5 – Abweichung (erscheint nur bei Ist < Soll) +- Anzeige Fehlmenge automatisch berechnet. +- Frage: „Direkt aus Lager nachfüllen?" – Ja/Nein als große Buttons (Karte 07). + - Ja → Mengeneingabe (vorbelegt mit Fehlmenge, editierbar bei Teilnachfüllung), Bestätigung → Fehlbestand+Nachfüllung im Hintergrund verbucht (Prompt 02/03). + - Nein → optionales Bemerkungsfeld (Ursache), Fehlbestand bleibt offen, zurück zu Screen 4. + +### Screen 6 – Kontrollabschluss (Prompt 16 vertieft) +- Zusammenfassung: Anzahl Positionen ok, Anzahl Abweichungen, Anzahl noch offener Fehlbestände. +- Bestätigungs-Button „Kontrolle abschließen". +- Hinweis, falls offene Fehlbestände bestehen bleiben („bleiben als eigene Vorgänge sichtbar"). + +## 3. Bedienprinzipien +- Touch-Ziele mindestens fingerspitzengerecht groß (Einsatzumfeld, ggf. Handschuhe). +- Statusfarben konsistent: grün=ok, gelb=abweichend/in Bearbeitung, rot=kritisch/offen, grau=neutral/nicht bearbeitet. +- Keine Pflicht-Freitexteingabe im Normalfall (nur bei Mindermengen-Begründung/Ursache optional). +- Fortschritt jederzeit sichtbar (X von Y Positionen), damit Unterbrechung (Einsatzalarmierung) klar erkennbar bleibt, wo man stand. +- Geräteunabhängig fortsetzbar (Karte 06): Status „in Bearbeitung" ist login-/objektgebunden, nicht gerätegebunden. + +## 4. Offene Punkte für spätere Prompts +- Genaues Verhalten bei „Kontrolle abbrechen" (Screen-Ebene) final in Prompt 16. +- Offline-Verhalten der UI (Netzausfall mitten in Kontrolle) final in Prompt 17. + +## Referenzen +Bezug: [[02_prozess_kontrolle]], [[10_individuelle_beladung]] +Arbeitskarten: [[06_geraet_pc_mobil]], [[07_sofort_nachfuellung]], [[10_qr_barcode]] diff --git a/12_verantwortlichen_dashboard.md b/12_verantwortlichen_dashboard.md new file mode 100644 index 0000000..982e970 --- /dev/null +++ b/12_verantwortlichen_dashboard.md @@ -0,0 +1,49 @@ +# Prompt 12 – Dashboard für Verantwortliche + +Bezug: [[03_fehlbestandsmanagement]], [[04_mindermengen]], [[05_rollen_rechte]], Karte [[05_benachrichtigungen]], [[12_eskalation]]. + +## 1. Zielgruppe +Materialverantwortlicher, Leitungsverantwortlicher, Administration (Prompt 05). Sicht nach Zuständigkeitsbereich gefiltert (Karte 04), Administration sieht alles. + +## 2. Kennzahlen (Übersicht oben) +- Anzahl offener Fehlbestände (gesamt, im Zuständigkeitsbereich) – **zählt die Status `offen`, `in_bearbeitung` UND `nachgefuellt_teilweise` gemeinsam als „offen"** (Prompt 03/20 – technischer Substatus ist keine Erledigung). +- davon genehmigte Mindermengen (separat gezählt, Prompt 04: gilt weiterhin als offen) +- Anzahl kürzlich erledigter Fehlbestände (z. B. letzte 7 Tage) +- Anzahl bevorstehender Ablaufdaten (Prompt 14, Vorschau) +- Anzahl fälliger Prüfungen (Roadmap-Feld, Prompt 24, falls Daten vorhanden) +- Anzahl problematischer Objekte (Objekte mit ≥1 offenem Fehlbestand, als Kennzahl „X von Y Objekten ohne Beanstandung") + +## 3. Hauptlisten/Tabellen + +### Offene Fehlbestände +- Spalten: Material, Objekt, Standort, Fehlmenge, Status (offen/in Bearbeitung/Mindermenge genehmigt), Alter (Tage seit „entstanden am", Vorbereitung Eskalation Karte 12), Verantwortlicher. +- Filter: Standort, Objekt, Material, Alter (z. B. „älter als 7 Tage"), Status. +- Sortierung standardmäßig nach Alter absteigend (älteste zuerst) – unterstützt Eskalationsgedanken auch ohne automatisierten Job. +- Aktion direkt aus Liste: Mindermenge genehmigen, Nachfüllung erfassen, Detail öffnen. + +### Genehmigte Mindermengen +- Eigener Filter/Tab, getrennt von unbewerteten (Prompt 04, Punkt 5). +- Spalten wie oben plus Begründung, genehmigt von, gültig bis (nächste Kontrolle). + +### Kürzlich erledigte Fehlbestände +- Spalten: Material, Objekt, erledigt am, erledigt durch (Nachfüllung wer). +- Dient als „Erfolgs"-Sicht, keine Aktion nötig. + +### Bevorstehende Ablaufdaten (Verweis Prompt 14) +- Kompakte Vorschau, Link zu vollständiger Ablauf-Ansicht. + +## 4. Detailansicht (Klick auf Fehlbestand) +- Vollständige Historie (Prompt 13): Kontrolle, die ihn ausgelöst hat, alle Nachfüllungen/Teilschritte, Genehmigungen, aktueller Status. +- Aktionsbuttons je nach Rolle/Status: genehmigen, Nachfüllung erfassen, Sollmenge anpassen (Karte 03). + +## 5. Suchmöglichkeiten +- Globale Suche über Objekte/Material (Name, Artikelnummer, Code/QR-ID). +- Schnellzugriff auf ein bestimmtes Objekt unabhängig vom Fehlbestand-Kontext. + +## 6. Vorbereitung Eskalation (Karte 12, Roadmap) +- Alter-Spalte und -Filter bereits jetzt vorhanden (siehe oben), liefert Datenbasis. +- Kein automatischer Eskalations-Trigger/Benachrichtigung an Leitung in V1 (Karte 05: kein Push, nur Dashboard+E-Mail bei Entstehung), aber visuelle Hervorhebung alter offener Fehlbestände (z. B. rote Markierung ab konfigurierbarer Schwelle) als einfache Vorstufe sinnvoll und ohne Zusatzaufwand umsetzbar. + +## Referenzen +Bezug: [[03_fehlbestandsmanagement]], [[04_mindermengen]], [[05_rollen_rechte]] +Arbeitskarten: [[04_organisationsstruktur]], [[05_benachrichtigungen]], [[12_eskalation]] diff --git a/13_historie_audit.md b/13_historie_audit.md new file mode 100644 index 0000000..42af82b --- /dev/null +++ b/13_historie_audit.md @@ -0,0 +1,45 @@ +# Prompt 13 – Historie und Nachvollziehbarkeit + +Bezug: [[06_datenmodell]] (Historieneintrag), [[03_fehlbestandsmanagement]], [[04_mindermengen]], [[10_individuelle_beladung]]. + +## 1. Grundprinzip +Jede fachlich relevante Aktion erzeugt einen unveränderlichen Historieneintrag: wer, was, wann, vorheriger Wert, neuer Wert, Begründung (falls vorhanden). Kein Löschen/Überschreiben von Historie, nur Anhängen. + +## 2. Protokollierte Ereignistypen +| Ereignis | Ausgelöst durch | Gespeicherte Werte | +|---|---|---| +| Kontrolle gestartet/abgeschlossen/abgebrochen | Mitarbeiter | Objekt, Zeitpunkt, Status-Wechsel | +| Ist-Menge erfasst (je Position) | Mitarbeiter | Material, Soll, alter Ist, neuer Ist | +| Fehlbestand entstanden | System (automatisch) | Material, Objekt, Soll, Ist, Fehlmenge, entstanden am | +| Nachfüllung | Mitarbeiter/Verantwortlicher | Material, Objekt, Menge, wer, wann, verknüpfter Fehlbestand | +| Fehlbestand erledigt | System (automatisch bei Ist=Soll) | Zeitpunkt, auslösende Nachfüllung | +| Mindermenge genehmigt | Materialverantwortlicher/Leitung | Fehlbestand, Begründung, wer, wann, gültig bis | +| Mindermenge abgelaufen/beendet | System (automatisch) | Fehlbestand, Zeitpunkt/Kontrolle, die sie beendet hat | +| Sollmenge geändert (Vorlage oder Override) | Materialverantwortlicher/Administration | Material, Objekt/Vorlage, alter Wert, neuer Wert | +| Vorlage geändert (neue Version) | Administration/Materialverantwortlicher | Vorlage, Version alt/neu, geänderte Positionen | +| Individuelle Abweichung gesetzt/aufgehoben | Materialverantwortlicher | Objekt, Material, Override ja/nein, Begründung | +| Objekt dupliziert/angelegt | Administration | Quelle, neues Objekt, Zeitpunkt | +| Benutzer-/Rollenänderung | Administration | Benutzer, alte/neue Rolle(n) | +| Zuständigkeits-Zuordnung geändert | Administration | Benutzer, Standort/Objekt, alt/neu | + +## 3. Beispiel-Kette (aus Prompt-Vorgabe) +Soll 10, Ist 8 → Fehlbestand entstanden (Fehlmenge 2) → keine Nachfüllung möglich (Status offen) → Mindermenge genehmigt (Begründung, gültig bis nächste Kontrolle) → später 2 Stück nachgefüllt → Ist wieder 10 → Fehlbestand automatisch erledigt, Mindermengen-Genehmigung automatisch beendet (verknüpft mit derselben Erledigung). +Jeder dieser Schritte ist ein eigener, zeitlich geordneter Historieneintrag, alle auf denselben Fehlbestand referenziert. + +## 4. Darstellung + +### Für Mitarbeiter +- Eigene Aktionen einsehbar (was habe ich wann bei welchem Objekt erfasst) – Prompt 05: keine fremde Historie sichtbar. +- Objektbezogene Detailansicht (Prompt 11 Screen 4/6): Verlauf der letzten Kontrollen dieses Objekts. + +### Für Verantwortliche/Administration +- Vollständige Timeline je Fehlbestand (Dashboard-Detail, Prompt 12): chronologische Liste aller Ereignisse mit Icon je Typ. +- Filterbare globale Historie (z. B. „alle Änderungen an Vorlage X", „alle Genehmigungen von Benutzer Y") – v. a. für Administration/Audit-Zwecke. + +## 5. Technische/fachliche Anforderungen an Historie +- Unveränderlich (Append-only), kein Update/Delete bestehender Einträge. +- Referenzintegrität auch bei gelöschten/inaktiven Stammdaten erhalten (z. B. Material wird deaktiviert, Historie zeigt trotzdem den Namen von damals – Snapshot-Prinzip wie bei Kontrollpositionen, Prompt 06). +- Zeitstempel immer serverseitig, nicht durch Client vorgebbar (Manipulationsschutz, Nachvollziehbarkeit im Rettungsdienst-/KatS-Kontext). + +## Referenzen +Bezug: [[06_datenmodell]], [[03_fehlbestandsmanagement]], [[04_mindermengen]], [[10_individuelle_beladung]], [[05_rollen_rechte]] diff --git a/14_ablaufdaten.md b/14_ablaufdaten.md new file mode 100644 index 0000000..ebaf5f5 --- /dev/null +++ b/14_ablaufdaten.md @@ -0,0 +1,34 @@ +# Prompt 14 – Ablaufdaten und Warnungen + +Bezug: [[07_materialstamm]], [[11_kontroll_ui]], [[12_verantwortlichen_dashboard]]. + +## 1. Grundprinzip +Ablaufdatum lebt auf Ebene der konkreten Bestandseinheit (Objektposition/Charge), nicht im Materialstamm (Prompt 07, Punkt 6). Materialstamm definiert nur „hat Ablauf: ja" + Standard-Warnzeitraum. + +## 2. Zustände +- **gültig** – Ablaufdatum liegt außerhalb Warnzeitraum. +- **bald ablaufend** – innerhalb konfigurierbarem Warnzeitraum (z. B. 30 Tage vor Ablauf). +- **abgelaufen** – Ablaufdatum überschritten. + +Berechnung rein serverseitig anhand aktuellem Datum, kein manueller Status. + +## 3. Warnzeiträume +- Standardwert je Materialstamm-Position hinterlegbar (z. B. 30 Tage), überschreibbar je Objektposition/Charge falls nötig (z. B. kritisches Material braucht längeren Vorlauf). +- Administration/Materialverantwortlicher pflegt Standardwerte. + +## 4. Anzeige im Kontrollprozess (Prompt 11) +- Screen 4 (Materialpositionen): Position mit Ablaufdatum zeigt Status-Farbe zusätzlich zur Mengen-Bestätigung (gelb=bald ablaufend, rot=abgelaufen), auch wenn Menge korrekt ist – Mitarbeiter darf „passt" trotzdem nicht bestätigen, ohne den Ablauf-Hinweis gesehen zu haben. +- Austauschprozess: Mitarbeiter tauscht abgelaufenes Material aus wie in Alltagspraxis (Prompt 23 Papierablösung) → neues Exemplar mit neuem Ablaufdatum erfasst, altes wird wie Verbrauch behandelt (Ist-Menge bleibt gleich, nur Charge/Datum aktualisiert, kein Fehlbestand nötig sofern Menge stimmt). +- Ist bei Austausch kein Ersatz verfügbar (Lager leer) → behandelt wie normale Abweichung, Fehlbestand-Vorgang (Prompt 03). + +## 5. Dashboard-Warnungen (Prompt 12) +- Kennzahl „bevorstehende Ablaufdaten" bereits vorgesehen. +- Eigene filterbare Liste: Material, Objekt, Ablaufdatum, verbleibende Tage, Status. +- Sortierung nach verbleibenden Tagen aufsteigend (dringendste zuerst). + +## 6. Spätere Erweiterung: Chargen und Medikamente (Roadmap, Prompt 24) +- Chargenverwaltung mit mehreren Ablaufdaten pro Material innerhalb eines Objekts (z. B. zwei Packungen unterschiedlicher Charge gleichzeitig im Bestand) – V1 vereinfacht auf ein Ablaufdatum je Objektposition, Mehrfach-Chargen als Ausbaustufe. +- Medikamente mit Betäubungsmittel-Sonderregeln (Dokumentationspflichten) – eigener Materialtyp später, nutzt dieselbe Ablauf-Logik als Basis. + +## Referenzen +Bezug: [[07_materialstamm]], [[11_kontroll_ui]], [[12_verantwortlichen_dashboard]]