Dokumentiere Shopify Delta Dry Run

This commit is contained in:
2026-08-12 17:33:54 +02:00
parent fd00a851ed
commit 0e4c9219bf
@@ -70,12 +70,12 @@ Fachliche Übergabe: `erp/bestellungen`
## 3. Shopify-Datenmapping
- [ ] Shopify Order-GID als stabile externe Identität festlegen.
- [ ] Shopify-Bestellnummer separat speichern.
- [x] Shopify Order-GID als stabile externe Identität festlegen und eindeutig indizieren.
- [x] Shopify-Bestellnummer separat speicherbar machen.
- [ ] Wix-Bestellnummer als historische Referenz speichern.
- [ ] Kunden- und Shopify-Customer-ID abbilden.
- [x] Shopify-Customer-ID über `party_external_identity` speicherbar machen.
- [ ] Liefer- und Rechnungsadresse abbilden.
- [ ] Produkt-, Varianten- und SKU-Referenzen abbilden.
- [x] Produkt-, Varianten- und SKU-Referenzen in Bestellpositionen und Artikel-Alias speicherbar machen.
- [x] Shopify-Katalog read-only mit ERP-Produkten und `sellable_item` verglichen.
- [x] ERP-Produkt `006` für Cordyceps ergänzt.
- [x] Zwölf Shopify-SKU-Aliase im ERP angelegt; historische Wix-Aliase erhalten.
@@ -92,25 +92,25 @@ Fachliche Übergabe: `erp/bestellungen`
## 4. Ziel-Datenmodell
- [ ] `sales_order` um Shopify-Identitäten erweitern.
- [ ] `order_source` um `shopify` erweitern.
- [x] `sales_order` um Shopify-Identitäten, Zeitstempel und Quellstatus erweitern.
- [x] `order_source` um `shopify` erweitern.
- [ ] `external_ref` von der bisher gemischten Wix-/Direktverkaufssemantik entkoppeln.
- [ ] Zahlungsstatus über den bisherigen ausschliesslichen Wert `paid` hinaus modellieren.
- [ ] Fulfillment-Status modellieren.
- [x] Zahlungsstatus über den bisherigen ausschliesslichen Wert `paid` hinaus modellieren.
- [x] Shopify-Fulfillment-Status separat modellieren.
- [ ] Storno- und Refund-Status modellieren.
- [ ] Shopify-Kunden-, Produkt- und Variantenreferenzen ergänzen.
- [x] Shopify-Kunden-, Produkt- und Variantenreferenzen ergänzen.
- [ ] Synchronisations- und Reconciliation-Status ergänzen.
- [ ] Shopify-Rohdaten versioniert oder nachvollziehbar speichern.
- [ ] Datenbank-Constraints und Indizes definieren.
- [x] Datenbank-Constraints und Indizes definieren.
- [ ] Bestehende Wix-Daten und Direktverkaufsdaten rückwärtskompatibel erhalten.
- [ ] DB-Ownership für alle neuen Artefakte dokumentieren.
- [x] DB-Ownership für `party_external_identity` dokumentieren.
- [ ] Zielmodell als verbindlich abnehmen.
## 5. Prozess- und Modulgrenzen
- [x] `erp/bestellungen` als Eigentümer der Bestellfachlichkeit bestätigt.
- [x] `erp/import-integration` als Eigentümer der technischen Eingangsschnittstellen bestätigt.
- [ ] Prozess `shopify.orders.migrate` definieren.
- [x] Verbindlichen Prozess `erp.import-integration.shopify_delta_order_import` für den Delta-Import definieren.
- [ ] Prozess `shopify.orders.receive` definieren.
- [ ] Prozess `shopify.orders.reconcile` definieren.
- [x] Verbindlichen Webhook-Sync-Prozess dokumentieren.
@@ -222,6 +222,9 @@ Fachliche Übergabe: `erp/bestellungen`
- [ ] Excel-/n8n-Weiterleitungen vom Migrationslauf trennen.
- [ ] Aktuelle Nebenwirkungen in `order-import.php` entfernen oder explizit sperren.
- [ ] Wiederholter Import ohne doppelte Lagerbewegung nachweisen.
- [x] Read-only Delta-Dry-Run durchgeführt: vier stornierte/erstattete Shopify-Bestellungen übersprungen, `#1541` als einzige qualifizierte Bestellung bestätigt.
- [x] Dry-Run belegt: SKU `003.02` ist auf zwei Reishi-Einheiten aus der aktuellen Charge `2601.3` gemappt; verfügbar sind 194 Einheiten.
- [x] Dry-Run belegt: Es existiert noch keine Shopify-Bestellung im ERP.
## 10. Ausführliche Verifikation