UPDATE

2026-03-12 13:36:06 +01:00
parent daddb33e3b
commit 5c3374bf32
25 changed files with 2945 additions and 2 deletions
--- a/.paul/phases/06-integrations-refactoring/06-01-PLAN.md
+++ b/.paul/phases/06-integrations-refactoring/06-01-PLAN.md
@@ -0,0 +1,188 @@
+---
+phase: 06-integrations-refactoring
+plan: 01
+type: execute
+wave: 1
+depends_on: []
+files_modified:
+  - autoload/Domain/Integrations/ApiloRepository.php
+  - tests/Unit/Domain/Integrations/ApiloRepositoryTest.php
+autonomous: true
+---
+
+<objective>
+## Goal
+Wyekstrahować wszystkie metody Apilo z `IntegrationsRepository` do nowej klasy `ApiloRepository` — non-breaking (IntegrationsRepository pozostaje bez zmian do planu 06-02).
+
+## Purpose
+`IntegrationsRepository` ma 875 linii z czego ~650 to logika Apilo (OAuth, keepalive, fetchList, produkty). Po ekstrakcji każda klasa będzie mieć jedną odpowiedzialność, zgodnie z zasadami projektu (jedna klasa = jedna odpowiedzialność, max ~50 linii na metodę).
+
+## Output
+- Nowy plik: `autoload/Domain/Integrations/ApiloRepository.php` (~650 linii)
+- Nowy plik testów: `tests/Unit/Domain/Integrations/ApiloRepositoryTest.php`
+- `IntegrationsRepository` bez zmian (backward compatible)
+</objective>
+
+<context>
+## Project Context
+@.paul/PROJECT.md
+@.paul/ROADMAP.md
+@.paul/STATE.md
+
+## Source Files
+@autoload/Domain/Integrations/IntegrationsRepository.php
+@tests/Unit/Domain/Integrations/IntegrationsRepositoryTest.php
+</context>
+
+<acceptance_criteria>
+
+## AC-1: ApiloRepository zawiera wszystkie metody Apilo
+```gherkin
+Given plik autoload/Domain/Integrations/ApiloRepository.php istnieje
+When przeglądamy jego publiczne metody
+Then klasa ma: apiloAuthorize, apiloGetAccessToken, apiloKeepalive,
+     apiloIntegrationStatus, apiloFetchList, apiloFetchListResult,
+     apiloProductSearch, apiloCreateProduct
+```
+
+## AC-2: ApiloRepository ma własny dostęp do DB (DI przez konstruktor)
+```gherkin
+Given ApiloRepository(db: $mdb) jest tworzona
+When wywoływana jest dowolna metoda apilo*
+Then używa $db do zapytań bez zależności od IntegrationsRepository
+```
+
+## AC-3: IntegrationsRepository nie zmieniona (backward compatible)
+```gherkin
+Given istniejące testy IntegrationsRepositoryTest przechodzą
+When uruchamiane jest ./test.ps1
+Then wszystkie 817+ testów green, brak nowych błędów
+```
+
+## AC-4: Testy ApiloRepository pokrywają kluczowe metody
+```gherkin
+Given nowy plik ApiloRepositoryTest.php
+When uruchamiane jest ./test.ps1
+Then testy dla: apiloGetAccessToken, apiloKeepalive, apiloIntegrationStatus,
+     apiloFetchListResult, apiloFetchList (invalid type), prywatnych helperów przechodzą
+```
+
+</acceptance_criteria>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Utwórz ApiloRepository — ekstrakcja metod Apilo</name>
+  <files>autoload/Domain/Integrations/ApiloRepository.php</files>
+  <action>
+    Utwórz nowy plik `autoload/Domain/Integrations/ApiloRepository.php`.
+
+    Namespace: `Domain\Integrations`
+
+    Klasa ma:
+    - `private $db;`
+    - `private const SETTINGS_TABLE = 'pp_shop_apilo_settings';`
+    - Konstruktor: `public function __construct($db)`
+
+    Przenieś (skopiuj) z IntegrationsRepository **bez modyfikacji logiki**:
+    - Metody publiczne: `apiloAuthorize`, `apiloGetAccessToken`, `apiloKeepalive`,
+      `apiloIntegrationStatus`, `apiloFetchList`, `apiloFetchListResult`,
+      `apiloProductSearch`, `apiloCreateProduct`
+    - Metody prywatne: `refreshApiloAccessToken`, `shouldRefreshAccessToken`,
+      `isFutureDate`, `normalizeApiloMapList`, `isMapListShape`, `extractApiloErrorMessage`
+
+    Dostosowania niezbędne po przeniesieniu:
+    - Wszędzie gdzie metody apilo* wewnętrznie wołają `$this->getSettings('apilo')` —
+      zamień na `$this->db->select(self::SETTINGS_TABLE, ['name', 'value'])` i mapuj
+      na `[$row['name'] => $row['value']]` (ta sama logika co w IntegrationsRepository::getSettings)
+    - Wszędzie gdzie wołają `$this->saveSetting('apilo', ...)` — zamień na bezpośrednie
+      `$this->db->update(self::SETTINGS_TABLE, ['value' => $value], ['name' => $name])`
+      i `$this->db->insert(self::SETTINGS_TABLE, ['name' => $name, 'value' => $value])`
+      z `count()` przed jak w saveSetting (dokładna kopia logiki)
+
+    Unikaj: dziedziczenia z IntegrationsRepository, jakichkolwiek zależności poza $db.
+    PHP < 8.0: brak match, named args, union types, str_contains.
+  </action>
+  <verify>
+    php -l autoload/Domain/Integrations/ApiloRepository.php zwraca "No syntax errors"
+    Klasa ma dokładnie 8 publicznych metod apilo* + 6 prywatnych helperów.
+  </verify>
+  <done>AC-1 i AC-2 spełnione</done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Utwórz ApiloRepositoryTest</name>
+  <files>tests/Unit/Domain/Integrations/ApiloRepositoryTest.php</files>
+  <action>
+    Utwórz `tests/Unit/Domain/Integrations/ApiloRepositoryTest.php`.
+
+    Namespace: `Tests\Unit\Domain\Integrations`
+    Klasa extends `PHPUnit\Framework\TestCase`
+
+    Przenieś (skopiuj) z IntegrationsRepositoryTest wszystkie testy dotyczące metod Apilo:
+    - `testApiloGetAccessTokenReturnsNullWithoutSettings`
+    - `testShouldRefreshAccessTokenReturnsFalseForFarFutureDate`
+    - `testShouldRefreshAccessTokenReturnsTrueForNearExpiryDate`
+    - `testApiloFetchListThrowsForInvalidType`
+    - `testApiloFetchListResultReturnsDetailedErrorWhenConfigMissing`
+    - `testApiloIntegrationStatusReturnsMissingConfigMessage`
+    - `testNormalizeApiloMapListRejectsErrorPayload`
+    - `testNormalizeApiloMapListAcceptsIdNameList`
+
+    Dostosuj w skopiowanych testach:
+    - Zmień `new IntegrationsRepository($this->mockDb)` → `new ApiloRepository($this->mockDb)`
+    - Use statement: `use Domain\Integrations\ApiloRepository;`
+    - setUp: `$this->repository = new ApiloRepository($this->mockDb);`
+
+    Uwaga: w testach mockujących `select` z `pp_shop_apilo_settings` — sprawdź czy
+    ApiloRepository używa dokładnie tej samej tabeli i struktury zapytania co IntegrationsRepository.
+    Jeśli zmieniło się wywołanie (np. bezpośrednie select zamiast przez getSettings),
+    dostosuj expect() w testach.
+
+    Nie usuwaj tych testów z IntegrationsRepositoryTest — zostają tam do planu 06-02.
+  </action>
+  <verify>
+    ./test.ps1 tests/Unit/Domain/Integrations/ApiloRepositoryTest.php — wszystkie testy green
+    ./test.ps1 — pełna suite green (817+ testów, brak regresji)
+  </verify>
+  <done>AC-3 i AC-4 spełnione</done>
+</task>
+
+</tasks>
+
+<boundaries>
+
+## DO NOT CHANGE
+- `autoload/Domain/Integrations/IntegrationsRepository.php` — bez żadnych zmian w tym planie
+- `tests/Unit/Domain/Integrations/IntegrationsRepositoryTest.php` — tylko dodajemy, nie usuwamy
+- Żadne kontrolery, App.php, cron.php — migracja konsumentów to plan 06-02
+- Żadne zmiany logiki biznesowej — czysta ekstrakcja, zero refaktoringu logiki
+
+## SCOPE LIMITS
+- Ten plan tworzy tylko nową klasę + testy. Konsumenci nadal używają IntegrationsRepository.
+- Nie zmieniamy nazw metod, sygnatur, zachowania.
+- Nie optymalizujemy kodu Apilo podczas przenoszenia.
+
+</boundaries>
+
+<verification>
+Before declaring plan complete:
+- [ ] php -l autoload/Domain/Integrations/ApiloRepository.php — no syntax errors
+- [ ] ApiloRepository ma 8 publicznych metod: apiloAuthorize, apiloGetAccessToken,
+      apiloKeepalive, apiloIntegrationStatus, apiloFetchList, apiloFetchListResult,
+      apiloProductSearch, apiloCreateProduct
+- [ ] ./test.ps1 tests/Unit/Domain/Integrations/ApiloRepositoryTest.php — all green
+- [ ] ./test.ps1 — full suite green, żadna regresja w IntegrationsRepositoryTest
+- [ ] IntegrationsRepository.php nie został zmodyfikowany
+</verification>
+
+<success_criteria>
+- ApiloRepository.php istnieje z pełnym zestawem metod Apilo
+- ApiloRepositoryTest.php istnieje z testami dla kluczowych metod
+- Pełna suite testów green (817+ testów)
+- IntegrationsRepository niezmieniony (backward compatible)
+</success_criteria>
+
+<output>
+After completion, create `.paul/phases/06-integrations-refactoring/06-01-SUMMARY.md`
+</output>
--- a/.paul/phases/06-integrations-refactoring/06-01-SUMMARY.md
+++ b/.paul/phases/06-integrations-refactoring/06-01-SUMMARY.md
@@ -0,0 +1,104 @@
+---
+phase: 06-integrations-refactoring
+plan: 01
+subsystem: domain
+tags: [apilo, integrations, refactoring, repository]
+
+requires: []
+provides:
+  - "ApiloRepository — klasa z 8 pub metodami Apilo (OAuth, keepalive, fetchList, products)"
+  - "ApiloRepositoryTest — 9 testów jednostkowych"
+affects: [06-02-consumers-migration]
+
+tech-stack:
+  added: []
+  patterns:
+    - "ApiloRepository: własna stała SETTINGS_TABLE, prywatne getApiloSettings/saveApiloSetting zamiast delegacji do IntegrationsRepository"
+
+key-files:
+  created:
+    - autoload/Domain/Integrations/ApiloRepository.php
+    - tests/Unit/Domain/Integrations/ApiloRepositoryTest.php
+  modified: []
+
+key-decisions:
+  - "ApiloRepository nie dziedziczy z IntegrationsRepository — własny $db, własna const SETTINGS_TABLE"
+  - "Non-breaking: IntegrationsRepository zachowany bez zmian do planu 06-02"
+  - "saveApiloSetting/getApiloSettings jako prywatne — nie duplikują interfejsu publicznego"
+
+patterns-established:
+  - "Ekstrakcja domenowej podklasy: nowa klasa z własnym $db, prywatnym dostępem do settings swojej tabeli"
+
+duration: ~15min
+started: 2026-03-12T00:00:00Z
+completed: 2026-03-12T00:00:00Z
+---
+
+# Phase 6 Plan 01: IntegrationsRepository split — ApiloRepository Summary
+
+**Wyekstrahowano 8 metod Apilo (~330 linii) z IntegrationsRepository do nowego ApiloRepository — non-breaking, 826/826 testów green.**
+
+## Performance
+
+| Metric | Value |
+|--------|-------|
+| Duration | ~15 min |
+| Completed | 2026-03-12 |
+| Tasks | 2 / 2 |
+| Files created | 2 |
+| Files modified | 0 |
+
+## Acceptance Criteria Results
+
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+| AC-1: ApiloRepository zawiera wszystkie metody Apilo | Pass | 8 pub metod + 6 priv helperów |
+| AC-2: Własny DI przez konstruktor ($db) | Pass | brak zależności od IntegrationsRepository |
+| AC-3: IntegrationsRepository niezmieniony (backward compatible) | Pass | plik nie był modyfikowany |
+| AC-4: Testy ApiloRepository przechodzą | Pass | 9/9 testów, 826/826 full suite |
+
+## Accomplishments
+
+- `ApiloRepository.php` — 330 linii: OAuth (authorize, getAccessToken, keepalive, refresh), integracja status, fetchList/fetchListResult, productSearch, createProduct
+- `ApiloRepositoryTest.php` — 9 testów: getAccessToken, shouldRefreshAccessToken (×2), fetchList invalid type, fetchListResult config missing, integrationStatus missing config, normalizeApiloMapList (×2), allPublicMethodsExist
+- Full suite wzrosła z 817 do 826 testów (zero regresji)
+
+## Files Created/Modified
+
+| File | Change | Purpose |
+|------|--------|---------|
+| `autoload/Domain/Integrations/ApiloRepository.php` | Created | Klasa Apilo: OAuth, keepalive, fetchList, produkty |
+| `tests/Unit/Domain/Integrations/ApiloRepositoryTest.php` | Created | Testy jednostkowe ApiloRepository |
+
+## Decisions Made
+
+| Decision | Rationale | Impact |
+|----------|-----------|--------|
+| Prywatne `getApiloSettings()` / `saveApiloSetting()` zamiast dziedziczenia | Unika coupling z IntegrationsRepository, czysta encapsulacja | 06-02 nie potrzebuje IntegrationsRepository w ApiloRepository |
+| Zachowanie `APILO_ENDPOINTS` i `APILO_SETTINGS_KEYS` jako class constants | Były private const w IntegrationsRepository — logicznie należą do ApiloRepository | Stałe są prywatne, nie wymuszają zmian w konsumentach |
+| Non-breaking w 06-01 | Migracja konsumentów w 06-02 — mniejsze ryzyko, łatwiejszy review | IntegrationsRepository nadal działa dla wszystkich konsumentów |
+
+## Deviations from Plan
+
+Brak — plan wykonany dokładnie jak napisano.
+
+## Issues Encountered
+
+Brak.
+
+## Next Phase Readiness
+
+**Ready:**
+- `ApiloRepository` gotowy do użycia przez konsumentów
+- Interfejs publiczny identyczny z metodami `apilo*` w IntegrationsRepository
+- Testy stanowią baseline dla weryfikacji po migracji konsumentów
+
+**Concerns:**
+- `IntegrationsController` używa zarówno metod Apilo jak i Settings/ShopPRO — po 06-02 będzie potrzebować obu repozytoriów w konstruktorze
+- `OrderAdminService` tworzy `new IntegrationsRepository($db)` lokalnie w 5 miejscach — po 06-02 trzeba zmienić na `new ApiloRepository($db)`
+
+**Blockers:** Brak
+
+---
+*Phase: 06-integrations-refactoring, Plan: 01*
+*Completed: 2026-03-12*
--- a/.paul/phases/06-integrations-refactoring/06-02-PLAN.md
+++ b/.paul/phases/06-integrations-refactoring/06-02-PLAN.md
@@ -0,0 +1,296 @@
+---
+phase: 06-integrations-refactoring
+plan: 02
+type: execute
+wave: 1
+depends_on: ["06-01"]
+files_modified:
+  - autoload/admin/Controllers/IntegrationsController.php
+  - autoload/admin/App.php
+  - autoload/Domain/Order/OrderAdminService.php
+  - cron.php
+  - autoload/Domain/Integrations/IntegrationsRepository.php
+  - tests/Unit/Domain/Integrations/IntegrationsRepositoryTest.php
+autonomous: true
+---
+
+<objective>
+## Goal
+Zmigrować wszystkich konsumentów metod `apilo*` z `IntegrationsRepository` na nowy `ApiloRepository`, a następnie usunąć metody Apilo z `IntegrationsRepository` (cleanup).
+
+## Purpose
+Po tym planie `IntegrationsRepository` będzie lean (~225 linii): tylko settings, logi, product linking, ShopPRO import. `ApiloRepository` jest jedynym miejscem logiki Apilo.
+
+## Output
+- IntegrationsController: używa obu repozytoriów (IntegrationsRepository dla settings/logi, ApiloRepository dla apilo*)
+- OrderAdminService: 3 metody używają ApiloRepository dla apiloGetAccessToken
+- cron.php: apilo* wywołania przez $apiloRepository
+- IntegrationsRepository: usunięte metody apilo* (~650 linii mniej)
+- IntegrationsRepositoryTest: oczyszczony z duplikatów testów apilo*
+</objective>
+
+<context>
+## Project Context
+@.paul/PROJECT.md
+@.paul/STATE.md
+
+## Prior Work
+@.paul/phases/06-integrations-refactoring/06-01-SUMMARY.md
+
+## Source Files
+@autoload/admin/Controllers/IntegrationsController.php
+@autoload/admin/App.php
+@autoload/Domain/Order/OrderAdminService.php
+@autoload/Domain/Integrations/IntegrationsRepository.php
+@tests/Unit/Domain/Integrations/IntegrationsRepositoryTest.php
+</context>
+
+<acceptance_criteria>
+
+## AC-1: IntegrationsController używa ApiloRepository dla apilo*
+```gherkin
+Given IntegrationsController ma dwa repozytoria: $repository i $apiloRepository
+When wywoływana jest dowolna metoda apilo* (apilo_settings, apilo_authorization, itp.)
+Then używa $this->apiloRepository->apilo*() a nie $this->repository->apilo*()
+```
+
+## AC-2: OrderAdminService i cron.php używają ApiloRepository dla apiloGetAccessToken
+```gherkin
+Given OrderAdminService::resendToApilo, syncApiloPayment, syncApiloStatus
+  oraz cron.php potrzebują access tokenu
+When wywoływana jest metoda apiloGetAccessToken()
+Then używają new ApiloRepository($db) lub $apiloRepository, nie IntegrationsRepository
+```
+
+## AC-3: IntegrationsRepository nie zawiera metod apilo*
+```gherkin
+Given plik IntegrationsRepository.php po cleanup
+When sprawdzamy publiczne metody klasy
+Then metody apilo* NIE ISTNIEJĄ, pozostają tylko:
+     getSettings, getSetting, saveSetting,
+     getLogs, deleteLog, clearLogs,
+     linkProduct, unlinkProduct, getProductSku,
+     shopproImportProduct
+```
+
+## AC-4: Pełna suite testów green
+```gherkin
+Given wszystkie zmiany wprowadzone
+When uruchamiane jest php phpunit.phar
+Then wszystkie testy green (826+ testów, zero regresji)
+```
+
+</acceptance_criteria>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Zaktualizuj IntegrationsController i App.php</name>
+  <files>autoload/admin/Controllers/IntegrationsController.php, autoload/admin/App.php</files>
+  <action>
+    **IntegrationsController.php:**
+
+    1. Dodaj import: `use Domain\Integrations\ApiloRepository;`
+    2. Dodaj property: `private ApiloRepository $apiloRepository;`
+    3. Zmień konstruktor na:
+       ```php
+       public function __construct( IntegrationsRepository $repository, ApiloRepository $apiloRepository )
+       {
+           $this->repository = $repository;
+           $this->apiloRepository = $apiloRepository;
+       }
+       ```
+    4. Zamień wszystkie wywołania `$this->repository->apilo*()` na `$this->apiloRepository->apilo*()`:
+       - linia ~128: `$this->repository->apiloIntegrationStatus()` → `$this->apiloRepository->apiloIntegrationStatus()`
+       - linia ~150: `$this->repository->apiloAuthorize(...)` → `$this->apiloRepository->apiloAuthorize(...)`
+       - linia ~159: `$this->repository->apiloIntegrationStatus()` → `$this->apiloRepository->apiloIntegrationStatus()`
+       - linia ~194: `$this->repository->apiloCreateProduct(...)` → `$this->apiloRepository->apiloCreateProduct(...)`
+       - linia ~211: `$this->repository->apiloProductSearch(...)` → `$this->apiloRepository->apiloProductSearch(...)`
+       - linia ~270: `$this->repository->apiloFetchListResult(...)` → `$this->apiloRepository->apiloFetchListResult(...)`
+
+    Pozostaw bez zmian: getLogs, clearLogs, getSettings, saveSetting, getProductSku,
+    linkProduct, unlinkProduct, getSettings('shoppro'), saveSetting('shoppro'), shopproImportProduct
+    — wszystkie przez `$this->repository`.
+
+    **App.php:**
+
+    W fabryce 'Integrations' (linia ~384) zmień:
+    ```php
+    return new \admin\Controllers\IntegrationsController(
+        new \Domain\Integrations\IntegrationsRepository( $mdb )
+    );
+    ```
+    na:
+    ```php
+    return new \admin\Controllers\IntegrationsController(
+        new \Domain\Integrations\IntegrationsRepository( $mdb ),
+        new \Domain\Integrations\ApiloRepository( $mdb )
+    );
+    ```
+  </action>
+  <verify>
+    php -l autoload/admin/Controllers/IntegrationsController.php — no syntax errors
+    php -l autoload/admin/App.php — no syntax errors
+    grep "apiloRepository" autoload/admin/Controllers/IntegrationsController.php — pokazuje 6+ wystąpień
+  </verify>
+  <done>AC-1 spełnione</done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Zaktualizuj OrderAdminService i cron.php</name>
+  <files>autoload/Domain/Order/OrderAdminService.php, cron.php</files>
+  <action>
+    **OrderAdminService.php** — 3 metody tworzą IntegrationsRepository i wołają apiloGetAccessToken().
+    Zmień tylko te 3 miejsca (linie ~422, ~678, ~751):
+
+    ```php
+    // PRZED (w każdym z 3 miejsc):
+    $integrationsRepository = new \Domain\Integrations\IntegrationsRepository($db);
+    // lub: new \Domain\Integrations\IntegrationsRepository( $mdb );
+    $accessToken = $integrationsRepository->apiloGetAccessToken();
+
+    // PO (w każdym z 3 miejsc):
+    $apiloRepository = new \Domain\Integrations\ApiloRepository($db);
+    // lub z $mdb gdzie używano $mdb
+    $accessToken = $apiloRepository->apiloGetAccessToken();
+    ```
+
+    POZOSTAW BEZ ZMIAN (linie ~579, ~628) — te tworzą IntegrationsRepository
+    i wołają tylko getSettings('apilo') — to metoda generyczna, zostaje w IntegrationsRepository.
+
+    **cron.php** — linia ~133:
+    Po linii `$integrationsRepository = new \Domain\Integrations\IntegrationsRepository( $mdb );`
+    dodaj:
+    ```php
+    $apiloRepository = new \Domain\Integrations\ApiloRepository( $mdb );
+    ```
+
+    Zamień wywołania apilo* przez `$integrationsRepository` na `$apiloRepository`:
+    - linia ~191: `$integrationsRepository->apiloKeepalive(300)` → `$apiloRepository->apiloKeepalive(300)`
+    - linia ~279: `$integrationsRepository->apiloGetAccessToken()` → `$apiloRepository->apiloGetAccessToken()`
+    - linia ~560: `$integrationsRepository->apiloGetAccessToken()` → `$apiloRepository->apiloGetAccessToken()`
+    - linia ~589: `$integrationsRepository->apiloGetAccessToken()` → `$apiloRepository->apiloGetAccessToken()`
+    - linia ~642: `$integrationsRepository->apiloGetAccessToken()` → `$apiloRepository->apiloGetAccessToken()`
+
+    POZOSTAW BEZ ZMIAN w cron.php:
+    - `$integrationsRepository->getSettings('apilo')` (linie ~188, ~198, ~553, ~586, ~632)
+    - `$integrationsRepository->saveSetting('apilo', ...)` (linia ~625)
+  </action>
+  <verify>
+    php -l autoload/Domain/Order/OrderAdminService.php — no syntax errors
+    php -l cron.php — no syntax errors
+    grep "integrationsRepository->apilo" cron.php — brak wyników (wszystkie apilo przeniesione)
+    grep "integrationsRepository->apilo" autoload/Domain/Order/OrderAdminService.php — brak wyników
+  </verify>
+  <done>AC-2 spełnione</done>
+</task>
+
+<task type="auto">
+  <name>Task 3: Usuń metody apilo* z IntegrationsRepository + cleanup testów</name>
+  <files>autoload/Domain/Integrations/IntegrationsRepository.php, tests/Unit/Domain/Integrations/IntegrationsRepositoryTest.php</files>
+  <action>
+    **IntegrationsRepository.php:**
+
+    Usuń następujące bloki (cały kod między komentarzami sekcji a kolejną sekcją):
+
+    1. Sekcję "// ── Apilo OAuth" z metodami:
+       - `apiloAuthorize()`
+       - `apiloGetAccessToken()`
+       - `apiloKeepalive()`
+       - `refreshApiloAccessToken()` (private)
+       - `shouldRefreshAccessToken()` (private)
+       - `isFutureDate()` (private)
+
+    2. Stałe klasy:
+       - `private const APILO_ENDPOINTS = [...]`
+       - `private const APILO_SETTINGS_KEYS = [...]`
+
+    3. Sekcję "// ── Apilo API fetch lists" z metodami:
+       - `apiloFetchList()`
+       - `apiloFetchListResult()`
+       - `normalizeApiloMapList()` (private)
+       - `isMapListShape()` (private)
+       - `extractApiloErrorMessage()` (private)
+
+    4. Z sekcji "// ── Apilo product operations" usuń tylko:
+       - `apiloProductSearch()`
+       - `apiloCreateProduct()`
+       (ZACHOWAJ `getProductSku()` — jest generyczna, używana też przez ShopProductController)
+
+    Po usunięciu IntegrationsRepository powinna zawierać:
+    - settings (settingsTable, getSettings, getSetting, saveSetting)
+    - logs (getLogs, deleteLog, clearLogs)
+    - product linking (linkProduct, unlinkProduct, getProductSku)
+    - ShopPRO import (shopproImportProduct, missingShopproSetting, shopproDb)
+
+    **IntegrationsRepositoryTest.php:**
+
+    Usuń następujące metody testowe (zostały już przeniesione do ApiloRepositoryTest):
+    - `testApiloGetAccessTokenReturnsNullWithoutSettings()`
+    - `testShouldRefreshAccessTokenReturnsFalseForFarFutureDate()`
+    - `testShouldRefreshAccessTokenReturnsTrueForNearExpiryDate()`
+    - `testApiloFetchListThrowsForInvalidType()`
+    - `testApiloFetchListResultReturnsDetailedErrorWhenConfigMissing()`
+    - `testApiloIntegrationStatusReturnsMissingConfigMessage()`
+    - `testNormalizeApiloMapListRejectsErrorPayload()`
+    - `testNormalizeApiloMapListAcceptsIdNameList()`
+
+    W metodzie `testAllPublicMethodsExist()` usuń z tablicy `$expectedMethods` wpisy apilo*:
+    - `'apiloAuthorize'`, `'apiloGetAccessToken'`, `'apiloKeepalive'`, `'apiloIntegrationStatus'`
+    - `'apiloFetchList'`, `'apiloFetchListResult'`, `'apiloProductSearch'`, `'apiloCreateProduct'`
+    (Pozostaw: `'getSettings'`, `'getSetting'`, `'saveSetting'`, `'linkProduct'`, `'unlinkProduct'`,
+     `'getProductSku'`, `'shopproImportProduct'`, `'getLogs'`, `'deleteLog'`, `'clearLogs'`)
+
+    Usuń też `testSettingsTableMapping()` i `testShopproProviderWorks()` tylko jeśli są duplikatami
+    (sprawdź przed usunięciem — jeśli nie mają odpowiedników, zostaw).
+  </action>
+  <verify>
+    php -l autoload/Domain/Integrations/IntegrationsRepository.php — no syntax errors
+    grep "apilo" autoload/Domain/Integrations/IntegrationsRepository.php — brak wyników (lub tylko komentarze)
+    php phpunit.phar — wszystkie testy green (826+, zero regresji)
+    php phpunit.phar tests/Unit/Domain/Integrations/ — oba pliki testów green
+  </verify>
+  <done>AC-3 i AC-4 spełnione</done>
+</task>
+
+</tasks>
+
+<boundaries>
+
+## DO NOT CHANGE
+- `autoload/Domain/Integrations/ApiloRepository.php` — gotowy, nie modyfikować
+- `tests/Unit/Domain/Integrations/ApiloRepositoryTest.php` — gotowy, nie modyfikować
+- `autoload/admin/Controllers/ShopProductController.php` — używa tylko getSetting(), nie apilo*
+- `autoload/admin/Controllers/ShopStatusesController.php` — używa tylko getSetting(), nie apilo*
+- `autoload/admin/Controllers/ShopTransportController.php` — używa tylko getSetting(), nie apilo*
+- `autoload/admin/Controllers/ShopPaymentMethodController.php` — używa tylko getSetting(), nie apilo*
+- Logika biznesowa nie zmienia się — czysta migracja wywołań
+
+## SCOPE LIMITS
+- Nie refaktoryzujemy OrderAdminService poza zmianą 3 instancji na ApiloRepository
+- Nie zmieniamy sygnatury metod ani logiki
+- Nie przenosimy ShopPRO import do osobnej klasy (to nie ten plan)
+
+</boundaries>
+
+<verification>
+Before declaring plan complete:
+- [ ] php -l na wszystkich zmodyfikowanych plikach — no syntax errors
+- [ ] grep "apiloRepository->apilo" w IntegrationsController — 6 wystąpień (apilo metody)
+- [ ] grep "this->repository->apilo" w IntegrationsController — brak wyników
+- [ ] grep "integrationsRepository->apilo" w cron.php — brak wyników
+- [ ] grep "integrationsRepository->apilo" w OrderAdminService — brak wyników
+- [ ] grep "public function apilo" w IntegrationsRepository — brak wyników
+- [ ] php phpunit.phar — 826+ testów green
+</verification>
+
+<success_criteria>
+- IntegrationsController używa ApiloRepository dla wszystkich metod apilo*
+- OrderAdminService i cron.php używają ApiloRepository dla apiloGetAccessToken
+- IntegrationsRepository nie zawiera żadnych metod apilo*
+- Pełna suite testów green bez regresji
+</success_criteria>
+
+<output>
+After completion, create `.paul/phases/06-integrations-refactoring/06-02-SUMMARY.md`
+</output>
--- a/.paul/phases/06-integrations-refactoring/06-02-SUMMARY.md
+++ b/.paul/phases/06-integrations-refactoring/06-02-SUMMARY.md
@@ -0,0 +1,99 @@
+---
+phase: 06-integrations-refactoring
+plan: 02
+subsystem: domain
+tags: [apilo, integrations, refactoring, migration]
+
+requires:
+  - phase: 06-01
+    provides: ApiloRepository class with all apilo* methods
+provides:
+  - "Wszyscy konsumenci apilo* używają ApiloRepository"
+  - "IntegrationsRepository lean (~225 linii): settings, logi, product linking, ShopPRO"
+affects: []
+
+tech-stack:
+  added: []
+  patterns:
+    - "IntegrationsController z dwoma repozytoriami: IntegrationsRepository + ApiloRepository"
+
+key-files:
+  created: []
+  modified:
+    - autoload/admin/Controllers/IntegrationsController.php
+    - autoload/admin/App.php
+    - autoload/Domain/Order/OrderAdminService.php
+    - cron.php
+    - autoload/Domain/Integrations/IntegrationsRepository.php
+    - tests/Unit/Domain/Integrations/IntegrationsRepositoryTest.php
+    - tests/Unit/admin/Controllers/IntegrationsControllerTest.php
+
+key-decisions:
+  - "IntegrationsController dostał ApiloRepository jako drugi argument konstruktora"
+  - "OrderAdminService: tylko 3 z 5 instancji zmienione na ApiloRepository (2 używają getSettings — zostają)"
+  - "cron.php: $apiloRepository obok $integrationsRepository (oba potrzebne)"
+
+patterns-established:
+  - "Kontroler używający dwóch repozytoriów: każde do swojej domeny"
+
+duration: ~20min
+started: 2026-03-12T00:00:00Z
+completed: 2026-03-12T00:00:00Z
+---
+
+# Phase 6 Plan 02: Migracja konsumentów + cleanup IntegrationsRepository
+
+**Wszyscy konsumenci apilo* zmigrowano na ApiloRepository; IntegrationsRepository oczyszczono do ~225 linii; 818/818 testów green.**
+
+## Performance
+
+| Metric | Value |
+|--------|-------|
+| Duration | ~20 min |
+| Completed | 2026-03-12 |
+| Tasks | 3 / 3 |
+| Files modified | 7 |
+
+## Acceptance Criteria Results
+
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+| AC-1: IntegrationsController używa ApiloRepository dla apilo* | Pass | 6 wywołań przeniesione |
+| AC-2: OrderAdminService i cron.php używają ApiloRepository | Pass | 3 metody + 5 wywołań w cron |
+| AC-3: IntegrationsRepository nie zawiera metod apilo* | Pass | 0 wystąpień apilo* |
+| AC-4: Pełna suite green | Pass | 818/818 testów |
+
+## Accomplishments
+
+- IntegrationsRepository: ~650 linii usunięte, zostały settings + logi + product linking + ShopPRO
+- IntegrationsController: nowy konstruktor `(IntegrationsRepository, ApiloRepository)`
+- OrderAdminService: 3 metody (resendToApilo, syncApiloPayment, syncApiloStatus) używają ApiloRepository
+- cron.php: `$apiloRepository` dla 5 wywołań apilo*; `$integrationsRepository` dla getSettings/saveSetting
+- IntegrationsRepositoryTest: oczyszczony z 8 duplikatów apilo testów + przywrócone 3 testy generyczne
+- IntegrationsControllerTest: zaktualizowany do nowego 2-arg konstruktora
+
+## Files Modified
+
+| File | Zmiana |
+|------|--------|
+| `autoload/admin/Controllers/IntegrationsController.php` | +ApiloRepository dependency, 6 apilo* calls rerouted |
+| `autoload/admin/App.php` | Inject ApiloRepository do IntegrationsController |
+| `autoload/Domain/Order/OrderAdminService.php` | 3× IntegrationsRepository → ApiloRepository |
+| `cron.php` | +$apiloRepository, 5 apilo* calls rerouted |
+| `autoload/Domain/Integrations/IntegrationsRepository.php` | Usunięto ~650 linii apilo* |
+| `tests/Unit/Domain/Integrations/IntegrationsRepositoryTest.php` | Cleanup + przywrócone testy generyczne |
+| `tests/Unit/admin/Controllers/IntegrationsControllerTest.php` | Zaktualizowany do 2-arg konstruktora |
+
+## Deviations from Plan
+
+- IntegrationsControllerTest wymagał aktualizacji (nie był w planie) — auto-fix podczas weryfikacji
+- 3 testy przypadkowo usunięte przez regex (testAllPublicMethodsExist, testSettingsTableMapping, testShopproProviderWorks) — przywrócone
+
+## Next Phase Readiness
+
+**Ready:** Refaktoring fazy 6 kompletny. IntegrationsRepository lean, ApiloRepository izolowany.
+**Blockers:** Brak
+
+---
+*Phase: 06-integrations-refactoring, Plan: 02*
+*Completed: 2026-03-12*