13-05-2026 implementation FR

dev/2026-05-13-dhl-modul/legacy/OPTIMIERUNGEN.md

@@ -0,0 +1,33 @@
+# Optimierungen am DHL-Modul
+
+## Code-Verbesserungen
+
+- Erweiterte Logging in allen Services und DhlClient.
+- Robuste Payload-Extraktion mit data_get().
+- Exponential Backoff für Rate-Limits in DhlClient.
+
+## Behebene Fehler
+
+- Namenskonflikt: Shipment zu DhlShipment geändert.
+- Erweiterte Status-Updates in Webhook und TrackingService (mehr Codes gemappt).
+- Validierung in cancelLabel: Prüft Existenz und canCancel().
+
+## Optionale Queues
+
+- Neu in config: 'use_queue' => false (Standard: synchron).
+- In Services: Wenn true, dispatch Job (z.B. SyncTrackingJob); sonst synchron.
+- Für Entwicklung/Erstrollout: Synchron. Bei höherer Last: Aktivieren für Asynchronität.
+
+## Weitere Dokumentation
+
+- Aktualisierte README.md und PAKET-INSTALLATION.md mit Queue-Infos.
+
+## Weitere Fixes
+
+- DhlClient: Sleep zu usleep geändert mit Cap auf 10 Sekunden.
+- ShippingService: HouseNumber required for DHL!, Retry für Storage::put.
+- TrackingService: Transaction um firstOrCreate.
+- Migration: Kommentar zur anonymen Klasse.
+- Status-Mappings: Zentral in DhlShipment, referenziert in TrackingService.
+- DhlManager: Descriptive Variablen, Typ-Hints.
+- Storage-Retry: 3 Versuche mit Logging in ShippingService.