feat(108): delivery status management

Phase 108 complete (v3.2 milestone):

Plan 108-01 — Delivery Status DB & CRUD:
- Tabela delivery_statuses z seedem 11 statusow systemowych
- DeliveryStatusRepository (CRUD + per-request static cache)
- DeliveryStatus::setRepository() — DB fallback dla static final class
- Panel /settings/delivery-statuses (zakladki Statusy + Mapowanie)
- Sidebar przebudowany: Statusy zamowien + Statusy przesylek

Plan 108-02 — Automation Dropdowns z DB + UI Refactor:
- Dropdowny automatyzacji ladowane z DB (warunek shipment_status + akcja update_shipment_status)
- Walidacja przez DeliveryStatus::getAllStatuses()
- Osobna podstrona formularza CRUD (delivery-status-form.php)
- Lista uproszczona: rename Terminal -> Koncowy, usunieta kolumna Typ
- BREAKING: drop backward compat dla starych grupowych kluczy automatyzacji
- Bug fix: path params w DeliveryStatusesController via \$request->input('id')

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

.paul/docs/ARCHITECTURE.md

@@ -1,3 +1,28 @@
 # ARCHITECTURE
 
 > Struktura klas, modulow, przeplywow i zaleznosci w projekcie.
+
+## Phase 108 — Delivery Status Management
+
+### DeliveryStatusRepository (`src/Modules/Shipments/DeliveryStatusRepository.php`)
+- CRUD dla tabeli `delivery_statuses`
+- Per-request static cache (`private static ?array $cache`)
+- Blokuje edycję/usunięcie statusów systemowych (`is_system=1`)
+- Blokuje usunięcie statusów używanych w `delivery_status_mappings` lub `shipment_packages`
+
+### DeliveryStatusesController (`src/Modules/Settings/DeliveryStatusesController.php`)
+- Panel `/settings/delivery-statuses`
+- Dwie zakładki via `?tab=` param: `statuses` (CRUD) i `mapping` (embed mapowania)
+- Wstrzykuje `DeliveryStatusRepository` i `DeliveryStatusMappingRepository`
+
+### DeliveryStatus::setRepository() (dynamic loading)
+- Wywoływane raz w `routes/web.php` po bootstrap
+- `label()`, `getAllOptions()`, `getAllStatuses()`, `getColor()` ladują z DB gdy repo ustawione
+- Fallback na hardcoded stałe gdy repo niedostępne
+
+### AutomationController + AutomationService (Phase 108 Plan 02)
+- `AutomationController::buildShipmentStatusOptions()` — buduje listę opcji `[key => ['label' => ...]]` z `DeliveryStatus::getAllOptions()` (DB-driven)
+- Walidacja `shipment_status` warunku i `update_shipment_status` akcji w `parseConditionValue()`/`parseActionConfig()` używa `DeliveryStatus::getAllStatuses()`
+- `AutomationService::evaluateShipmentStatusCondition()` — bezpośrednie porównanie kluczy DB (usunięto mapping grupowy `SHIPMENT_STATUS_OPTION_MAP`)
+- `AutomationService::resolveStatusFromActionKey()` — bezpośredni klucz statusu z DB jako target
+- BREAKING: stare reguły z grupowymi kluczami (`registered`, `courier_pickup`, `dropped_at_point`, `unclaimed`, `picked_up_return`) nie matchują się — operator musi je odtworzyć przy użyciu nowych kluczy DB

.paul/docs/DB_SCHEMA.md

@@ -1,3 +1,21 @@
 # DB_SCHEMA
 
 > Schemat bazy danych — tabele, kolumny, FK, indeksy.
+
+## delivery_statuses
+
+Tabela znormalizowanych statusów przesyłek. Zastępuje hardcoded stałe z `DeliveryStatus.php` (od Phase 108).
+
+| Kolumna | Typ | Opis |
+|---------|-----|------|
+| id | INT UNSIGNED PK | Auto-increment |
+| key | VARCHAR(50) UNIQUE | Klucz statusu (np. `in_transit`) |
+| label_pl | VARCHAR(100) | Etykieta po polsku |
+| color | VARCHAR(7) | Kolor tła w formacie hex (`#rrggbb`) |
+| sort_order | TINYINT UNSIGNED | Kolejność sortowania |
+| is_terminal | TINYINT(1) | 1 = status końcowy (nie można cofnąć) |
+| is_system | TINYINT(1) | 1 = status systemowy (nieedytowalny z UI) |
+| created_at | DATETIME | Data utworzenia |
+
+**Statusy systemowe** (is_system=1, is_terminal=1): `delivered`, `returned`, `cancelled`.
+**Migracja**: `20260427_000103_create_delivery_statuses_table.sql`

.paul/docs/TECH_CHANGELOG.md

@@ -1,3 +1,31 @@
 # TECH_CHANGELOG
 
 > Chronologiczny log zmian technicznych — co i dlaczego.
+
+## 2026-04-27 — Phase 108 Plan 02: Automation Dropdowns z DB
+
+**Co zrobiono:**
+- `AutomationController` — usunięto stałą `SHIPMENT_STATUS_OPTIONS` (8 grupowych kluczy)
+- Dropdown statusów w warunku `shipment_status` i akcji `update_shipment_status` ładuje statusy z DB przez `DeliveryStatus::getAllOptions()`
+- Walidacja w `parseConditionValue()` i `parseActionConfig()` używa `DeliveryStatus::getAllStatuses()`
+- `AutomationService` — usunięto stałą `SHIPMENT_STATUS_OPTION_MAP`; ewaluacja `evaluateShipmentStatusCondition()` porównuje klucze bezpośrednio
+- `resolveStatusFromActionKey()` — bezpośredni klucz statusu z DB jako target (zamiast pierwszego z grupy)
+
+**Dlaczego:**
+- Zamknięcie integracji z Plan 01 — operator dodaje status w `/settings/delivery-statuses` i jest on od razu dostępny w dropdownach automatyzacji bez deploymentu
+- Eliminacja kolizji semantycznej: stary klucz grupowy `picked_up` mapował na `delivered` (paczka odebrana przez klienta), nowy klucz DB `picked_up` to "Odebrana przez kuriera" (od nadawcy)
+- BREAKING: stare reguły z grupowymi kluczami (`registered`, `courier_pickup`, `dropped_at_point`, `unclaimed`, `picked_up_return`, oraz `picked_up`/`ready_for_pickup`/`cancelled` w starym znaczeniu) nie matchują — wymagają ręcznego odtworzenia z nowymi kluczami DB
+
+## 2026-04-27 — Phase 108 Plan 01: Delivery Status Management
+
+**Co zrobiono:**
+- Tabela `delivery_statuses` z seedem 11 statusów (migracja `20260427_000103`)
+- `DeliveryStatusRepository` — CRUD + per-request cache
+- `DeliveryStatus.php` — dynamiczne ładowanie statusów z DB (`setRepository()`)
+- Panel `/settings/delivery-statuses` z CRUD (zakładka "Statusy") i mapowaniem (zakładka "Mapowanie dostawy")
+- Sidebar: "Statusy" → "Statusy zamówień", nowe "Statusy przesyłek" z badge niezmapowanych
+- Badge przesyłek: inline CSS custom property `--status-color` dla niestandardowych statusów
+
+**Dlaczego:**
+- Dodanie nowego statusu wymagało zmiany kodu + deploymentu; teraz z UI
+- Operator może definiować własne statusy znormalizowane bez ingerencji w kod