Project-Pro/orderPRO
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
00634028973ee205742386107d4cae8ede860682
orderPRO/.paul/phases/108-delivery-status-management/108-01-SUMMARY.md
Jacek Pyziak 0063402897 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>
2026-04-27 22:10:24 +02:00

8.5 KiB
Raw Blame History

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

Reference in New Issue View Git Blame Copy Permalink