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

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.