docs: update API.md, CHANGELOG, PROJECT_STRUCTURE for categories/list endpoint

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

docs/API.md

@@ -440,6 +440,38 @@ Odpowiedz:
 }
 ```
 
+### Kategorie
+
+#### Lista kategorii
+```
+GET api.php?endpoint=categories&action=list
+```
+
+Zwraca plaska liste wszystkich aktywnych kategorii w domyslnym jezyku sklepu.
+
+Odpowiedz:
+```json
+{
+  "status": "ok",
+  "data": {
+    "categories": [
+      {"id": 1, "parent_id": null, "title": "Kategoria glowna"},
+      {"id": 3, "parent_id": 1, "title": "Podkategoria A"},
+      {"id": 5, "parent_id": 1, "title": "Podkategoria B"}
+    ]
+  }
+}
+```
+
+Pola odpowiedzi:
+| Pole | Typ | Opis |
+|------|-----|------|
+| `id` | int | ID kategorii |
+| `parent_id` | int\|null | ID kategorii nadrzednej (null = kategoria glowna) |
+| `title` | string | Nazwa w domyslnym jezyku; fallback na inny jezyk jesli brak tlumaczenia |
+
+---
+
 ### Slowniki
 
 #### Lista statusow zamowien
@@ -549,3 +581,4 @@ UPDATE pp_settings SET value = 'twoj-klucz-api' WHERE param = 'api_key';
   - `OrdersApiController` — zamowienia (5 akcji)
   - `ProductsApiController` — produkty (8 akcji: list, get, create, update, variants, create_variant, update_variant, delete_variant)
   - `DictionariesApiController` — slowniki (5 akcji: statuses, transports, payment_methods, attributes, ensure_producer)
+  - `CategoriesApiController` — kategorie (1 akcja: list)

docs/CHANGELOG.md

@@ -4,6 +4,14 @@ Logi zmian z migracji na Domain-Driven Architecture. Najnowsze na gorze.
 
 ---
 
+## ver. 0.326 (2026-02-27) - API: endpoint categories/list
+
+- **NEW**: `api\Controllers\CategoriesApiController` — nowy kontroler API z akcją `list`
+- **NEW**: Endpoint `GET api.php?endpoint=categories&action=list` — zwraca płaską listę aktywnych kategorii (id, parent_id, title) w domyślnym języku sklepu
+- **FIX**: Usunięto zbędny parametr w `CategoryRepository`, eliminacja N+1 queries w categories/list przez bulk-fetch tytułów
+
+---
+
 ## ver. 0.325 (2026-02-27) - Fix changelog encoding + limit wyświetlania
 
 - **FIX**: `updates/changelog.php` — naprawione krzaczki (mojibake) w polskich znakach; dane odbudowane z plików manifest

docs/PROJECT_STRUCTURE.md

@@ -85,6 +85,7 @@ REST API dla ordersPRO. Entry point: `api.php`. Stateless (bez sesji), autentyka
 - `OrdersApiController` — lista, szczegoly, zmiana statusu, platnosc (5 akcji)
 - `ProductsApiController` — lista, szczegoly, tworzenie, aktualizacja produktow (4 akcje)
 - `DictionariesApiController` — statusy, transporty, metody platnosci (3 akcje)
+- `CategoriesApiController` — lista aktywnych kategorii (1 akcja)
 
 Dokumentacja: `docs/API.md`