Files
cmsPRO/.paul/phases/01-infrastructure/01-01-SUMMARY.md
Jacek Pyziak 3325eaf44c refactor: centralny autoloader, Shared\Email i Shared\Security
- Utworzono autoload/autoloader.php (hybrydowy PSR-4 + legacy)
- Zmigrowano 7 entry pointów do centralnego autoloadera
- Dodano PSR-4 mapowanie w composer.json (Domain, Shared, Admin, Frontend)
- Utworzono Shared\Email\Email (PHPMailer, migracja z Helpers)
- Utworzono Shared\Security\CsrfToken (random_bytes + hash_equals)
- Wrappery w Helpers delegują do nowych klas
- Zaktualizowano docs/PROJECT_STRUCTURE.md
- Inicjalizacja PAUL (.paul/) z roadmapą 19 faz refaktoryzacji

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-04 17:28:01 +02:00

3.7 KiB

phase, plan, subsystem, tags, requires, provides, affects, tech-stack, key-files, key-decisions, patterns-established, duration, completed
phase plan subsystem tags requires provides affects tech-stack key-files key-decisions patterns-established duration completed
01-infrastructure 01 infra
autoloader
psr-4
composer
Centralny hybrydowy autoloader (PSR-4 + legacy)
composer.json z PSR-4 mapowaniem namespace'ów
all future phases - every new class uses this autoloader
added patterns
centralny autoloader z __DIR__
hybrydowy PSR-4 + legacy
created modified
autoload/autoloader.php
composer.json
index.php
admin/index.php
admin/ajax.php
ajax.php
api.php
cron.php
download.php
Centralny autoloader zamiast duplikatów w entry pointach (ulepszenie vs shopPRO)
Savant3 special case przeniesiony do centralnego autoloadera
Jeden autoloader dla wszystkich entry pointów — __DIR__ based paths
Hybrydowe ładowanie: legacy class.*.php → PSR-4 ClassName.php
~10min 2026-04-04

Phase 1 Plan 01: Infrastructure & Autoloader Summary

Centralny hybrydowy autoloader (PSR-4 + legacy) zastępujący 7 zduplikowanych kopii w entry pointach.

Performance

Metric Value
Duration ~10min
Completed 2026-04-04
Tasks 3 completed
Files modified 8

Acceptance Criteria Results

Criterion Status Notes
AC-1: Centralny autoloader Pass autoload/autoloader.php z spl_autoload_register, DIR paths
AC-2: composer.json PSR-4 Pass Domain, Shared, Admin, Frontend\ mapped
AC-3: Entry pointy zmigrowane Pass 7 entry pointów, 0 duplikatów __autoload_my_classes
AC-4: Istniejące klasy działają Pass Autoloader obsługuje legacy + PSR-4 format

Accomplishments

  • Utworzono centralny autoload/autoloader.php z obsługą legacy (class.*.php) i PSR-4 (ClassName.php)
  • Zaktualizowano composer.json z PSR-4 mapowaniem dla 4 namespace'ów
  • Zmigrowano 7 entry pointów (index.php, admin/index.php, admin/ajax.php, ajax.php, api.php, cron.php, download.php)

Files Created/Modified

File Change Purpose
autoload/autoloader.php Created Centralny hybrydowy autoloader
composer.json Modified PSR-4 mapping dla Domain, Shared, Admin, Frontend\
index.php Modified require_once autoloader.php
admin/index.php Modified require_once ../autoloader.php
admin/ajax.php Modified require_once ../autoloader.php (Savant3 przeniesiony)
ajax.php Modified require_once autoloader.php
api.php Modified require_once autoloader.php
cron.php Modified require_once autoloader.php
download.php Modified require_once autoloader.php

Decisions Made

Decision Rationale Impact
Centralny autoloader (vs duplikaty jak w shopPRO) DRY, łatwiejsze utrzymanie, jednorazowa poprawka Ulepszenie vs shopPRO — notatka dodana do shopPRO/docs
Savant3 special case w centralnym autoloaderze Był tylko w admin/ajax.php, powinien działać globalnie Brak regresji

Deviations from Plan

Summary

Type Count Impact
Scope additions 1 Minimal — admin/ajax.php (7th entry point)

Plan zakładał 6 entry pointów, ale znaleziono 7 (admin/ajax.php nie był wymieniony w planie). Zmigrowany bez problemów.

Issues Encountered

None.

Next Phase Readiness

Ready:

  • Autoloader obsługuje wszystkie namespace'y potrzebne dla faz 2-19
  • Nowe klasy w Admin, Frontend\ będą automatycznie ładowane

Concerns:

  • AC-4 zweryfikowane statycznie (kod autoloadera) — runtime test wymaga uruchomienia aplikacji

Blockers:

  • None

Phase: 01-infrastructure, Plan: 01 Completed: 2026-04-04