update

.paul/phases/69-allegro-tracking-english-statuses/69-01-SUMMARY.md

@@ -0,0 +1,48 @@
+---
+phase: 69-allegro-tracking-english-statuses
+plan: 01
+subsystem: shipments
+tags: [allegro, tracking, edge-api, status-mapping, hotfix]
+
+requires:
+  - phase: 66-allegro-delivery-tracking
+    provides: AllegroTrackingService edge API flow
+
+provides:
+  - EN status mapping for Allegro edge descriptions
+  - EN keyword fallback in DeliveryStatus guesser
+  - Unit tests for DeliveryStatus EN/PL normalization
+
+affects: [allegro-tracking, delivery-status, docs]
+
+key-files:
+  modified:
+    - src/Modules/Shipments/DeliveryStatus.php
+    - DOCS/DB_SCHEMA.md
+    - DOCS/ARCHITECTURE.md
+    - DOCS/TECH_CHANGELOG.md
+  created:
+    - tests/Unit/DeliveryStatusTest.php
+---
+
+# Phase 69 Plan 01: Allegro Tracking English Statuses
+
+Naprawiono przypadki, w ktorych statusy Allegro edge API w jezyku angielskim byly zapisywane jako `unknown`.
+
+## Outcome
+- `DeliveryStatus::slugifyAllegroDescription()` obsluguje prefiksy EN (`Parcel has been ...`, `Parcel is ...`, `Courier has ...`).
+- `ALLEGRO_EDGE_MAP` rozszerzono o slugi EN (m.in. `awaiting_pick_up`, `delivered`, `dispatched`, `released_for_delivery`).
+- `guessStatusFromDescription()` rozszerzono o fallback EN.
+- Dodano testy jednostkowe `DeliveryStatusTest` (4 testy, 7 asercji).
+
+## Verification
+- `php -l src/Modules/Shipments/DeliveryStatus.php` -> OK.
+- `phpunit --filter DeliveryStatusTest` -> OK (4/4).
+- Realny numer `A0046XFMG1`:
+  - `description=Parcel is awaiting pick-up`
+  - `slug=awaiting_pick_up`
+  - `normalized=ready_for_pickup`
+
+## Notes
+- Zmiana nie wymaga migracji DB.
+- Zaktualizowano dokumentacje techniczna (`DB_SCHEMA`, `ARCHITECTURE`, `TECH_CHANGELOG`).