Dateien nach "/" hochladen

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]]

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]]

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]]

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]]