Files

Jacek Pyziak 02d06298ea feat(19-ui-integration): przycisk Drukuj, bulk print, kolejka wydruku

- Przycisk "Drukuj" w prepare.php i show.php z AJAX + duplikat protection
- Bulk print z listy zamówień (checkboxy + header action)
- Kolejka wydruku w Ustawienia > Drukowanie (filtr statusu, retry)
- POST /api/print/jobs/bulk endpoint (package_ids + order_ids)
- ensureLabel() auto-download przez ShipmentProviderRegistry
- Apaczka carrier_id = nazwa usługi, kolumna Przewoznik
- Tab persistence (localStorage), label file_exists check
- Fix use statement ApaczkaApiClient, redirect po utworzeniu przesyłki
- Phase 17 (receipt duplicate guard) + Phase 18 (print queue backend) docs

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

2026-03-22 21:16:54 +01:00

5.4 KiB

Raw Blame History

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

phase

plan

subsystem

tags

requires

provides

affects

tech-stack

key-files

key-decisions

patterns-established

duration

started

completed

19-ui-integration

printing

ajax

bulk-actions

label-queue

phase	provides
18-print-queue-backend	PrintApiController, PrintJobRepository, print_jobs table, API key auth

Przycisk "Drukuj" w widoku przesyłki i szczegółów zamówienia

Bulk print z listy zamówień

Kolejka wydruku w Ustawienia > Drukowanie

Endpoint POST /api/print/jobs/bulk

20-windows-client

added

patterns

ShipmentProviderRegistry for ensureLabel()

pendingPackageIds for duplicate protection

created

modified

src/Modules/Printing/PrintApiController.php (bulkCreateJobs, ensureLabel)

src/Modules/Printing/PrintJobRepository.php (findPendingByPackageId, pendingPackageIds)

src/Modules/Settings/PrintSettingsController.php (kolejka wydruku)

resources/views/settings/printing.php (kolejka UI)

resources/scss/modules/_printing.scss

database/migrations/20260322_000058_create_print_tables.sql

resources/views/shipments/prepare.php (przycisk Drukuj, label file check)

resources/views/orders/show.php (przycisk Drukuj, tab persistence, carrier_id column)

resources/views/orders/list.php (bulk print action)

routes/web.php (DI + nowe route'y)

src/Modules/Orders/OrdersController.php (storagePath + printJobRepo injection)

src/Modules/Shipments/ShipmentController.php (redirect po utworzeniu przesyłki)

src/Modules/Shipments/ApaczkaShipmentService.php (carrier_id = service name)

src/Modules/Settings/ApaczkaApiClient.php (fix use statement)

resources/scss/app.scss (_printing import)

public/assets/css/app.css (compiled)

ensureLabel() auto-downloads label via ShipmentProviderRegistry before creating print job

findPendingByPackageId protects against duplicate pending jobs

Apaczka carrier_id stores service name (e.g. 'Orlen Paczka') for display

Tab persistence via localStorage in show.php

Label file existence check hides Pobierz/Drukuj when file missing on disk

ShipmentProviderRegistry pattern for multi-provider label operations

Bulk endpoint returns {created: [], skipped: []} JSON structure

~4h

2026-03-22T10:00:00Z

2026-03-22T22:00:00Z

Phase 19 Plan 01: UI Integration Summary

Przycisk "Drukuj" w widoku przesyłki, bulk print z listy zamówień, kolejka wydruku w ustawieniach — pełna integracja UI z backendem kolejki wydruku z fazy 18.

Performance

Metric	Value
Duration	~4h (rozłożone na 2 sesje)
Started	2026-03-22
Completed	2026-03-22
Tasks	3 (2 auto + 1 checkpoint)
Files modified	14

Acceptance Criteria Results

Criterion	Status	Notes
AC-1: Przycisk "Drukuj" w widoku przesyłki	Pass	Widoczny w prepare.php i show.php, AJAX feedback + duplikat protection
AC-2: Zbiorcze drukowanie z listy zamówień	Pass	Checkboxy + header action "Drukuj etykiety", bulk endpoint
AC-3: Kolejka wydruku w ustawieniach	Pass	Tabela zleceń z filtrami statusu, retry dla failed
AC-4: Endpoint bulk create	Pass	POST /api/print/jobs/bulk z {package_ids/order_ids}

Accomplishments

Przycisk "Drukuj" obok "Pobierz" z AJAX feedback i ochroną przed duplikatami
Bulk print z listy zamówień (checkboxy + nagłówkowa akcja)
Kolejka wydruku w Ustawienia > Drukowanie z filtrami i retry
Auto-download etykiety (ensureLabel) przez ShipmentProviderRegistry
Stan "W kolejce" (disabled, czerwony) gdy pending job istnieje

Deviations from Plan

Summary

Type	Count	Impact
Scope additions	6	Usprawnienia UX wykryte podczas testów
Auto-fixed	1	Bug fix ApaczkaApiClient
Deferred	0	—

Total impact: Dodatkowe usprawnienia UX poza planem, zero regresji.

Scope Additions (poza planem)

show.php tab persistence — localStorage zapamiętuje aktywny tab
show.php label file check — ukrywa Pobierz/Drukuj gdy plik nie istnieje na dysku
show.php przycisk Drukuj — plan dotyczył tylko prepare.php, dodano też w show.php
Kolumna Przewoznik — "Apaczka → Orlen Paczka" zamiast pustego carrier_id
Redirect po utworzeniu przesyłki — ShipmentController redirect → /orders/{id} z flash
Sekcja przesyłek przeniesiona — pod formularz nowej przesyłki w prepare.php

Auto-fixed Issues

1. ApaczkaApiClient use statement bug

Found during: Task 1
Issue: Brak backslashy w use statement
Fix: Poprawiony import namespace
Files: src/Modules/Settings/ApaczkaApiClient.php

SonarQube Scan

Scan date: 2026-03-22 Result: 0 new blocker/critical issues on phase 19 files New issues (minor/major):

show.php:696 — S4833 require → use, S2003 require → require_once
OrdersController — S1448 (22 methods > 20), S1142 (bulkPrint 5 returns)

All logged to DOCS/todo.md.

Next Phase Readiness

Ready:

Pełne UI do zarządzania kolejką wydruku
API endpoints gotowe dla Windows Client (faza 20)
print_jobs table z pełnym lifecycle (pending → completed/failed)

Concerns:

OrdersController rośnie (22 metody) — rozważyć wydzielenie PrintController w przyszłości

Blockers:

None

Phase: 19-ui-integration, Plan: 01 Completed: 2026-03-22

5.4 KiB Raw Blame History