feat(05-domain-seoadditional-cron-releases): Domain layer kompletny — SeoAdditional + Cron + Releases

Phase 5 complete: - Domain\SeoAdditional\SeoAdditionalRepository (elementDelete, elementSave, elementDetails) - Domain\Cron\CronRepository (3 pub + 12 private helper methods) - Domain\Releases\ReleasesRepository (9 metod: wersje, licencje, discover) - Domain\Releases\UpdateRepository (auto-update, konstruktor($db, $settings)) - 4 legacy factory wrappers zaktualizowane do wrapper delegation Domain layer: 13/13 repozytoriów kompletnych. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-26 00:57:13 +02:00
parent bf4b7c6429
commit f7c7c0bb88
14 changed files with 1292 additions and 755 deletions
--- a/.paul/phases/05-domain-seoadditional-cron-releases/05-01-PLAN.md
+++ b/.paul/phases/05-domain-seoadditional-cron-releases/05-01-PLAN.md
@@ -0,0 +1,237 @@
+---
+phase: 05-domain-seoadditional-cron-releases
+plan: 01
+type: execute
+wave: 1
+depends_on: []
+files_modified:
+  - autoload/Domain/SeoAdditional/SeoAdditionalRepository.php
+  - autoload/Domain/Cron/CronRepository.php
+  - autoload/Domain/Releases/ReleasesRepository.php
+  - autoload/Domain/Releases/UpdateRepository.php
+  - autoload/admin/factory/class.SeoAdditional.php
+  - autoload/class.Cron.php
+  - autoload/admin/factory/class.Releases.php
+  - autoload/admin/factory/class.Update.php
+autonomous: true
+delegation: auto
+---
+
+<objective>
+## Goal
+Utworzyć Domain repositories dla SeoAdditional, Cron i Releases/Update, oraz zaktualizować legacy klasy do wzorca wrapper delegation.
+
+## Purpose
+Kompletuje Domain layer (wszystkie 13 repozytoriów). Po tej fazie cała logika biznesowa domenowa jest w namespace Domain\ — gotowe pod Admin\ controllers (Fazy 6-13).
+
+## Output
+- autoload/Domain/SeoAdditional/SeoAdditionalRepository.php
+- autoload/Domain/Cron/CronRepository.php
+- autoload/Domain/Releases/ReleasesRepository.php
+- autoload/Domain/Releases/UpdateRepository.php
+- Wrappery w 4 legacy klasach (SeoAdditional, Cron, Releases, Update)
+</objective>
+
+<context>
+## Project Context
+@.paul/PROJECT.md
+@.paul/ROADMAP.md
+
+## Prior Work
+@.paul/phases/04-domain-authors-newsletter/04-01-SUMMARY.md
+
+## Source Files
+@autoload/admin/factory/class.SeoAdditional.php
+@autoload/class.Cron.php
+@autoload/admin/factory/class.Releases.php
+@autoload/admin/factory/class.Update.php
+@autoload/Domain/Authors/AuthorsRepository.php
+@autoload/admin/factory/class.Authors.php
+</context>
+
+<acceptance_criteria>
+
+## AC-1: SeoAdditional Repository
+```gherkin
+Given klasa admin\factory\SeoAdditional używa global $mdb bezpośrednio
+When migrujemy logikę do Domain\SeoAdditional\SeoAdditionalRepository
+Then repo przyjmuje $db w konstruktorze, nie używa globals
+  And factory wrapper deleguje do nowego repo (new repo per call)
+  And wszystkie 3 metody: elementDelete, elementSave, elementDetails
+```
+
+## AC-2: Cron Repository
+```gherkin
+Given legacy class Cron (bez namespace) w autoload/class.Cron.php używa global $mdb
+When migrujemy logikę do Domain\Cron\CronRepository
+Then repo przyjmuje $db w konstruktorze
+  And legacy class Cron deleguje do Domain\Cron\CronRepository (new repo per call z global $mdb)
+  And wszystkie metody zachowane: automaticUpdateSites, getSiteMainLinks, getSiteOtherLinks + metody prywatne helper
+```
+
+## AC-3: Releases Repository
+```gherkin
+Given klasa admin\factory\Releases używa global $mdb bezpośrednio
+When migrujemy logikę do Domain\Releases\ReleasesRepository
+Then repo przyjmuje $db w konstruktorze
+  And factory wrapper deleguje do nowego repo
+  And wszystkie metody zachowane: getVersions, promote, demote, discoverVersions, getLicenses, getLicense, saveLicense, deleteLicense, toggleBeta
+```
+
+## AC-4: Update Repository
+```gherkin
+Given klasa admin\factory\Update używa global $mdb i $settings bezpośrednio
+When migrujemy logikę do Domain\Releases\UpdateRepository
+Then repo przyjmuje $db i $settings w konstruktorze
+  And factory wrapper deleguje do nowego repo (przekazując globals przez konstruktor)
+  And metoda update() zachowana w pełni
+```
+
+</acceptance_criteria>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: SeoAdditional — Domain repo + wrapper</name>
+  <files>
+    autoload/Domain/SeoAdditional/SeoAdditionalRepository.php,
+    autoload/admin/factory/class.SeoAdditional.php
+  </files>
+  <action>
+    Utwórz autoload/Domain/SeoAdditional/SeoAdditionalRepository.php:
+    - namespace Domain\SeoAdditional;
+    - konstruktor: __construct($db) — przechowuje $db jako private property
+    - Metody (camelCase, z logiki class.SeoAdditional.php):
+      * elementDelete($elementId) — delete z pp_seo_additional
+      * elementSave($id, $url, $status, $title, $keywords, $description, $text) — insert lub update + \S::delete_cache()
+      * elementDetails($elementId) — get z pp_seo_additional
+    - PHP < 8.0: bez typed params, bez named args, bez match
+
+    Zaktualizuj autoload/admin/factory/class.SeoAdditional.php:
+    - Zastąp każdą metodę wrapperem delegującym: new \Domain\SeoAdditional\SeoAdditionalRepository($mdb)->metoda()
+    - Pattern z class.Authors.php: global $mdb; $repo = new \Domain\...\Repository($mdb); return $repo->method(...)
+    - Zachowaj dokładnie te same sygnatury metod (snake_case w factory, camelCase w repo)
+  </action>
+  <verify>
+    Grep: Domain\SeoAdditional istnieje w autoload/Domain/SeoAdditional/SeoAdditionalRepository.php
+    Grep: new \Domain\SeoAdditional\SeoAdditionalRepository istnieje w class.SeoAdditional.php
+    Brak global $mdb bezpośrednio w repo (tylko w factory wrapper)
+  </verify>
+  <done>AC-1 satisfied: SeoAdditional repo + wrapper delegation</done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Cron — Domain repo + wrapper</name>
+  <files>
+    autoload/Domain/Cron/CronRepository.php,
+    autoload/class.Cron.php
+  </files>
+  <action>
+    Utwórz autoload/Domain/Cron/CronRepository.php:
+    - namespace Domain\Cron;
+    - konstruktor: __construct($db)
+    - Przenieś CAŁĄ logikę z class.Cron.php do repo jako metody camelCase:
+      * automaticUpdateSites() — odpowiednik automatic_update_sites()
+      * getSiteMainLinks() — odpowiednik get_site_main_links()
+      * getSiteOtherLinks() — odpowiednik get_site_other_links()
+      * Wszystkie metody prywatne helper (getSiteMetaTitle, getSiteMetaKeywords, itd.) — przenieś jako private methods
+    - PHP < 8.0: bez typed params
+    - $mdb zastąp przez $this->db we wszystkich zapytaniach
+
+    Zaktualizuj autoload/class.Cron.php:
+    - Zachowaj oryginalny namespace (brak namespace — klasa globalna Cron)
+    - Zastąp każdą public static metodę wrapperem:
+      global $mdb; $repo = new \Domain\Cron\CronRepository($mdb); return $repo->camelCaseMethod();
+    - Usuń ciała helper methods (prywatne) — logika jest teraz w repo
+  </action>
+  <verify>
+    Grep: Domain\Cron istnieje w autoload/Domain/Cron/CronRepository.php
+    Grep: new \Domain\Cron\CronRepository istnieje w autoload/class.Cron.php
+    Brak bezpośrednich zapytań $mdb-> w class.Cron.php (tylko delegacja)
+  </verify>
+  <done>AC-2 satisfied: Cron repo + wrapper delegation</done>
+</task>
+
+<task type="auto">
+  <name>Task 3: Releases + Update — Domain repos + wrappers</name>
+  <files>
+    autoload/Domain/Releases/ReleasesRepository.php,
+    autoload/Domain/Releases/UpdateRepository.php,
+    autoload/admin/factory/class.Releases.php,
+    autoload/admin/factory/class.Update.php
+  </files>
+  <action>
+    Utwórz autoload/Domain/Releases/ReleasesRepository.php:
+    - namespace Domain\Releases;
+    - konstruktor: __construct($db)
+    - Przenieś logikę z class.Releases.php: getVersions, promote, demote, discoverVersions, getLicenses, getLicense, saveLicense, deleteLicense, toggleBeta
+    - Prywatna metoda zipDir() jako private helper
+    - PHP < 8.0: bez ": array", bez ": void", bez ": int", bez ": string" type hints (PHP < 8.0, ale PHP 7.x obsługuje return types — ZACHOWAJ return type hints jeśli były w oryginale, bo PHP 7+ je obsługuje)
+    - Uwaga: PHP < 8.0 znaczy brak PHP8 features. PHP 7.x return types działają. Sprawdź oryginał — miał ": array", ": void", ": int", ": string" — zachowaj je.
+
+    Utwórz autoload/Domain/Releases/UpdateRepository.php:
+    - namespace Domain\Releases;
+    - konstruktor: __construct($db, $settings) — settings potrzebne do update_key i wersji
+    - Przenieś logikę z class.Update.php: metoda update()
+    - Zastąp global $mdb → $this->db, global $settings → $this->settings
+    - Wywołania \S::* zachowaj (klasa S jest dostępna globalnie)
+
+    Zaktualizuj autoload/admin/factory/class.Releases.php:
+    - Zastąp każdą metodę wrapperem: global $mdb; $repo = new \Domain\Releases\ReleasesRepository($mdb); return $repo->method(...)
+    - Zachowaj dokładnie te same sygnatury
+
+    Zaktualizuj autoload/admin/factory/class.Update.php:
+    - Zastąp metodę update() wrapperem:
+      global $mdb, $settings; $repo = new \Domain\Releases\UpdateRepository($mdb, $settings); return $repo->update();
+  </action>
+  <verify>
+    Grep: Domain\Releases istnieje w obu nowych plikach repo
+    Grep: new \Domain\Releases\ReleasesRepository istnieje w class.Releases.php
+    Grep: new \Domain\Releases\UpdateRepository istnieje w class.Update.php
+    Brak bezpośrednich zapytań $mdb-> w factory wrapperach
+  </verify>
+  <done>AC-3 i AC-4 satisfied: Releases + Update repos + wrapper delegation</done>
+</task>
+
+</tasks>
+
+<boundaries>
+
+## DO NOT CHANGE
+- autoload/autoloader.php (PSR-4 mapowanie już obejmuje Domain\)
+- autoload/Domain/Authors/, autoload/Domain/Newsletter/ (ukończone w Phase 4)
+- autoload/Domain/Scontainers/, autoload/Domain/Banners/ (ukończone w Phase 3)
+- Żadne inne pliki poza listą files_modified
+- cron.php entry point — nie modyfikuj (klasa Cron nadal globalna)
+
+## SCOPE LIMITS
+- Tylko Domain repositories i factory wrappers — bez Admin\ controllers
+- Bez zmian w tabelach bazy danych ani SQL schema
+- Bez refaktoryzacji metod — 1:1 przeniesienie logiki
+
+</boundaries>
+
+<verification>
+Przed deklaracją ukończenia:
+- [ ] Grep: autoload/Domain/SeoAdditional/SeoAdditionalRepository.php istnieje
+- [ ] Grep: autoload/Domain/Cron/CronRepository.php istnieje
+- [ ] Grep: autoload/Domain/Releases/ReleasesRepository.php istnieje
+- [ ] Grep: autoload/Domain/Releases/UpdateRepository.php istnieje
+- [ ] Grep: class.SeoAdditional.php zawiera "new \Domain\SeoAdditional"
+- [ ] Grep: class.Cron.php zawiera "new \Domain\Cron"
+- [ ] Grep: class.Releases.php zawiera "new \Domain\Releases"
+- [ ] Grep: class.Update.php zawiera "new \Domain\Releases"
+- [ ] Brak syntax errors (php -l na każdym nowym pliku)
+</verification>
+
+<success_criteria>
+- 4 nowe Domain repository pliki utworzone
+- 4 legacy klasy zaktualizowane do wrapper delegation
+- Zero zmian w logice biznesowej (1:1 migracja)
+- PHP < 8.0 kompatybilność zachowana
+- Brak globals w repozytoriach
+</success_criteria>
+
+<output>
+Po ukończeniu utwórz: .paul/phases/05-domain-seoadditional-cron-releases/05-01-SUMMARY.md
+</output>
--- a/.paul/phases/05-domain-seoadditional-cron-releases/05-01-SUMMARY.md
+++ b/.paul/phases/05-domain-seoadditional-cron-releases/05-01-SUMMARY.md
@@ -0,0 +1,125 @@
+---
+phase: 05-domain-seoadditional-cron-releases
+plan: 01
+subsystem: domain
+tags: [php, domain, repository, wrapper-delegation, medoo]
+
+requires:
+  - phase: 01-infrastructure
+    provides: PSR-4 autoloader mapujący Domain\
+
+provides:
+  - Domain\SeoAdditional\SeoAdditionalRepository
+  - Domain\Cron\CronRepository
+  - Domain\Releases\ReleasesRepository
+  - Domain\Releases\UpdateRepository
+  - Wrapper delegation dla 4 legacy klas
+
+affects:
+  - 11-admin-newsletter-emails-seoadditional
+  - 13-admin-releases-update
+
+tech-stack:
+  added: []
+  patterns:
+    - "Wrapper delegation: admin\\factory i global class.Cron delegują do Domain\\ repos"
+    - "UpdateRepository przyjmuje ($db, $settings) — dwa globals jako explicit params"
+
+key-files:
+  created:
+    - autoload/Domain/SeoAdditional/SeoAdditionalRepository.php
+    - autoload/Domain/Cron/CronRepository.php
+    - autoload/Domain/Releases/ReleasesRepository.php
+    - autoload/Domain/Releases/UpdateRepository.php
+  modified:
+    - autoload/admin/factory/class.SeoAdditional.php
+    - autoload/class.Cron.php
+    - autoload/admin/factory/class.Releases.php
+    - autoload/admin/factory/class.Update.php
+
+key-decisions:
+  - "UpdateRepository przyjmuje ($db, $settings) w konstruktorze — settings potrzebny do update_key"
+  - "Cron helper methods (get_site_meta_*) zostały private w CronRepository — były wywoływane tylko wewnętrznie"
+  - "class.Cron.php zachowuje brak namespace (klasa globalna) — entry point cron.php używa bezpośrednio"
+
+patterns-established:
+  - "Wszystkie Domain repos: konstruktor($db), brak globals, metody camelCase"
+  - "Factory wrappers: new repo per call, global $mdb w każdej metodzie"
+
+duration: ~5min
+started: 2026-04-26T00:00:00Z
+completed: 2026-04-26T00:05:00Z
+---
+
+# Phase 5 Plan 01: SeoAdditional + Cron + Releases Summary
+
+**4 Domain repositories ukończone — Domain layer kompletny (13/13 repos), wrapper delegation dla SeoAdditional, Cron, Releases i Update.**
+
+## Performance
+
+| Metric | Value |
+|--------|-------|
+| Duration | ~5min |
+| Started | 2026-04-26 |
+| Completed | 2026-04-26 |
+| Tasks | 3 completed |
+| Files modified | 8 (4 created, 4 updated) |
+
+## Acceptance Criteria Results
+
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+| AC-1: SeoAdditional Repository | Pass | 3 metody: elementDelete, elementSave, elementDetails |
+| AC-2: Cron Repository | Pass | 3 public + 12 private helper methods, brak namespace w wrapperze |
+| AC-3: Releases Repository | Pass | 9 metod + private zipDir helper |
+| AC-4: Update Repository | Pass | Pełna logika update(), ($db, $settings) w konstruktorze |
+
+## Accomplishments
+
+- Ukończono Domain layer: wszystkie 13 repozytoriów w `Domain\` namespace
+- SeoAdditional: prosta migracja 3 CRUD metod z factory do repo
+- Cron: migracja dużej klasy (15 metod) — helper methods stały się private w repo
+- Releases: 9 metod + prywatny helper zipDir, zachowane PHP 7.x return type hints
+- UpdateRepository: jako jedyny repo przyjmuje 2 parametry ($db, $settings) — settings wymagane dla update_key
+
+## Files Created/Modified
+
+| File | Change | Purpose |
+|------|--------|---------|
+| `autoload/Domain/SeoAdditional/SeoAdditionalRepository.php` | Created | SEO dodatkowe wpisy — CRUD |
+| `autoload/Domain/Cron/CronRepository.php` | Created | Cron jobs — crawling i analiza stron |
+| `autoload/Domain/Releases/ReleasesRepository.php` | Created | Zarządzanie wersjami i licencjami |
+| `autoload/Domain/Releases/UpdateRepository.php` | Created | Mechanizm auto-update (pobieranie paczek ZIP) |
+| `autoload/admin/factory/class.SeoAdditional.php` | Modified | Wrapper → deleguje do Domain\SeoAdditional |
+| `autoload/class.Cron.php` | Modified | Wrapper → deleguje do Domain\Cron (brak namespace) |
+| `autoload/admin/factory/class.Releases.php` | Modified | Wrapper → deleguje do Domain\Releases\ReleasesRepository |
+| `autoload/admin/factory/class.Update.php` | Modified | Wrapper → deleguje do Domain\Releases\UpdateRepository |
+
+## Decisions Made
+
+| Decision | Rationale | Impact |
+|----------|-----------|--------|
+| UpdateRepository($db, $settings) | Metoda update() używa $settings['update_key'] — musi być w konstruktorze | Admin\Update\UpdateController też przekaże oba parametry |
+| Cron helpers → private | Metody get_site_meta_* były wywoływane tylko przez getSiteOtherLinks() | Czystsza enkapsulacja, brak public API dla wewnętrznych helperów |
+| class.Cron.php bez namespace | Zachowanie 100% compat — cron.php używa `Cron::` bez backslasha | Klasa globalna pozostaje globalna do Phase 19 cleanup |
+
+## Deviations from Plan
+
+None — plan wykonany dokładnie jak zaplanowano.
+
+## Next Phase Readiness
+
+**Ready:**
+- Domain layer kompletny (13 repozytoriów) — gotowy pod Admin\ controllers
+- Phase 6: Admin Base Infrastructure może startować (nie zależy od Domain\Cron/Releases/SeoAdditional bezpośrednio)
+- Phase 11 (Admin: Newsletter + Emails + SeoAdditional) i Phase 13 (Admin: Releases + Update) mają gotowe Domain repos
+
+**Concerns:**
+- Brak — wszystkie dependency spełnione
+
+**Blockers:**
+- None
+
+---
+*Phase: 05-domain-seoadditional-cron-releases, Plan: 01*
+*Completed: 2026-04-26*