Artikeltypen-Matrix (Non-Standard Articles Documentation)

Dieses Dokument definiert das Verhalten, die Geschäftsregeln und das Datenmodell für die verschiedenen Artikeltypen im Dash ERP/POS-System:

Standard-Artikel (einfacher / eigenständiger Artikel)
Stückliste (BOM / Set / Bundle / Baugruppe)
Variations-Vater (Parent Variant / Modell / Abstrakter Gruppenartikel)
Variations-Kind (Child Variant / Konkrete Ausprägung)

1. Übersicht & Matrix

Kriterium / Frage	Standard-Artikel	Stückliste (BOM / Set)	Variations-Vater	Variations-Kind
Kann auch Stückliste sein?	✅ Ja (umwandelbar)	ℹ️ Ist Stückliste (mehrstufig schachtelbar)	❌ Nein (System blockiert)	✅ Ja (Kind-Variante als Bundle)
Kann auch Variations-Vater sein?	✅ Ja (aktivierbar)	❌ Nein (System blockiert)	ℹ️ Ist Vater	✅ Ja (als Zwischenknoten im Baum)
Kann auch Variations-Kind sein?	✅ Ja (zuordenbar)	⚠️ Ja (als Kind-Stückliste)	✅ Ja (als Zwischenknoten im Baum)	ℹ️ Ist Kind
Kann Optionen haben? (`optionslist`)	✅ Ja	✅ Ja (koexistiert)	❌ Nein (System blockiert)	✅ Ja (als Blattknoten / Verkaufsartikel)
Hat eigenen physischen Bestand?	✅ Ja	⚠️ Virtuell (Komponenten-Minimum) / Montage	❌ Nein (auf Variantenebene)	⚠️ Nur als Blattknoten (Zwischenknoten: Nein)
Eigene Eigenschaften (Hersteller, Kategorie)	✅ Ja	✅ Ja (eigene Kategorie & Marke)	✅ Ja (Basis-Attribute, vererbt nach unten)	⚠️ Ja / Geerbt (vom Elternknoten)
Hat Lieferanten? (`articlesupplier`)	✅ Ja	✅ Ja (wenn Set als 1 SKU bezogen wird)	❌ Nein (auf Variantenebene)	⚠️ Nur als Blattknoten (Zwischenknoten: Nein)
Kann auf Beleg sein? (Kasse, Rechnung, etc.)	✅ Ja	✅ Ja (als Set-Position verkaufbar)	❌ Nein (abstrakt, nicht buchbar)	⚠️ Nur als Blattknoten (vollständig spezifiziert)
Hat eigenen Preis? (`price`-Tabelle)	✅ Ja	✅ Ja (fester Bundle-Verkaufspreis)	❌ Nein (wird auf Variantenebene geführt)	⚠️ Nur als Blattknoten (Zwischenknoten: Nein)
Hat individuelle Fotos? (`articlepic`)	✅ Ja	✅ Ja (Foto des Gesamt-Sets)	✅ Ja (Modell-/Familienfoto)	✅ Ja (variantenspezifisch z. B. Farbe Rot)

2. Varianten-Baum: Das Rollenmodell (Hierarchische Varianten)

Varianten bilden im System eine Baum-Struktur ab (z. B. für mehrdimensionale Varianten wie Modell \rightarrow Farbe \rightarrow Größe).

[Wurzel: T-Shirt Classic]           <- Reiner Vaterartikel (is_father = 1, fatherarticle_id = NULL)
       │
       ├── [Zwischenknoten: Rot]    <- Kind UND Vater (fatherarticle_id != NULL, is_father = 1)
       │         ├── [Größe S]      <- Blattknoten / Reines Kind (Endprodukt / verkaufbare SKU)
       │         └── [Größe M]      <- Blattknoten / Reines Kind (Endprodukt / verkaufbare SKU)
       │
       └── [Zwischenknoten: Blau]   <- Kind UND Vater (fatherarticle_id != NULL, is_father = 1)
                 ├── [Größe S]      <- Blattknoten / Reines Kind (Endprodukt / verkaufbare SKU)
                 └── [Größe L]      <- Blattknoten / Reines Kind (Endprodukt / verkaufbare SKU)

Die zwei Zustände von Knoten im Varianten-Baum:

Innere Knoten / Zwischenknoten (Vater & Kind zugleich):
- Gruppieren weitere Unterausprägungen (z. B. Farbvariante „Rot“ mit untergeordneten Größen).
- Sind noch nicht vollständig spezifiziert \rightarrow verhalten sich wie Vaterartikel:
  - Kein eigener physischer Lagerbestand.
  - Kein eigener Preis.
  - Kein Lieferant.
  - Nicht direkt auf Belegen / Kasse buchbar.
- Fotos: Dienen oft als Träger für Farbfotos, die von allen darunterliegenden Größen geerbt werden.
Blattknoten (Reines Kind am Ende des Astes):
- Vollständig spezifizierter physischer Verkaufs- und Einkaufsartikel.
- Eigener Lagerbestand, Barcode/EAN, Lieferantenkonditionen, Verkaufspreise und Belegfähigkeit.

3. Detail-Spezifikation nach Artikeltyp

A. Stückliste (BOM / Bill of Materials / Bundle / Set)

Technischer Bezug: article.articlelist_id -> articlelist

Kann auch Stückliste sein?:
- Ja (Mehrstufig): Eine Stückliste ist bereits eine Stückliste. Komponenten können ihrerseits Stücklisten sein (verschachtelte Baugruppen). Selbstreferenz / Zirkelbezug ist verboten.
Kann auch Variations-Vater sein?:
- Nein: Im Frontend und Backend blockiert (Ein Stücklisten-Artikel kann kein Vaterartikel sein.). Ein Vater ist ein abstraktes Gruppierungselement, kein Bündel konkreter Teile.
Kann auch Variations-Kind sein?:
- Ja: Ein Blattknoten im Variantenbaum kann als Stückliste definiert sein (z. B. „Geschenkset T-Shirt – Größe L“ besteht aus T-Shirt L + Box + Karte).
Kann Optionen haben?:
- Ja: articlelist und optionslist koexistieren harmonisch nebeneinander (z. B. PC-Set mit wählbaren Upgrades).
Hat Bestand?:
- Virtuell abgeleitet: Ergibt sich dynamisch aus der kleinsten verfügbaren Komponentenmenge: \text{Bestand}_{\text{Set}} = \min_{i} \left( \left\lfloor \frac{\text{Bestand}_i}{\text{Menge}_i} \right\rfloor \right) Bei Verkauf werden die Komponenten aus dem Lager abgebucht. Manuelle Bestandsanpassungen (POST /api/stock/adjust) auf Stücklisten sind gesperrt (HTTP 400), um eine künstliche Komponenten-Inflation zu verhindern. Inventur- und Bestandskorrekturen erfolgen direkt an den physischen Komponenten.
Eigene Eigenschaften (Hersteller, Kategorie)?:
- Ja: Eigenständige Zuweisung von Marke (brand_id), Kategorien (categoryarticle), Name und Beschreibung.
Hat Lieferanten?:
- Ja: Wenn der Lieferant das fertige Set als 1 Artikel liefert (z. B. Handelsset, Werkzeugkoffer oder Starterkit mit eigener Lieferanten-SKU und Set-EK). Bei interner Montage liegen die Lieferanten stattdessen auf den Komponenten.
Kann auf Beleg sein?:
- Ja: Voll belegfähig auf Kasse (POS), Angebot, Auftrag, Lieferschein und Rechnung.
Hat einen Preis?:
- Ja: Eigener Verkaufspreis in price (Set-Preis mit Steuer und Preisstaffeln).
Hat individuelle Fotos?:
- Ja: Zeigt das Set/Bundle als Gesamtheit.

B. Variations-Vater (Parent Variant Article)

Technischer Bezug: article.is_father = 1, fatherarticle_id = NULL (Wurzelknoten)

Kann auch Stückliste sein?:
- Nein: Vaterartikel können keine Stückliste besitzen.
Kann auch Variations-Vater sein?:
- Ja: Ist der Vater.
Kann auch Variations-Kind sein?:
- Ja, als Zwischenknoten: Im Variantenbaum kann ein Vaterartikel seinerseits Kind eines übergeordneten Vaters sein (fatherarticle_id != NULL).
Kann Optionen haben?:
- Nein: Optionen werden erst an der konkreten verkaufbaren Variante angehängt.
Hat Bestand?:
- Nein: Wird auf Variantenebene geführt.
Eigene Eigenschaften (Hersteller, Kategorie)?:
- Ja: Definiert gemeinsame Basiseigenschaften (Hersteller, Hauptkategorie, Grundbeschreibung), die von den Kindern geerbt werden.
Hat Lieferanten?:
- Nein: Lieferanten und EK-Preise werden auf Variantenebene gepflegt.
Kann auf Beleg sein?:
- Nein: Da abstrakt (nicht greifbar / nicht ausgeliefert), kann ein Vater nie auf einem Beleg stehen.
Hat einen Preis?:
- Nein: Eigene Preise existieren nur an den konkreten Ausprägungen (im Katalog ggf. nur abgeleitete Anzeige wie „ab X €“).
Hat individuelle Fotos?:
- Ja: Dient als Haupt-/Familienbild im Produktkatalog.

C. Variations-Kind (Child Variant Article)

Technischer Bezug: article.fatherarticle_id -> article.id

Kann auch Stückliste sein?:
- Ja: Als Blattknoten kann die Variante als Set aus mehreren Komponenten aufgebaut sein.
Kann auch Variations-Vater sein?:
- Ja: Kann als Zwischenknoten im Baum weitere Unterausprägungen besitzen.
Kann auch Variations-Kind sein?:
- Ja: Ist ein Kind des übergeordneten Knotens.
Kann Optionen haben?:
- Ja: Als verkaufbarer Blattknoten können Optionen zugewiesen werden.
Hat Bestand?:
- Ja (als Blattknoten): Physischer Lagerbestand pro Lagerplatz mit Zu-/Abgangsbuchungen. (Als Zwischenknoten: Nein).
Eigene Eigenschaften (Hersteller, Kategorie)?:
- Ja / Geerbt: Erbt standardmäßig Hersteller und Kategorie vom Elternknoten, kann aber abweichende Merkmale und Texte besitzen.
Hat Lieferanten?:
- Ja (als Blattknoten): Eigene Lieferantenbeziehungen, Lieferanten-SKU, Gebindegrößen (PU) und Einkaufspreise.
Kann auf Beleg sein?:
- Ja (als Blattknoten): Ist der eigentliche Verkaufsartikel mit Barcode/EAN für Kasse, Angebot, Lieferschein und Rechnung.
Hat einen Preis?:
- Ja (als Blattknoten): Eigene Preise, Steuerklassen, Staffelpreise und Kundengruppen-Preise.
Hat individuelle Fotos?:
- Ja: Spezifisches Foto der Ausprägung (mit Fallback auf Elternknoten/Wurzel, falls keines vorhanden ist).

9.3 KiB Raw Blame History Unescape Escape