update

.paul/phases/62-import-reimport-safety/62-01-SUMMARY.md

@@ -0,0 +1,106 @@
+---
+phase: 62-import-reimport-safety
+plan: 01
+subsystem: api
+tags: [import, activity-log, deduplication, data-protection]
+
+requires:
+  - phase: 56-order-payments
+    provides: ręczne płatności w orderPRO które mogą być nadpisane
+provides:
+  - rozróżnienie import vs aktualizacja w activity log shopPRO
+  - deduplikacja wpisów activity log shopPRO (shouldSkipDuplicateImportActivity)
+  - ochrona lokalnych płatności, przesyłek i historii statusów przed nadpisaniem przy re-imporcie
+affects: []
+
+tech-stack:
+  added: []
+  patterns:
+    - "replacePayments/Shipments/StatusHistory tylko przy INSERT (nie UPDATE) w upsertOrderAggregate"
+
+key-files:
+  created: []
+  modified:
+    - src/Modules/Settings/ShopproOrdersSyncService.php
+    - src/Modules/Orders/OrderImportRepository.php
+
+key-decisions:
+  - "Adresy, pozycje i notatki nadpisywane zawsze (dane ze źródła); płatności, przesyłki i historia statusów tylko przy pierwszym imporcie"
+  - "Reuse shouldSkipDuplicateImportActivity z Allegro zamiast nowej logiki"
+
+patterns-established:
+  - "Przy re-imporcie chronić dane które mogą pochodzić z lokalnych akcji użytkownika"
+
+duration: 3min
+started: 2026-03-31
+completed: 2026-03-31
+---
+
+# Phase 62 Plan 01: Import Re-import Safety Summary
+
+**Rozróżnienie import/aktualizacja w activity log shopPRO + ochrona lokalnych danych (płatności, przesyłki, historia statusów) przed nadpisaniem przy re-imporcie dla obu źródeł.**
+
+## Performance
+
+| Metric | Value |
+|--------|-------|
+| Duration | ~3min |
+| Started | 2026-03-31 |
+| Completed | 2026-03-31 |
+| Tasks | 2 completed |
+| Files modified | 2 |
+
+## Acceptance Criteria Results
+
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+| AC-1: shopPRO rozróżnia import od aktualizacji | Pass | "Import zamowienia z shopPRO" vs "Zaktualizowano zamowienie z shopPRO (re-import)" |
+| AC-2: shopPRO deduplikuje identyczne wpisy | Pass | shouldSkipDuplicateImportActivity reuse z Allegro |
+| AC-3: Re-import nie kasuje lokalnych płatności | Pass | replacePayments tylko przy $created |
+| AC-4: Re-import nie kasuje lokalnej historii statusów | Pass | replaceStatusHistory tylko przy $created |
+| AC-5: Re-import nie kasuje lokalnych przesyłek | Pass | replaceShipments tylko przy $created |
+
+## Accomplishments
+
+- shopPRO activity log rozróżnia pierwszy import od re-importu (analogicznie do Allegro)
+- Deduplikacja wpisów activity log eliminuje powtórzenia przy tym samym source_updated_at
+- Re-import (UPDATE) nie kasuje już płatności, przesyłek ani historii statusów — chroni dane dodane lokalnie w orderPRO
+- Zmiana w OrderImportRepository dotyczy obu źródeł (shopPRO i Allegro)
+
+## Files Created/Modified
+
+| File | Change | Purpose |
+|------|--------|---------|
+| `src/Modules/Settings/ShopproOrdersSyncService.php` | Modified | Rozróżnienie summary import/aktualizacja, dodanie pól deduplikacji, warunek shouldSkipDuplicate |
+| `src/Modules/Orders/OrderImportRepository.php` | Modified | replacePayments/Shipments/StatusHistory przeniesione do bloku if ($created) |
+
+## Decisions Made
+
+| Decision | Rationale | Impact |
+|----------|-----------|--------|
+| Adresy/pozycje/notatki nadpisywane zawsze | Dane pochodzą wyłącznie ze źródła, nie są edytowane lokalnie | Źródło pozostaje autorytatywne dla tych danych |
+| Płatności/przesyłki/historia tylko przy INSERT | Mogą być dodawane lokalnie w orderPRO (ręczna płatność, zmiana statusu) | Lokalne dane chronione przed kaskadowym DELETE |
+
+## Deviations from Plan
+
+None - plan executed exactly as written
+
+## Issues Encountered
+
+None
+
+## Next Phase Readiness
+
+**Ready:**
+- Import bezpieczny dla danych lokalnych
+- Activity log spójny między Allegro i shopPRO
+
+**Concerns:**
+- Brak kolumny `origin` (source/local) na tabelach relacyjnych — przy przyszłej potrzebie merge/diff danych z obu źródeł trzeba będzie dodać
+
+**Blockers:**
+- None
+
+---
+*Phase: 62-import-reimport-safety, Plan: 01*
+*Completed: 2026-03-31*