Jacek Pyziak
3a9cfcd4a2
Plany dla php:S112, S1142, S1192, S3776, S1448, S138 — gotowe do APPLY. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
12 KiB
12 KiB
phase, plan, type, wave, depends_on, files_modified, autonomous
| phase | plan | type | wave | depends_on | files_modified | autonomous | |||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 06-sonarqube-quality | 01 | execute | 1 |
|
true |
Purpose
SonarQube flaguje RuntimeException jako zbyt ogólny — łapanie catch (RuntimeException) nie mówi nic o tym, jaki błąd nastąpił. Typowane wyjątki umożliwiają precyzyjny catch w wywołującym kodzie i poprawiają czytelność stacktrace.
Output
Hierarchia klas wyjątków w src/Core/Exceptions/ + podmienione throw w 13 plikach. Liczba S112 w SonarQube spada z 95 do ~5 (pozostałości w Core).
Source Files
@src/Modules/Settings/AllegroApiClient.php @src/Modules/Settings/AllegroOAuthClient.php @src/Modules/Settings/AllegroTokenManager.php @src/Modules/Shipments/ApaczkaShipmentService.php @src/Modules/Shipments/AllegroShipmentService.php @src/Modules/Settings/ApaczkaApiClient.php @src/Modules/Settings/IntegrationSecretCipher.php
## Required Skills (from SPECIAL-FLOWS.md)| Skill | Priority | When to Invoke | Loaded? |
|---|---|---|---|
| sonar-scanner | required | Po APPLY, przed UNIFY | ○ |
Skill Invocation Checklist
- sonar-scanner uruchomiony po zakończeniu APPLY (CLI w katalogu projektu)
<acceptance_criteria>
AC-1: Hierarchia wyjątków istnieje
Given brak folderu src/Core/Exceptions/
When plan zostaje wykonany
Then folder src/Core/Exceptions/ istnieje z klasami: OrderProException, AllegroApiException, AllegroOAuthException, ApaczkaApiException, ShipmentException, IntegrationConfigException
AC-2: Allegro-specific throws podmienione
Given AllegroApiClient, AllegroOAuthClient, AllegroTokenManager rzucają RuntimeException
When plan zostaje wykonany
Then wszystkie throw w tych plikach używają AllegroApiException lub AllegroOAuthException
AC-3: Apaczka-specific throws podmienione
Given ApaczkaApiClient, ApaczkaShipmentService, ApaczkaIntegrationRepository rzucają RuntimeException
When plan zostaje wykonany
Then wszystkie throw w tych plikach używają ApaczkaApiException
AC-4: Shipment throws podmienione
Given AllegroShipmentService, ShipmentController rzucają RuntimeException
When plan zostaje wykonany
Then wszystkie throw używają ShipmentException
AC-5: Brak regresji
Given aplikacja działa przed zmianą
When klasy wyjątków rozszerzają RuntimeException (łańcuch dziedziczenia zachowany)
Then istniejące catch (RuntimeException) w kodzie wywołującym nadal działają
</acceptance_criteria>
Task 1: Utwórz hierarchię klas wyjątków src/Core/Exceptions/OrderProException.php, src/Core/Exceptions/AllegroApiException.php, src/Core/Exceptions/AllegroOAuthException.php, src/Core/Exceptions/ApaczkaApiException.php, src/Core/Exceptions/ShipmentException.php, src/Core/Exceptions/IntegrationConfigException.php Utwórz folder src/Core/Exceptions/ i pliki klas z namespace App\Core\Exceptions.Hierarchia:
- OrderProException extends \RuntimeException — baza dla wszystkich własnych wyjątków
- AllegroApiException extends OrderProException — błędy HTTP/JSON Allegro API i OAuth
- AllegroOAuthException extends AllegroApiException — specyficznie błędy OAuth (token refresh, brak tokenów)
- ApaczkaApiException extends OrderProException — błędy API Apaczka (HTTP, curl, payload)
- ShipmentException extends OrderProException — błędy tworzenia/pobierania przesyłek (brak zamówienia, brak providera, brak paczki)
- IntegrationConfigException extends OrderProException — błędy konfiguracji integracji (brak rekordu w DB, brak klucza API, brak sekretu)
Każda klasa: minimalna (tylko class declaration + extends). Brak dodatkowych metod — nie powielać logiki.
Nie dodawaj konstruktorów ani innych metod — klasy wyjątków mają być tylko markerami.
Uwaga: NIE zmieniaj logiki catch bloków — tylko throw. NIE zmieniaj komunikatów błędów.
Uwaga: \RuntimeException w AllegroIntegrationController (jeśli catch) — NIE ruszać.
W każdym pliku dodaj odpowiednie use statements na górze.
NIE zmieniaj logiki catch — tylko throw.
DO NOT CHANGE
- Bloki catch (RuntimeException) w controllers/handlers — łańcuch dziedziczenia zachowuje kompatybilność, ale NIE ruszaj istniejących catch
- Komunikaty błędów w throw — tylko typ wyjątku się zmienia
- src/Core/Exceptions/ — nie tworzyć tu nic poza 6 klasami z tego planu
- routes/web.php
- Pliki widoków (resources/views/)
SCOPE LIMITS
- Nie refaktoryzuj logiki poza podmianą throw
- Nie dodawaj konstruktorów ani metod do klas wyjątków
- Nie zmieniaj sposobu obsługi błędów w UI (flash messages, HTTP redirecty)
- Core wyjątki (Router.php, Template.php, Translator.php, ConnectionFactory.php, Migrator.php) — zostawić jako RuntimeException (mają sens jako generyczne)
<success_criteria>
- Wszystkie 3 taski ukończone
- Zero błędów składniowych PHP
- grep "new RuntimeException" src/ zwraca ≤5 wyników
- SonarQube S112 spada z 95 do ≤10 </success_criteria>