update

.paul/handoffs/archive/HANDOFF-2026-03-13.md

@@ -0,0 +1,98 @@
+# PAUL Handoff
+
+**Date:** 2026-03-13
+**Status:** paused
+
+---
+
+## READ THIS FIRST
+
+You have no prior context. This document tells you everything.
+
+**Project:** orderPRO — aplikacja do zarządzania zamówieniami z wielu kanałów sprzedaży (Allegro, Erli, własne sklepy)
+**Core value:** Sprzedawca może obsługiwać zamówienia ze wszystkich kanałów sprzedaży i nadawać przesyłki bez przełączania się między platformami.
+
+---
+
+## Current State
+
+**Version:** v0.1.0 (In Progress)
+**Phase:** 2 of TBD — 02-bug-fixes
+**Plans:** 02-02 i 02-03 utworzone, oba oczekują na akceptację i APPLY
+
+**Loop Position:**
+```
+PLAN ──▶ APPLY ──▶ UNIFY
+  ✓        ○        ○     [Dwa plany gotowe do wykonania]
+```
+
+---
+
+## What Was Done
+
+- **Faza 01 (Tech Debt) — UKOŃCZONA:** ExtractAllegroTokenManager i StringHelper
+- **Plan 02-01 — UKOŃCZONY:** Naprawa martwego warunku ZPL page size w `AllegroShipmentService`
+- **Plan 02-02 — UTWORZONY (oczekuje):** Kursor `last_status_checked_at` w `AllegroStatusSyncService`
+  - Nowa kolumna `orders.last_status_checked_at DATETIME NULL`
+  - Filtr kursorowy w `findOrdersNeedingStatusSync()`
+  - Metoda `markOrderStatusChecked()` po sukcesie importu
+- **Plan 02-03 — UTWORZONY (oczekuje):** `ShopproOrdersSyncService` używa błędnie `AllegroOrderSyncStateRepository`
+  - Nowy `ShopproOrderSyncStateRepository` (ta sama tabela, poprawna nazwa)
+  - Zamiana zależności w `ShopproOrdersSyncService` i `Application.php`
+
+---
+
+## What's In Progress
+
+- Plan 02-02 i Plan 02-03 — oba gotowe, żaden jeszcze nie był wykonany (APPLY ○)
+- Plany są niezależne (depends_on: []) — można je wykonać w dowolnej kolejności
+
+---
+
+## What's Next
+
+**Immediate:** Zatwierdź i uruchom Plan 02-02
+```
+/paul:apply .paul/phases/02-bug-fixes/02-02-PLAN.md
+```
+
+**Po 02-02:** Uruchom Plan 02-03
+```
+/paul:apply .paul/phases/02-bug-fixes/02-03-PLAN.md
+```
+
+**Po obu planach:** `/paul:unify` dla fazy 02, następnie zaplanować kolejne bugi z CONCERNS.md
+
+---
+
+## Key Files
+
+| Plik | Cel |
+|------|-----|
+| `.paul/STATE.md` | Aktualny stan projektu |
+| `.paul/ROADMAP.md` | Przegląd faz |
+| `.paul/phases/02-bug-fixes/02-02-PLAN.md` | Plan: kursor last_status_checked_at |
+| `.paul/phases/02-bug-fixes/02-03-PLAN.md` | Plan: ShopproOrderSyncStateRepository |
+| `.paul/codebase/CONCERNS.md` | Lista wszystkich znanych problemów |
+| `src/Modules/Settings/AllegroStatusSyncService.php` | Plik docelowy planu 02-02 |
+| `src/Modules/Settings/ShopproOrdersSyncService.php` | Plik docelowy planu 02-03 |
+| `src/Core/Application.php` | Plik docelowy planu 02-03 |
+
+---
+
+## Deferred Issues (z STATE.md)
+
+- **CI/CD SonarQube** — dodać GitHub Actions workflow (`.github/workflows/sonarqube.yml`). Token: `sqp_8ef2748d037777cf00cf1b38534f8d435b762d7d` jako secret `SONAR_TOKEN`
+- **code-review** — wywołać `/code-review` przed UNIFY (pominięto w planach 01 i 02-01)
+
+---
+
+## Resume Instructions
+
+1. Przeczytaj `.paul/STATE.md` dla aktualnej pozycji
+2. Przejrzyj plan(y) w `.paul/phases/02-bug-fixes/`
+3. Uruchom `/paul:resume` lub `/paul:progress`
+
+---
+
+*Handoff created: 2026-03-13*