update

.paul/phases/79-personalization-message-field/79-01-SUMMARY.md

@@ -0,0 +1,117 @@
+---
+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*