wip(06-sonarqube-quality): paused after 06-02 UNIFY — 3/6 plans complete

06-01 (S112 exceptions), 06-02 (S1142 returns), 06-03 (S1192 constants) done.
Next: 06-06 → 06-04 → 06-05

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-13 12:06:30 +01:00
parent 028c46c685
commit ae976b7964
5 changed files with 488 additions and 52 deletions

View File

@@ -18,55 +18,38 @@ You have no prior context. This document tells you everything.
**Version:** v0.1.0 (In Progress)
**Phase:** 6 of TBD — 06-sonarqube-quality
**Plan:** 06-01..06-06 — CREATED, awaiting approval
**Plan:** 06-01 ✓ DONE, 06-02 ✓ DONE, 06-03 ✓ DONE, 06-04/05/06 awaiting
**Loop Position:**
```
PLAN ──▶ APPLY ──▶ UNIFY
[6 planów gotowych, żaden nie wykonany]
[loop closed — ready for next plan: 06-06]
```
---
## What Was Done
## What Was Done (this session)
- Przeanalizowano 327 issues SonarQube z CONCERNS.md i DOCS/todo.md
- Zbadano kluczowe pliki (AllegroIntegrationController 923L, ShopproIntegrationsController 901L, ShopproOrdersSyncService 1192L, OrdersRepository 785L)
- Utworzono 6 planów dla fazy 06-sonarqube-quality:
- `06-01-PLAN.md` — php:S112 (95x) — typowane wyjątki zamiast RuntimeException
- `06-02-PLAN.md` — php:S1142 (57x) — redukcja return statements (save() z 5→≤3)
- `06-03-PLAN.md` — php:S1192 (40x) — ekstrakcja literałów do stałych (IntegrationSources, RedirectPaths)
- `06-04-PLAN.md` — php:S3776 (31x) — redukcja złożoności kognitywnej (extract method)
- `06-05-PLAN.md` — php:S1448 (6x) — podział god classes (ShopproOrdersSyncService 39→≤20 metod, AllegroIntegrationController 30→≤15)
- `06-06-PLAN.md` — php:S138 (4x) — skrócenie długich metod (sync 195L, paginate 183L)
- Zaktualizowano ROADMAP.md (Phase 6 dodana)
- Zaktualizowano STATE.md
- **APPLY + UNIFY 06-02** — S1142: redukcja return statements (commit 028c46c)
- AllegroIntegrationController: save 6→3, saveImportSettings 5→3, oauthCallback 4→3
- ShopproIntegrationsController: save 9→3, saveStatusMappings 4→3, syncStatuses 4→3
- Nowe wzorce: `validateXxxInput(): ?string` i `validateXxxAccess(): ?Response`
- Phase 6 progress: 3/6 plans complete (50%)
---
## What's In Progress
- Żaden plan nie jest w trakcie — wszystkie 6 czeka na zatwierdzenie i APPLY
Nic — pętla 06-02 zamknięta, codebase stabilny.
---
## What's Next
**Immediate:** Wybierz plan do wykonania i uruchom `/paul:apply .paul/phases/06-sonarqube-quality/06-XX-PLAN.md`
**Immediate:** `/paul:apply .paul/phases/06-sonarqube-quality/06-06-PLAN.md`
**Rekomendowana kolejność:**
1. `06-01` (php:S112) — najprostsza zmiana, nowe klasy + podmiana throw
2. `06-03` (php:S1192) — quick win, stałe zamiast literałów
3. `06-02` (php:S1142) — refaktoryzacja metod w 2 kontrolerach
4. `06-06` (php:S138) — skrócenie długich metod
5. `06-04` (php:S3776) — redukcja złożoności (extract method w god classes)
6. `06-05` (php:S1448) — największa zmiana: podział klas (ma checkpoint:human-verify)
**Zależności między planami:**
- `06-01, 06-02, 06-03` — niezależne, wave 1
- `06-04` — niezależny, wave 2 (lepiej przed 06-05)
- `06-05``depends_on: ["06-04"]`, wave 3, nie jest autonomous (ma human-verify)
- `06-06` — wave 2, uważaj na interferencję z 06-05 w ShopproOrdersSyncService
**Kolejność pozostałych planów:** 06-06 → 06-04 → 06-05
- 06-05 (god classes) zależy od 06-04 i ma `checkpoint:human-verify` (nie autonomous)
---
@@ -76,22 +59,17 @@ PLAN ──▶ APPLY ──▶ UNIFY
|------|---------|
| `.paul/STATE.md` | Live project state |
| `.paul/ROADMAP.md` | Phase overview |
| `.paul/phases/06-sonarqube-quality/06-01-PLAN.md` | S112: Typowane wyjątki |
| `.paul/phases/06-sonarqube-quality/06-02-PLAN.md` | S1142: Redukcja return |
| `.paul/phases/06-sonarqube-quality/06-03-PLAN.md` | S1192: Stałe dla literałów |
| `.paul/phases/06-sonarqube-quality/06-04-PLAN.md` | S3776: Złożoność kognitywna |
| `.paul/phases/06-sonarqube-quality/06-05-PLAN.md` | S1448: Podział god classes |
| `.paul/phases/06-sonarqube-quality/06-06-PLAN.md` | S138: Długie metody |
| `.paul/codebase/CONCERNS.md` | Pełna lista concerns (tech debt, bugs, performance) |
| `DOCS/todo.md` | Lista TODO z SonarQube issues |
| `.paul/phases/06-sonarqube-quality/06-06-PLAN.md` | Następny plan |
| `.paul/phases/06-sonarqube-quality/06-02-SUMMARY.md` | Ostatni UNIFY — context |
| `src/Modules/Settings/AllegroIntegrationController.php` | Zrefaktoryzowany w 06-02 |
| `src/Modules/Settings/ShopproIntegrationsController.php` | Zrefaktoryzowany w 06-02 |
---
## Resume Instructions
1. Przeczytaj `.paul/STATE.md` — potwierdź pozycję w loop
2. Wybierz plan (rekomendowane: 06-01 lub 06-03)
3. Uruchom `/paul:apply .paul/phases/06-sonarqube-quality/06-01-PLAN.md`
2. Uruchom `/paul:apply .paul/phases/06-sonarqube-quality/06-06-PLAN.md`
---