refactor(shop_category): migrate admin module to Domain+DI with routing and ajax cleanup

2026-02-15 15:32:23 +01:00
parent c99b42af68
commit d0747b3e0a
63 changed files with 8998 additions and 625 deletions
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -4,6 +4,25 @@ Logi zmian z migracji na Domain-Driven Architecture. Najnowsze na gorze.

 ---

+## ver. 0.275 (2026-02-15) - ShopCategory
+
+- **ShopCategory** - migracja `/admin/shop_category/*` na Domain + DI + nowe endpointy AJAX
+  - NOWE: `Domain\Category\CategoryRepository` (`sortTypes`, `subcategories`, `categoryDetails`, `categoryProducts`, `save`, `categoryDelete`, `saveCategoriesOrder`, `saveProductOrder`, `categoryTitle`)
+  - NOWE: `admin\Controllers\ShopCategoryController` (DI) z akcjami `list/view_list`, `edit/category_edit`, `save`, `delete/category_delete`, `products/category_products`, `category_url_browser`, `save_categories_order`, `save_products_order`, `cookie_categories`
+  - UPDATE: routing DI (`admin\Site`) rozszerzony o modul `ShopCategory`
+  - UPDATE: menu admin przepiete na kanoniczny URL `/admin/shop_category/list/`
+  - UPDATE: widoki `shop-category/*` - wydzielenie skryptow do `*-custom-script.php`, ujednolicone strzalki drzewa (`button + caret + aria-expanded`)
+  - UPDATE: AJAX drzewek przepiety z `/admin/ajax.php?a=*` na `/admin/shop_category/*`
+  - UPDATE: zaleznosci `ShopProduct` przepiete z `admin\factory\ShopCategory` na `Domain\Category\CategoryRepository`
+  - CLEANUP: usuniete legacy `autoload/admin/controls/class.ShopCategory.php`, `autoload/admin/factory/class.ShopCategory.php`, `autoload/admin/view/class.ShopCategory.php`
+  - CLEANUP: usuniety preload `class.ShopCategory.php` z `libraries/grid/config.php`
+- TEST:
+  - NOWE: `tests/Unit/Domain/Category/CategoryRepositoryTest.php`
+  - NOWE: `tests/Unit/admin/Controllers/ShopCategoryControllerTest.php`
+  - Testy punktowe: **OK (16 tests, 72 assertions)**
+
+---
+
 ## ver. 0.274 (2026-02-15) - ShopProduct mass_edit + UI trees

 - **ShopProduct (mass_edit)** - migracja akcji masowej edycji na Domain + DI
--- a/docs/DATABASE_STRUCTURE.md
+++ b/docs/DATABASE_STRUCTURE.md
@@ -57,6 +57,42 @@ Przypisanie produktów do kategorii.

 **Aktualizacja 2026-02-15 (ver. 0.274):** akcje `/admin/shop_product/mass_edit/*` korzystają z `Domain\Product\ProductRepository` przez `admin\Controllers\ShopProductController`.

+## pp_shop_categories
+Kategorie sklepu.
+
+| Kolumna | Opis |
+|---------|------|
+| id | PK |
+| parent_id | FK do kategorii nadrzednej (NULL dla root) |
+| status | 1 = aktywna, 0 = nieaktywna |
+| o | Kolejnosc wyswietlania |
+| sort_type | Typ sortowania produktow w kategorii |
+| view_subcategories | Czy wyswietlac podkategorie |
+
+**Uzywane w:** `Domain\Category\CategoryRepository`, `admin\Controllers\ShopCategoryController`.
+
+## pp_shop_categories_langs
+Tlumaczenia kategorii (per jezyk).
+
+| Kolumna | Opis |
+|---------|------|
+| category_id | FK do pp_shop_categories |
+| lang_id | ID jezyka (np. pl, en) |
+| title | Nazwa kategorii |
+| text | Opis kategorii |
+| text_hidden | Rozwiniecie opisu kategorii |
+| seo_link | Link SEO kategorii |
+| meta_title | Meta title |
+| meta_description | Meta description |
+| meta_keywords | Meta keywords |
+| noindex | Flaga noindex |
+| category_title | Naglowek H1 kategorii |
+| additional_text | Dodatkowy tekst nad lista produktow |
+
+**Uzywane w:** `Domain\Category\CategoryRepository`, `admin\Controllers\ShopCategoryController`.
+
+**Aktualizacja 2026-02-15 (ver. 0.275):** modul `/admin/shop_category/*` korzysta z `Domain\Category\CategoryRepository` przez `admin\Controllers\ShopCategoryController`; usunieto legacy `admin\controls/factory/view\ShopCategory`.
+
 ## pp_shop_orders
 Zamówienia sklepu (źródło danych dla list i szczegółów klientów w panelu admin).

--- a/docs/PROJECT_STRUCTURE.md
+++ b/docs/PROJECT_STRUCTURE.md
@@ -324,5 +324,15 @@ Pelna dokumentacja testow: `TESTING.md`
  - `admin/templates/pages/pages-list.php` + `admin/templates/pages/subpages-list.php`
  - `admin/templates/articles/subpages-list.php` + `admin/templates/articles/article-edit-custom-script.php`

+## Dodatkowa aktualizacja 2026-02-15 (ver. 0.275)
+- Dodano modul domenowy `Domain/Category/CategoryRepository.php`.
+- Dodano kontroler DI `admin/Controllers/ShopCategoryController.php`.
+- Modul `/admin/shop_category/*` dziala przez DI i kanoniczny URL `/admin/shop_category/list/` (z zachowaniem aliasu `view_list`).
+- Widoki `shop-category/*` maja wydzielone skrypty `*-custom-script.php` i ujednolicone strzalki drzewa (`button + caret + aria-expanded`).
+- Endpointy AJAX dla drzewka kategorii i kolejnosci produktow przepiete na `/admin/shop_category/save_categories_order/`, `/admin/shop_category/save_products_order/`, `/admin/shop_category/cookie_categories/`.
+- Usunieto legacy: `autoload/admin/controls/class.ShopCategory.php`, `autoload/admin/factory/class.ShopCategory.php`, `autoload/admin/view/class.ShopCategory.php`.
+- Przepieto zaleznosci `ShopProduct` z `admin\factory\ShopCategory` na `Domain\Category\CategoryRepository`.
+- Usunieto preload `autoload/admin/factory/class.ShopCategory.php` z `libraries/grid/config.php`.
+
 ---
 *Dokument aktualizowany: 2026-02-15*
--- a/docs/REFACTORING_PLAN.md
+++ b/docs/REFACTORING_PLAN.md
@@ -155,6 +155,7 @@ grep -r "Product::getQuantity" .
 | 24 | ShopProducer | 0.273 | listForAdmin, find, save, delete, allProducers, producerProducts, fasada shop\Producer, DI kontroler |
 | 25 | ShopProduct (mass_edit) | 0.274 | DI kontroler + routing dla `mass_edit`, `mass_edit_save`, `get_products_by_category`, cleanup legacy akcji |
 | 26 | ShopClients | 0.274 | DI kontroler + routing dla `list/details`, nowe listy na `components/table-list`, cleanup legacy controls/factory |
+| 27 | ShopCategory | 0.275 | CategoryRepository + DI kontroler + routing, endpointy AJAX (`save_categories_order`, `save_products_order`, `cookie_categories`), cleanup legacy controls/factory/view |

 ### Product - szczegolowy status
 - ✅ getQuantity (ver. 0.238)
@@ -170,16 +171,14 @@ grep -r "Product::getQuantity" .

 ### 📋 Do zrobienia
 - Order
- Category
 - ShopProduct (factory)

 ## Kolejność refaktoryzacji (priorytet)

-1-26: ✅ Cache, Product, Banner, Settings, Dictionaries, ProductArchive, Filemanager, Users, Pages, Integrations, ShopPromotion, ShopCoupon, ShopStatuses, ShopPaymentMethod, ShopTransport, ShopAttribute, ShopProductSets, ShopProducer, ShopProduct (mass_edit), ShopClients
+1-27: ✅ Cache, Product, Banner, Settings, Dictionaries, ProductArchive, Filemanager, Users, Pages, Integrations, ShopPromotion, ShopCoupon, ShopStatuses, ShopPaymentMethod, ShopTransport, ShopAttribute, ShopProductSets, ShopProducer, ShopProduct (mass_edit), ShopClients, ShopCategory

 Nastepne:
-27. **Order**
-28. **Category**
+28. **Order**

 ## Form Edit System

--- a/docs/TESTING.md
+++ b/docs/TESTING.md
@@ -44,9 +44,16 @@ Aktualizacja po migracji ShopClients (2026-02-15, ver. 0.274) - testy punktowe:
 OK (10 tests, 34 assertions)
 ```

+Aktualizacja po migracji ShopCategory (2026-02-15, ver. 0.275) - testy punktowe:
+```text
+OK (16 tests, 72 assertions)
+```
+
 Nowe testy dodane 2026-02-15:
 - `tests/Unit/Domain/Client/ClientRepositoryTest.php`
 - `tests/Unit/admin/Controllers/ShopClientsControllerTest.php`
+- `tests/Unit/Domain/Category/CategoryRepositoryTest.php`
+- `tests/Unit/admin/Controllers/ShopCategoryControllerTest.php`

 ## Struktura testow

@@ -60,6 +67,7 @@ tests/
 |   |   |-- Banner/BannerRepositoryTest.php
 |   |   |-- Cache/CacheRepositoryTest.php
 |   |   |-- Coupon/CouponRepositoryTest.php
+|   |   |-- Category/CategoryRepositoryTest.php
 |   |   |-- Dictionaries/DictionariesRepositoryTest.php
 |   |   |-- Integrations/IntegrationsRepositoryTest.php
 |   |   |-- PaymentMethod/PaymentMethodRepositoryTest.php
@@ -79,6 +87,7 @@ tests/
 |           |-- ProductArchiveControllerTest.php
 |           |-- SettingsControllerTest.php
 |           |-- ShopAttributeControllerTest.php
+|           |-- ShopCategoryControllerTest.php
 |           |-- ShopCouponControllerTest.php
 |           |-- ShopPaymentMethodControllerTest.php
 |           |-- ShopProducerControllerTest.php