Dateien nach "/" hochladen

01_anforderungsanalyse.md

@@ -0,0 +1,72 @@
+# Prompt 01 – Anforderungsanalyse
+
+Projekt: Ressourcen- und Materialmanagement, Bereich Rettungsdienst/KatS als erster Anwendungsfall ([[11_systemumfang_ressourcenmanagement]]). Noch keine technische Umsetzung — reine fachliche Zusammenfassung.
+
+## 1. Ausgangslage
+Heute: Papierlisten pro Rucksack/Fahrzeug (Beispiele: Handball Rucksack, Rettungsrucksack, Rucksack PAX SEG). Mitarbeiter kontrolliert, zählt, tauscht abgelaufenes Material, trägt Abweichung ein, unterschreibt, Papier wird abgeheftet. Ziel: dies weitgehend digital ersetzen, ohne dass Fehlbestände vergessen werden können.
+
+## 2. Funktionale Anforderungen
+
+### Muss
+- Digitale Erfassung von Materialbeständen je Ressource (Rucksack, Fahrzeug, später weitere Objekttypen).
+- Digitale Durchführung von Kontrollen: Ist-Menge je Position erfassen, Abweichungen sichtbar machen.
+- Automatisches Anlegen eines Fehlbestand-Vorgangs bei jeder festgestellten Mindermenge — auch bei sofortiger Nachfüllung (Karte 07: entsteht + wird sofort erledigt, mit Historie).
+- Fehlbestand bleibt als eigener, offener Vorgang bestehen, unabhängig vom Abschluss der Kontrolle.
+- Besatzung kann fehlendes Material selbst aus dem Lager nachfüllen und dies dokumentieren.
+- Fehlbestand gilt erst als erledigt, wenn tatsächlicher Bestand wieder vollständig ist (nicht durch bloße Genehmigung).
+- Genehmigung von Mindermengen durch berechtigte Rollen (Materialverantwortlicher/Leitungsverantwortlicher), OHNE dass sich dadurch die tatsächliche Ist-Menge ändert (Karte 08: Genehmigung gilt automatisch bis zur nächsten Kontrolle).
+- Materialverantwortlicher kann Sollmengen/Beladungsvorlagen ändern (Karte 03).
+- Mitarbeiter meldet nur Ist-Menge, keine Stammdaten-Änderung (Karte 02).
+- Administration verwaltet Ressourcen, Vorlagen, Materialstamm, Benutzer, Zuständigkeiten (Karte 04: Zuständigkeiten flexibel durch Admin einteilbar, n:m Verantwortlicher↔Standort/Objekt).
+- Duplizieren von Ressourcen/Vorlagen als Grundlage für neue Objekte, mit anschließend voller Editierbarkeit; Zustandsdaten (Bestand, SN, Chargen, offene Fehlbestände, Historie) werden NICHT mitkopiert.
+- Individuelle Abweichung eines konkreten Objekts von seiner Vorlage muss möglich und nachvollziehbar sein.
+- Verantwortlichen-Dashboard mit offenen Fehlbeständen, genehmigten Mindermengen, Filtermöglichkeiten (Standort, Objekt, Material, Alter).
+- Benachrichtigung bei neuem Fehlbestand: Dashboard + E-Mail (Karte 05).
+- Vollständige Historie/Audit: wer, was, wann, alter/neuer Wert, Begründung.
+- Echtes Benutzerkonto mit Login (Passwort/PIN) für alle Rollen (Karte 09).
+- Bedienbarkeit sowohl auf PC als auch auf Smartphone/Tablet (Karte 06).
+- Zuweisung von Kontrollverantwortung an Einzelperson oder Gruppe möglich, ohne dass dies andere Mitarbeiter von der Kontrolle ausschließt (Karte 01).
+
+### Soll
+- Ablaufdaten/Chargen-Unterstützung inkl. Warnzeiträume (Prompt 14, später vertieft).
+- Erweiterbarkeit des Materialstamms um Medikamente, Geräte mit Seriennummer, Chargen.
+- Objekt- und Geräte-Code-Feld (ID für spätere QR/Barcode-Nutzung) bereits im Datenmodell vorsehen (Karte 10).
+- Zeitstempel "Fehlbestand entstanden am" für spätere Eskalationslogik vorsehen (Karte 12).
+
+### Kann (spätere Ausbaustufen, nicht MVP)
+- QR-/Barcode-Scan für Direktzugriff auf Objekt bzw. automatische SN-Erkennung (Roadmap, Karte 10).
+- Automatische Eskalation offener Fehlbestände an Leitungsverantwortliche nach konfigurierbaren Fristen (Roadmap, Karte 12).
+- Lagerverwaltung mit eigenen Lagerorten/Mindestbeständen, getrennt von Objektbestand (Prompt 15).
+- Offline-fähige mobile Nutzung mit Synchronisierung (Prompt 17).
+- Push-Benachrichtigungen (bewusst nicht in V1, Karte 05).
+- Generische Ausweitung auf weitere Ressourcentypen (Zelte, Feldbetten, Stromerzeuger, Funkgeräte, Betreuungsmaterial) über bereits vorbereitete Bereichs-/Kategorie-Dimension (Karte 11).
+
+## 3. Nichtfunktionale Anforderungen
+- Nachvollziehbarkeit/Auditierbarkeit hat hohe Priorität (Rettungsdienst-/KatS-Kontext, Verantwortlichkeit im Einsatzfall).
+- Bedienung muss im Einsatzumfeld schnell und mit wenig Tipparbeit möglich sein (Prompt 11).
+- System muss für mehrere Standorte/Wachen gleichzeitig nutzbar sein, mit flexibler, nicht starrer Organisationsstruktur (Karte 04).
+- Erweiterbarkeit ohne Grundmodell-Umbau ist ausdrückliches Designziel (Medikamente, Geräte, Prüfungen, Lagerbestände, weitere Ressourcentypen).
+- Datensicherheit: echte Authentifizierung, Rollen-/Rechtetrennung.
+- Verfügbarkeit auf gängigen Endgeräten (PC, Smartphone, Tablet) ohne getrennte Codebasis-Pflicht.
+
+## 4. Angenommene Rahmenbedingungen (Annahmen)
+- Rettungsdienst/KatS ist der erste produktive Bereich, System aber von Anfang an bereichsoffen modelliert (Karte 11).
+- Es gibt mehrere Standorte/Wachen mit potenziell unterschiedlichen Verantwortlichkeiten (Karte 04).
+- Mengenangaben aus bestehenden Excel-Listen (Artikel, Menge, Artikelnummer, teils Seriennummer) bilden den fachlichen Ausgangsdatensatz für Materialstamm und Vorlagen.
+- Netzabdeckung im Einsatzumfeld ist nicht durchgängig gesichert (Offline-Frage bleibt in Prompt 17 vertiefend zu klären).
+
+## 5. Risiken
+- Vermischung von "genehmigter Mindermenge" und "tatsächlichem Bestand" wäre fachlich falsch und sicherheitskritisch (ausdrücklich zu verhindern, siehe `reihenfolge.md`) — hohe Sorgfalt bei Statusmodell in Prompt 03/04 nötig.
+- Zu frühes technisches Design (Datenbank/UI) vor Abschluss 01–05 kann zu Fehlannahmen führen, die teuren Umbau erfordern (deswegen strikte Reihenfolge).
+- Generischer Ressourcenansatz (Karte 11) kann Komplexität erhöhen, wenn nicht sauber von MVP-Umfang (Prompt 18) getrennt.
+- Fehlende/inkonsistente Netzabdeckung im Einsatz kann Datenverlust oder Doppelerfassung verursachen, falls Offline-Konzept (Prompt 17) nicht sauber gelöst wird.
+- Kein Push in V1 (Karte 05) kann bei zeitkritischen Fehlbeständen zu Verzögerung führen, falls Verantwortlicher E-Mail/Dashboard nicht zeitnah prüft — als bekanntes Risiko für Roadmap (Eskalation, Karte 12) vermerkt.
+
+## 6. Offene Fragen (vor Prompt 02–05 weiter zu klären)
+- Muss zugewiesene Kontrollverantwortung (Karte 01) eine Pflichtkontrolle erzwingen, oder bleibt sie reine Sichtbarkeits-/Priorisierungshilfe?
+- Kann ein Objekt mehrere gleichzeitig zuständige Verantwortliche haben, und vererbt sich Zuständigkeit vom Standort automatisch auf alle dortigen Objekte (Karte 04)?
+- Wie granular soll der Objekttyp/Kategorie-Baum sein (Karte 11) — flache Liste (Rettungsdienst, Betreuung, Technik, ...) oder hierarchisch mit Unterkategorien?
+- Welche Kontrollintervalle/Fristen sind organisatorisch vorgesehen (täglich, wöchentlich, nach Einsatz)? — relevant für Prompt 02 und spätere Eskalation.
+
+## Referenzen
+Arbeitskarten: [[01_rollen_zuordnung]], [[02_rechte_stammdaten]], [[03_sollmengen_recht]], [[04_organisationsstruktur]], [[05_benachrichtigungen]], [[06_geraet_pc_mobil]], [[07_sofort_nachfuellung]], [[08_mindermenge_gueltigkeit]], [[09_authentifizierung]], [[10_qr_barcode]], [[11_systemumfang_ressourcenmanagement]], [[12_eskalation]]

02_prozess_kontrolle.md

@@ -0,0 +1,69 @@
+# Prompt 02 – Kontrollprozess vollständig definieren
+
+Bezug: [[01_anforderungsanalyse]], Karten [[01_rollen_zuordnung]], [[07_sofort_nachfuellung]], [[08_mindermenge_gueltigkeit]], [[06_geraet_pc_mobil]].
+
+## 1. Status einer Kontrolle
+- **nicht gestartet** – Objekt wartet auf Kontrolle
+- **in Bearbeitung** – Mitarbeiter hat Kontrolle geöffnet, noch nicht abgeschlossen
+- **abgeschlossen** – Kontrolle beendet (kann trotzdem offene Fehlbestände als eigene Vorgänge hinterlassen, siehe Prompt 16)
+- **abgebrochen** – Mitarbeiter hat Kontrolle gestartet, aber nicht zu Ende geführt (z. B. Einsatzalarmierung); keine Ist-Werte werden übernommen, Objekt bleibt „nicht gestartet“/vorherigen Stand
+
+## 2. Ablauf (Normalfall, keine Abweichung)
+1. Mitarbeiter öffnet Ressource (Rucksack/Fahrzeug) – frei wählbar oder aus zugewiesener Liste (Karte 01).
+2. System zeigt Positionen nach Kategorie/Fach gegliedert (siehe Struktur der bestehenden Excel-Listen: Fach → Artikel → Sollmenge).
+3. Für jede Position: einfache Bestätigung „passt“ (Ist = Soll) per einem Tap, oder Eingabe abweichender Ist-Menge.
+4. Bestätigte Positionen benötigen keine weitere Eingabe.
+5. Nach letzter Position: Kontrolle abschließen (Prompt 16), System speichert Kontrollnachweis (wer, wann, Objekt, Ergebnis je Position).
+
+## 3. Ablauf bei Abweichung (Ist < Soll)
+1. Mitarbeiter trägt Ist-Menge ein, System berechnet Fehlmenge automatisch (Soll − Ist).
+2. System legt automatisch einen Fehlbestand-Vorgang an, Status „offen“, mit Zeitstempel „entstanden am“ (Vorbereitung Eskalation, Karte 12).
+3. Mitarbeiter wird gefragt: „Direkt aus Lager nachfüllen?“
+   - **Ja, sofort nachgefüllt:** Ist-Menge wird auf Soll korrigiert, Fehlbestand-Vorgang wird im selben Moment auf Status „erledigt“ gesetzt, Historieneintrag zeigt beide Ereignisse mit Zeitstempel (Karte 07).
+   - **Nein, nicht verfügbar:** Fehlbestand bleibt „offen“, Kontrolle kann trotzdem fortgesetzt/abgeschlossen werden (Prompt 16).
+4. Optional: Mitarbeiter kann Ursache/Bemerkung zum Fehlbestand hinterlegen (z. B. „Verbrauch im Einsatz“, „nicht auffindbar“).
+
+## 4. Ablauf bei Ist > Soll (Überbestand)
+- Wird ebenfalls erfasst und als Abweichung protokolliert (informativ), löst aber keinen Fehlbestand-Vorgang aus. Keine Genehmigungspflicht nötig, da kein Sicherheitsrisiko wie bei Mindermenge.
+
+## 5. Nachfüllung außerhalb der Kontrolle
+- Ein offener Fehlbestand kann jederzeit unabhängig von einer laufenden Kontrolle nachgefüllt werden (z. B. Lieferung trifft später ein).
+- Nachfüllung erfasst: nachgefüllte Menge, wer, wann. Ist die Sollmenge danach wieder vollständig erreicht → Fehlbestand-Vorgang wird automatisch auf „erledigt“ gesetzt.
+- Teilnachfüllung: Fehlbestand bleibt „offen“, Fehlmenge wird reduziert, Historieneintrag dokumentiert Teilschritt.
+
+## 6. Mindermengen-Genehmigung im Ablauf
+- Bei offenem Fehlbestand kann Materialverantwortlicher/Leitungsverantwortlicher eine Ausnahme genehmigen (Prompt 04).
+- Genehmigung ändert NICHT die Ist-Menge, sondern setzt einen zusätzlichen Status/Vermerk „Mindermenge genehmigt“ neben dem weiterhin bestehenden Fehlbestand.
+- Genehmigung gilt automatisch nur bis zur nächsten Kontrolle desselben Objekts (Karte 08) – bei dieser nächsten Kontrolle wird die Position erneut regulär bewertet.
+
+## 7. Sonderfälle
+- **Material nicht mehr im Bestand des Materialstamms vorhanden** (z. B. Position wurde durch Vorlagenänderung entfernt): Kontrolle zeigt Hinweis, Position wird als „entfällt“ markiert statt als Fehlbestand.
+- **Individuelle Abweichung vom Vorlagen-Soll** (Prompt 10): Kontrolle rechnet gegen die objektindividuelle Sollmenge, nicht gegen die ursprüngliche Vorlage.
+- **Mehrere Mitarbeiter gleichzeitig an derselben Kontrolle:** ausgeschlossen durch Objekt-Sperre nach Scan/Kontrollstart (siehe Punkt 8), nicht durch reine Konvention.
+- **Gerätewechsel (PC ↔ mobil) mitten in einer Kontrolle:** Kontrollstatus „in Bearbeitung“ muss geräteunabhängig fortsetzbar sein (Karte 06), da Login-basiert und nicht gerätegebunden.
+
+## 8. Objekt-Sperre bei aktiver Kontrolle (Nutzerentscheidung)
+Ergänzung zum Sonderfall „mehrere Mitarbeiter gleichzeitig": Sobald ein Objekt gescannt bzw. eine Kontrolle daran gestartet wird, gilt es für andere Mitarbeiter als **gesperrt**, solange die Kontrolle „in Bearbeitung“ ist.
+
+**Wichtige Klarstellung zum Geltungsbereich:** Die Sperre gilt ausschließlich **pro einzelnem Objekt**, nicht für eine ganze Kontrollrunde/Kampagne. Mehrere Mitarbeiter können jederzeit **gleichzeitig verschiedene Objekte** kontrollieren (z. B. eine ganze Fahrzeugflotte wird parallel von mehreren Personen kontrolliert, je eine Person pro Fahrzeug/Rucksack). Gesperrt ist immer nur das konkrete Objekt, an dem gerade eine Kontrolle läuft – nicht das System oder ein größerer Bereich.
+
+- **Sperre auslösen:** automatisch bei Scan/Kontrollstart (Prompt 11, Screen 1/2).
+- **Zweiter Zugriffsversuch:** System zeigt klare Meldung „wird gerade von [Name] kontrolliert, seit [Zeitpunkt]" statt stillschweigend zu blockieren.
+- **Übernahme möglich:** zweiter Mitarbeiter kann nach dieser Meldung bewusst „trotzdem übernehmen" wählen (z. B. wenn erster Kollege erwiesenermaßen nicht mehr dran ist, Akku leer, Einsatzalarmierung). Kein automatischer Timeout nötig, da menschliche Entscheidung die Übernahme freigibt.
+- **Protokollierung:** jede Übernahme wird als Historieneintrag festgehalten (wer hat wem die laufende Kontrolle entzogen, wann, Prompt 13) – Nachvollziehbarkeit bleibt gewahrt.
+- **Freigabe der Sperre:** automatisch bei Abschluss oder Abbruch der Kontrolle (Prompt 16), zusätzlich jederzeit durch Übernahme gemäß obigem Mechanismus.
+- Getrennt vom Server-Zuordnungs-Mechanismus für Satelliten (Karte 13): diese Sperre wirkt innerhalb eines Servers (Haupt- oder Satellit) zwischen einzelnen Benutzern, die Server-Zuordnung wirkt zwischen Haupt- und Satelliten-Server als Ganzes.
+
+## 9. Trennung der vier Kernbegriffe (verbindlich)
+| Begriff | Bedeutung | Ändert Ist-Menge? |
+|---|---|---|
+| Kontrolle | Erfassungsvorgang zu einem Zeitpunkt | nein, nur Erfassung |
+| Fehlbestand | Automatisch entstandener Vorgang bei Ist < Soll | nein, dokumentiert nur |
+| Nachfüllung | Tatsächliches Auffüllen aus Lager | ja, korrigiert Ist-Menge |
+| Mindermengen-Genehmigung | Fachliche Ausnahmeentscheidung | nein, niemals |
+
+Diese Trennung ist die zentrale Leitplanke aus `reihenfolge.md` und darf bei Prompt 03/04/06 nicht aufgeweicht werden.
+
+## Offene Fragen für Prompt 03/04
+- Braucht „abgebrochene“ Kontrolle eine Aufbewahrung als Teil-Historie, oder wird sie komplett verworfen?
+- Soll Bemerkungsfeld beim Fehlbestand Pflicht oder optional sein?

03_fehlbestandsmanagement.md

@@ -0,0 +1,62 @@
+# Prompt 03 – Fehlbestände und Aufgaben definieren
+
+Bezug: [[02_prozess_kontrolle]], Karten [[07_sofort_nachfuellung]], [[08_mindermenge_gueltigkeit]], [[12_eskalation]].
+
+## 1. Statusmaschine Fehlbestand
+
+```
+                 ┌────────────────────────────────────┐
+                 │                                      │
+  entdeckt ──▶ offen ──▶ in Bearbeitung ──▶ nachgefüllt ──▶ erledigt
+                 │            │
+                 │            └──▶ Mindermenge genehmigt ─┐
+                 │                                          │ (bleibt weiterhin
+                 └──────────────────────────────────────────┘  als Fehlbestand sichtbar,
+                                                                bis tatsächlich erledigt)
+```
+
+**Status-Definitionen:**
+- **offen** – Fehlmenge festgestellt, noch keine Reaktion.
+- **in Bearbeitung** – jemand kümmert sich aktiv (z. B. Bestellung ausgelöst, Ersatzteil unterwegs); optionaler Zwischenstatus, kein Pflichtdurchlauf.
+- **Mindermenge genehmigt** – zusätzlicher Vermerk/Substatus, KEIN Ersatz für „offen“; Fehlbestand bleibt fachlich offen, nur die Bewertung/Sichtbarkeit ändert sich (Karte 08). Läuft automatisch aus bei nächster Kontrolle des Objekts.
+- **nachgefüllt (teilweise)** – Ist-Menge wurde erhöht, aber Soll noch nicht vollständig erreicht; Fehlmenge reduziert sich. Technisch eigener Status `nachgefuellt_teilweise` (Prompt 20), fachlich zählt er weiterhin als „offen" – Dashboard-Kennzahlen (Prompt 12) müssen `offen`, `in_bearbeitung` UND `nachgefuellt_teilweise` gemeinsam als „offen" aggregieren.
+- **erledigt** – Ist-Menge = Soll-Menge erreicht, unabhängig davon ob durch sofortige Nachfüllung (Karte 07) oder spätere Lieferung.
+
+**Wichtigste Regel (aus `reihenfolge.md`):** „Mindermenge genehmigt“ ist niemals gleichbedeutend mit „erledigt“. Ein Fehlbestand gilt ausschließlich als erledigt, wenn der tatsächliche Bestand wieder vollständig ist.
+
+## 2. Pflichtattribute eines Fehlbestand-Vorgangs
+| Feld | Beschreibung |
+|---|---|
+| Material | Referenz auf Materialstamm-Position |
+| Ressource | Rucksack/Fahrzeug/Objekt, an dem Fehlbestand festgestellt wurde |
+| Standort | zum Zeitpunkt der Feststellung |
+| Sollmenge | zum Zeitpunkt der Feststellung (kann sich später durch Vorlagenänderung ändern, Vorgang bleibt an ursprünglichem Wert dokumentiert) |
+| Istmenge | zum Zeitpunkt der Feststellung |
+| Fehlmenge | Soll − Ist, wird bei Teilnachfüllung neu berechnet |
+| Entstanden am | Zeitstempel, Grundlage für spätere Eskalation (Karte 12) |
+| Festgestellt von | Mitarbeiter/Kontrolle, die den Fehlbestand ausgelöst hat |
+| Ursache | optional (z. B. Verbrauch, nicht auffindbar, beschädigt) |
+| Maßnahme(n) | Historie von Aktionen (Nachfüllung, Genehmigung, Bemerkungen) |
+| Verantwortlicher | zuständiger Materialverantwortlicher (aus Zuständigkeits-Zuordnung, Karte 04) |
+| Erledigt am | Zeitstempel, wenn Status „erledigt“ erreicht |
+| Historie | vollständiger Verlauf aller Statuswechsel mit wer/wann/alt→neu |
+
+## 3. Übergangsregeln
+- **offen → in Bearbeitung**: manuell durch Verantwortlichen, rein informativ, keine Pflicht.
+- **offen/in Bearbeitung → Mindermenge genehmigt**: nur durch Materialverantwortlicher/Leitungsverantwortlicher (Prompt 04), niemals durch Mitarbeiter/Kontrollorgan selbst.
+- **jeder Status → erledigt**: ausschließlich automatisch durch das System, wenn Ist = Soll erreicht wird (nie manuell durch Setzen eines Häkchens ohne Mengenabgleich).
+- **Mindermenge genehmigt → offen**: automatisch beim Start der nächsten Kontrolle desselben Objekts (Ablauf der Genehmigung, Karte 08), sofern die Abweichung dort weiterhin besteht.
+- Sofortige Nachfüllung während der Kontrolle: Übergang offen → erledigt geschieht ohne Zwischenstatus, aber mit vollständigem Historieneintrag beider Ereignisse (Karte 07).
+
+## 4. Sichtbarkeit
+- Mitarbeiter: sieht offene Fehlbestände seiner kontrollierten/zugewiesenen Objekte, kann nachfüllen.
+- Materialverantwortlicher/Leitungsverantwortlicher: sieht alle Fehlbestände seines Zuständigkeitsbereichs (Karte 04), kann genehmigen, Sollmengen anpassen.
+- Administration: sieht alles, verwaltet Stammdaten/Struktur.
+
+## 5. Vorbereitung für Roadmap-Feature Eskalation (Karte 12)
+- Feld „entstanden am“ ist Pflicht, damit späteres Eskalationsjob (Prompt 24) Alter berechnen kann, ohne Modelländerung.
+- Kein Eskalationsmechanismus selbst in V1 – nur Datenbasis.
+
+## Offene Fragen für Prompt 04
+- Bemerkungsfeld beim Fehlbestand: aus Prompt 02 offen – Pflicht oder optional? → Empfehlung: optional, aber bei Genehmigung einer Mindermenge zwingend (Begründungspflicht), siehe Prompt 04.
+- Muss ein Fehlbestand einem bestimmten Verantwortlichen fest zugeordnet werden, oder reicht "sichtbar für alle Verantwortlichen des Zuständigkeitsbereichs"? → Im Schema (Prompt 20) als `verantwortlicher_id` NULLABLE umgesetzt: NULL bedeutet „sichtbar für alle Verantwortlichen des Zuständigkeitsbereichs" (Standardfall), gesetzter Wert bedeutet feste Zuordnung. Beide Fälle vom Modell abgedeckt, keine weitere Entscheidung nötig.

04_mindermengen.md

@@ -0,0 +1,38 @@
+# Prompt 04 – Mindermengen-Ausnahmen
+
+Bezug: [[03_fehlbestandsmanagement]], Karten [[03_sollmengen_recht]], [[08_mindermenge_gueltigkeit]].
+
+## 1. Grundprinzip
+Eine genehmigte Mindermenge ist eine **fachliche Bewertung**, kein Bestandsvorgang. Beispiel: Soll 10, Ist 8, Fehlbestand 2 → nach Genehmigung bleibt Ist weiterhin 8, Fehlbestand weiterhin 2, nur die Einstufung ändert sich von „unbewertet offen“ zu „bewusst akzeptiert, aber weiterhin offen“.
+
+## 2. Wer darf genehmigen
+- Materialverantwortlicher (Karte 03: darf auch Sollmengen ändern).
+- Leitungsverantwortlicher (vermutlich gleiche oder erweiterte Rechte, final in Prompt 05 zu bestätigen).
+- Mitarbeiter/Kontrollorgan: darf Abweichung feststellen und dokumentieren, NIEMALS selbst genehmigen.
+
+## 3. Genehmigungsprozess
+1. Offener Fehlbestand existiert (Prompt 03, Status „offen“ oder „in Bearbeitung“).
+2. Berechtigte Rolle öffnet Fehlbestand, wählt „Mindermenge genehmigen“.
+3. Pflichtfeld: Begründung (Freitext), z. B. „Lieferengpass Hersteller, Ersatz bestellt, Lieferung erwartet KW38“.
+4. System setzt Vermerk „Mindermenge genehmigt“, verknüpft mit der aktuellen Kontrolle des Objekts.
+5. Genehmigung ändert nicht Ist-Menge, nicht Fehlmenge, nicht den zugrundeliegenden „offen“-Zustand des Fehlbestands als Faktum.
+
+## 4. Gültigkeitsdauer (Karte 08 – bereits entschieden)
+- Genehmigung gilt automatisch nur **bis zur nächsten Kontrolle** desselben Objekts – kein Kalenderdatum, kein manuelles Ablaufen nötig.
+- Bei Start der nächsten Kontrolle: Position wird regulär neu bewertet. Besteht die Abweichung weiterhin, ist eine neue, eigenständige Genehmigung erforderlich (alte Genehmigung erlischt automatisch, wird aber in der Historie sichtbar archiviert, nicht gelöscht).
+- Wird die Abweichung bei nächster Kontrolle behoben (nachgefüllt), erledigt sich sowohl Fehlbestand als auch Genehmigungs-Vermerk gemeinsam.
+
+## 5. Anzeige
+- Im Kontroll-Screen: Position mit genehmigter Mindermenge zeigt deutliches Symbol „genehmigte Abweichung, gültig bis nächste Kontrolle“ + Begründung, damit Mitarbeiter nicht denkt, hier bestehe kein Handlungsbedarf.
+- Im Dashboard: eigener Filter „genehmigte Mindermengen“, getrennt von unbewerteten offenen Fehlbeständen (Prompt 12).
+- Fehlbestand-Zähler (z. B. für KPIs) muss genehmigte UND ungenehmigte offene Fehlbestände weiterhin als „offen“ zählen – Genehmigung ist keine Erledigung.
+
+## 6. Verhalten nach Ablauf
+- Kein separater „Ablauf-Job“ nötig, da Ablauf an Kontrollstart gekoppelt ist (kein Zeit-Trigger notwendig für V1, vereinfacht MVP).
+- Falls später ein zusätzliches zeitbasiertes Ablaufen gewünscht wird (z. B. Genehmigung verfällt auch ohne neue Kontrolle nach X Tagen) → das wäre eine Erweiterung, aktuell nicht gefordert.
+
+## 7. Historie/Audit
+Jede Genehmigung protokolliert: wer, wann, Begründung, betroffene Kontrolle, und – beim automatischen Erlöschen – Zeitpunkt/Kontrolle, die sie beendet hat.
+
+## Offene Fragen für Prompt 05
+- Gibt es einen Unterschied in den Genehmigungsrechten zwischen Materialverantwortlichem und Leitungsverantwortlichem (z. B. Eskalationsstufen, Genehmigung ab bestimmter Fehlmengenhöhe nur durch Leitung)?

05_rollen_rechte.md

@@ -0,0 +1,50 @@
+# Prompt 05 – Benutzerrollen und Rechte
+
+Bezug: [[01_anforderungsanalyse]], [[02_prozess_kontrolle]], [[03_fehlbestandsmanagement]], [[04_mindermengen]], Karten [[01_rollen_zuordnung]], [[02_rechte_stammdaten]], [[03_sollmengen_recht]], [[04_organisationsstruktur]], [[09_authentifizierung]].
+
+## 1. Rollen
+- **Mitarbeiter/Kontrollorgan** – führt Kontrollen durch, füllt nach, meldet Abweichungen.
+- **Materialverantwortlicher** – fachlich zuständig für Material eines Zuständigkeitsbereichs (Standort/Objekt, Karte 04), genehmigt Mindermengen, pflegt Sollmengen/Vorlagen.
+- **Leitungsverantwortlicher** – übergeordnete Verantwortung, gleiche Rechte wie Materialverantwortlicher plus organisatorische/eskalierende Sicht (siehe 3.).
+- **Administration** – verwaltet Stammdaten, Struktur, Benutzer, Zuständigkeiten.
+
+Mehrfachrollen pro Person möglich (z. B. Mitarbeiter UND Materialverantwortlicher).
+
+## 2. Berechtigungsmatrix
+
+| Aktion | Mitarbeiter | Materialverantwortlicher | Leitungsverantwortlicher | Administration |
+|---|---|---|---|---|
+| Kontrolle durchführen/abschließen | ✅ | ✅ | ✅ | ✅ |
+| Ist-Menge erfassen | ✅ | ✅ | ✅ | ✅ |
+| Nachfüllung dokumentieren | ✅ | ✅ | ✅ | ✅ |
+| Fehlbestand einsehen (eigener Zuständigkeitsbereich) | ✅ (nur zugewiesene/kontrollierte Objekte) | ✅ | ✅ | ✅ (alles) |
+| Mindermenge genehmigen | ❌ | ✅ | ✅ | ❌ (Admin genehmigt fachlich nicht, reine Stammdatenrolle) |
+| Sollmenge/Vorlage ändern | ❌ | ✅ (Karte 03) | ✅ | ✅ |
+| Zuständigkeiten zuordnen (wer verantwortet was) | ❌ | ❌ | ❌ | ✅ (Karte 04) |
+| Objekte/Ressourcen anlegen, duplizieren | ❌ | ❌ | ❌ | ✅ |
+| Materialstamm pflegen | ❌ | ❌ | ❌ | ✅ |
+| Benutzer/Rollen verwalten | ❌ | ❌ | ❌ | ✅ |
+| Kontrollverantwortung zuweisen (Einzelperson/Gruppe) | ❌ | ✅ (eigener Bereich) | ✅ | ✅ |
+| Historie/Audit einsehen (eigener Bereich) | ✅ (eigene Aktionen) | ✅ | ✅ | ✅ (alles) |
+| Dashboard mit offenen Fehlbeständen/Mindermengen | ❌ (nicht nötig, sieht nur eigene Objekte in Kontroll-UI) | ✅ | ✅ | ✅ |
+
+## 3. Offene Frage aus Prompt 04 – geklärt
+**Frage:** Unterschied in Genehmigungsrechten zwischen Materialverantwortlichem und Leitungsverantwortlichem?
+
+**Entscheidung:** In V1 **keine** fachliche Einschränkung – beide dürfen jede Mindermenge in ihrem Zuständigkeitsbereich genehmigen, unabhängig von Fehlmengenhöhe. Kein Eskalationsstufen-Zwang beim Genehmigen selbst.
+Begründung: Materialverantwortlicher ist die fachlich nähere, schnellere Instanz; Leitung soll nicht zum Flaschenhals werden. Eskalation (Karte 12) ist ein separater, zeitbasierter Mechanismus für *unbearbeitete* Fehlbestände, keine Genehmigungshierarchie.
+Für spätere Ausbaustufe denkbar, aber nicht MVP: Schwellenwert (z. B. hohe Fehlmengen nur durch Leitung genehmigbar) – als Roadmap-Notiz vermerkt, kein Datenmodell-Zwang jetzt.
+
+## 4. Feingranulare Rechte (zusätzlich identifiziert)
+- Lesen vs. Schreiben pro Bereich (z. B. Leitungsverantwortlicher kann bereichsübergreifend lesen, aber nur in zugewiesenem Bereich schreiben – abhängig von Zuständigkeits-Zuordnung Karte 04).
+- Eigene Aktionen vs. fremde Aktionen einsehen (Mitarbeiter sieht nur eigene Historie, Verantwortliche sehen Historie ihres Bereichs).
+- Genehmigen vs. Sollmenge ändern sind zwei getrennte Rechte (nicht zwingend gekoppelt), falls später feinere Rollen gewünscht (z. B. "nur genehmigen, keine Vorlagenänderung").
+
+## 5. Mögliche zukünftige Rollen (Roadmap, nicht MVP)
+- **Lagerverantwortlicher** (Prompt 15 – separate Lagerbestände, getrennt vom Objektbestand).
+- **Prüforgan/Medizinprodukteverantwortlicher** (Prompt 14/24 – Prüfungen, Ablaufdaten, Medizinprodukte-Konformität).
+- **Bereichsleitung** oberhalb Leitungsverantwortlicher, falls generischer Ressourcenansatz (Karte 11) mehrere Bereiche mit eigener Leitung erfordert.
+- **Read-only-Auditor** (z. B. externe Prüfung/Revision) – nur Historie/Audit einsehen, keine Aktionen.
+
+## Referenzen
+Arbeitskarten: [[01_rollen_zuordnung]], [[02_rechte_stammdaten]], [[03_sollmengen_recht]], [[04_organisationsstruktur]], [[09_authentifizierung]]