Files

Jacek Pyziak c59d431083 feat(26-manual-tracking-number): reczne dodawanie numeru przesylki do zamowienia

Nowy endpoint POST /orders/{id}/shipment/manual z formularzem inline
w zakladce Przesylki. Reuse tabeli shipment_packages (provider='manual',
status='created'). Activity log, walidacja CSRF, HTML required.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-23 18:17:21 +01:00

3.5 KiB

Raw Blame History

phase, plan, subsystem, tags, requires, provides, affects, tech-stack, key-files, key-decisions, patterns-established, duration, completed

phase

plan

subsystem

tags

requires

provides

affects

tech-stack

key-files

key-decisions

patterns-established

duration

completed

26-manual-tracking-number

shipments

tracking-number

manual-entry

shipment-packages

phase	provides
25-shipment-presets-management	shipment UI in order details

manual tracking number entry endpoint

inline form in order detail shipments tab

added

patterns

provider='manual' for non-API shipments

created

modified

src/Modules/Shipments/ShipmentPackageRepository.php

src/Modules/Shipments/ShipmentController.php

routes/web.php

resources/views/orders/show.php

resources/scss/app.scss

Reuse shipment_packages table with provider='manual' instead of new table

Inline form in shipments tab instead of modal

provider='manual' pattern for non-API tracking entries

~10min

2026-03-23

Phase 26 Plan 01: Manual Tracking Number Summary

Endpoint POST /orders/{id}/shipment/manual z formularzem inline — ręczne dodawanie numerów śledzenia przesyłek do zamówień

Performance

Metric	Value
Duration	~10min
Completed	2026-03-23
Tasks	3 completed
Files modified	7

Acceptance Criteria Results

Criterion	Status	Notes
AC-1: Ręczne dodanie numeru przesyłki	Pass	Endpoint tworzy rekord, activity log, flash success
AC-2: Walidacja — pusty numer	Pass	HTML required + server-side trim check
AC-3: Wyświetlanie ręcznych przesyłek	Pass	Status "Dodana recznie", przewoźnik z carrier_id, etykieta "—"

Accomplishments

Nowy endpoint POST /orders/{id}/shipment/manual z walidacją CSRF i tracking_number
Metoda ShipmentPackageRepository::createManual() — INSERT z provider='manual', status='created'
Formularz inline w zakładce Przesyłki + zmienione renderowanie dla ręcznych przesyłek

Files Created/Modified

File	Change	Purpose
`src/Modules/Shipments/ShipmentPackageRepository.php`	Modified	Nowa metoda createManual()
`src/Modules/Shipments/ShipmentController.php`	Modified	Nowa metoda createManual() — endpoint
`routes/web.php`	Modified	Nowa route POST /orders/{id}/shipment/manual
`resources/views/orders/show.php`	Modified	Formularz inline + wyświetlanie ręcznych przesyłek
`resources/scss/app.scss`	Modified	Klasa .manual-tracking-form
`public/assets/css/app.css`	Rebuilt	Skompilowany SCSS
`DOCS/ARCHITECTURE.md`	Modified	Dokumentacja nowego endpointu
`DOCS/TECH_CHANGELOG.md`	Modified	Wpis Phase 26

Decisions Made

Decision	Rationale	Impact
Reuse shipment_packages z provider='manual'	Tabela ma już tracking_number, carrier_id, status — nie trzeba nowej migracji	Zero zmian DB
Formularz inline zamiast modala	Szybszy dostęp, mniej kliknięć, spójny z kompaktowym UI	Prostsze UX
carrier_id jako nazwa przewoźnika dla manual	Pole VARCHAR już istnieje, semantycznie pasuje	Brak zmian schematu

Deviations from Plan

None — plan executed exactly as written.

Issues Encountered

None.

Next Phase Readiness

Ready:

Ręczne numery przesyłek w pełni funkcjonalne
Milestone v1.1 gotowy do zamknięcia

Concerns:

Brak możliwości edycji/usunięcia ręcznych przesyłek (celowo poza scope)

Blockers:

None

Phase: 26-manual-tracking-number, Plan: 01 Completed: 2026-03-23

3.5 KiB Raw Blame History