refactor(shop-statuses): migrate to DI, restructure docs into docs/ folder (0.268)

- Migrate ShopStatuses module to Domain + DI architecture - Add ShopStatusRepository, ShopStatusesController with color picker - Convert front\factory\ShopStatuses to facade - Add FormFieldType::COLOR with HTML5 color picker - Move documentation files to docs/ folder (PROJECT_STRUCTURE, REFACTORING_PLAN, CHANGELOG, FORM_EDIT_SYSTEM, TESTING, DATABASE_STRUCTURE) - Tests: 254 tests, 736 assertions Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-14 10:43:31 +01:00
parent 7574785d68
commit 847fdbbf3f
29 changed files with 1895 additions and 1572 deletions
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -0,0 +1,315 @@
+# Changelog shopPRO
+
+Logi zmian z migracji na Domain-Driven Architecture. Najnowsze na gorze.
+
+---
+
+## ver. 0.267 (2026-02-14) - ShopStatuses
+
+- **ShopStatuses** - migracja `/admin/shop_statuses` na Domain + DI + nowe widoki
+  - NOWE: `Domain\ShopStatus\ShopStatusRepository` (`listForAdmin`, `find`, `save`, `getApiloStatusId`, `getByIntegrationStatusId`, `allStatuses`)
+  - NOWE: `admin\Controllers\ShopStatusesController` (DI) z akcjami `list`, `edit`, `save` (bez aliasow legacy)
+  - NOWE: typ pola `FormFieldType::COLOR` + `FormField::color()` + `FormFieldRenderer::renderColor()` (color picker HTML5 zsynchronizowany z polem tekstowym)
+  - UPDATE: modul `/admin/shop_statuses/*` dziala na `components/table-list` i `components/form-edit`
+  - UPDATE: `front\factory\ShopStatuses` jako fasada delegujaca do `Domain\ShopStatus\ShopStatusRepository`
+  - UPDATE: menu admin przepiete na kanoniczny URL `/admin/shop_statuses/list/`
+  - CLEANUP: usuniete legacy `autoload/admin/controls/class.ShopStatuses.php`, `autoload/admin/factory/class.ShopStatuses.php`
+  - UWAGA: statusy maja ID od 0 - kluczowe dla walidacji (find/save uzywaja `$id < 0`)
+- Testy: **OK (254 tests, 736 assertions)**
+
+---
+
+## ver. 0.266 (2026-02-13) - ShopCoupon
+
+- **ShopCoupon** - migracja `/admin/shop_coupon` na Domain + DI + nowe widoki
+  - NOWE: `Domain\Coupon\CouponRepository` (`listForAdmin`, `find`, `save`, `delete`, `categoriesTree`)
+  - NOWE: `admin\Controllers\ShopCouponController` (DI) z akcjami `list`, `edit`, `save`, `delete`
+  - UPDATE: kompatybilnosc aliasow legacy (`view_list`, `coupon_edit`, `coupon_save`, `coupon_delete`) obslugiwana przez nowy kontroler
+  - UPDATE: modul `/admin/shop_coupon/*` dziala na `components/table-list` i `components/form-edit`
+  - NOWE: widoki/partiale `shop-coupon/coupons-list`, `shop-coupon/coupon-edit-new`, `shop-coupon/coupon-categories-selector`, `shop-coupon/coupon-categories-tree`, `shop-coupon/coupon-edit-custom-script`
+  - CLEANUP: usuniete legacy `autoload/admin/controls/class.ShopCoupon.php`, `autoload/admin/factory/class.ShopCoupon.php`, `admin/templates/shop-coupon/view-list.php`, `admin/templates/shop-coupon/coupon-edit.php`
+  - UPDATE: menu admin przepiete na kanoniczny URL `/admin/shop_coupon/list/`
+  - FIX: ujednolicone UI drzewek i checkboxow miedzy kuponami i layoutami
+- Testy: **OK (235 tests, 682 assertions)**
+
+---
+
+## ver. 0.265 (2026-02-13) - ShopPromotion poprawki
+
+- **ShopPromotion** - stabilizacja po migracji
+  - UPDATE: dodane `date_from` w `Domain\Promotion\PromotionRepository` (save/find/list/sort)
+  - UPDATE: `admin\Controllers\ShopPromotionController` rozszerzony o pole `Data od` na formularzu i kolumne `Data od` na liscie
+  - UPDATE: `shop\Promotion::get_active_promotions()` filtruje aktywnosc po `date_from` i `date_to`
+  - FIX: zapis edycji promocji nie tworzy nowego rekordu (hidden `id` + fallback `id` z URL)
+  - TEST: rozszerzono `PromotionRepositoryTest` o asercje `date_from`
+- Testy: **OK (222 tests, 614 assertions)**
+
+---
+
+## ver. 0.264 (2026-02-13) - ShopPromotion
+
+- **ShopPromotion** - migracja `/admin/shop_promotion` na Domain + DI + nowe widoki
+  - NOWE: `Domain\Promotion\PromotionRepository` (`listForAdmin`, `find`, `save`, `delete`, `categoriesTree`, invalidacja cache aktywnych promocji)
+  - NOWE: `admin\Controllers\ShopPromotionController` (DI) z akcjami `list`, `edit`, `save`, `delete`
+  - UPDATE: routing DI (`admin\Site`) rozszerzony o modul `ShopPromotion`
+  - UPDATE: modul `/admin/shop_promotion/*` dziala na `components/table-list` i `components/form-edit`
+  - NOWE: widoki/partiale `shop-promotion/promotions-list`, `shop-promotion/promotion-edit`, `shop-promotion/promotion-categories-selector`, `shop-promotion/promotion-categories-tree`, `shop-promotion/promotion-edit-custom-script`
+  - CLEANUP: usuniete legacy `autoload/admin/controls/class.ShopPromotion.php`, `autoload/admin/factory/class.ShopPromotion.php`, `admin/templates/shop-promotion/view-list.php`
+  - UPDATE: menu admin przepiete na kanoniczny URL `/admin/shop_promotion/list/`
+- Testy: **OK (222 tests, 609 assertions)**
+
+---
+
+## ver. 0.263 (2026-02-13) - Integrations + cleanup Sellasist/Baselinker
+
+- NOWE: `Domain\Integrations\IntegrationsRepository` (settings Apilo/ShopPRO, OAuth, product linking, API fetch)
+- NOWE: `admin\Controllers\IntegrationsController` (DI) dla akcji Apilo i ShopPRO
+- UPDATE: `admin\factory\Integrations` jako fasada delegujaca do repozytorium
+- **CLEANUP: usunieto integracje Sellasist i Baselinker z calego projektu:**
+  - Usuniete klasy: `admin\controls\Integrations`, `admin\controls\Baselinker`, `admin\factory\Baselinker`, `front\factory\Shop`, `shop\ShopStatus`
+  - Usuniete szablony: `integrations/sellasist-settings.php`, `integrations/baselinker-settings.php`, `admin/templates/baselinker/`
+  - Wyczyszczone referencje w: `cron.php`, `cron/cron-xml.php`, `shop\Order`, kontrolery/factory/front Shop*
+- Testy: **OK (212 tests, 577 assertions)**
+
+---
+
+## ver. 0.262 (2026-02-13) - Pages
+
+- NOWE: `Domain\Pages\PagesRepository` (CRUD menu/stron, drzewo stron, sortowanie, SEO)
+- NOWE: `admin\Controllers\PagesController` (DI) dla akcji menu/page/AJAX
+- UPDATE: widoki `admin/templates/pages/*` przepiete na dane z kontrolera/repozytorium
+- UPDATE: endpointy AJAX przepiete z `admin/ajax.php?a=*` na `/admin/pages/*`
+- CLEANUP: usuniete legacy `controls/Pages`, `view/Pages`, `factory/Pages`, `ajax/pages.php`
+- Testy: **OK (186 tests, 478 assertions)**
+
+---
+
+## ver. 0.261 (2026-02-13) - Articles (dalsza refaktoryzacja)
+
+- UPDATE: `Domain\Article\ArticleRepository` rozszerzone o metody UI/admin i `saveFilesOrder()`
+- UPDATE: `admin\Controllers\ArticlesController` obsluguje AJAX: `article_image_alt_change`, `article_file_name_change`, `article_image_delete`, `article_file_delete`, `filesOrderSave`
+- UPDATE: lista artykulow nie korzysta juz z `admin\factory\Articles::article_pages()`
+- UPDATE: widok edycji przepiety z `/admin/ajax.php` na `/admin/articles/*`
+- UPDATE: drag&drop sortowania listy zalacznikow
+- CLEANUP: usuniete `autoload/admin/view/class.Articles.php` i `admin/ajax/articles.php`
+- Testy: **OK (178 tests, 443 assertions)**
+
+---
+
+## ver. 0.260 (2026-02-12) - ArticlesArchive
+
+- NOWE: `admin\Controllers\ArticlesArchiveController` (DI)
+- UPDATE: `Domain\Article\ArticleRepository` rozszerzone o `listArchivedForAdmin()`, `restore()`, `deletePermanently()`
+- UPDATE: `/admin/articles_archive/view_list/` migrowane na `components/table-list`
+- CLEANUP: usuniete legacy `controls/ArticlesArchive`, `factory/ArticlesArchive`, `view/ArticlesArchive`
+- Testy: **OK (165 tests, 424 assertions)**
+
+---
+
+## ver. 0.259 (2026-02-12) - Scontainers
+
+- NOWE: `Domain\Scontainers\ScontainersRepository` (listForAdmin, find, save, delete, detailsForLanguage)
+- NOWE: `admin\Controllers\ScontainersController` (DI)
+- UPDATE: `/admin/scontainers/*` migrowane na `components/table-list` i `components/form-edit`
+- UPDATE: `admin\factory\Scontainers` i `front\factory\Scontainers` jako fasady
+- CLEANUP: usuniete `controls/Scontainers`, `view/Scontainers`
+- Testy: **OK (158 tests, 397 assertions)**
+
+---
+
+## ver. 0.258 (2026-02-12) - Newsletter (stabilizacja)
+
+- UPDATE: tymczasowo wylaczono flow `prepare/send/preview` (wymaga przebudowy)
+- UPDATE: tymczasowo wylaczono modul `Szablony uzytkownika`
+- UPDATE: aktywna obsluga tylko szablonow administracyjnych (`is_admin = 1`)
+- CLEANUP: usuniete nieuzywane widoki `prepare.php`, `preview.php`, `email-templates-user.php`
+
+---
+
+## ver. 0.257 (2026-02-12) - Newsletter
+
+- NOWE: `Domain\Newsletter\NewsletterRepository` (subskrybenci, szablony, ustawienia, kolejka wysylki)
+- NOWE: `Domain\Newsletter\NewsletterPreviewRenderer` (render podgladu)
+- NOWE: `admin\Controllers\NewsletterController` (DI)
+- UPDATE: `/admin/newsletter/*` migrowane na `components/table-list` i `components/form-edit`
+- UPDATE: `admin\factory\Newsletter` jako fasada; `front\factory\Newsletter` bez `admin\view\Newsletter`
+- CLEANUP: usuniete `controls/Newsletter`, `view/Newsletter`
+- Testy: **OK (150 tests, 372 assertions)**
+
+---
+
+## ver. 0.256 (2026-02-12) - Layouts
+
+- NOWE: `Domain\Layouts\LayoutsRepository` (find, save, delete, listForAdmin, menusWithPages, categoriesTree)
+- NOWE: `admin\Controllers\LayoutsController` (DI)
+- UPDATE: lista `/admin/layouts/view_list/` migrowana na `components/table-list`
+- UPDATE: widok `layouts/layout-edit` korzysta z danych z repozytorium
+- NOWE: partial `admin/templates/layouts/subcategories-list.php`
+- UPDATE: `Domain\Languages\LanguagesRepository::defaultLanguageId()` jako wspolna metoda
+- UPDATE: `ArticlesController` korzysta z `LayoutsRepository` (DI)
+- CLEANUP: usuniete `controls/Layouts`, `view/Layouts`; `factory/Layouts` jako fasada
+- Testy: **OK (141 tests, 336 assertions)**
+
+---
+
+## ver. 0.255 (2026-02-12) - Languages DI cleanup
+
+- UPDATE: SettingsController, BannerController, DictionariesController, ArticlesController pobieraja liste jezykow przez `Domain/Languages/LanguagesRepository` (DI)
+- UPDATE: router DI przekazuje `LanguagesRepository` do kontrolerow
+- UPDATE: legacy `admin/controls`, `admin/factory/Shop*` przepiete na `LanguagesRepository`
+- FIX: `admin/factory/class.Languages.php` poprawione na `<?php` (short_open_tag=Off)
+- Testy: **OK (130 tests, 303 assertions)**
+
+---
+
+## ver. 0.254 (2026-02-12) - Languages
+
+- NOWE: `Domain\Languages\LanguagesRepository` (languages + translations CRUD/list)
+- NOWE: `admin\Controllers\LanguagesController` (DI)
+- UPDATE: widoki `languages/*` migrowane na `components/table-list` i `components/form-edit`
+- CLEANUP: usuniete `controls/Languages`, `view/Languages`; `factory/Languages` jako fasada
+- Testy: **OK (130 tests, 301 assertions)**
+
+---
+
+## ver. 0.253 (2026-02-12) - Users
+
+- NOWE: `Domain\User\UserRepository` (CRUD, logon, 2FA, checkLogin)
+- NOWE: `admin\Controllers\UsersController` (DI: view_list, user_edit, user_save, user_delete, login_form, twofa)
+- UPDATE: `admin\factory\Users` jako fasada; `admin/ajax/users.php` oparty o `UserRepository`
+- UPDATE: widoki users migrowane na `components/table-list` i `components/form-edit`
+- UPDATE: walidacja warunkowa: `twofa_email` wymagany gdy `twofa_enabled = 1`
+- CLEANUP: usuniete `controls/Users`, `factory/Users`, `view/Users`
+- Testy: **OK (119 tests, 256 assertions)**
+
+---
+
+## ver. 0.252 (2026-02-10) - ProductArchive + Filemanager
+
+- UPDATE: `ProductArchiveController` i szablony przepiete na `components/table-list`
+- UPDATE: CSS/JS dla list wydzielone do osobnych widoków `*-custom-script.php`
+- NOWE: `admin\Controllers\FilemanagerController` - przepieto filemanager na nowy routing
+- FIX: naprawiono błąd `Invalid Key` w filemanagerze
+- CLEANUP: usunieto legacy `controls/Archive`, `controls/Filemanager`, `view/FileManager`, stare szablony
+- RENAME: `admin/templates/product_archive/` → `admin/templates/product-archive/`
+- Testy: **OK (82 tests, 181 assertions)**
+
+---
+
+## ver. 0.251 (2026-02-09) - Dictionaries
+
+- NOWE: `Domain\Dictionaries\DictionariesRepository` (listForAdmin, find, save, delete, allUnits)
+- NOWE: `admin\Controllers\DictionariesController` (lista + formularz na nowych komponentach)
+- UPDATE: migracja słowników na `components/table-list` i `components/form-edit`
+- FIX: obsługa `lang_id` jako string (`pl`, `en`) w zapisie tłumaczeń
+- CLEANUP: usunięto legacy klasy Dictionaries (`admin\controls`, `admin\factory`, `front\factory`)
+- Testy: **OK (82 tests, 181 assertions)**
+
+---
+
+## ver. 0.250 (2026-02-09) - Settings (refaktoryzacja)
+
+- UPDATE: `Domain\Settings\SettingsRepository` ma bezpośredni dostęp do DB (bez delegacji do `admin\factory\Settings`)
+- UPDATE: przepięto użycia `admin\factory\Settings` na `Domain\Settings\SettingsRepository`
+- CLEANUP: usunięto legacy klasy Settings (`factory`, `controls`, `view`)
+- Testy: **OK (82 tests, 181 assertions)**
+
+---
+
+## ver. 0.246 (2026-02-07) - Articles legacy cleanup
+
+- CLEANUP: usunięto `autoload/admin/controls/class.Articles.php`
+- UPDATE: `admin\Controllers\ArticlesController::galleryOrderSave()` uzywa `ArticleRepository::saveGalleryOrder()`
+- FIX: sortowanie list admin po reloadzie - `RewriteRule` dla `/admin/...` ma `QSA`
+- FIX: generator `\S::htacces()` komentuje dyrektywy `AddHandler|SetHandler|ForceType`
+- Testy: **OK (65 tests, 131 assertions)**
+
+---
+
+## ver. 0.245 (2026-02-06) - Articles::archive
+
+- UPDATE: `Domain\Article\ArticleRepository` - dodano `archive()` (status = -1)
+- UPDATE: `admin\Controllers\ArticlesController` - nowa akcja `delete()` z DI
+- UPDATE: `admin\factory\Articles::articles_set_archive()` deleguje do repozytorium
+- Testy: **OK (59 tests, 123 assertions)**
+
+---
+
+## ver. 0.244 (2026-02-06) - Articles::save
+
+- UPDATE: `Domain\Article\ArticleRepository` - dodano `save()` z prywatnych helperow
+- UPDATE: `admin\Controllers\ArticlesController` - nowa akcja `save()` z DI
+- UPDATE: `tests/bootstrap.php` - dodano stub `S::seo()`
+- Testy: **OK (57 tests, 119 assertions)**
+
+---
+
+## ver. 0.243 (2026-02-06) - Articles cleanup
+
+- UPDATE: `Domain\Article\ArticleRepository` - dodano `deleteNonassignedImages()` i `deleteNonassignedFiles()`
+- UPDATE: `admin\Controllers\ArticlesController::edit()` uses repository cleanup methods
+- Testy: **OK (50 tests, 95 assertions)**
+
+---
+
+## ver. 0.242 (2026-02-06) - Articles::edit
+
+- NOWE: `Domain\Article\ArticleRepository` (find: artykuł + relacje)
+- UPDATE: `admin\Controllers\ArticlesController` - konstruktor DI + `edit()` używa repozytorium
+- UPDATE: `admin\factory\Articles::article_details()` deleguje do repozytorium
+- Testy: **OK (48 tests, 91 assertions)**
+
+---
+
+## ver. 0.241 (2026-02-06) - ProductArchive
+
+- NOWE: `admin\Controllers\ProductArchiveController` (DI)
+- NOWE: `ProductRepository::archive()`, `unarchive()`
+- RENAME: `admin/templates/archive/` → `admin/templates/product_archive/`
+- FIX: SQL w `ajax_products_list_archive()` (puste wyszukiwanie + brak `archive = 1`)
+- Testy: **OK (50 tests, 95 assertions)**
+
+---
+
+## ver. 0.240 (2026-02-05) - Settings + Cache
+
+- NOWE: `Domain\Settings\SettingsRepository` (fasada → factory)
+- NOWE: `Domain\Cache\CacheRepository` (dirs + Redis)
+- NOWE: `admin\Controllers\SettingsController` (DI: clearCache, save, view)
+- FIX: Brakujący `id="content"` w main-layout.php
+- FIX: `persist_edit = true` w settings.php
+- Testy: **OK (29 tests, 60 assertions)**
+
+---
+
+## ver. 0.239 (2026-02-05) - Banner + Product
+
+- NOWE: `Domain\Banner\BannerRepository` (find, delete, save)
+- NOWE: `admin\Controllers\BannerController` - pierwszy kontroler z DI
+- NOWE: Router z mapą `$newControllers` + fallback na stare kontrolery
+- NOWE: Autoloader PSR-4 fallback w 9 entry pointach
+- Zmigrowano: `get_product_price()` → `ProductRepository::getPrice()`
+- Zmigrowano: `get_product_name()` → `ProductRepository::getName()`
+- Testy: **OK (15 tests, 31 assertions)**
+
+---
+
+## ver. 0.238 (2025-02-05) - Product Repository
+
+- NOWE: `Domain\Product\ProductRepository` - pierwsza klasa w nowej architekturze
+- NOWE: Dependency Injection zamiast `global $mdb`
+- NOWE: Testy jednostkowe (5 testów, 100% pokrycie)
+- Zmigrowano: `get_product_quantity()` → `ProductRepository::getQuantity()`
+- Kompatybilność: Stara klasa `shop\Product` działa jako fasada
+
+---
+
+## ver. 0.237 (2025-02-05) - System cache produktów
+
+- Automatyczne czyszczenie cache produktu po aktualizacji przez CRON
+- AJAX dla przycisku "Wyczyść cache" w panelu admin
+- Metody `delete()` i `deletePattern()` w CacheHandler
+- Metoda `clear_product_cache()` w klasie S
+
+---
+*Dokument aktualizowany: 2026-02-14*