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

33 lines
1.2 KiB
Markdown

# 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.