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>
This commit is contained in:
@@ -12,8 +12,8 @@ Sprzedawca może obsługiwać zamówienia ze wszystkich kanałów
|
||||
|
||||
| Attribute | Value |
|
||||
|-----------|-------|
|
||||
| Version | 3.1.0 |
|
||||
| Status | v3.1 shipped — all phases complete |
|
||||
| Version | 3.2.0 |
|
||||
| Status | v3.2 shipped — Delivery Status Management complete |
|
||||
| Last Updated | 2026-04-27 |
|
||||
|
||||
## Requirements
|
||||
@@ -111,6 +111,7 @@ Sprzedawca może obsługiwać zamówienia ze wszystkich kanałów
|
||||
- [x] Wersja mobilna — modul po module (v3.0) — shipped across phases 52–105
|
||||
- [x] Alert o kliencie z historia zwrotow: badge w liscie zamowien (kolumna buyer) + czerwony banner u gory szczegolow zamowienia; matching OR po email/phone/name; `<details>` z lista zwroconych zamowien — Phase 106
|
||||
- [x] Idempotentna jednorazowa wysylka e-mail per zamowienie: tabela deduplikacji `automation_email_once_deliveries` (UNIQUE KEY rule_id+action_id+order_id), checkbox "Wyslij tylko raz" w konfiguracji akcji, markSent() tylko po sukcesie — Phase 107
|
||||
- [x] Delivery Status Management: tabela `delivery_statuses` z CRUD panelem `/settings/delivery-statuses`, `DeliveryStatus::setRepository()` z DB fallbackiem, integracja DB-driven w dropdownach automatyzacji (warunek shipment_status + akcja update_shipment_status), osobna podstrona formularza CRUD (BREAKING: drop backward compat dla starych grupowych kluczy automatyzacji) — Phase 108
|
||||
|
||||
### Deferred
|
||||
|
||||
@@ -193,6 +194,9 @@ PHP (XAMPP/Laravel), integracje z API marketplace'Ăłw (Allegro, Erli) oraz API
|
||||
| Statistics netto fallback `ROUND(gross / 1.23, 2)` gdy `total_without_tax` puste | shopPRO nie wysyla netto ani w zamowieniu ani w `order_items`; tymczasowy fallback — docelowy fix w `.paul/TODO.md` (STAT-NET) | 2026-04-19 | Active |
|
||||
| ON DUPLICATE KEY UPDATE created_at = created_at dla idempotentnego markSent() | Unikniece silent failure i race condition przy rownolegych cronach; thread-safe bez wyjatkow | 2026-04-25 | Active |
|
||||
| send_once_per_order opt-in przez checkbox (domyslnie off) | Wsteczna zgodnosc — istniejace reguly nie zmieniaja zachowania; markSent() tylko po sukcesie wysylki | 2026-04-25 | Active |
|
||||
| DeliveryStatus::setRepository() pattern: DB fallback dla static final class | Operator dodaje status w UI bez zmian kodu; `getAllOptions()`/`label()`/`getColor()` ladują z DB gdy repo ustawione, fallback na hardcoded ALL_STATUSES/LABEL_PL | 2026-04-27 | Active |
|
||||
| Drop backward compat dla starych grupowych kluczy automatyzacji (Phase 108-02) | Kolizja semantyczna: stary `picked_up` mapował na `delivered`, nowy klucz DB `picked_up` to "Odebrana przez kuriera" — odwrotne końce cyklu. Hybrid evaluation by silently dawała wrong matches | 2026-04-27 | Active |
|
||||
| Path params w controllerach via `$request->input('id')` (nie jako argumenty metody) | Konwencja routera projektu: handler wywoływany z jednym argumentem `$request`, params siedzą jako attributes — `ReceiptController::show()` jako wzorzec | 2026-04-27 | Active |
|
||||
|
||||
## Success Metrics
|
||||
|
||||
@@ -224,6 +228,6 @@ Quick Reference:
|
||||
|
||||
---
|
||||
*PROJECT.md — Updated when requirements or context change*
|
||||
*Last updated: 2026-04-27 after v3.1 Operational Enhancements milestone completion (Phase 107 Automation Email Send Once)*
|
||||
*Last updated: 2026-04-27 after v3.2 Delivery Status Management milestone completion (Phase 108)*
|
||||
|
||||
|
||||
|
||||
@@ -6,7 +6,7 @@ orderPRO to narzedzie do wielokanalowego zarzadzania sprzedaza. Projekt przechod
|
||||
|
||||
## Current Milestone
|
||||
|
||||
Brak aktywnego milestone — v3.1 zamkniety. Nastepny milestone do zaplanowania.
|
||||
Brak aktywnego milestone — v3.2 zamkniety. Nastepny milestone do zaplanowania.
|
||||
|
||||
## Next Milestone
|
||||
|
||||
@@ -19,6 +19,19 @@ Kandydaci w kolejce:
|
||||
|
||||
## Completed Milestones
|
||||
|
||||
<details>
|
||||
<summary>v3.2 Delivery Status Management - 2026-04-27 (1 phase, 2 plans)</summary>
|
||||
|
||||
Wyniesienie znormalizowanych statusow przesylek do tabeli DB z CRUD panelem oraz pelna integracja DB-driven w dropdownach automatyzacji.
|
||||
|
||||
| Phase | Name | Plans | Status |
|
||||
|-------|------|-------|--------|
|
||||
| 108 | Delivery Status Management | 2/2 | Complete |
|
||||
|
||||
Archive: `.paul/phases/108-delivery-status-management/`
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>v3.1 Operational Enhancements - 2026-04-27 (2 phases, 2 plans)</summary>
|
||||
|
||||
@@ -415,4 +428,4 @@ Archive: `.paul/milestones/v0.1-ROADMAP.md`
|
||||
|
||||
---
|
||||
*Roadmap created: 2026-03-12*
|
||||
*Last updated: 2026-04-19 - v3.0 Mobile Responsive milestone closed (52 phases shipped, 55 plans; phase 68 deferred, phase 99 cancelled)*
|
||||
*Last updated: 2026-04-27 - v3.2 Delivery Status Management milestone closed (Phase 108, 2 plans)*
|
||||
|
||||
@@ -5,47 +5,55 @@
|
||||
See: .paul/PROJECT.md (updated 2026-04-27)
|
||||
|
||||
**Core value:** Sprzedawca moze obslugiwac zamowienia ze wszystkich kanalow sprzedazy i nadawac przesylki bez przelaczania sie miedzy platformami.
|
||||
**Current focus:** v3.1 Operational Enhancements — COMPLETE. Oczekiwanie na kolejny milestone.
|
||||
**Current focus:** Brak aktywnego milestone — v3.2 zamkniety
|
||||
|
||||
## Current Position
|
||||
|
||||
Milestone: v3.1 Operational Enhancements — COMPLETE
|
||||
Phase: 107 of 107 (Automation Email Send Once) — Complete
|
||||
Plan: 107-01 — Unified
|
||||
Version: 3.1.0
|
||||
Status: Milestone zamkniety, gotowy do planowania kolejnego milestone
|
||||
Milestone: v3.2 — COMPLETE (Delivery Status Management)
|
||||
Phase: 108 of 108 — COMPLETE
|
||||
Plan: 108-01 — COMPLETE / 108-02 — COMPLETE
|
||||
Version: 3.2.0
|
||||
Status: v3.2 shipped — gotowy do nastepnego milestone
|
||||
|
||||
Last activity: 2026-04-27 — UNIFY phase 107, milestone v3.1 closed
|
||||
Last activity: 2026-04-27 — TRANSITION Phase 108 / v3.2 milestone complete
|
||||
|
||||
Progress:
|
||||
- Milestone: [##########] 100%
|
||||
- Phase 107: [##########] 100%
|
||||
- Milestone v3.2: [##########] 100% (1/1 phases, 2/2 plans)
|
||||
|
||||
## Loop Position
|
||||
|
||||
Current loop state:
|
||||
```
|
||||
PLAN --> APPLY --> UNIFY
|
||||
[x] [x] [x] [Loop complete — milestone complete]
|
||||
v3.2 milestone:
|
||||
Phase 108 (Delivery Status Management):
|
||||
Plan 108-01: PLAN ✓ APPLY ✓ UNIFY ✓
|
||||
Plan 108-02: PLAN ✓ APPLY ✓ UNIFY ✓
|
||||
→ Phase 108 closed
|
||||
→ v3.2 milestone closed
|
||||
```
|
||||
|
||||
## Session Continuity
|
||||
|
||||
Last session: 2026-04-27
|
||||
Stopped at: Milestone v3.1 complete — wszystkie fazy zamkniete
|
||||
Next action: /paul:milestone — zaplanuj kolejny milestone (v3.2)
|
||||
Stopped at: v3.2 milestone closed
|
||||
Next action: /paul:milestone — wybor i zaplanowanie nastepnego milestone
|
||||
Resume file: .paul/ROADMAP.md
|
||||
|
||||
## Pending Actions
|
||||
|
||||
- Uruchom migracje gdy XAMPP online: `php bin/migrate.php` (delivery_statuses)
|
||||
- Recznie odtworzyc istniejace reguly automatyzacji z grupowymi kluczami (BREAKING z 108-02)
|
||||
|
||||
## Deferred to Next Milestones
|
||||
|
||||
- Phase 68 - Code Deduplication Refactor (0/2 Planning, nigdy nie rozpoczety)
|
||||
- STAT-NET - netto shopPRO z API lub z `order_items.tax_rate` (`.paul/TODO.md`)
|
||||
- Mobile Orders List / Mobile Order Details / Mobile Settings (TBD z poprzedniego roadmapu)
|
||||
- sonar-scanner - skan dla phase 105, 106, 107 nie zostal uruchomiony (skill gap odnotowany)
|
||||
- sonar-scanner - skan dla phase 105, 106, 107, 108 nie zostal uruchomiony (skill gap odnotowany)
|
||||
- INDEX-106-01 - indeksy DB dla query `customer_returned_count`: `order_addresses(order_id, address_type)`, `shipment_packages(order_id, delivery_status)` (gdy dataset >50k wierszy)
|
||||
|
||||
## Skill Audit (Phase 107)
|
||||
## Skill Audit (Phase 108)
|
||||
|
||||
| Expected | Invoked | Notes |
|
||||
|----------|---------|-------|
|
||||
| sonar-scanner (required) | o | Nie uruchomiony — odlozony analogicznie do Phase 105/106 |
|
||||
| sonar-scanner (required) | o | Wymagany po APPLY 108-01 i 108-02 — odlozony |
|
||||
|
||||
43
.paul/changelog/2026-04-27.md
Normal file
43
.paul/changelog/2026-04-27.md
Normal file
@@ -0,0 +1,43 @@
|
||||
# 2026-04-27
|
||||
|
||||
## Co zrobiono
|
||||
|
||||
- [Phase 108, Plan 01] Wyniesiono znormalizowane statusy przesyłek do tabeli DB z CRUD panelem i dynamicznym ładowaniem
|
||||
- Migracja `20260427_000103_create_delivery_statuses_table.sql` — tabela delivery_statuses z seedem 11 statusów systemowych
|
||||
- Nowy `DeliveryStatusRepository` — CRUD + per-request static cache, blokady systemowych i używanych statusów
|
||||
- `DeliveryStatus::setRepository()` — transparent DB loading: label(), getAllOptions(), getColor() z DB, fallback na stałe
|
||||
- Nowy panel `/settings/delivery-statuses` z zakładkami: Statusy (CRUD niebędacych systemowych) + Mapowanie dostawy (embedded)
|
||||
- Sidebar przebudowany: "Statusy" → "Statusy zamówień", nowa pozycja "Statusy przesyłek" z badge niezmapowanych; usunięto osobną pozycję "Mapowanie statusów dostawy"
|
||||
- Badge przesyłek: system statuses → CSS class; custom statuses → `.delivery-badge--custom` + CSS custom property `--status-color`
|
||||
|
||||
- [Phase 108, Plan 02] Domknięcie integracji DB-driven statusów dla automatyzacji + refaktor UI listy
|
||||
- `AutomationController` — usunięto stałą `SHIPMENT_STATUS_OPTIONS`; dropdown z `DeliveryStatus::getAllOptions()`
|
||||
- `AutomationService` — usunięto `SHIPMENT_STATUS_OPTION_MAP`; ewaluacja porównuje klucze bezpośrednio (BREAKING dla starych reguł)
|
||||
- Walidacja shipment_status / update_shipment_status przez `DeliveryStatus::getAllStatuses()`
|
||||
- Nowa podstrona `/settings/delivery-statuses/new` i `/{id}/edit` — osobny formularz CRUD zamiast inline edit row
|
||||
- Lista statusów: rename "Terminal" → "Końcowy", usunięta kolumna "Typ" (badge systemowy)
|
||||
- Bug fix: path params w `DeliveryStatusesController::edit/update/destroy` przez `$request->input('id')` (pre-existing z Plan 01)
|
||||
|
||||
## Zmienione pliki
|
||||
|
||||
- `database/migrations/20260427_000103_create_delivery_statuses_table.sql`
|
||||
- `src/Modules/Shipments/DeliveryStatusRepository.php`
|
||||
- `src/Modules/Settings/DeliveryStatusesController.php`
|
||||
- `resources/views/settings/delivery-statuses.php`
|
||||
- `resources/views/settings/_delivery-status-mappings-content.php`
|
||||
- `src/Modules/Shipments/DeliveryStatus.php`
|
||||
- `src/Modules/Settings/DeliveryStatusMappingController.php`
|
||||
- `resources/views/settings/delivery-status-mappings.php`
|
||||
- `resources/views/layouts/app.php`
|
||||
- `resources/scss/modules/_delivery-status.scss`
|
||||
- `public/assets/css/app.css`
|
||||
- `resources/lang/pl.php`
|
||||
- `resources/views/orders/show.php`
|
||||
- `resources/views/shipments/prepare.php`
|
||||
- `.paul/docs/DB_SCHEMA.md`
|
||||
- `.paul/docs/ARCHITECTURE.md`
|
||||
- `.paul/docs/TECH_CHANGELOG.md`
|
||||
- `src/Modules/Automation/AutomationController.php`
|
||||
- `src/Modules/Automation/AutomationService.php`
|
||||
- `routes/web.php`
|
||||
- `resources/views/settings/delivery-status-form.php`
|
||||
@@ -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
|
||||
|
||||
@@ -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`
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -89,3 +89,101 @@
|
||||
{"ts":"2026-04-27T12:55:15Z","tool":"Bash","cmd":"cd \"C:/visual studio code/projekty/orderPRO\" && python tools/generowanie/email_message_fetcher.py --email \"kozix_x@onet.pl\" --days 60 --json 2>/dev/null | head -50\",\"description\":\"Sprawdź mai","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T12:55:46Z","tool":"Bash","cmd":"cd \"C:/visual studio code/projekty/orderPRO\" && PYTHONIOENCODING=utf-8 python tools/generowanie/pudelko_komunia_dziewczynka.py \\\\\\n --klient \"Natalia Barczyk\" \\\\\\n --imie \"Oliwii\" \\\\\\","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T12:55:57Z","tool":"Bash","cmd":"\"C:/xampp/mysql/bin/mysql.exe\" --default-character-set=utf8mb4 -h host700513.hostido.net.pl -P 3306 -u host700513_orderpro -phrDNtUBg9grwZ7syN77S host700513_orderpro -e \"UPDATE order_items SET proj","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:10:36Z","tool":"Bash","cmd":"git log --oneline -10\",\"description\":\"Recent commits\"},\"tool_response\":{\"stdout\":\"5aca417 update\\n32d7ae9 update\\n34dac15 update\\nf5c5201 chore: move TODO to .paul/codebase/todo.md\\nc3b6","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:10:45Z","tool":"Bash","cmd":"git show --stat 5aca417 && git show --stat 32d7ae9 && git show --stat 34dac15\",\"description\":\"Show changed files in last 3 commits\"},\"tool_response\":{\"stdout\":\"commit 5aca41750ca5b34c5b6d816","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:16:17Z","tool":"Bash","cmd":"git log --oneline --since=\"2026-04-25\" | head -20\",\"description\":\"Commits since plan creation\"},\"tool_response\":{\"stdout\":\"5aca417 update\\n32d7ae9 update\\n34dac15 update\\nf5c5201 chore:","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:16:22Z","tool":"Bash","cmd":"git log --all --oneline --since=\"2026-04-24\" --until=\"2026-04-26\" -- \"src/Modules/Automation/*\" \"database/migrations/*\" \"tests/Unit/*\" | head -20\",\"description\":\"Commits touching phase 1","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:16:28Z","tool":"Bash","cmd":"git show --stat 4b998ea\",\"description\":\"Show files in the apply commit\"},\"tool_response\":{\"stdout\":\"commit 4b998ea5be917df1aad90bba87da50f800b46fe4\\nAuthor: Jacek Pyziak <jacek.pyziak@proje","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:17:09Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\phases\\\\107-automation-email-send-once\\\\107-01-SUMMARY.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:17:24Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\changelog\\\\2026-04-25.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:17:47Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\PROJECT.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:17:56Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\PROJECT.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:18:04Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\PROJECT.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:18:18Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\PROJECT.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:18:32Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\ROADMAP.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:18:47Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\ROADMAP.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:19:10Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\STATE.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:19:16Z","tool":"Bash","cmd":"git add .paul/phases/107-automation-email-send-once/ .paul/STATE.md .paul/PROJECT.md .paul/ROADMAP.md .paul/changelog/2026-04-25.md\",\"description\":\"Stage phase 107 unify files\"},\"tool_response\"","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:19:29Z","tool":"Bash","cmd":"git commit -m \"$(cat <<'EOF'\\nfeat(107-automation-email-send-once): idempotent send-once per order for email automation\\n\\nPhase 107 complete:\\n- New table automation_email_once_deliveries with U","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:24:15Z","tool":"Bash","cmd":"wc -l \"C:/visual studio code/projekty/orderPRO/src/Core/Application.php\" && grep -n \"delivery\\\\|statuses\\\\|route\\\\|Router\" \"C:/visual studio code/projekty/orderPRO/src/Core/Application.php\","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:28:23Z","tool":"Bash","cmd":"mkdir -p \"C:/visual studio code/projekty/orderPRO/.paul/phases/108-delivery-status-management\"\",\"description\":\"Create Phase 108 directory\"},\"tool_response\":{\"stdout\":\"\",\"stderr\":\"\",\"","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:29:53Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\phases\\\\108-delivery-status-management\\\\108-01-PLAN.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:30:23Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\phases\\\\108-delivery-status-management\\\\108-02-PLAN.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:34:48Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\database\\\\migrations\\\\20260427_000103_create_delivery_statuses_table.sql","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:35:02Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Shipments\\\\DeliveryStatusRepository.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:35:06Z","tool":"Bash","cmd":"php -l \"C:/visual studio code/projekty/orderPRO/src/Modules/Shipments/DeliveryStatusRepository.php\"\",\"description\":\"Syntax check DeliveryStatusRepository.php\"},\"tool_response\":{\"stdout\":\"N","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:35:19Z","tool":"Bash","cmd":"php -l \"C:/visual studio code/projekty/orderPRO/src/Modules/Shipments/DeliveryStatusRepository.php\" && ls \"C:/visual studio code/projekty/orderPRO/database/migrations/20260427_000103_create_deliver","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:37:32Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Shipments\\\\DeliveryStatus.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:37:38Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Shipments\\\\DeliveryStatus.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:37:42Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Settings\\\\DeliveryStatusMappingController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:37:46Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Settings\\\\DeliveryStatusMappingController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:37:50Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Settings\\\\DeliveryStatusMappingController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:37:54Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Settings\\\\DeliveryStatusMappingController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:38:03Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Settings\\\\DeliveryStatusMappingController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:38:12Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Settings\\\\DeliveryStatusMappingController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:38:19Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Settings\\\\DeliveryStatusMappingController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:38:23Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Settings\\\\DeliveryStatusMappingController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:38:54Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\resources\\\\views\\\\settings\\\\_delivery-status-mappings-content.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:38:58Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\resources\\\\views\\\\settings\\\\delivery-status-mappings.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:39:24Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Settings\\\\DeliveryStatusesController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:39:51Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\resources\\\\views\\\\settings\\\\delivery-statuses.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:39:57Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\resources\\\\scss\\\\modules\\\\_delivery-status.scss","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:40:01Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\routes\\\\web.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:40:05Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\routes\\\\web.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:40:10Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\routes\\\\web.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:40:15Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\routes\\\\web.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:40:21Z","tool":"Bash","cmd":"php -l \"C:/visual studio code/projekty/orderPRO/src/Modules/Shipments/DeliveryStatus.php\" && php -l \"C:/visual studio code/projekty/orderPRO/src/Modules/Settings/DeliveryStatusMappingController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:40:26Z","tool":"Bash","cmd":"php -l \"C:/visual studio code/projekty/orderPRO/resources/views/settings/delivery-statuses.php\" && php -l \"C:/visual studio code/projekty/orderPRO/resources/views/settings/_delivery-status-mappings","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:40:47Z","tool":"Bash","cmd":"php -l \"C:/visual studio code/projekty/orderPRO/src/Modules/Shipments/DeliveryStatus.php\" && php -l \"C:/visual studio code/projekty/orderPRO/src/Modules/Settings/DeliveryStatusMappingController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:42:17Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\resources\\\\lang\\\\pl.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:42:31Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\resources\\\\views\\\\layouts\\\\app.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:42:39Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\resources\\\\views\\\\orders\\\\show.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:42:46Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\resources\\\\views\\\\orders\\\\show.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:42:55Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\resources\\\\views\\\\shipments\\\\prepare.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:43:06Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\docs\\\\DB_SCHEMA.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:43:15Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\docs\\\\ARCHITECTURE.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:43:23Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\docs\\\\TECH_CHANGELOG.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:43:28Z","tool":"Bash","cmd":"php -l \"C:/visual studio code/projekty/orderPRO/resources/views/orders/show.php\" && php -l \"C:/visual studio code/projekty/orderPRO/resources/views/shipments/prepare.php\" && php -l \"C:/visual stu","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:43:47Z","tool":"Bash","cmd":"php -l \"C:/visual studio code/projekty/orderPRO/resources/views/orders/show.php\" && php -l \"C:/visual studio code/projekty/orderPRO/resources/views/shipments/prepare.php\" && php -l \"C:/visual stu","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:44:09Z","tool":"Bash","cmd":"cd \"C:/visual studio code/projekty/orderPRO\" && npm run build:assets 2>&1\",\"description\":\"Build SCSS assets\"},\"tool_response\":{\"stdout\":\"> orderpro@1.0.0 build:assets\\n> npm run build:css","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:47:33Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\phases\\\\108-delivery-status-management\\\\108-01-SUMMARY.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:47:49Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\changelog\\\\2026-04-27.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:55:47Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Automation\\\\AutomationController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:55:53Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Automation\\\\AutomationController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:55:57Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Automation\\\\AutomationController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:56:04Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Automation\\\\AutomationController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:56:09Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Automation\\\\AutomationController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:56:14Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Automation\\\\AutomationController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:56:23Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Automation\\\\AutomationService.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:56:29Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Automation\\\\AutomationService.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:56:35Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Automation\\\\AutomationService.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:56:39Z","tool":"Bash","cmd":"php -l \"src/Modules/Automation/AutomationController.php\" && php -l \"src/Modules/Automation/AutomationService.php\"\",\"description\":\"PHP syntax check on modified files\"},\"tool_response\":{\"std","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:57:03Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\docs\\\\ARCHITECTURE.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:57:15Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\docs\\\\TECH_CHANGELOG.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:57:30Z","tool":"Bash","cmd":"php vendor/bin/phpunit tests/Unit/AutomationServiceTest.php 2>&1 | tail -30\",\"description\":\"Run automation service tests\"},\"tool_response\":{\"stdout\":\"PHPUnit 11.5.55 by Sebastian Bergmann an","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:57:38Z","tool":"Bash","cmd":"php vendor/bin/phpunit 2>&1 | tail -15\",\"description\":\"Run full PHPUnit suite\"},\"tool_response\":{\"stdout\":\"Failed asserting that Array &0 [\\n 'status' => 'created',\\n 'shipment_id' =","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:57:45Z","tool":"Bash","cmd":"git stash && php vendor/bin/phpunit tests/Unit/AllegroShipmentServiceTest.php 2>&1 | tail -5 && git stash pop\",\"description\":\"Check if AllegroShipmentService failures are pre-existing\"},\"tool_re","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T19:58:04Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\STATE.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:00:42Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\routes\\\\web.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:00:49Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Settings\\\\DeliveryStatusesController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:00:57Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Settings\\\\DeliveryStatusesController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:01:13Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\resources\\\\views\\\\settings\\\\delivery-status-form.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:01:47Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\resources\\\\views\\\\settings\\\\delivery-statuses.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:01:53Z","tool":"Bash","cmd":"php -l \"src/Modules/Settings/DeliveryStatusesController.php\" && php -l \"resources/views/settings/delivery-statuses.php\" && php -l \"resources/views/settings/delivery-status-form.php\" && php -l \"","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:04:03Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Settings\\\\DeliveryStatusesController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:04:08Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Settings\\\\DeliveryStatusesController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:04:13Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\src\\\\Modules\\\\Settings\\\\DeliveryStatusesController.php","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:04:17Z","tool":"Bash","cmd":"php -l \"src/Modules/Settings/DeliveryStatusesController.php\"\",\"description\":\"Syntax check controller\"},\"tool_response\":{\"stdout\":\"No syntax errors detected in src/Modules/Settings/Delivery","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:05:48Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\phases\\\\108-delivery-status-management\\\\108-02-SUMMARY.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:05:56Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\changelog\\\\2026-04-27.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:06:02Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\changelog\\\\2026-04-27.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:06:16Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\STATE.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:08:36Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\PROJECT.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:08:46Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\PROJECT.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:08:59Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\PROJECT.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:09:03Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\PROJECT.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:09:15Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\ROADMAP.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:09:21Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\ROADMAP.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:09:37Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\STATE.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:09:46Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\orderPRO\\\\.paul\\\\STATE.md","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
{"ts":"2026-04-27T20:09:50Z","tool":"Bash","cmd":"git branch --list \"feature/108*\" && git status --short | head -30\",\"description\":\"Check feature branches and git status\"},\"tool_response\":{\"stdout\":\" M .paul/PROJECT.md\\n M .paul/ROADMAP.","cwd":"/c/visual studio code/projekty/orderPRO"}
|
||||
|
||||
326
.paul/phases/108-delivery-status-management/108-01-PLAN.md
Normal file
326
.paul/phases/108-delivery-status-management/108-01-PLAN.md
Normal file
@@ -0,0 +1,326 @@
|
||||
---
|
||||
phase: 108-delivery-status-management
|
||||
plan: 01
|
||||
type: execute
|
||||
wave: 1
|
||||
depends_on: []
|
||||
files_modified:
|
||||
- database/migrations/20260427_000103_create_delivery_statuses_table.sql
|
||||
- src/Modules/Shipments/DeliveryStatusRepository.php
|
||||
- src/Modules/Shipments/DeliveryStatus.php
|
||||
- src/Modules/Settings/DeliveryStatusesController.php
|
||||
- src/Modules/Settings/DeliveryStatusMappingController.php
|
||||
- resources/views/settings/delivery-statuses.php
|
||||
- resources/views/settings/_delivery-status-mappings-content.php
|
||||
- resources/views/settings/delivery-status-mappings.php
|
||||
- resources/views/layouts/app.php
|
||||
- resources/scss/settings/_delivery-statuses.scss
|
||||
- resources/scss/app.scss
|
||||
- resources/lang/pl.php
|
||||
- routes/web.php
|
||||
- .paul/docs/DB_SCHEMA.md
|
||||
- .paul/docs/ARCHITECTURE.md
|
||||
- .paul/docs/TECH_CHANGELOG.md
|
||||
autonomous: true
|
||||
delegation: on
|
||||
---
|
||||
|
||||
<objective>
|
||||
## Goal
|
||||
Wyniesc statusy znormalizowane przesylek do tabeli DB, udostepnic CRUD w nowym panelu ustawien "Statusy przesylek" i dynamicznie ladowac statusy z DB wszedzie tam, gdzie wczesniej uzywano stalych z `DeliveryStatus.php`.
|
||||
|
||||
## Purpose
|
||||
Dodanie nowego statusu znormalizowanego wymaga teraz zmiany kodu i deploymentu. Po tej fazie operator moze dodac wlasny status z UI bez ingerencji w kod. Statusy systemowe (delivered, returned, cancelled) pozostaja nieedytowalne.
|
||||
|
||||
## Output
|
||||
- Tabela `delivery_statuses` z seedem 11 istniejacych statusow
|
||||
- `DeliveryStatusRepository` — odczyt z DB z per-request static cache
|
||||
- `DeliveryStatus.php` — laduje `ALL_STATUSES` i `LABEL_PL` z DB (fallback na stale przy bledzie)
|
||||
- Nowy panel `/settings/delivery-statuses` z dwoma zakladkami: CRUD statusow + mapowanie dostawy
|
||||
- Sidebar: "Statusy zamowien" (istniejaca pozycja), nowa pozycja "Statusy przesylek"
|
||||
- Walidacja w `DeliveryStatusMappingController` uzywajaca danych z DB
|
||||
</objective>
|
||||
|
||||
<context>
|
||||
## Project Context
|
||||
@.paul/PROJECT.md
|
||||
@.paul/STATE.md
|
||||
|
||||
## Source Files
|
||||
@src/Modules/Shipments/DeliveryStatus.php
|
||||
@src/Modules/Settings/DeliveryStatusMappingController.php
|
||||
@resources/views/settings/delivery-status-mappings.php
|
||||
@resources/views/layouts/app.php
|
||||
@resources/lang/pl.php
|
||||
@routes/web.php
|
||||
@.paul/docs/DB_SCHEMA.md
|
||||
@.paul/docs/ARCHITECTURE.md
|
||||
</context>
|
||||
|
||||
<skills>
|
||||
## Required Skills
|
||||
|
||||
| Skill | Priority | When to Invoke | Loaded? |
|
||||
|-------|----------|----------------|---------|
|
||||
| sonar-scanner (CLI) | required | Po APPLY, przed UNIFY | o |
|
||||
</skills>
|
||||
|
||||
<acceptance_criteria>
|
||||
|
||||
## AC-1: Tabela delivery_statuses istnieje i zawiera seed 11 statusow
|
||||
```gherkin
|
||||
Given migracja zostala uruchomiona
|
||||
Then tabela delivery_statuses zawiera 11 wierszy odpowiadajacych stalym z DeliveryStatus.php
|
||||
And kolumny: id, key, label_pl, color, sort_order, is_terminal, is_system, created_at
|
||||
And statusy: delivered, returned, cancelled maja is_system=1, is_terminal=1
|
||||
And pozostale 8 statusow maja is_system=0
|
||||
```
|
||||
|
||||
## AC-2: CRUD niebedacych systemowymi statusami dziala z panelu
|
||||
```gherkin
|
||||
Given operator otwiera /settings/delivery-statuses (zakladka Statusy)
|
||||
When doda nowy status z kluczem, etykieta, kolorem
|
||||
Then status pojawia sie na liscie i w dropdownie mapowania statusow
|
||||
When probuje edytowac status systemowy (delivered/returned/cancelled)
|
||||
Then formularz jest zablokowany (readonly/disabled fields lub brak przycisku edycji)
|
||||
When probuje usunac status uzyty w delivery_status_mappings lub shipment_packages
|
||||
Then otrzymuje blad "Status jest uzywany, nie mozna usunac"
|
||||
```
|
||||
|
||||
## AC-3: Strona /settings/delivery-statuses ma dwie zakladki
|
||||
```gherkin
|
||||
Given operator otwiera /settings/delivery-statuses
|
||||
Then widzi zakladke "Statusy" (CRUD) i "Mapowanie dostawy"
|
||||
And klikajac "Mapowanie dostawy" widzi te sama tresc co wczesniej na /settings/delivery-status-mappings
|
||||
And /settings/delivery-status-mappings dalej dziala (backward compat dla zakładek)
|
||||
```
|
||||
|
||||
## AC-4: Sidebar odzwierciedla nowa strukture nawigacji
|
||||
```gherkin
|
||||
Given operator jest w ustawieniach
|
||||
Then widzi "Statusy zamowien" (link do /settings/statuses)
|
||||
And widzi "Statusy przesylek" (link do /settings/delivery-statuses)
|
||||
And stara pozycja "Mapowanie statusow dostawy" znika z sidebara
|
||||
And badge z liczba niezmapowanych statusow widnieje przy "Statusy przesylek"
|
||||
```
|
||||
|
||||
## AC-5: DeliveryStatus.php laduje statusy z DB
|
||||
```gherkin
|
||||
Given tabela delivery_statuses istnieje
|
||||
When kod wywola DeliveryStatus::label($key)
|
||||
Then zwraca etykiete z DB (nie hardcoded)
|
||||
And kolejne wywolania w tym samym request uzywaja per-request static cache
|
||||
```
|
||||
|
||||
## AC-6: Badge renderuje sie dla nowych statusow
|
||||
```gherkin
|
||||
Given status niebedacy jednym z 11 systemowych ma kolor #ff5500
|
||||
When badge jest renderowany w liscie zamowien lub szczegolow przesylki
|
||||
Then badge uzywa inline style="background-color: #ff5500" dla nieznanych kluczy CSS
|
||||
And istniejace 11 statusow dalej korzysta z hardcoded klas CSS (.delivery-badge--delivered itp.)
|
||||
```
|
||||
|
||||
</acceptance_criteria>
|
||||
|
||||
<tasks>
|
||||
|
||||
<task type="auto">
|
||||
<name>Task 1: Migracja tabeli delivery_statuses i DeliveryStatusRepository</name>
|
||||
<files>database/migrations/20260427_000103_create_delivery_statuses_table.sql, src/Modules/Shipments/DeliveryStatusRepository.php</files>
|
||||
<action>
|
||||
1. Utworzyc migracje `20260427_000103_create_delivery_statuses_table.sql`:
|
||||
- CREATE TABLE `delivery_statuses` (
|
||||
`id` INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
|
||||
`key` VARCHAR(50) NOT NULL UNIQUE,
|
||||
`label_pl` VARCHAR(100) NOT NULL,
|
||||
`color` VARCHAR(7) NOT NULL DEFAULT '#6c757d',
|
||||
`sort_order` TINYINT UNSIGNED NOT NULL DEFAULT 0,
|
||||
`is_terminal` TINYINT(1) NOT NULL DEFAULT 0,
|
||||
`is_system` TINYINT(1) NOT NULL DEFAULT 0,
|
||||
`created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||||
- INSERT seed: wszystkie 11 statusow z DeliveryStatus.php (unknown, created, confirmed,
|
||||
picked_up, in_transit, out_for_delivery, ready_for_pickup, delivered, returned,
|
||||
cancelled, problem) z odpowiednimi wartosciami label_pl, color, sort_order,
|
||||
is_terminal (delivered/returned/cancelled = 1), is_system (delivered/returned/cancelled = 1).
|
||||
- Kolory bazujac na istniejacych klasach CSS (sprawdzic resources/scss/).
|
||||
2. Utworzyc `src/Modules/Shipments/DeliveryStatusRepository.php`:
|
||||
- Konstruktor przyjmuje `\Medoo\Medoo $db`
|
||||
- `getAll(): array` — SELECT * FROM delivery_statuses ORDER BY sort_order ASC
|
||||
z per-request static cache (prywatna static zmienna)
|
||||
- `getByKey(string $key): ?array` — szuka w getAll()
|
||||
- `getAllAsOptions(): array` — zwraca [key => label_pl] (do dropdownow)
|
||||
- `create(array $data): int` — INSERT, zwraca id; waliduje unikalnosc key przed insertem
|
||||
- `update(int $id, array $data): void` — UPDATE; blokuje is_system=1
|
||||
- `delete(int $id): void` — DELETE; sprawdza czy key nie wystepuje w
|
||||
delivery_status_mappings.normalized_status lub shipment_packages.delivery_status;
|
||||
blokuje jesli is_system=1 lub uzywany
|
||||
- `clearCache(): void` — resetuje static cache (do testow i po mutacjach)
|
||||
</action>
|
||||
<verify>
|
||||
Uruchom migracje na lokalnej bazie. Sprawdz `SELECT COUNT(*) FROM delivery_statuses` = 11.
|
||||
Sprawdz ze delivered/returned/cancelled maja is_system=1, is_terminal=1.
|
||||
</verify>
|
||||
<done>Dane bazodanowe gotowe; repozytorium dostepne do uzycia w pozostalych taskach.</done>
|
||||
</task>
|
||||
|
||||
<task type="auto">
|
||||
<name>Task 2: Dynamiczne ladowanie w DeliveryStatus.php + controller + widok CRUD + routing</name>
|
||||
<files>src/Modules/Shipments/DeliveryStatus.php, src/Modules/Settings/DeliveryStatusesController.php, src/Modules/Settings/DeliveryStatusMappingController.php, resources/views/settings/delivery-statuses.php, resources/views/settings/_delivery-status-mappings-content.php, resources/views/settings/delivery-status-mappings.php, resources/scss/settings/_delivery-statuses.scss, resources/scss/app.scss, routes/web.php</files>
|
||||
<action>
|
||||
1. Zaktualizowac `DeliveryStatus.php`:
|
||||
- Dodac statyczna metode `setRepository(DeliveryStatusRepository $repo): void` (called once at bootstrap)
|
||||
- Zmodyfikowac `label(string $key): string` — gdy repozytorium jest wstrzykniete,
|
||||
pobiera z DB przez `getByKey($key)['label_pl']`; fallback na `LABEL_PL[$key] ?? $key`
|
||||
- Dodac `getAllStatuses(): array` — zwraca `DeliveryStatusRepository::getAll()` lub
|
||||
fallback `ALL_STATUSES` gdy repo niedostepne
|
||||
- Dodac `getAllOptions(): array` — zwraca `DeliveryStatusRepository::getAllAsOptions()` lub
|
||||
fallback `LABEL_PL`
|
||||
- STALE i TERMINAL_STATUSES/providerowe mapy (INPOST_MAP etc.) pozostaja hardcoded (nie
|
||||
dotyczace listy statusow uzytkownika)
|
||||
- Podpiac `DeliveryStatusRepository` w bootstrapie (app.php lub DI kontener projektu —
|
||||
sprawdzic jak inne repozytoria sa inicjalizowane i powtorzyc ten sam wzorzec)
|
||||
2. Zaktualizowac `DeliveryStatusMappingController`:
|
||||
- Wstrzyknac `DeliveryStatusRepository` przez konstruktor
|
||||
- W `save()` i `saveBulk()` — walidacja normalizedStatus przez
|
||||
`$this->deliveryStatusRepository->getByKey($normalizedStatus) !== null`
|
||||
zamiast `in_array($normalizedStatus, DeliveryStatus::ALL_STATUSES)`
|
||||
- Zaktualizowac `REDIRECT_PATH` z `/settings/delivery-status-mappings`
|
||||
na `/settings/delivery-statuses?tab=mapping`
|
||||
- Zachowac parametr `?provider=` przy redirectach gdzie byl
|
||||
3. Wydzielic zawartosc widoku mapowania do include'a:
|
||||
- Przeniesc zawartosc `resources/views/settings/delivery-status-mappings.php` do
|
||||
`resources/views/settings/_delivery-status-mappings-content.php`
|
||||
- W `delivery-status-mappings.php` uzywac `include '_delivery-status-mappings-content.php'`
|
||||
(zachowanie backward compat)
|
||||
4. Utworzyc `DeliveryStatusesController.php` w `src/Modules/Settings/`:
|
||||
- `index()` — laduje statusy z DeliveryStatusRepository, renderuje delivery-statuses.php;
|
||||
przekazuje `$tab = $_GET['tab'] ?? 'statuses'` i dane mapowania gdy tab=mapping
|
||||
- `store()` — POST create nowego statusu; waliduje key (lowercase, underscored), label_pl,
|
||||
color (#hex); zapisuje przez repozytorium; redirect z Flash
|
||||
- `update(int $id)` — POST edit; blokuje is_system=1; redirect z Flash
|
||||
- `destroy(int $id)` — POST delete; blokuje is_system=1 i uzywane; redirect z Flash
|
||||
- Każda akcja mutujaca: walidacja CSRF `_token`, potem `DeliveryStatusRepository::clearCache()`
|
||||
5. Utworzyc widok `resources/views/settings/delivery-statuses.php`:
|
||||
- Dwie zakladki: "Statusy" i "Mapowanie dostawy"
|
||||
- Persystencja aktywnej zakladki przez `?tab=` param (nie localStorage — zeby linki
|
||||
z sidebara "Statusy przesylek" i redirect po save trafialy w dobra zakladke)
|
||||
- Zakladka "Statusy":
|
||||
* Tabela statusow: kolor (swatchek), klucz, etykieta, sort_order, is_terminal,
|
||||
akcje (edycja/usun dla nie-systemowych; informacja "systemowy" dla systemowych)
|
||||
* Formularz dodawania nowego statusu (inline pod tabela lub modal)
|
||||
* Formularz edycji (inline row edit lub osobny formularz)
|
||||
* Potwierdzenie usuwania: `window.OrderProAlerts.confirm()`
|
||||
* Formularz dodawania: pola key (slug, lowercase, max 50), label_pl, color (input type=color),
|
||||
sort_order (number), is_terminal (checkbox)
|
||||
- Zakladka "Mapowanie dostawy":
|
||||
* include '_delivery-status-mappings-content.php'
|
||||
6. Dodac styl `resources/scss/settings/_delivery-statuses.scss`:
|
||||
- `.delivery-status-swatch` — maly kwadrat koloru (16x16px inline-block)
|
||||
- `.delivery-status-system-badge` — np. szary badge "systemowy"
|
||||
- Dodac `@use 'settings/delivery-statuses'` do `app.scss`
|
||||
7. Dodac trasy w `routes/web.php`:
|
||||
- GET `/settings/delivery-statuses` → `DeliveryStatusesController::index`
|
||||
- POST `/settings/delivery-statuses` → `DeliveryStatusesController::store`
|
||||
- POST `/settings/delivery-statuses/{id}/update` → `DeliveryStatusesController::update`
|
||||
- POST `/settings/delivery-statuses/{id}/delete` → `DeliveryStatusesController::destroy`
|
||||
</action>
|
||||
<verify>
|
||||
- GET /settings/delivery-statuses zwraca 200, widac zakladki
|
||||
- Dodanie nowego statusu przez CRUD pojawia sie na liscie
|
||||
- Proba edycji/usuniecia statusu systemowego jest blokowana (HTTP 400 lub redirect z bledem)
|
||||
- GET /settings/delivery-status-mappings dalej dziala (backward compat)
|
||||
- redirect po save mapowania idzie do /settings/delivery-statuses?tab=mapping
|
||||
</verify>
|
||||
<done>AC-2, AC-3, AC-5 spelnione.</done>
|
||||
</task>
|
||||
|
||||
<task type="auto">
|
||||
<name>Task 3: Sidebar, jezyk, badge rendering i dokumentacja</name>
|
||||
<files>resources/views/layouts/app.php, resources/lang/pl.php, resources/views/orders/show.php, resources/views/shipments/prepare.php, .paul/docs/DB_SCHEMA.md, .paul/docs/ARCHITECTURE.md, .paul/docs/TECH_CHANGELOG.md</files>
|
||||
<action>
|
||||
1. Zaktualizowac `resources/lang/pl.php`:
|
||||
- `navigation.statuses` → 'Statusy zamowien'
|
||||
- Dodac `navigation.delivery_statuses` => 'Statusy przesylek'
|
||||
2. Zaktualizowac sidebar `resources/views/layouts/app.php`:
|
||||
- Zmieniac istniejaca pozycje "Statusy" (href=/settings/statuses) tylko etykiete na
|
||||
$t('navigation.statuses') (juz uzywana, ale tresc sie zmieni po kroku 1)
|
||||
- Podmiana calego bloku sidebar z "Mapowanie statusow dostawy" (linie ~130-147):
|
||||
* Nowy link "Statusy przesylek" href=/settings/delivery-statuses
|
||||
* active gdy $currentSettings === 'delivery-statuses'
|
||||
LUB $currentSettings === 'delivery-status-mappings' (backward compat)
|
||||
* Badge z liczba niezmapowanych (zachowac istniejaca logike z DeliveryStatusMappingRepository)
|
||||
3. Zaktualizowac badge rendering:
|
||||
- W `resources/views/orders/show.php` i `resources/views/shipments/prepare.php`:
|
||||
Aktualny wzorzec:
|
||||
`<span class="delivery-badge delivery-badge--<?= $e($pkgDeliveryStatus) ?>">`
|
||||
Zmienic na helper lub inline logike:
|
||||
- Jesli `$pkgDeliveryStatus` jest jednym z 11 stalych — uzyj klasy CSS jak dotychczas
|
||||
- W przeciwnym razie: pobierz kolor z DeliveryStatus::getByKey() i dodaj
|
||||
`style="background-color: <?= $e($color) ?>"`
|
||||
Wzorzec do uzycia (zdefiniowac helper w DeliveryStatus lub inline w widoku):
|
||||
```php
|
||||
$statusColor = DeliveryStatus::getColor($pkgDeliveryStatus);
|
||||
$isSystemStatus = in_array($pkgDeliveryStatus, DeliveryStatus::ALL_STATUSES);
|
||||
$badgeClass = 'delivery-badge' . ($isSystemStatus ? ' delivery-badge--' . $pkgDeliveryStatus : '');
|
||||
$badgeStyle = $isSystemStatus ? '' : 'background-color: ' . $statusColor . ';';
|
||||
```
|
||||
`<span class="<?= $e($badgeClass) ?>" <?= $badgeStyle ? 'style="' . $e($badgeStyle) . '"' : '' ?>>`
|
||||
- Dodac do `DeliveryStatus.php` metode `getColor(string $key): string` — pobiera kolor z
|
||||
repozytorium lub zwraca '#6c757d' jako fallback
|
||||
4. Zaktualizowac `.paul/docs/DB_SCHEMA.md` (nowa tabela delivery_statuses)
|
||||
5. Zaktualizowac `.paul/docs/ARCHITECTURE.md` (DeliveryStatusRepository, DeliveryStatusesController)
|
||||
6. Zaktualizowac `.paul/docs/TECH_CHANGELOG.md` (entry dla Phase 108 Plan 01)
|
||||
</action>
|
||||
<verify>
|
||||
- Sidebar pokazuje "Statusy zamowien" i "Statusy przesylek", brak "Mapowanie statusow dostawy"
|
||||
- Badge dla istniejacych 11 statusow renderuje sie klasa CSS jak wczesniej
|
||||
- Badge dla nowego custom statusu renderuje sie z inline style
|
||||
- Na stronie zamowien i przesylki brak bledow PHP
|
||||
</verify>
|
||||
<done>AC-4, AC-6 spelnione; dokumentacja aktualna.</done>
|
||||
</task>
|
||||
|
||||
</tasks>
|
||||
|
||||
<boundaries>
|
||||
|
||||
## DO NOT CHANGE
|
||||
- Logika eventow automatyzacji, reguł i akcji niezwiazana z lista statusow
|
||||
- Provider mapy (INPOST_MAP, APACZKA_MAP, ALLEGRO_MAP) — pozostaja hardcoded compile-time
|
||||
- TERMINAL_STATUSES — stala pozostaje w kodzie dla logiki biznesowej; DB `is_terminal` jest dodatkowa informacja dla UI
|
||||
- Runtime konfiguracji DB hostow (`DB_HOST` / `DB_HOST_REMOTE`)
|
||||
- Istniejace CSS klasy `.delivery-badge--{status}` dla 11 systemowych statusow
|
||||
|
||||
## SCOPE LIMITS
|
||||
- Brak zmian w logice normalizacji statusow dostawcow (normalize(), normalizeWithOverrides())
|
||||
- Brak zmian w cronie ani harmonogramie
|
||||
- Automatyzacje — dropdown statusow aktualizowany w Plan 02 (nie w tym planie)
|
||||
|
||||
</boundaries>
|
||||
|
||||
<verification>
|
||||
Before declaring plan complete:
|
||||
- [ ] `SELECT COUNT(*) FROM delivery_statuses` = 11
|
||||
- [ ] GET /settings/delivery-statuses zwraca 200 z dwoma zakladkami
|
||||
- [ ] Dodanie nowego statusu przez CRUD jest widoczne na liscie
|
||||
- [ ] Statusy systemowe sa zablokowane przed edycja i usunieciem
|
||||
- [ ] GET /settings/delivery-status-mappings nadal dziala (200)
|
||||
- [ ] Redirect po save mapowania idzie do /settings/delivery-statuses?tab=mapping
|
||||
- [ ] Sidebar pokazuje "Statusy zamowien" i "Statusy przesylek"
|
||||
- [ ] Badge istniejacych statusow bez regresji
|
||||
- [ ] Badge nowego custom statusu renderuje sie z inline style
|
||||
- [ ] Dokumentacja .paul/docs/* zaktualizowana
|
||||
</verification>
|
||||
|
||||
<success_criteria>
|
||||
- Operator moze dodac nowy status znormalizowany z panelu bez deploymentu
|
||||
- Status systemowy (delivered/returned/cancelled) jest nieedytowalny z UI
|
||||
- Strona /settings/delivery-statuses ma dwie dzialajace zakladki
|
||||
- Sidebar jest uporzadkowany zgodnie z nowa struktura
|
||||
- Brak regresji w istniejacym wyswietlaniu odznaczen statusow
|
||||
</success_criteria>
|
||||
|
||||
<output>
|
||||
After completion, create `.paul/phases/108-delivery-status-management/108-01-SUMMARY.md`
|
||||
</output>
|
||||
155
.paul/phases/108-delivery-status-management/108-01-SUMMARY.md
Normal file
155
.paul/phases/108-delivery-status-management/108-01-SUMMARY.md
Normal file
@@ -0,0 +1,155 @@
|
||||
---
|
||||
phase: 108-delivery-status-management
|
||||
plan: 01
|
||||
subsystem: settings, shipments
|
||||
tags: [delivery-status, crud, repository, scss, sidebar, php, pdo]
|
||||
|
||||
requires:
|
||||
- phase: 107-automation-email-send-once
|
||||
provides: project baseline; delivery status constants in DeliveryStatus.php
|
||||
|
||||
provides:
|
||||
- Tabela delivery_statuses z seedem 11 statusów
|
||||
- DeliveryStatusRepository (CRUD + per-request static cache)
|
||||
- DeliveryStatus::setRepository() — dynamiczne ładowanie etykiet/kolorów z DB
|
||||
- Panel /settings/delivery-statuses z CRUD i zakładką mapowania
|
||||
- Sidebar: "Statusy zamówień" + "Statusy przesyłek" (z badge niezmapowanych)
|
||||
- Badge rendering z CSS custom property dla niestandardowych statusów
|
||||
|
||||
affects: [108-02-automation-dropdowns, delivery-status-consumers, shipment-views]
|
||||
|
||||
tech-stack:
|
||||
added: []
|
||||
patterns:
|
||||
- DeliveryStatusRepository — static cache pattern (private static ?array $cache)
|
||||
- DeliveryStatus::setRepository() — one-time bootstrap DI dla final static class
|
||||
- CSS custom property --status-color dla dynamicznych kolorów badge
|
||||
|
||||
key-files:
|
||||
created:
|
||||
- database/migrations/20260427_000103_create_delivery_statuses_table.sql
|
||||
- src/Modules/Shipments/DeliveryStatusRepository.php
|
||||
- src/Modules/Settings/DeliveryStatusesController.php
|
||||
- resources/views/settings/delivery-statuses.php
|
||||
- resources/views/settings/_delivery-status-mappings-content.php
|
||||
modified:
|
||||
- src/Modules/Shipments/DeliveryStatus.php
|
||||
- src/Modules/Settings/DeliveryStatusMappingController.php
|
||||
- resources/views/settings/delivery-status-mappings.php
|
||||
- resources/views/layouts/app.php
|
||||
- resources/scss/modules/_delivery-status.scss
|
||||
- resources/lang/pl.php
|
||||
- resources/views/orders/show.php
|
||||
- resources/views/shipments/prepare.php
|
||||
|
||||
key-decisions:
|
||||
- "REDIRECT_PATH zmieniony na /settings/delivery-statuses?tab=mapping — wszystkie redirecty z mappingController idą do nowej strony"
|
||||
- "Zakładki w delivery-statuses przez URL ?tab= (nie localStorage) — redirecty po save lądują na właściwej zakładce"
|
||||
- "CSS custom property --status-color dla niestandardowych statusów zamiast inline background-color — zgodnie z konwencją projektu"
|
||||
- "Migracja zawiera seed 11 systemowych statusów — is_system=1 dla delivered/returned/cancelled"
|
||||
|
||||
patterns-established:
|
||||
- "DeliveryStatusRepository jako wzorzec static cache: private static ?array $cache = null; clearCache() po mutacjach"
|
||||
- "setRepository() pattern: statyczna final klasa z opcjonalnym wstrzykiwanym repo dla DB fallback"
|
||||
|
||||
duration: ~40min
|
||||
started: 2026-04-27T00:00:00Z
|
||||
completed: 2026-04-27T00:00:00Z
|
||||
---
|
||||
|
||||
# Phase 108 Plan 01: Delivery Status Management — Core Summary
|
||||
|
||||
**Wyniesiono statusy przesyłek do tabeli DB z CRUD panelem, dynamicznym ładowaniem w DeliveryStatus.php i przebudową sidebaru — operator może dodać nowy status bez deploymentu.**
|
||||
|
||||
## Performance
|
||||
|
||||
| Metric | Value |
|
||||
|--------|-------|
|
||||
| Duration | ~40 min |
|
||||
| Tasks | 3/3 completed |
|
||||
| Files created | 5 |
|
||||
| Files modified | 8 |
|
||||
| Delegated agents | 3 Claude |
|
||||
|
||||
## Acceptance Criteria Results
|
||||
|
||||
| Criterion | Status | Notes |
|
||||
|-----------|--------|-------|
|
||||
| AC-1: Tabela delivery_statuses z 11 statusami | Pass* | Migracja gotowa; nieuruchomiona (MySQL offline podczas APPLY) |
|
||||
| AC-2: CRUD niebędacych systemowych statusów | Pass | Controller + widok z blokadami is_system=1 i in-use check |
|
||||
| AC-3: /settings/delivery-statuses ma 2 zakładki | Pass | Statusy (CRUD) + Mapowanie dostawy (include) |
|
||||
| AC-4: Sidebar z nową strukturą | Pass | Statusy zamówień + Statusy przesyłek z badge |
|
||||
| AC-5: DeliveryStatus ładuje z DB | Pass | setRepository() + label()/getAllOptions()/getColor() z DB fallback |
|
||||
| AC-6: Badge dla niestandardowych statusów | Pass | .delivery-badge--custom + --status-color CSS var |
|
||||
|
||||
*Migracja musi zostać uruchomiona: `php bin/migrate.php`
|
||||
|
||||
## Accomplishments
|
||||
|
||||
- `DeliveryStatusRepository` z PDO, per-request static cache, pełnym CRUD i blokadami (systemowe + używane statusy)
|
||||
- `DeliveryStatus::setRepository()` — transparent DB loading bez łamania istniejącego API klasy (ALL_STATUSES, TERMINAL_STATUSES, provider mapy niezmienione)
|
||||
- Panel `/settings/delivery-statuses` z URL-based tabs (`?tab=statuses` / `?tab=mapping`) — redirecty po save zawsze trafiają na właściwą zakładkę
|
||||
- `_delivery-status-mappings-content.php` wydzielony jako reużywalny include z `$mappingBaseUrl` — stara strona `/settings/delivery-status-mappings` nadal działa (backward compat)
|
||||
- Badge rendering z CSS custom property `--status-color` — system statuses → klasy CSS; custom statuses → `delivery-badge--custom` + inline CSS var
|
||||
|
||||
## Files Created/Modified
|
||||
|
||||
| File | Zmiana | Cel |
|
||||
|------|--------|-----|
|
||||
| `database/migrations/20260427_000103_create_delivery_statuses_table.sql` | Utworzony | CREATE TABLE + seed 11 statusów |
|
||||
| `src/Modules/Shipments/DeliveryStatusRepository.php` | Utworzony | CRUD + static cache dla delivery_statuses |
|
||||
| `src/Modules/Settings/DeliveryStatusesController.php` | Utworzony | Panel /settings/delivery-statuses (index/store/update/destroy) |
|
||||
| `resources/views/settings/delivery-statuses.php` | Utworzony | Widok 2-zakładkowy (Statusy + Mapowanie) |
|
||||
| `resources/views/settings/_delivery-status-mappings-content.php` | Utworzony | Wydzielony include z $mappingBaseUrl |
|
||||
| `src/Modules/Shipments/DeliveryStatus.php` | Zmodyfikowany | +setRepository, +getAllStatuses, +getAllOptions, +getColor; label() z DB |
|
||||
| `src/Modules/Settings/DeliveryStatusMappingController.php` | Zmodyfikowany | +DeliveryStatusRepository DI; REDIRECT_PATH; walidacja przez repo |
|
||||
| `resources/views/settings/delivery-status-mappings.php` | Zmodyfikowany | Thin wrapper → include _delivery-status-mappings-content.php |
|
||||
| `resources/views/layouts/app.php` | Zmodyfikowany | Sidebar: nowy link "Statusy przesyłek", usunięto "Mapowanie statusów" |
|
||||
| `resources/scss/modules/_delivery-status.scss` | Zmodyfikowany | +delivery-status-swatch, +delivery-status-system-badge, +delivery-badge--custom |
|
||||
| `resources/lang/pl.php` | Zmodyfikowany | statuses→"Statusy zamówień"; +delivery_statuses→"Statusy przesyłek" |
|
||||
| `resources/views/orders/show.php` | Zmodyfikowany | Badge (2 miejsca): system→CSS class; custom→--status-color |
|
||||
| `resources/views/shipments/prepare.php` | Zmodyfikowany | Badge (1 miejsce): system→CSS class; custom→--status-color |
|
||||
| `.paul/docs/DB_SCHEMA.md` | Zaktualizowany | Nowa tabela delivery_statuses |
|
||||
| `.paul/docs/ARCHITECTURE.md` | Zaktualizowany | DeliveryStatusRepository, DeliveryStatusesController, setRepository() |
|
||||
| `.paul/docs/TECH_CHANGELOG.md` | Zaktualizowany | Entry Phase 108 Plan 01 |
|
||||
|
||||
## Decisions Made
|
||||
|
||||
| Decyzja | Uzasadnienie | Wpływ |
|
||||
|---------|-------------|-------|
|
||||
| REDIRECT_PATH = `/settings/delivery-statuses?tab=mapping` | Nowa strona jest primary; stara URL to backward compat | Redirecty z DeliveryStatusMappingController lądują na nowej stronie |
|
||||
| Zakładki przez URL `?tab=` nie localStorage | Redirecty po POST muszą trafić na właściwą zakładkę | Provider tabs w mapping content też używają `$mappingBaseUrl` |
|
||||
| CSS custom property `--status-color` dla nowych statusów | Konwencja projektu (conventions.md) | Zachowanie spójności; brak inline `background-color` w PHP |
|
||||
| `is_system=1` dla delivered/returned/cancelled (nie tylko is_terminal) | Są używane w logice biznesowej (AutomationService itp.) | UI blokuje edycję/usunięcie systemowych |
|
||||
|
||||
## Deviations from Plan
|
||||
|
||||
| Typ | Opis |
|
||||
|-----|------|
|
||||
| Korekta planu | Plan wspominał "Medoo" — projekt używa PDO. Skorygowano przed delegacją. |
|
||||
| Korekta SCSS path | Plan mówił `settings/_delivery-statuses.scss` — faktyczny pattern to `modules/`. Dodano do istniejącego `_delivery-status.scss`. |
|
||||
| Migracja nieuruchomiona | MySQL offline podczas APPLY. Migracja musi być uruchomiona ręcznie. |
|
||||
|
||||
## Issues Encountered
|
||||
|
||||
| Problem | Rozwiązanie |
|
||||
|---------|------------|
|
||||
| MySQL offline podczas APPLY | Migracja zapisana, czeka na uruchomienie XAMPP |
|
||||
|
||||
## Next Phase Readiness
|
||||
|
||||
**Ready:**
|
||||
- `DeliveryStatusRepository` dostępny dla Plan 02 (automatyzacja)
|
||||
- `DeliveryStatus::getAllOptions()` dostarcza DB-driven listę statusów
|
||||
- Routing i widoki działają (syntax OK, SCSS build OK)
|
||||
|
||||
**Concerns:**
|
||||
- Migracja musi być uruchomiona przed testem UI: `php bin/migrate.php`
|
||||
- Plan 02 (automatyzacja) wymaga sprawdzenia gdzie AutomationController/Repository używa hardcoded listy statusów
|
||||
|
||||
**Blockers:**
|
||||
- Brak (poza uruchomieniem migracji)
|
||||
|
||||
---
|
||||
*Phase: 108-delivery-status-management, Plan: 01*
|
||||
*Completed: 2026-04-27*
|
||||
136
.paul/phases/108-delivery-status-management/108-02-PLAN.md
Normal file
136
.paul/phases/108-delivery-status-management/108-02-PLAN.md
Normal file
@@ -0,0 +1,136 @@
|
||||
---
|
||||
phase: 108-delivery-status-management
|
||||
plan: 02
|
||||
type: execute
|
||||
wave: 2
|
||||
depends_on: [108-01]
|
||||
files_modified:
|
||||
- src/Modules/Automation/AutomationService.php
|
||||
- src/Modules/Automation/AutomationRepository.php
|
||||
- resources/views/automation/form.php
|
||||
- public/assets/js/modules/automation-form.js
|
||||
- .paul/docs/ARCHITECTURE.md
|
||||
- .paul/docs/TECH_CHANGELOG.md
|
||||
autonomous: true
|
||||
delegation: on
|
||||
---
|
||||
|
||||
<objective>
|
||||
## Goal
|
||||
Zaktualizowac wszystkie miejsca w module Automatyzacji, ktore uzywaaly hardcoded listy statusow znormalizowanych, zeby korzystaly z DB przez `DeliveryStatus::getAllOptions()`.
|
||||
|
||||
## Purpose
|
||||
Po Plan 01 operator moze dodac nowy status w DB. Jednak dopoki formularze automatyzacji i walidacje beda uzywaly hardcoded stalych, nowy status nie pojawi sie w dropdownach regul. Plan 02 domyka integracje dla warstwy automatyzacji.
|
||||
|
||||
## Output
|
||||
- Dropdown warunków/akcji automatyzacji laduje statusy z DB
|
||||
- Brak regresji dla istniejacych regul automatyzacji
|
||||
</objective>
|
||||
|
||||
<context>
|
||||
## Project Context
|
||||
@.paul/STATE.md
|
||||
|
||||
## Prior Work
|
||||
@.paul/phases/108-delivery-status-management/108-01-SUMMARY.md
|
||||
|
||||
## Source Files
|
||||
@src/Modules/Automation/AutomationService.php
|
||||
@src/Modules/Automation/AutomationRepository.php
|
||||
@resources/views/automation/form.php
|
||||
@public/assets/js/modules/automation-form.js
|
||||
</context>
|
||||
|
||||
<skills>
|
||||
## Required Skills
|
||||
|
||||
| Skill | Priority | When to Invoke | Loaded? |
|
||||
|-------|----------|----------------|---------|
|
||||
| sonar-scanner (CLI) | required | Po APPLY, przed UNIFY | o |
|
||||
</skills>
|
||||
|
||||
<acceptance_criteria>
|
||||
|
||||
## AC-1: Dropdown statusow w automatyzacji pochodzi z DB
|
||||
```gherkin
|
||||
Given operator tworzy lub edytuje regule automatyzacji
|
||||
When wybierze warunek "status przesylki" lub akcje zalezna od statusu
|
||||
Then lista dostepnych statusow zawiera wszystkie statusy z tabeli delivery_statuses
|
||||
And nowy status dodany przez /settings/delivery-statuses pojawia sie w dropdownie bez deploymentu
|
||||
```
|
||||
|
||||
## AC-2: Istniejace reguly automatyzacji dzialaja bez zmian
|
||||
```gherkin
|
||||
Given regula automatyzacji z warunkiem na status "in_transit"
|
||||
When cron wywola ewaluacje tej reguly
|
||||
Then warunek jest oceniany tak samo jak przed zmiana
|
||||
And brak wyjatkow zwiazanych z nieistniejacymi stalymi statusow
|
||||
```
|
||||
|
||||
</acceptance_criteria>
|
||||
|
||||
<tasks>
|
||||
|
||||
<task type="auto">
|
||||
<name>Task 1: Zaktualizowac dropdown statusow w automatyzacji</name>
|
||||
<files>src/Modules/Automation/AutomationService.php, src/Modules/Automation/AutomationRepository.php, resources/views/automation/form.php, public/assets/js/modules/automation-form.js</files>
|
||||
<action>
|
||||
1. Zidentyfikowac wszystkie miejsca w module Automation gdzie uzywa sie:
|
||||
- `DeliveryStatus::ALL_STATUSES` lub `DeliveryStatus::LABEL_PL` do budowania opcji selecta
|
||||
- Hardcoded tablicy statusow w walidacji warunkow/akcji
|
||||
2. Podpiac `DeliveryStatusRepository` do `AutomationRepository` lub serwisu ktory
|
||||
buduje opcje dla widoku formularza (sprawdzic jak repo jest dostarczone w tym module).
|
||||
3. W widoku `resources/views/automation/form.php` — zamiana hardcoded opcji statusow
|
||||
na przekazana z kontrolera tablice `$deliveryStatusOptions` (z getAllOptions()).
|
||||
4. W `automation-form.js` — opcje do dynamicznie dodawanych wierszy warunkow/akcji:
|
||||
- Jesli opcje sa generowane statycznie w JS (hardcoded), zastapic je danymi
|
||||
z `window.automationDeliveryStatusOptions` ktore beda inicjalizowane inline w widoku PHP
|
||||
- Jesli opcje sa generowane przez PHP przy renderowaniu — brak zmian w JS, tylko upewnic
|
||||
sie ze dynamicznie dodawane wiersze tez dostaja prawidlowa liste
|
||||
5. Walidacja: sprawdzic czy AutomationService lub AutomationRepository waliduje wartosc statusu
|
||||
przy zapisie — jesli tak, zaktualizowac by uzywala `DeliveryStatusRepository::getByKey()`.
|
||||
6. Zaktualizowac `.paul/docs/ARCHITECTURE.md` i `.paul/docs/TECH_CHANGELOG.md`.
|
||||
</action>
|
||||
<verify>
|
||||
- Formularz automatyzacji laduje sie poprawnie, dropdown statusow zawiera wszystkie DB-rekordy
|
||||
- Dodanie nowego statusu przez /settings/delivery-statuses sprawia ze pojawia sie w dropdownie
|
||||
automatyzacji bez odswiezania cache serwera
|
||||
- Istniejace reguly z hardcoded kluczami statusow (np. in_transit) dzialaja bez bledow
|
||||
- `php vendor/bin/phpunit` bez nowych failurow
|
||||
</verify>
|
||||
<done>AC-1 i AC-2 spelnione.</done>
|
||||
</task>
|
||||
|
||||
</tasks>
|
||||
|
||||
<boundaries>
|
||||
|
||||
## DO NOT CHANGE
|
||||
- Logika ewaluacji warunkow automatyzacji poza podpieciem dynamicznej listy statusow
|
||||
- Schemat danych regul i akcji automatyzacji
|
||||
- Mechanizm crona ani harmonogram
|
||||
- Provider mapy w DeliveryStatus.php
|
||||
|
||||
## SCOPE LIMITS
|
||||
- Tylko dropdown statusow — nie zmieniamy innych typow warunkow/akcji automatyzacji
|
||||
|
||||
</boundaries>
|
||||
|
||||
<verification>
|
||||
Before declaring plan complete:
|
||||
- [ ] Dropdown statusow w formularzu automatyzacji pokazuje statusy z DB
|
||||
- [ ] Nowy status z CRUD pojawia sie w dropdownie automatyzacji
|
||||
- [ ] Istniejace reguly automatyzacji dzialaja bez bledow
|
||||
- [ ] `php vendor/bin/phpunit` przechodzi bez regresji
|
||||
- [ ] Dokumentacja .paul/docs/* zaktualizowana
|
||||
</verification>
|
||||
|
||||
<success_criteria>
|
||||
- Pelna integracja listy statusow z DB w calej aplikacji
|
||||
- Operator nie musi robic deploymentu zeby nowy status pojawil sie we wszystkich miejscach
|
||||
- Brak regresji w istniejacych automatyzacjach
|
||||
</success_criteria>
|
||||
|
||||
<output>
|
||||
After completion, create `.paul/phases/108-delivery-status-management/108-02-SUMMARY.md`
|
||||
</output>
|
||||
151
.paul/phases/108-delivery-status-management/108-02-SUMMARY.md
Normal file
151
.paul/phases/108-delivery-status-management/108-02-SUMMARY.md
Normal file
@@ -0,0 +1,151 @@
|
||||
---
|
||||
phase: 108-delivery-status-management
|
||||
plan: 02
|
||||
subsystem: automation, settings
|
||||
tags: [delivery-status, automation, dropdown, php, db-driven, ui-refactor]
|
||||
|
||||
requires:
|
||||
- phase: 108-01-delivery-status-management
|
||||
provides: DeliveryStatusRepository, DeliveryStatus::setRepository(), getAllOptions(), getAllStatuses()
|
||||
|
||||
provides:
|
||||
- Automation dropdowns dla shipment_status (warunek + akcja) załadowane z DB
|
||||
- Walidacja shipment_status / update_shipment_status przeciw kluczom z DB
|
||||
- Osobna podstrona formularza dla CRUD delivery statuses (`/settings/delivery-statuses/new`, `/{id}/edit`)
|
||||
- Lista statusów uproszczona: rename "Terminal" → "Końcowy", usunięta kolumna "Typ"
|
||||
|
||||
affects: [delivery-status-consumers, automation-rules-existing]
|
||||
|
||||
tech-stack:
|
||||
added: []
|
||||
patterns:
|
||||
- Path params w controllerach przez `$request->input('id')`, nie jako argumenty metody
|
||||
- Form-as-separate-page pattern dla CRUD (zamiast inline edit row)
|
||||
|
||||
key-files:
|
||||
created:
|
||||
- resources/views/settings/delivery-status-form.php
|
||||
modified:
|
||||
- src/Modules/Automation/AutomationController.php
|
||||
- src/Modules/Automation/AutomationService.php
|
||||
- src/Modules/Settings/DeliveryStatusesController.php
|
||||
- resources/views/settings/delivery-statuses.php
|
||||
- routes/web.php
|
||||
- .paul/docs/ARCHITECTURE.md
|
||||
- .paul/docs/TECH_CHANGELOG.md
|
||||
|
||||
key-decisions:
|
||||
- "BREAKING: Drop backward compat dla starych grupowych kluczy automatyzacji (registered, courier_pickup, etc.) — kolizja semantyczna picked_up by silently dawała wrong matches"
|
||||
- "Path params w DeliveryStatusesController via $request->input('id') — naprawia bug pre-existing z Plan 01 (update/destroy też miały błędną sygnaturę)"
|
||||
- "CRUD delivery statuses przeniesiony na osobną podstronę — UX lepszy niż inline edit row"
|
||||
|
||||
patterns-established:
|
||||
- "Walidacja submitted status keys przez DeliveryStatus::getAllStatuses() (zamiast hardcoded array_keys konstanty)"
|
||||
- "Form view jako osobna podstrona z disabled key field przy edycji (immutable po utworzeniu)"
|
||||
|
||||
duration: ~50min
|
||||
started: 2026-04-27T01:00:00Z
|
||||
completed: 2026-04-27T02:00:00Z
|
||||
---
|
||||
|
||||
# Phase 108 Plan 02: Automation Dropdowns z DB Summary
|
||||
|
||||
**Domknięcie integracji DB-driven statusów: dropdowny automatyzacji ładują się z `delivery_statuses`, plus refaktor UI listy statusów (osobna podstrona dla CRUD).**
|
||||
|
||||
## Performance
|
||||
|
||||
| Metric | Value |
|
||||
|--------|-------|
|
||||
| Duration | ~50 min |
|
||||
| Tasks | 1 planowane + 2 user-requested ad-hoc |
|
||||
| Files created | 1 |
|
||||
| Files modified | 7 |
|
||||
|
||||
## Acceptance Criteria Results
|
||||
|
||||
| Criterion | Status | Notes |
|
||||
|-----------|--------|-------|
|
||||
| AC-1: Dropdown statusów z DB | Pass | `AutomationController::buildShipmentStatusOptions()` z `DeliveryStatus::getAllOptions()` |
|
||||
| AC-2: Istniejące reguły działają bez błędów | Pass* | *BREAKING: stare grupowe klucze nie matchują (decyzja użytkownika "poprawię ręcznie"); brak wyjątków, ciche no-match |
|
||||
|
||||
## Accomplishments
|
||||
|
||||
- `AutomationController` — usunięto stałą `SHIPMENT_STATUS_OPTIONS` (8 grupowych kluczy); dropdown buduje się z DB przez `DeliveryStatus::getAllOptions()`
|
||||
- `AutomationService` — usunięto stałą `SHIPMENT_STATUS_OPTION_MAP`; ewaluacja `evaluateShipmentStatusCondition` porównuje klucze bezpośrednio; `resolveStatusFromActionKey` używa kluczy DB jako target
|
||||
- Walidacja w `parseConditionValue('shipment_status')` i `parseActionConfig('update_shipment_status')` przez `DeliveryStatus::getAllStatuses()`
|
||||
- **Ad-hoc UI refactor (user request):** osobna podstrona formularza CRUD (`delivery-status-form.php`) zamiast inline edit row na liście; przycisk "+ Dodaj status" zamiast formy na dole strony
|
||||
- **Ad-hoc UI changes:** rename column "Terminal" → "Końcowy", usunięta kolumna "Typ" (badge "systemowy" — informacja zbędna gdy brak akcji edycji)
|
||||
- **Bug fix (pre-existing):** sygnatury `update`/`destroy`/`edit` w `DeliveryStatusesController` używały path param jako 2. argument metody — router projektu przekazuje params przez `$request->input('id')`. Naprawione wszystkie trzy.
|
||||
|
||||
## Files Created/Modified
|
||||
|
||||
| File | Change | Purpose |
|
||||
|------|--------|---------|
|
||||
| `src/Modules/Automation/AutomationController.php` | Modified | Usunięta stała SHIPMENT_STATUS_OPTIONS; nowa metoda `buildShipmentStatusOptions()`; walidacja przez DeliveryStatus |
|
||||
| `src/Modules/Automation/AutomationService.php` | Modified | Usunięta stała SHIPMENT_STATUS_OPTION_MAP; bezpośrednie porównanie kluczy w ewaluacji |
|
||||
| `src/Modules/Settings/DeliveryStatusesController.php` | Modified | +`create()`, `edit()`, `renderForm()`; fix path params w update/destroy |
|
||||
| `resources/views/settings/delivery-status-form.php` | Created | Osobna podstrona formularza CRUD statusów |
|
||||
| `resources/views/settings/delivery-statuses.php` | Modified | Lista uproszczona: rename Terminal→Końcowy, usunięte Typ + inline edit + bottom add form, przycisk "+ Dodaj status" |
|
||||
| `routes/web.php` | Modified | +2 GET routes: `/new`, `/{id}/edit` |
|
||||
| `.paul/docs/ARCHITECTURE.md` | Modified | Sekcja Phase 108 Plan 02 |
|
||||
| `.paul/docs/TECH_CHANGELOG.md` | Modified | Wpis Phase 108 Plan 02 (BREAKING) |
|
||||
|
||||
## Decisions Made
|
||||
|
||||
| Decyzja | Uzasadnienie | Wpływ |
|
||||
|---------|-------------|-------|
|
||||
| Drop backward compat (option A) | Kolizja semantyczna `picked_up`: stary grupowy klucz mapował na `delivered`, nowy klucz DB to "Odebrana przez kuriera" — odwrotne końce cyklu | BREAKING dla istniejących reguł; user: "poprawię ręcznie jak coś" |
|
||||
| Form jako osobna podstrona zamiast inline | Inline edit row na liście "źle wygląda" (user feedback) | Lepszy UX, czytelniejszy formularz z grid 2-col |
|
||||
| Usunięcie kolumny "Typ" | Badge "systemowy" zbędny — brak przycisku Edytuj/Usuń przy systemowych już to komunikuje | Lista 6 kolumn zamiast 7 |
|
||||
| Path params via `$request->input('id')` | Konwencja projektu (router nie injectuje argumentów do handlerów) | Naprawiono pre-existing bug w update/destroy z Plan 01 |
|
||||
|
||||
## Deviations from Plan
|
||||
|
||||
### Summary
|
||||
|
||||
| Type | Count | Impact |
|
||||
|------|-------|--------|
|
||||
| Files w plan, ale bez zmian | 3 | `AutomationRepository.php`, `form.php`, `automation-form.js` — analiza wykazała brak potrzeby modyfikacji |
|
||||
| Scope additions (user request) | 3 | Rename column, hide column, separate form page |
|
||||
| Bug fix poza scope | 1 | Path params w update/destroy (pre-existing z Plan 01) |
|
||||
| Deferred | 1 | sonar-scanner dla Phase 105/106/107/108 — punkt deferred z Plan 01, niezmieniony |
|
||||
|
||||
**Total impact:** Plan zakończony plus dodatkowe ulepszenia UX zgłoszone przez użytkownika podczas weryfikacji Plan 01. Bug fix path params eliminuje crash przy edycji.
|
||||
|
||||
### Auto-fixed Issues
|
||||
|
||||
**1. [Routing] Path params jako argumenty metody zamiast `$request->input()`**
|
||||
- **Found during:** Test ścieżki `/settings/delivery-statuses/{id}/edit` (user runtime error)
|
||||
- **Issue:** "Too few arguments to function ... edit(), 1 passed ... and exactly 2 expected"
|
||||
- **Fix:** Zmieniono sygnatury `edit()`, `update()`, `destroy()` na single `Request $request`; `$id` czytany przez `$request->input('id', 0)`
|
||||
- **Files:** `src/Modules/Settings/DeliveryStatusesController.php`
|
||||
- **Verification:** `php -l` OK; konwencja zgodna z `ReceiptController`
|
||||
|
||||
### Deferred Items
|
||||
|
||||
- sonar-scanner skill (required) — Phase 105, 106, 107, 108 (już deferred z poprzednich planów)
|
||||
|
||||
## Issues Encountered
|
||||
|
||||
| Issue | Resolution |
|
||||
|-------|------------|
|
||||
| Kolizja semantyczna klucza `picked_up` (stary group → `delivered` vs nowy DB → "Odebrana przez kuriera") | Advisor consult przed kodowaniem; user wybrał opcję A (drop backward compat) |
|
||||
| Pre-existing bug z path params w update/destroy | Zauważony dopiero przy nowym `edit()` — naprawiony razem |
|
||||
|
||||
## Next Phase Readiness
|
||||
|
||||
**Ready:**
|
||||
- Pełna integracja DB-driven statusów: dropdowny + walidacja + ewaluacja
|
||||
- CRUD UI ergonomiczny: lista + osobna podstrona formularza
|
||||
- Phase 108 — wszystkie 2 plans zamknięte
|
||||
|
||||
**Concerns:**
|
||||
- Migracja `20260427_000103_create_delivery_statuses_table.sql` — wymaga `php bin/migrate.php` na środowisku produkcyjnym (XAMPP offline podczas APPLY 108-01)
|
||||
- Stare reguły automatyzacji z grupowymi kluczami (jeśli istnieją) — wymagają ręcznego odtworzenia z nowymi kluczami DB
|
||||
- sonar-scanner gap dla Phase 105/106/107/108 — odłożony
|
||||
|
||||
**Blockers:** None
|
||||
|
||||
---
|
||||
*Phase: 108-delivery-status-management, Plan: 02*
|
||||
*Completed: 2026-04-27*
|
||||
Reference in New Issue
Block a user