MABEA/arbeitskacheln/07_warehouse.md

Epic 07 — Warehouse

Details zu WH-001 … WH-007 (vollständig).

---

WH-001 — Lager-Stammdaten (Hierarchie)

• Ziel: Mehrstufige Standort-Hierarchie statt flacher Standort-Liste.
• Beschreibung: Organisation→Standort→Gebäude→Raum→Lager als Baum, nicht nur ein flaches „Standort"-Feld.
• Benutzerwert: Größere Organisationen mit mehreren Gebäuden/Lagern pro Standort abbildbar.
• Abhängigkeiten: FOUND-002
• Datenmodell: lagerort (id, name, parent_id, typ: organisation/standort/gebaeude/raum/lager)
• Backend: CRUD, Baum-Query
• Frontend: Baum-/Breadcrumb-Navigation
• Mobile: einfache Auswahl
• QR-Code/Seriennummer/Inventarnummer: nein
• Akte: Standortbereich referenziert Lagerort statt flachen Standort
• Rechte: Administrator
• Audit: Änderung geloggt
• Akzeptanzkriterien: mehrstufige Hierarchie anlegen und navigieren.
• Tests: Baum-Test (Kind/Eltern-Beziehungen korrekt).
• DoD: mind. 3 Ebenen tief angelegt und funktionsfähig. Lücke gegenüber MABEA: Standort ist flach (kein Parent) — echte strukturelle Erweiterung, kein reiner Nachzug.

WH-002 — Lagerplätze

• Ziel: Feingranulare Position innerhalb eines Lagers (Regal/Fach/Box).
• Beschreibung: Lagerplatz als unterste Hierarchieebene (oder eigenes Konzept unterhalb WH-001), mit eigenem Code/QR.
• Benutzerwert: „Wo genau im Regal" statt nur „irgendwo im Lager X".
• Abhängigkeiten: WH-001
• Datenmodell: lagerplatz (id, lagerort_id, code, bezeichnung)
• Backend: CRUD
• Frontend: Verwaltung
• Mobile: Scan-Unterstützung
• QR-Code: eigener QR je Lagerplatz (IDENT-001-Konzept gilt auch für Lagerplätze, nicht nur physische Assets — deckt die Ursprungs-Anforderung /lager/HALLE-01 ab)
• Seriennummer/Inventarnummer: nein
• Akte: Lagerplatz kann eigene „Akte" haben (was liegt hier) — Sonderfall des Akte-Konzepts
• Rechte: Materialwart/Administrator
• Audit: Änderung geloggt
• Akzeptanzkriterien: Lagerplatz anlegen mit eigenem Code, QR generierbar.
• Tests: CRUD-Test.
• DoD: QR-Scan eines Lagerplatzes zeigt dessen Inhalt (Kopplung zu WH-003).

WH-003 — Bestand je Lagerplatz

• Ziel: Wissen, wie viel wovon an welchem Lagerplatz liegt.
• Beschreibung: Bestandstabelle (Consumable-/Asset-Menge je Lagerplatz).
• Benutzerwert: Grundlage für Einlagerung/Auslagerung/Inventur.
• Abhängigkeiten: WH-002, INV-003
• Datenmodell: bestand (lagerplatz_id, material_id, menge) — lagerplatz-spezifisch statt nur „irgendein Standort" wie in INV-003
• Backend: Bestandsabfrage je Lagerplatz
• Frontend: Lagerplatz-Detailansicht mit Inhalt
• Mobile: Anzeige beim Scan
• QR-Code: Scan Lagerplatz zeigt Bestand
• Seriennummer/Inventarnummer: nein
• Akte: Lagerplatz-Akte
• Rechte: wie Lese-Recht
• Audit: nein (Bewegungen selbst werden in WH-004/007 geloggt)
• Akzeptanzkriterien: Bestand je Lagerplatz korrekt abfragbar.
• Tests: Abfragetest.
• DoD: konsistent mit INV-003 (kein Doppelbestand-Tracking).

WH-004 — Einlagerung/Auslagerung

• Ziel: Material einem Lagerplatz zubuchen/abbuchen.
• Beschreibung: Aktionen, die Bestand (WH-003) verändern und dabei protokolliert werden (WH-007).
• Benutzerwert: Kernaktion im Lageralltag.
• Abhängigkeiten: WH-003
• Datenmodell: keins neu (nutzt bestand + WH-007-Protokoll)
• Backend: Ein-/Auslagerungs-Endpunkte
• Frontend: Aktion in Lagerplatz-/Material-Ansicht
• Mobile: scan-gestützt (Lagerplatz scannen, Menge eingeben)
• QR-Code: zentral für den mobilen Ablauf
• Seriennummer/Inventarnummer: nein
• Akte: Bestandsverlauf
• Rechte: Mitarbeiter+ (Materialwart für Korrekturen)
• Audit: jede Bewegung geloggt (WH-007)
• Akzeptanzkriterien: Einlagerung erhöht, Auslagerung verringert Bestand korrekt, negativer Bestand unmöglich.
• Tests: Grenzwerttest.
• DoD: funktioniert scan-gestützt im Feldtest.

WH-005 — Umlagerung

• Ziel: Material von einem Lagerplatz zu einem anderen verschieben (auch über Lager hinweg), in einem Schritt statt Aus+Ein manuell.
• Beschreibung: Kombinierte Aktion: Auslagerung an Quelle + Einlagerung an Ziel atomar, mit Grund.
• Benutzerwert: Ein Klick statt zwei fehleranfällige Einzelschritte.
• Abhängigkeiten: WH-004
• Datenmodell: keins neu (nutzt WH-004 zweifach in einer Transaktion + WH-007-Eintrag mit Von/Nach)
• Backend: Umlagerungs-Endpunkt (transaktional)
• Frontend: „Verschieben"-Aktion
• Mobile: Scan Quelle + Scan Ziel
• QR-Code: zentral
• Seriennummer/Inventarnummer: nein
• Akte: Bewegungshistorie
• Rechte: Materialwart+
• Audit: WH-007-Eintrag
• Akzeptanzkriterien: Umlagerung schlägt fehlerfrei fehl oder läuft komplett durch (keine halbe Buchung).
• Tests: Transaktions-Test (Fehler führt zu Rollback, keine Teilbuchung).
• DoD: deckt sich konzeptionell mit MABEA Lagerbewegung, aber auf Lagerplatz- statt nur Standort-Ebene (MABEA kennt keine Lagerplätze, nur Standorte).

WH-006 — Inventur & Bestandskorrektur

• Ziel: Periodischer Abgleich Soll-Bestand (System) vs. Ist-Bestand (gezählt).
• Beschreibung: Inventurlauf je Lager/Lagerplatz, Erfassung Ist-Menge, automatische Korrekturbuchung bei Abweichung mit Begründung.
• Benutzerwert: Systematische Fehlerkorrektur statt stiller Bestandsdrift über Zeit.
• Abhängigkeiten: WH-003
• Datenmodell: inventur (id, lagerort_id, gestartet_am, status), inventur_position (inventur_id, material_id, soll, ist)
• Backend: Inventur starten/erfassen/abschließen
• Frontend: Inventur-Erfassungsmaske
• Mobile: scan-gestützte Zählung
• QR-Code: Lagerplatz/Material scannen während der Inventur
• Seriennummer/Inventarnummer: Erfassung bei SN-pflichtigen Gütern inkl. SN-Abgleich
• Akte: Korrekturen erscheinen im Bestandsverlauf
• Rechte: Materialwart+ startet/schließt, Mitarbeiter+ erfasst
• Audit: jede Korrekturbuchung mit Begründung geloggt
• Akzeptanzkriterien: Abweichung erzeugt nachvollziehbare Korrekturbuchung, keine stille Anpassung ohne Log.
• Tests: Inventur-Zyklus-Test mit Abweichung.
• DoD: ein vollständiger Inventurzyklus durchgeführt. Lücke: MABEA hat kein Inventur-Konzept, nur Kontrolle (Soll/Ist je Objekt, nicht als eigener Lagerlauf mit Korrekturbuchung).

WH-007 — Materialbewegungsprotokoll

• Ziel: Vollständige, lückenlose Historie aller Bestandsbewegungen.
• Beschreibung: Append-only Protokoll (Was/Menge/Von/Nach/Wer/Wann/Warum), Basis für WH-004/005/006 und ASSET-006.
• Benutzerwert: Nachvollziehbarkeit, Diebstahl-/Schwund-Erkennung.
• Abhängigkeiten: WH-004, FOUND-006
• Datenmodell: materialbewegung (material_id, menge, von_lagerplatz_id, nach_lagerplatz_id, benutzer_id, zeitpunkt, grund)
• Backend: log-Funktion, von WH-004/005/006 aufgerufen
• Frontend: Bewegungs-Liste/Filter
• Mobile: nur Anzeige
• QR-Code/Seriennummer/Inventarnummer: nein
• Akte: Historienbereich
• Rechte: wie Lese-Recht (Verantwortliche)
• Audit: eigenständiges Fach-Protokoll (analog ASSET-006, nicht generisches FOUND-006-JSON — strukturierte Von/Nach-Felder gebraucht)
• Akzeptanzkriterien: jede Bestandsbewegung erzeugt genau einen Eintrag.
• Tests: Vollständigkeitstest (keine Bewegung ohne Protokolleintrag).
• DoD: deckt sich konzeptionell mit MABEA Lagerbewegung (dort schon vorhanden, aber objekt-/standort-bezogen statt material-/lagerplatz-bezogen).

---

MABEA-Ist-Stand-Abgleich (aktualisiert 2026-09-05): WH-001..004+007 (Kern) sind umgesetzt und live deployed — lagerort (Hierarchie), lagerplatz, bestand je Lagerplatz+Material, Ein-/Auslagerung mit lückenlosem materialbewegung-Protokoll. Bewusst zurückgestellt (Nutzer-Entscheidung, Kern zuerst): WH-005 (Umlagerung) — aktuell nur Aus- dann Einlagern als zwei Einzelschritte, keine atomare Kombi-Aktion. WH-006 (Inventur) fehlt weiterhin komplett — MABEA hat kein Inventurlauf-Konzept mit Korrekturbuchung, nur objektbezogene Kontrolle. Lagerbewegung (Objekt-Ebene) bleibt unverändert parallel bestehen, keine Vermischung mit dem neuen Material-/Lagerplatz- Bewegungsprotokoll.