Jacek Pyziak
f8db8c0162
Phase 1 complete (2/2 plans): - Plan 01-01: Extract AllegroTokenManager — OAuth token logic centralized from 4 classes into dedicated manager class - Plan 01-02: Extract StringHelper — nullableString/normalizeDateTime/ normalizeColorHex extracted from 15+ classes into App\Core\Support\StringHelper; removed 19 duplicate private methods Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
11 KiB
11 KiB
phase, plan, type, wave, depends_on, files_modified, autonomous
| phase | plan | type | wave | depends_on | files_modified | autonomous | |||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 01-tech-debt | 02 | execute | 1 |
|
true |
Uzasadnienie
Te same metody są copy-paste w 12+ klasach. Narusza to regułę projektu przeciwko duplikowaniu kodu (CLAUDE.md) oraz zasadę SRP. Ryzyko rozbieżności jeśli jedna kopia zostanie zmieniona a inne nie.
Wynik
- Nowy plik
src/Core/Support/StringHelper.phpz 3 metodami statycznymi - 15 plików — usunięte prywatne metody, zamienione wywołania na
StringHelper::* - Wpis o tym błędzie usunięty z
.paul/codebase/CONCERNS.md
Istniejące pliki w Core/Support
Już istnieją: src/Core/Support/Env.php, Flash.php, Logger.php, Session.php — wzorzec dla StringHelper.php.
Wzorzec implementacji helperów
nullableString() — trim + zwróć null jeśli pusty string:
private function nullableString(string $value): ?string
{
$trimmed = trim($value);
return $trimmed === '' ? null : $trimmed;
}
normalizeDateTime() — trim, walidacja, formatowanie do Y-m-d H:i:s:
private function normalizeDateTime(string $value): ?string
{
$trimmed = trim($value);
if ($trimmed === '') { return null; }
try {
return (new DateTimeImmutable($trimmed))->format('Y-m-d H:i:s');
} catch (\Exception $e) { return null; }
}
normalizeColorHex() — walidacja regex #RRGGBB, fallback #64748b:
private function normalizeColorHex(string $value): string
{
$trimmed = trim($value);
if (preg_match('/^#[0-9a-fA-F]{6}$/', $trimmed) === 1) {
return strtolower($trimmed);
}
return '#64748b';
}
| Skill | Priorytet | Kiedy wywołać | Załadowany? |
|---|---|---|---|
| /feature-dev | required | Przed implementacją | ○ |
| /code-review | required | Po implementacji, przed UNIFY | ○ |
BLOKUJĄCE: Wymagane skille MUSZĄ być załadowane przed uruchomieniem APPLY.
Lista do odhaczenia
- /feature-dev załadowany
- /code-review załadowany (przed UNIFY)
<acceptance_criteria>
AC-1: StringHelper istnieje i zawiera wszystkie 3 metody
Given plik src/Core/Support/StringHelper.php nie istnieje
When plan zostanie wykonany
Then plik istnieje, zawiera klasę StringHelper z metodami statycznymi nullableString(), normalizeDateTime(), normalizeColorHex() z poprawnymi sygnaturami i logiką
AC-2: Brak duplikatów prywatnych metod w klasach
Given 15+ klas zawiera prywatne kopie tych metod
When plan zostanie wykonany
Then żadna klasa w src/ nie zawiera prywatnej metody nullableString(), normalizeDateTime() ani normalizeColorHex()
AC-3: Wszystkie wywołania przekierowane na StringHelper
Given klasy wywołują $this->nullableString(), $this->normalizeDateTime(), $this->normalizeColorHex()
When plan zostanie wykonany
Then każde takie wywołanie jest zastąpione przez StringHelper::nullableString(), StringHelper::normalizeDateTime(), StringHelper::normalizeColorHex()
AC-4: Wpis w CONCERNS.md usunięty
Given sekcja "[HIGH] Duplicated nullableString()..." istnieje w .paul/codebase/CONCERNS.md
When plan zostanie wykonany
Then ta sekcja jest usunięta z pliku CONCERNS.md
AC-5: Brak błędów składniowych PHP
Given zmodyfikowane pliki PHP
When uruchomimy php -l na każdym zmodyfikowanym pliku
Then każdy plik zwraca "No syntax errors detected"
</acceptance_criteria>
Zadanie 1: Utwórz StringHelper z 3 metodami statycznymi src/Core/Support/StringHelper.php Utwórz nowy plik `src/Core/Support/StringHelper.php` z namespace `App\Core\Support`. Klasa `StringHelper` (final) z 3 publicznymi metodami statycznymi:1. `nullableString(string $value): ?string`
- trim($value), jeśli '' → return null, inaczej return trimmed
2. `normalizeDateTime(string $value): ?string`
- trim($value), jeśli '' → return null
- try { return (new DateTimeImmutable($trimmed))->format('Y-m-d H:i:s'); }
- catch (\Exception) { return null; }
- WAŻNE: użyj `use DateTimeImmutable;` w importach
3. `normalizeColorHex(string $value): string`
- trim($value), jeśli pasuje do `/^#[0-9a-fA-F]{6}$/` → return strtolower($trimmed)
- fallback: return '#64748b'
Styl: `declare(strict_types=1)`, PascalCase dla klasy, brak konstruktora.
1. Dodaj `use App\Core\Support\StringHelper;` do sekcji importów (po istniejących `use` statements)
- Tylko jeśli plik rzeczywiście używa co najmniej jednej z tych metod
- Zachowaj alfabetyczną kolejność lub dodaj na końcu bloku use
2. Zamień wywołania:
- `$this->nullableString(` → `StringHelper::nullableString(`
- `$this->normalizeDateTime(` → `StringHelper::normalizeDateTime(`
- `$this->normalizeColorHex(` → `StringHelper::normalizeColorHex(`
3. Usuń prywatną metodę z klasy:
- Całą definicję `private function nullableString(...)` jeśli istnieje w pliku
- Całą definicję `private function normalizeDateTime(...)` jeśli istnieje
- Całą definicję `private function normalizeColorHex(...)` jeśli istnieje
UWAGA: AllegroOrderImportService.php ma zarówno nullableString() jak i normalizeDateTime() — usuń obie.
UWAGA: ShopproOrdersSyncService.php ma zarówno nullableString() jak i normalizeDateTime() — usuń obie.
UWAGA: ShopproPaymentStatusSyncService.php ma zarówno nullableString() jak i normalizeDateTime() — usuń obie.
NIE zmieniaj żadnej innej logiki. Tylko zamiana wywołań i usunięcie duplikatów.
Usuń także poziomą linię `---` oddzielającą tę sekcję od następnej (zostaw jeden separator między Tech Debt a kolejną sekcją jeśli to potrzebne dla czytelności).
NIE modyfikuj żadnych innych wpisów w CONCERNS.md.
DO NOT CHANGE
- Logika biznesowa wewnątrz helperów — przepisz 1:1 do StringHelper, nie zmieniaj zachowania
- Żadne inne metody w modyfikowanych klasach
- Inne sekcje w CONCERNS.md
- Testy, migracje, widoki, zasoby statyczne
SCOPE LIMITS
- Tylko 3 metody: nullableString, normalizeDateTime, normalizeColorHex
- Nie refaktoryzuj innych prywatnych helperów przy okazji
- Nie przenoś plików ani nie zmieniaj namespace'ów innych klas
- Nie dodawaj nowych zależności (composer)
<success_criteria>
- StringHelper.php utworzony z 3 poprawnymi metodami statycznymi
- 0 prywatnych kopii tych metod pozostało w src/
- Wszystkie wywołania przekierowane na StringHelper::
- CONCERNS.md zaktualizowany — wpis usunięty
- Brak błędów składniowych PHP w zmodyfikowanych plikach </success_criteria>