113 lines
3.8 KiB
Markdown
113 lines
3.8 KiB
Markdown
---
|
|
phase: 76-shipment-receiver-fallback
|
|
plan: 01
|
|
subsystem: shipments
|
|
tags: [address-fallback, shoppro, receiver-data]
|
|
|
|
requires:
|
|
- phase: none
|
|
provides: none
|
|
provides:
|
|
- Fallback danych odbiorcy z customer na delivery w formularzu przesylki
|
|
affects: []
|
|
|
|
tech-stack:
|
|
added: []
|
|
patterns: [address-field-fallback-loop]
|
|
|
|
key-files:
|
|
created: []
|
|
modified:
|
|
- src/Modules/Shipments/ShipmentController.php
|
|
|
|
key-decisions:
|
|
- "Fix w buildReceiverAddress zamiast w mapperze — problem prezentacyjny, nie importowy"
|
|
- "Foreach loop zamiast osobnych if-ow — czystszy kod, latwiejsze rozszerzenie"
|
|
|
|
patterns-established:
|
|
- "buildReceiverAddress fallback: delivery -> customer dla wszystkich pol adresowych"
|
|
|
|
duration: 10min
|
|
started: 2026-04-07T00:00:00Z
|
|
completed: 2026-04-07T00:10:00Z
|
|
---
|
|
|
|
# Phase 76 Plan 01: Shipment Receiver Fallback Summary
|
|
|
|
**Fallback danych odbiorcy z customer address gdy delivery address nie ma danych adresowych (ulica/miasto/kod)**
|
|
|
|
## Performance
|
|
|
|
| Metric | Value |
|
|
|--------|-------|
|
|
| Duration | ~10min |
|
|
| Tasks | 1 completed |
|
|
| Files modified | 3 (code + docs) |
|
|
|
|
## Acceptance Criteria Results
|
|
|
|
| Criterion | Status | Notes |
|
|
|-----------|--------|-------|
|
|
| AC-1: Fallback danych adresowych na klienta | Pass | Loop fallback na 7 pol (phone, email, street_name, street_number, city, zip_code, country) |
|
|
| AC-2: Delivery z pelnymi danymi — bez zmian | Pass | Fallback uruchamia sie tylko gdy pole jest puste |
|
|
| AC-3: Nazwa odbiorcy — fallback gdy delivery nie ma ulicy | Pass | Warunek `!$deliveryHasAddress` pokrywa przypadek label metody dostawy |
|
|
|
|
## Accomplishments
|
|
|
|
- Formularz odbiorcy na `/orders/{id}/shipment/prepare` automatycznie wypelnia sie danymi klienta gdy delivery nie ma danych adresowych
|
|
- Uproszczono kod — foreach loop zamiast powtarzajacych sie if-ow dla phone/email, rozszerzony o street/city/zip/country
|
|
- Dodano warunek name fallback: gdy delivery nie ma ulicy, name tez jest pobierane z customer (pokrywa "Kurier - przedplata" jako delivery name)
|
|
|
|
## Files Created/Modified
|
|
|
|
| File | Change | Purpose |
|
|
|------|--------|---------|
|
|
| `src/Modules/Shipments/ShipmentController.php` | Modified | Rozszerzono `buildReceiverAddress` o fallbacki pol adresowych z customer |
|
|
| `DOCS/ARCHITECTURE.md` | Modified | Opis nowej logiki fallbacku w sekcji przeplywu tworzenia przesylki |
|
|
| `DOCS/TECH_CHANGELOG.md` | Modified | Wpis Phase 76 z opisem problemu i rozwiazania |
|
|
|
|
## Decisions Made
|
|
|
|
| Decision | Rationale | Impact |
|
|
|----------|-----------|--------|
|
|
| Fix w buildReceiverAddress, nie w mapperze | Problem jest prezentacyjny — dane w DB sa poprawne (customer ma pelne dane), mapper robi co moze z danymi API shopPRO | Brak zmian w logice importu |
|
|
| Foreach loop zamiast osobnych if-ow | Uproszczenie kodu, latwiejsze dodanie nowych pol w przyszlosci | Zamieniono 2 osobne if-y na 1 loop pokrywajacy 7 pol |
|
|
| ShopproOrderMapper.php bez zmian | Plan przewidywal potencjalna modyfikacje, ale fix w kontrolerze wystarczyl | Mniej zmian, mniejsze ryzyko regresji importu |
|
|
|
|
## Deviations from Plan
|
|
|
|
### Summary
|
|
|
|
| Type | Count | Impact |
|
|
|------|-------|--------|
|
|
| Scope reduction | 1 | Pozytywny — mniej zmian |
|
|
|
|
**Total impact:** Mniejszy zakres niz planowany — ShopproOrderMapper nie wymaga zmian
|
|
|
|
### Details
|
|
|
|
**1. ShopproOrderMapper.php bez zmian**
|
|
- **Plan:** files_modified zawieral ShopproOrderMapper.php
|
|
- **Rzeczywistosc:** Fix w buildReceiverAddress wystarczyl, mapper nie wymaga modyfikacji
|
|
- **Impact:** Pozytywny — mniej kodu do zmiany, zero ryzyka regresji importu
|
|
|
|
## Issues Encountered
|
|
|
|
None
|
|
|
|
## Next Phase Readiness
|
|
|
|
**Ready:**
|
|
- Formularz przesylki dziala poprawnie dla zamowien shopPRO z niekompletnymi adresami delivery
|
|
- Logika jest generyczna — dziala dla kazdego zrodla zamowien
|
|
|
|
**Concerns:**
|
|
- None
|
|
|
|
**Blockers:**
|
|
- None
|
|
|
|
---
|
|
*Phase: 76-shipment-receiver-fallback, Plan: 01*
|
|
*Completed: 2026-04-07*
|