Jacek Pyziak
02d06298ea
- 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>
10 KiB
10 KiB
phase, plan, type, wave, depends_on, files_modified, autonomous
| phase | plan | type | wave | depends_on | files_modified | autonomous | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 19-ui-integration | 01 | execute | 1 |
|
|
false |
Purpose
Użytkownik może jednym kliknięciem wysłać etykietę do zdalnej drukarki (Windows Client z fazy 20) bez ręcznego pobierania i drukowania. Zbiorcze drukowanie oszczędza czas przy wielu zamówieniach.
Output
- Przycisk "Drukuj" obok "Pobierz" w prepare.php z AJAX feedback
- Zbiorcza akcja "Drukuj etykiety" na liście zamówień (zaznaczone checkboxy)
- Sekcja "Kolejka wydruku" w ustawieniach drukowania z historią zleceń
Prior Work
@.paul/phases/18-print-queue-backend/18-01-SUMMARY.md
- Phase 18 created: PrintApiController (createJob, listPending, downloadLabel, markComplete)
- API key auth middleware for Windows client
- print_jobs table (order_id, package_id, label_path, status, created_by)
- createJob() expects package_id, validates label exists
Source Files
@resources/views/shipments/prepare.php — "Pobierz" button at line ~109 @resources/views/orders/index.php — lista zamówień z checkboxami @src/Modules/Printing/PrintApiController.php — existing REST endpoints @src/Modules/Printing/PrintJobRepository.php — DB operations @resources/views/settings/printing.php — API key management @routes/web.php — route registration
## Required Skills (from SPECIAL-FLOWS.md)| Skill | Priority | When to Invoke | Loaded? |
|---|---|---|---|
| sonar-scanner | required | Po APPLY, przed UNIFY | ○ |
Skill Invocation Checklist
- sonar-scanner loaded (run before UNIFY)
<acceptance_criteria>
AC-1: Przycisk "Drukuj" w widoku przesyłki
Given przesyłka ma wygenerowaną etykietę (label_path istnieje)
When użytkownik klika "Drukuj" obok przycisku "Pobierz"
Then AJAX POST /api/print/jobs z package_id
And przycisk zmienia się na "Wysłano ✓" z krótkim feedbackiem
And w razie błędu wyświetla OrderProAlerts.alert z komunikatem
AC-2: Zbiorcze drukowanie z listy zamówień
Given użytkownik zaznaczył ≥1 zamówienie z etykietą na liście zamówień
When klika akcję "Drukuj etykiety" (bulk action)
Then dla każdego zaznaczonego zamówienia tworzony jest print job
And wyświetla podsumowanie: "Wysłano N zleceń do drukarki"
And zamówienia bez etykiety są pomijane z informacją
AC-3: Kolejka wydruku w ustawieniach
Given użytkownik otwiera Ustawienia > Drukowanie
When strona się ładuje
Then widzi sekcję "Kolejka wydruku" pod sekcją "Klucze API"
And lista pokazuje ostatnie zlecenia: data, zamówienie, status (pending/completed/failed)
And może filtrować po statusie
AC-4: Endpoint bulk create
Given request POST /api/print/jobs/bulk z tablicą package_ids
When co najmniej 1 package_id ma etykietę
Then tworzy print jobs dla wszystkich valid packages
And zwraca JSON z listą created + skipped
</acceptance_criteria>
Task 1: Przycisk "Drukuj" w prepare.php + bulk endpoint resources/views/shipments/prepare.php, src/Modules/Printing/PrintApiController.php, src/Modules/Printing/PrintJobRepository.php, routes/web.php 1. W prepare.php obok przycisku "Pobierz" (form POST label) dodaj przycisk "Drukuj": - Button z klasą `btn btn-sm btn-outline-primary btn-print-label` - data-package-id="{$pkg['id']}" data-order-id="{$orderId}" - Ikona drukarki (fa-print lub SVG) - Widoczny tylko gdy $pkgLabelPath istnieje (ten sam warunek co "Pobierz")2. JavaScript AJAX handler na dole prepare.php (lub w osobnym module):
- Click `.btn-print-label` → POST /api/print/jobs z {package_id, _token}
- Success → zmień tekst na "Wysłano ✓", disable button na 3s
- Error → OrderProAlerts.alert('Błąd: ' + response.error)
- Duplikat (job already pending) → OrderProAlerts.alert('Zlecenie już w kolejce')
3. W PrintApiController dodaj metodę bulkCreateJobs():
- Przyjmuje JSON {package_ids: [1,2,3], _token}
- Waliduje CSRF
- Dla każdego package_id: sprawdź label_path, utwórz job lub skip
- Zwraca {created: [{id, package_id}], skipped: [{package_id, reason}]}
4. W PrintJobRepository dodaj findPendingByPackageId(int $packageId):
- Sprawdza czy istnieje pending job dla danego package
- Używane do ochrony przed duplikatami
5. W routes/web.php dodaj:
- POST /api/print/jobs/bulk → PrintApiController::bulkCreateJobs (session auth)
Avoid: Nie zmieniaj istniejących endpointów API key auth (GET /api/print/jobs/pending itd.)
Avoid: Nie dodawaj natywnych alert() — używaj OrderProAlerts
2. W PrintJobRepository dodaj getRecentJobs(int $limit = 50, ?string $statusFilter = null):
- SELECT z JOIN na orders (numer zamówienia) i shipment_packages (tracking)
- Sortowanie: created_at DESC
- Opcjonalny filtr statusu
3. W PrintSettingsController dodaj metodę index() rozszerzoną o dane kolejki:
- Pobierz listę ostatnich print jobs (getRecentJobs)
- Przekaż do widoku
4. W settings/printing.php pod sekcją "Klucze API" dodaj sekcję "Kolejka wydruku":
- Tabela: Data | Zamówienie | Tracking | Status | Akcje
- Status badges: pending (żółty), completed (zielony), failed (czerwony)
- Filtr statusu (select/buttons nad tabelą)
- Paginacja jeśli >20 rekordów (lub scroll)
- Przycisk "Ponów" przy failed jobs (POST /api/print/jobs z tym samym package_id)
5. Dodaj _printing.scss z stylami:
- .print-status-badge (pending/completed/failed kolory)
- .print-queue-table (kompaktowy layout)
- Zaimportuj w głównym pliku SCSS
Avoid: Nie modyfikuj sekcji API keys w printing.php — dodaj nową sekcję pod spodem
Avoid: Nie dodawaj osobnej strony — kolejka jest częścią ustawień drukowania
DO NOT CHANGE
- database/migrations/* (schemat z fazy 18 jest stabilny)
- src/Modules/Printing/ApiKeyMiddleware.php (auth middleware gotowe)
- Endpointy API key auth (GET /api/print/jobs/pending, download, complete) — te są dla Windows Client
SCOPE LIMITS
- Nie buduj Windows Client (to faza 20)
- Nie dodawaj WebSocket/polling do auto-odświeżania statusów — wystarczy ręczne odświeżenie
- Nie zmieniaj flow pobierania etykiet ("Pobierz" pozostaje bez zmian)
- Nie dodawaj nowych tabel DB — używaj istniejącej print_jobs
<success_criteria>
- Wszystkie 4 AC spełnione
- Brak regresji w istniejącym flow pobierania etykiet
- Kod zgodny z konwencjami projektu (camelCase, Medoo, XSS escape)
- Brak nowych issues SonarQube na zmienionych plikach </success_criteria>