Warenwirtschaft: Doku V7.0 — Hinweise erweitert + Testleitfaden Version 2

- resources/docs/hinweise.md: Stand 28.08.2026; neuer Block „Neu in Runde V7.0"
  (AP-34/35/38/39/40/41/42/43/44/45/46/47/48/49/50/51) unter „Bereits nutzbar";
  zentrale Verhaltens-Hinweise ergänzt (Füllgewicht/Soll, Dichte/ml, Entwurf vs.
  Abschließen, Varianten & Aktions-Kopien, Lagerplatz Produkte/Verpackung).
- resources/docs/testleitfaden.md: auf Version 2 gehoben. Teil A = bisherige
  Basis-Abschnitte 1–11 (unverändert), neuer Teil B = Abschnitte 12–18 mit
  Test-Schritten für die V7.0-Funktionen (Stammdaten/Produkt/Rohstoff/
  Wareneingang/Produktion/Entwurf/Verpackung/Versand). Wird über NoticeController
  (Einstellungen → Leitfaden) ausgeliefert.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Kevin Adametz 2026-08-28 12:07:37 +00:00
parent 0f641ef33a
commit 912dce65d4
2 changed files with 219 additions and 5 deletions

View file

@ -1,11 +1,16 @@
# Testleitfaden Warenwirtschaft — Anforderungsrunde 12.06.2026
# Testleitfaden Warenwirtschaft — Version 2
> **Stand:** 16.07.2026
> 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.
> **Stand:** 28.08.2026
> Dieser Leitfaden führt einmal durch die Funktionen der Warenwirtschaft — 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](/admin/inventory/notices)**.
>
> - **Teil A** (Abschnitte 1–11) — die Basis-Funktionen der Warenwirtschaft (Runde 12.06.2026, Stand 16.07.2026). Unverändert gültig.
> - **Teil B** (Abschnitte 12–18) — **neu in Runde V7.0** (Testphasen-Rückmeldung 26.–28.08.2026). Wer nur die neuen Punkte prüfen will, springt direkt zu **Teil B**.
---
# Teil A — Basis-Funktionen (Runde 12.06.2026)
## 1. Einstellungen: Lagerort-Bausteine & Ausschuss-Gründe
**Wo:** Menü **[Einstellungen → Allgemein](/admin/inventory/general)**
@ -171,6 +176,123 @@
---
---
# Teil B — Neu in Runde V7.0 (26.–28.08.2026)
> Diese Abschnitte prüfen die Punkte aus der Testphasen-Rückmeldung vom 26.08.2026.
> Reihenfolge wieder entlang des Arbeitsablaufs (Stammdaten → Produkt → Rohstoff →
> Wareneingang → Produktion → Versand).
## 12. Stammdaten: getrennte Buchungsgründe, Lieferanten-Filter, Lagerorte
**Wo:** **[Einstellungen → Allgemein](/admin/inventory/general)**, **[Produkte → Inhaltsstoffe](/admin/product/ingredients)**, **[Stammdaten → Lagerorte](/admin/inventory/locations)**
**Neu:**
- **Buchungsgründe getrennt Ein-/Ausgang (AP-48):** Zwei getrennte, selbst pflegbare Listen für **Eingangs-** und **Ausgangs-Gründe** des Produktbestands.
- **Lieferanten-Dropdown gefiltert (AP-49):** Am Inhaltsstoff werden nur noch **Rohstoff-Lieferanten** (Kategorie „Kosmetikrohstoffe") angeboten.
- **Lagerort löschbar + Köln-Default (AP-50):** Ein belegter Lagerort (z. B. „Waldbröl") lässt sich löschen, indem seine Buchungen auf einen **Ziel-Lagerort** übernommen werden.
**So testen:**
1. Unter *Allgemein* je einen neuen **Eingangs-** und **Ausgangs-Grund** anlegen → sie erscheinen später (Schritt 16) je nach Buchungsrichtung getrennt.
2. Einen INCI öffnen → das Lieferanten-Dropdown zeigt nur Rohstoff-Lieferanten.
3. Unter *Lagerorte* bei „Waldbröl" als Ziel **„Köln"** wählen und übernehmen → Waldbröl ist weg, seine Buchungen hängen an Köln.
---
## 13. Produkt: Füllgewicht, „produktionsrelevant", Lagerplatz
**Wo:** **[Produkte → Übersicht](/admin/product/show)**, ein Produkt bearbeiten → Karte **Warenwirtschaft**
**Neu:**
- **Füllgewicht (g) (AP-35):** Grundlage für die Produktions-Soll-Mengen (Anteil % × Füllgewicht). Leer = „Menge = Gramm".
- **„Produktionsrelevant" (AP-47):** Schalter; nur produktionsrelevante Produkte erscheinen im Produktions-Dropdown und in der Rohstoffbestand-Box „Enthalten in".
- **Lagerplatz Raum/Regal/Fach (AP-51):** Dieselbe Zuordnung wie beim Rohstoff, jetzt auch am Produkt.
**So testen:**
1. Bei einem Rezeptur-Produkt (z. B. Deocreme 50 ml) **Füllgewicht = 50** eintragen, Lagerplatz setzen, speichern.
2. Bei einem Handels-/Nebenprodukt **„produktionsrelevant" abwählen** → es verschwindet aus dem Produktions-Dropdown (Schritt 15).
3. Produktbestand (Schritt 8) öffnen → der Lagerplatz erscheint als Zeile unter dem Produktnamen.
---
## 14. Rohstoff & Wareneingang: Dichte und ml-Erfassung
**Wo:** **[Produkte → Inhaltsstoffe](/admin/product/ingredients)** und **[Einkauf & Wareneingang](/admin/inventory/stock-entries)**
**Neu (AP-42):**
- Am Rohstoff optionales Feld **Dichte (g/ml)**.
- Im Einkauf/Wareneingang lässt sich die Einheit **g oder ml** wählen; bei **ml** wird über die Dichte in Gramm umgerechnet und **als Gramm gespeichert**.
**So testen:**
1. Bei einer in ml gekauften Tinktur die **Dichte** hinterlegen (z. B. 0,79).
2. Einen Wareneingang mit Einheit **ml** erfassen (z. B. 100 ml) → gespeichert/gebucht werden 79 g.
3. Ohne hinterlegte Dichte ist die ml-Auswahl gesperrt (Prüfung).
---
## 15. Produktion: Soll auf Füllgewicht, Abwiege-Ampel, Bestand/Differenz
**Wo:** **Produktion → [Neue Produktion](/admin/inventory/productions/create)**
**Neu:**
- **Soll = Anteil % × Füllgewicht × Stückzahl (AP-35)** statt fix 100 g.
- **Abwiege-Ist-Wert + Ampel (AP-39):** orange = nichts eingetragen, grün = ±5 % vom Soll, rot = >5 % Abweichung.
- **INCI-Tabelle: Spalten „Bestand" und „Differenz", „Regal" → „Ablage" (AP-40).**
- **Verpackungs-Vorschau direkt unter der INCI-Tabelle + Phasen-Gramm hinter dem Namen (AP-41).**
- **INCI-Liste nach Konzentration absteigend sortiert (AP-46).**
- **Verpackung wird aus dem Produktionsergebnis gebucht (AP-45).**
**So testen:**
1. Produkt mit Füllgewicht (Schritt 13) wählen, Stückzahl planen → die Soll-Gramm je Rohstoff entsprechen **Anteil % × Füllgewicht × Stück** (nicht mehr 100 g).
2. Je Charge eine Ist-Menge eintragen: exakt aufs Soll → **grün**; ~10 % daneben → **rot**; leer → **orange**.
3. Spalten **Bestand/Differenz** prüfen (Differenz negativ = rot). Kopf heißt **„Ablage"**.
4. Phasen-Kopf zeigt die **Gesamt-Gramm** in Klammern; die Verpackungs-Vorschau steht direkt unter der INCI-Tabelle.
5. Ergebnis mit zwei Output-Produkten buchen → die **Verpackung** wird je Ergebnisprodukt × Menge gebucht (Detailseite prüfen).
---
## 16. Produktion zwischenspeichern (Entwurf)
**Wo:** **Produktion → Neue Produktion** / eine Produktion **bearbeiten**
**Neu (AP-43):** Neben **„Produktion abschließen"** gibt es **„Zwischenspeichern (Entwurf)"**.
**So testen:**
1. Eine neue Produktion nur teilweise ausfüllen (Produkt + Standort + Datum + Menge), **„Zwischenspeichern"** → wird ohne Fehlermeldung gespeichert und in der Liste mit **Badge „Entwurf"** angezeigt.
2. **Produktbestand & Rohstoffbestand prüfen:** der Entwurf hat **nichts gebucht**.
3. Den Entwurf öffnen, vervollständigen, **„Produktion abschließen"** → jetzt wird gebucht, das Badge verschwindet.
4. Optik/iPad (AP-44): Phasenkästen leicht hinterlegt, kein innerer Kasten um die Chargen, auf dem iPad sind die Felder gut mit dem Finger bedienbar.
---
## 17. Verpackung: Lagerplatz
**Wo:** **[Produkte → Verpackung](/admin/inventory/packaging-items?category=packaging)**
**Neu (AP-51):** Verpackungsartikel haben jetzt ebenfalls **Raum / Regal / Fach**; in der Übersicht gibt es die Spalte **„Lagerplatz"**.
**So testen:** Einen Verpackungsartikel öffnen, Lagerplatz setzen, speichern → er erscheint in der Übersicht in der neuen Spalte.
---
## 18. Versand & Shop: Varianten-Zuordnung und Ampel
**Wo:** **[Versand → API-Bestellungen](/admin/inventory/api-orders)** und der WooCommerce-Shop
**Neu:**
- **Varianten-/Duplikat-Zuordnung (AP-34):** Jede verkaufbare Variante bucht ihr eigenes Warenwirtschafts-Produkt über die **eigene Artikelnummer**; **Aktions-Kopien** desselben Produkts (SKU `100500-a`) buchen auf die **Kernnummer** (`100500`).
- **WooCommerce-Ampel (AP-38):** Der Status-Abgleich im Shop läuft wieder (Cron), das Mapping ist vollständig (Wartestellung/Abholung/Storno).
**Voraussetzung:** Das aktualisierte **Connector-Plugin v1.6.0** muss im Shop installiert sein (Rollout-Anleitung: `dev/partnercenter-api/README.md`). Ohne dieses Update greifen AP-34/AP-38 shopseitig noch nicht.
**So testen (nach Connector-Rollout):**
1. Im Shop eine Bestellung mit einer Variante **und** einer Aktions-Kopie auslösen und ins Partnercenter übertragen.
2. Unter **API-Bestellungen** die Übertragung öffnen → jede Position ist dem richtigen Produkt zugeordnet (Variante = eigenes Produkt, Aktions-Kopie = Kernnummer). Nicht zugeordnete Positionen wären hier rot markiert (dann fehlt der Variante die eigene Artikelnummer im Shop).
3. Eine versendete Bestellung im Shop prüfen → die Status-Ampel steht auf **grün**.
---
## 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.