Warenwirtschaft: Kunden-Testleitfaden zur Anforderungsrunde 12.06.

docs/testleitfaden-wawi-2026-07-06.md — Browser-Flow in 8 Stationen
(Einstellungen → INCI → Rohstoffbestand → Produkt → Wareneingang →
Chargen-Detail → Produktion → Produktbestand/Ausschuss) mit Klickwegen,
Testschritten und erwartetem Ergebnis je Funktion; inkl. Abgrenzung
der nachgelagerten Punkte.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

docs/testleitfaden-wawi-2026-07-06.md

@@ -0,0 +1,140 @@
+# Testleitfaden Warenwirtschaft — Anforderungsrunde 12.06.2026
+
+> **Stand:** 06.07.2026 · Alle Punkte aus `nächsten Anforderungen an die WaWi.md` (12.06.2026) sind umgesetzt.
+> Dieser Leitfaden führt einmal durch alle neuen Funktionen — in der Reihenfolge eines typischen Arbeitsablaufs, sodass jede Stelle direkt im Browser nachgeschaut und getestet werden kann.
+> Die fachlichen Erklärungen dazu stehen wie gewohnt in der App unter den **Hinweisen zur Warenwirtschaft** (`resources/docs/hinweise.md`).
+
+---
+
+## 1. Einstellungen: Lagerort-Bausteine & Ausschuss-Gründe
+
+**Wo:** Menü **Einstellungen → Allgemein** (`/admin/inventory/general`)
+
+**Neu:**
+- Drei neue Karten **Räume**, **Regale**, **Fächer** — die zentralen Bausteine für Lagerorte nach dem Schema *Raum 1 | Regal 3 | A*.
+- Karte **Ausschuss-Gründe** (aus Runde 12.06.): Gründe für Ausgang/Ausschuss selbst anlegen, umbenennen, deaktivieren.
+
+**So testen:**
+1. Je einen Raum (z. B. „Raum 1"), ein Regal („Regal 3") und ein Fach („A") anlegen.
+2. Einen Eintrag umbenennen → die Änderung wirkt übergeordnet überall, wo der Baustein verwendet wird.
+3. Einen Ausschuss-Grund anlegen (z. B. „Verkleckert") — der taucht später in Schritt 8 auf.
+
+---
+
+## 2. INCI-Ebene: Lieferanten mit Bestellweg, Alternativname, Lagerort
+
+**Wo:** Menü **Produkte → Inhaltsstoffe**, einen INCI öffnen (z. B. ZinClear XP) (`/admin/product/ingredients`)
+
+**Neu:**
+- **Lieferanten-Zeilen mit „+ weiteren Lieferanten anlegen":** je Zeile Lieferant + **URL**. URL eingetragen ⇒ Bestellung im Online-Shop; URL leer ⇒ Bestellung per Mail.
+- Feld **Alternativer Name** (Handelsname, z. B. LECITHIN → *Phospholipon 80 H*).
+- Drei Dropdowns **Raum / Regal / Fach** (die Bausteine aus Schritt 1).
+- Checkbox **„Kein Rohstoffbestand"** (für Allergene u. Ä. — wirkt in Schritt 3).
+
+**So testen:**
+1. Beim INCI zwei Lieferanten anlegen: einen **mit** URL (z. B. Dragonspice-Shoplink), einen **ohne**.
+2. Alternativnamen und Lagerort (Raum 1 | Regal 3 | A) setzen, speichern.
+3. **Filter „nur aktive"** oben in der INCI-Liste anhaken → es bleiben nur INCI übrig, die in der Herstellerrezeptur mindestens eines aktiven Produkts vorkommen.
+
+**Ergebnis prüfen:** In der Rohstoffbestand-Detailansicht (Schritt 3) erscheint je Lieferant der Button **„Zum Shop"** bzw. **„Per Mail"**; Alternativname und Lagerort werden im Kopf angezeigt.
+
+---
+
+## 3. Rohstoffbestand: Filter & Ausblendungen
+
+**Wo:** Menü **Rohstoffbestand** (`/admin/inventory/raw-material-stock`)
+
+**Neu:**
+- Umschalter **„Alle" / „Nur aus Herstellerrezepturen"** oben in der Übersicht.
+- INCI mit Häkchen **„Kein Rohstoffbestand"** erscheinen gar nicht (auch nicht im roten Kritisch-Zähler).
+
+**So testen:**
+1. Auf „Nur aus Herstellerrezepturen" klicken → Rohstoffe, die nur für Neuentwicklungen eingekauft wurden, verschwinden; auf „Alle" sind sie wieder da.
+2. Bei einem Test-INCI „Kein Rohstoffbestand" anhaken → er verschwindet in beiden Modi.
+
+---
+
+## 4. Produktebene: Rezeptur-Phasen & Chargen-Präfix
+
+**Wo:** Menü **Produkte → Übersicht**, ein Produkt bearbeiten (z. B. Tattoocreme)
+
+**Neu:**
+- **Hersteller-Rezeptur in Phasen** (Phase A, B, …): je Phase eigene Rohstoffe, ein **Notizfeld** (z. B. „auf 70 °C erhitzen"), Umbenennen möglich; Rohstoffe lassen sich per Drag & Drop **innerhalb und zwischen Phasen** verschieben. Die 100-%-Summe gilt weiterhin **über alle Phasen zusammen**.
+- Feld **„Chargen-Nr.-Präfix"** in der Warenwirtschaft-Karte (z. B. `TP1` = Tattoopflege + Produkt-Nr. 1).
+- **Lieferbestand** (aus Runde 12.06.): Feld „Wieder lieferbar ab" als **Datum**; das Produkt bleibt kaufbar, im Shop erscheint die tagesaktuell berechnete Anzahl Tage.
+
+**So testen:**
+1. In der Hersteller-Rezeptur „+ Neue Phase" klicken, Rohstoffe zuordnen, eine Notiz eintragen, einen Rohstoff in eine andere Phase ziehen → Summe unten muss weiter 100 % ergeben.
+2. Präfix `TP1` eintragen und speichern → wirkt in Schritt 7 (Produktion).
+3. „Wieder lieferbar ab" auf ein Datum in 12 Tagen setzen → Produkt im Shop ansehen: kaufbar, mit Tage-Hinweis.
+4. Produkt **kopieren** → Phasenstruktur wird mitkopiert.
+
+---
+
+## 5. Einkauf & Wareneingang: gleiche Charge zusammenführen
+
+**Wo:** Menü **Einkauf & Wareneingang** (`/admin/inventory/stock-entries`)
+
+**Neu:**
+- Beim **Buchen des Wareneingangs** (Stufe 2) prüft die Maske beim Eintippen der Chargennummer automatisch, ob diese Charge für den Rohstoff **schon im Haus** ist: Hinweis „Charge bereits im Haus" mit Restbestand, Lagerort und MHD — **MHD und Qualität werden vorbelegt** (bleiben überschreibbar).
+- Der Einkaufsvorgang bleibt trotzdem **separat erfasst** (eigener Eintrag mit Preis und Datum).
+
+**So testen:**
+1. Sonnenblumenöl bestellen und mit Charge `XY-123` als eingegangen buchen.
+2. Sonnenblumenöl **erneut** bestellen und beim Buchen wieder `XY-123` eintippen → der blaue Hinweis erscheint, MHD ist vorbelegt.
+3. Danach Schritt 6 ansehen: die Charge erscheint dort **einmal mit summiertem Rest**.
+
+---
+
+## 6. Rohstoffbestand-Detail: Chargen summiert
+
+**Wo:** Menü **Rohstoffbestand**, den Rohstoff aus Schritt 5 anklicken
+
+**Neu:** Tabelle **„Verfügbare Chargen"** zeigt je Chargennummer **eine Zeile mit Summen-Rest** und dem Vermerk „2 Einkäufe"; darunter die einzelnen Einkäufe als eingerückte Unterzeilen („Einkauf vom …"). Außerdem: Spalte **„Letzter Einkauf (Netto/kg)"** je Lieferant und die Bestell-Buttons aus Schritt 2.
+
+**So testen:** Restbestand der Charge = Summe beider Einkäufe; beide Einkaufszeilen mit eigenem Datum sichtbar.
+
+---
+
+## 7. Produktion: neue Maske mit Produktionsergebnis
+
+**Wo:** Menü **Produktion → Produktionen → Neue Produktion** (`/admin/inventory/productions/create`)
+
+**Neu (Kernstück der Runde):**
+- Oben nur noch **Planung**: „Geplante Stückzahl (Planung)" — **bucht keinen Bestand**.
+- **INCI-Liste** der Herstellerrezeptur: Name, **Alternativer Name**, Qualität, Anteil %, Gramm gesamt, **Regal** — mit Summenzeile.
+- **Chargen-Zuordnung nach Phasen** gegliedert (inkl. Phasen-Notiz) mit **Status-Ampel** je Rohstoff (grün = eingetragene Menge entspricht dem Soll).
+- Das **Chargen-Dropdown** zeigt zusammengeführte Chargen mit Summen-Rest (z. B. „… — Rest 8.000 g (2 Einkäufe)"); der Verbrauch wird automatisch nach frühestem MHD auf die Einkäufe verteilt.
+- Ganz unten **„Produktionsergebnis"**: Zeilen mit Produkt + produzierte Stückzahl + **Chargen-Nr.** (vorbelegt aus Präfix + Produktionsdatum, z. B. `TP1150626` — editierbar), „+ weitere Ergebniszeile" für **mehrere Output-Produkte**.
+
+**So testen (Beispiel aus der Anforderung):**
+1. 50 × „50 ml Deobalm" **planen**, Chargen zuordnen (Ampeln grün).
+2. Im Produktionsergebnis eintragen: **40 × 50 ml** und (zweite Zeile) **50 × 5 ml** — Chargen-Nr. wird je Zeile automatisch vorgeschlagen.
+3. Speichern → Detailseite zeigt die Karte „Produktionsergebnis".
+4. **Produktbestand prüfen** (Schritt 8): 50-ml-Produkt +40, 5-ml-Produkt +50 — **nicht** +50 aus der Planung.
+5. Produktion **bearbeiten**, Ergebnis ändern → der Produktbestand korrigiert sich als Differenz-Gegenbuchung (Historie bleibt vollständig).
+6. Rohstoffbestand (Schritt 6) prüfen: abgezogen wurden die **je Charge eingetragenen Gramm** — unabhängig vom Ergebnis.
+
+---
+
+## 8. Produktbestand & Ausschuss (aus Runde 12.06., bereits länger live)
+
+**Wo:** Menü **Produktbestand → Übersicht** (`/admin/inventory/product-stock`) und **Ausgang / Ausschuss** (`/admin/inventory/stock-disposals`)
+
+**Neu seit 12.06.:**
+- Übersicht **standardmäßig nach Dringlichkeit sortiert**; alle **vier Status-Kacheln** oben sind klickbare Filter.
+- Spalte **„Verbrauch pro Monat"** (Durchschnitt der letzten 6 Monate).
+- Auf Produktebene Häkchen **„Im Produktbestand anzeigen"** — z. B. Logo-Etiketten-Abrechnungen ausblendbar.
+- Ausschuss-Erfassung nutzt die **selbst gepflegten Gründe** aus Schritt 1; Chargen-Auswahl setzt den Lagerort automatisch.
+
+**So testen:** Kacheln durchklicken, ein Produkt per Häkchen ausblenden, einen Ausschuss mit eigenem Grund buchen und in der Historie wiederfinden.
+
+---
+
+## Hinweis am Rande
+
+Die Listen **Einkauf & Wareneingang** und **Produktionen** zeigen aus Performance-Gründen die neuesten 500 Einträge; darüber erscheint ein Link **„Alle anzeigen"**. Offene Bestellungen sind immer vollständig gelistet.
+
+## Was bewusst noch nicht dabei ist (nachgelagert)
+
+Shop-Bestandsabzug beim Versand (inkl. Sets), Audit-Trail, 2FA, blockbasierte Rechte und die WaWi-Einstellungsseite folgen in der nächsten Runde — hier fließen zuvor noch weitere Anforderungen ein (siehe Entwicklungsplan V6.0, §3).