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 ## 3. Shopify-Datenmapping
- [ ] Shopify Order-GID als stabile externe Identität festlegen. - [x] Shopify Order-GID als stabile externe Identität festlegen und eindeutig indizieren.
- [ ] Shopify-Bestellnummer separat speichern. - [x] Shopify-Bestellnummer separat speicherbar machen.
- [ ] Wix-Bestellnummer als historische Referenz speichern. - [ ] 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. - [ ] 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] Shopify-Katalog read-only mit ERP-Produkten und `sellable_item` verglichen.
- [x] ERP-Produkt `006` für Cordyceps ergänzt. - [x] ERP-Produkt `006` für Cordyceps ergänzt.
- [x] Zwölf Shopify-SKU-Aliase im ERP angelegt; historische Wix-Aliase erhalten. - [x] Zwölf Shopify-SKU-Aliase im ERP angelegt; historische Wix-Aliase erhalten.
@@ -92,25 +92,25 @@ Fachliche Übergabe: `erp/bestellungen`
## 4. Ziel-Datenmodell ## 4. Ziel-Datenmodell
- [ ] `sales_order` um Shopify-Identitäten erweitern. - [x] `sales_order` um Shopify-Identitäten, Zeitstempel und Quellstatus erweitern.
- [ ] `order_source` um `shopify` erweitern. - [x] `order_source` um `shopify` erweitern.
- [ ] `external_ref` von der bisher gemischten Wix-/Direktverkaufssemantik entkoppeln. - [ ] `external_ref` von der bisher gemischten Wix-/Direktverkaufssemantik entkoppeln.
- [ ] Zahlungsstatus über den bisherigen ausschliesslichen Wert `paid` hinaus modellieren. - [x] Zahlungsstatus über den bisherigen ausschliesslichen Wert `paid` hinaus modellieren.
- [ ] Fulfillment-Status modellieren. - [x] Shopify-Fulfillment-Status separat modellieren.
- [ ] Storno- und Refund-Status 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. - [ ] Synchronisations- und Reconciliation-Status ergänzen.
- [ ] Shopify-Rohdaten versioniert oder nachvollziehbar speichern. - [ ] 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. - [ ] 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. - [ ] Zielmodell als verbindlich abnehmen.
## 5. Prozess- und Modulgrenzen ## 5. Prozess- und Modulgrenzen
- [x] `erp/bestellungen` als Eigentümer der Bestellfachlichkeit bestätigt. - [x] `erp/bestellungen` als Eigentümer der Bestellfachlichkeit bestätigt.
- [x] `erp/import-integration` als Eigentümer der technischen Eingangsschnittstellen 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.receive` definieren.
- [ ] Prozess `shopify.orders.reconcile` definieren. - [ ] Prozess `shopify.orders.reconcile` definieren.
- [x] Verbindlichen Webhook-Sync-Prozess dokumentieren. - [x] Verbindlichen Webhook-Sync-Prozess dokumentieren.
@@ -222,6 +222,9 @@ Fachliche Übergabe: `erp/bestellungen`
- [ ] Excel-/n8n-Weiterleitungen vom Migrationslauf trennen. - [ ] Excel-/n8n-Weiterleitungen vom Migrationslauf trennen.
- [ ] Aktuelle Nebenwirkungen in `order-import.php` entfernen oder explizit sperren. - [ ] Aktuelle Nebenwirkungen in `order-import.php` entfernen oder explizit sperren.
- [ ] Wiederholter Import ohne doppelte Lagerbewegung nachweisen. - [ ] 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 ## 10. Ausführliche Verifikation