118 lines
3.9 KiB
Markdown
118 lines
3.9 KiB
Markdown
---
|
|
phase: 79-personalization-message-field
|
|
plan: 01
|
|
subsystem: api
|
|
tags: [shoppro, import, personalization, order-notes]
|
|
|
|
requires:
|
|
- phase: 63-order-item-personalization
|
|
provides: extractPersonalization z attributes/custom_fields
|
|
provides:
|
|
- import pola message z API shopPRO do personalizacji pozycji zamowien
|
|
- import pola message z API shopPRO do notatek zamowienia (order_notes)
|
|
affects: []
|
|
|
|
tech-stack:
|
|
added: []
|
|
patterns: []
|
|
|
|
key-files:
|
|
created:
|
|
- database/migrations/20260407_000080_backfill_personalization_message.sql
|
|
modified:
|
|
- src/Modules/Settings/ShopproOrderMapper.php
|
|
- resources/views/orders/show.php
|
|
- DOCS/ARCHITECTURE.md
|
|
- DOCS/TECH_CHANGELOG.md
|
|
|
|
key-decisions:
|
|
- "Pole message na pozycji poprzedzone etykieta 'Wiadomosc:' dla odroznienia od attributes/custom_fields"
|
|
- "Pole message na poziomie zamowienia importowane do order_notes jako note_type=message"
|
|
- "Usunieto etykiete 'Personalizacja:' z widoku — kolor tla wystarczajacy"
|
|
|
|
patterns-established: []
|
|
|
|
duration: ~15min
|
|
started: 2026-04-07T00:00:00Z
|
|
completed: 2026-04-07T00:15:00Z
|
|
---
|
|
|
|
# Phase 79 Plan 01: Personalization Message Field Summary
|
|
|
|
**Import pola `message` z API shopPRO do personalizacji pozycji i notatek zamowienia + backfill istniejacych danych**
|
|
|
|
## Performance
|
|
|
|
| Metric | Value |
|
|
|--------|-------|
|
|
| Duration | ~15min |
|
|
| Tasks | 3 completed (plan) + 2 deviations |
|
|
| Files modified | 5 |
|
|
|
|
## Acceptance Criteria Results
|
|
|
|
| Criterion | Status | Notes |
|
|
|-----------|--------|-------|
|
|
| AC-1: Pole message importowane do personalizacji | Pass | extractPersonalization sprawdza attributes, custom_fields, message |
|
|
| AC-2: Laczenie message z attributes i custom_fields | Pass | message poprzedzony etykieta "Wiadomosc:" |
|
|
| AC-3: Backfill istniejacych zamowien | Pass | 21 pozycji + 70 notatek zamowien |
|
|
|
|
## Accomplishments
|
|
|
|
- `extractPersonalization()` rozszerzony o pole `message` z etykieta "Wiadomosc:"
|
|
- `mapNotes()` rozszerzony o pole `message` na poziomie zamowienia (wiadomosc klienta do sprzedawcy)
|
|
- Backfill: 21 pozycji zamowien uzupelnionych o personalizacje, 70 zamowien uzupelnionych o notatki
|
|
- Usunieto zbedna etykiete "Personalizacja:" z widoku zamowienia
|
|
|
|
## Files Created/Modified
|
|
|
|
| File | Change | Purpose |
|
|
|------|--------|---------|
|
|
| `src/Modules/Settings/ShopproOrderMapper.php` | Modified | Dodano pole message do extractPersonalization + mapNotes |
|
|
| `database/migrations/20260407_000080_backfill_personalization_message.sql` | Created | Backfill personalizacji i notatek z payload_json |
|
|
| `resources/views/orders/show.php` | Modified | Usunieto etykiete "Personalizacja:" |
|
|
| `DOCS/ARCHITECTURE.md` | Modified | Opis extractPersonalization z 3 polami |
|
|
| `DOCS/TECH_CHANGELOG.md` | Modified | Wpis Phase 79 |
|
|
|
|
## Deviations from Plan
|
|
|
|
### Summary
|
|
|
|
| Type | Count | Impact |
|
|
|------|-------|--------|
|
|
| Scope additions | 2 | Niezbedne uzupelnienia wykryte podczas UAT |
|
|
|
|
**Total impact:** Wiadomosc klienta importowana zarowno na poziomie pozycji jak i zamowienia.
|
|
|
|
### Scope Additions
|
|
|
|
**1. Import wiadomosci klienta do order_notes**
|
|
- **Found during:** UAT zamowienia #218
|
|
- **Issue:** Pole `message` na poziomie zamowienia (wiadomosc klienta do sprzedawcy) nie bylo importowane do sekcji "Wiadomosci i zalaczniki"
|
|
- **Fix:** Dodano `'message'` do listy kluczy w `mapNotes()` + backfill 70 zamowien
|
|
- **Files:** `src/Modules/Settings/ShopproOrderMapper.php`, migracja SQL
|
|
|
|
**2. Usuniecie etykiety "Personalizacja:"**
|
|
- **Found during:** UAT
|
|
- **Issue:** Etykieta zbedna — kolor tla wystarczajaco oznacza sekcje personalizacji
|
|
- **Fix:** Usunieto `<span class="item-personalization__label">` z widoku
|
|
- **Files:** `resources/views/orders/show.php`
|
|
|
|
## Issues Encountered
|
|
|
|
None
|
|
|
|
## Next Phase Readiness
|
|
|
|
**Ready:**
|
|
- Import shopPRO kompletny — wszystkie pola personalizacji i wiadomosci klienta sa importowane
|
|
- Backfill wykonany na produkcji
|
|
|
|
**Concerns:** None
|
|
|
|
**Blockers:** None
|
|
|
|
---
|
|
*Phase: 79-personalization-message-field, Plan: 01*
|
|
*Completed: 2026-04-07*
|