Files
voyage/apps/workspace-api/Doc.txt
Domonkos 0c7d525e4a Implementiert:
- GET /api/inventory/overview

Liefert pro SKU:
- Produktname
- Kategorie
- Größe / Farbe
- Preis
- Aktueller Bestand (SUM der InventoryMovements)

Bedeutung:
- Ein einzelner Request ist ausreichend für das gesamte Inventory-Dashboard
- Backend liefert UI-fertige Daten (keine Aggregation im Frontend nötig)

Grundlage für:
- Inventory Tabelle
- Low-Stock Checks
- Drop-Planung
- Workspace UI
2026-01-21 09:29:43 +01:00

109 lines
2.2 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
VOYAGE SKUs & InventoryMovements
=================================
1. Product vs. SKU
------------------
Ein Product beschreibt das Modell / die Idee.
Beispiel:
- "Voyage Tee"
Eine SKU (Stock Keeping Unit) ist die kleinste verkaufbare Einheit.
Sie beschreibt eine konkrete Variante eines Produkts.
Beispiel-SKUs für "Voyage Tee":
- VOY-TEE-BLK-M (Schwarz, Größe M)
- VOY-TEE-BLK-L (Schwarz, Größe L)
- VOY-TEE-WHT-M (Weiß, Größe M)
Wichtige Regel:
- Produkte werden NICHT gelagert oder verkauft
- NUR SKUs werden gelagert, verkauft und gezählt
2. Warum SKUs notwendig sind
----------------------------
- Bestand unterscheidet sich pro Größe/Farbe
- Preis kann pro Variante unterschiedlich sein
- Orders referenzieren SKUs
- Inventory bezieht sich IMMER auf SKUs
Kurz:
Alles Operative hängt an der SKU, nicht am Product.
3. InventoryMovement Grundidee
--------------------------------
InventoryMovement speichert JEDE Veränderung am Bestand.
Es gibt KEIN Feld wie:
- stock = 49
Stattdessen gibt es Buchungen (Movements):
- +50 PRODUCTION
- -1 SALE
- +1 RETURN
- -3 ADJUSTMENT
4. Inventory als Buchhaltung
----------------------------
Inventory funktioniert wie ein Konto:
- Jede Bewegung ist eine Buchung
- Der aktuelle Bestand ist die Summe aller Buchungen
Beispiel für eine SKU:
+50 (PRODUCTION)
-1 (SALE)
+1 (RETURN)
Current Stock = 50
5. Vorteile dieses Modells
--------------------------
- Vollständige Historie
- Jeder Bestand ist erklärbar
- Fehler lassen sich nachvollziehen
- Perfekt für:
- Drops
- Reporting
- Automationen
- Forecasting
6. Beziehung zwischen Product, SKU und Inventory
------------------------------------------------
Product
└─ SKU
└─ InventoryMovements
├─ +50 (PRODUCTION)
├─ -1 (SALE)
└─ -3 (ADJUSTMENT)
7. Goldene Regeln
-----------------
1. Bestand niemals direkt speichern
2. Inventory immer über Movements ändern
3. Orders erzeugen InventoryMovements
4. Drops erzeugen initiale Production-Movements
8. Was darauf aufbaut
---------------------
- Inventory Overview (Stock pro SKU)
- Order-Fulfillment (automatische Abbuchung)
- Drop-Planung (geplant vs. real)
- Low-Stock Alerts
Dieses Modell ist bewusst einfach, aber skalierbar.