Files
orderPRO/.paul/phases/103-print-autoclick-fix/103-01-PLAN.md
2026-04-16 23:19:11 +02:00

87 lines
2.7 KiB
Markdown

---
phase: 103-print-autoclick-fix
plan: 01
type: execute
wave: 1
depends_on: []
files_modified: [resources/views/orders/show.php]
autonomous: true
---
<objective>
## Goal
Naprawic auto-click etykiety po utworzeniu przesylki — klikany ma byc przycisk najnowszej paczki (pierwszej w tabeli), nie najstarszej (ostatniej w tabeli).
## Purpose
Uzytkownik po utworzeniu przesylki oczekuje automatycznego wyslania do drukarki najnowszej etykiety. Obecny kod klika ostatni przycisk w DOM, ktory odpowiada najstarszej paczce (bo tabela jest posortowana DESC).
## Output
Poprawiony JS w `resources/views/orders/show.php` — zmiana `buttons[buttons.length - 1]` na `buttons[0]`.
</objective>
<context>
## Project Context
@.paul/PROJECT.md
@.paul/STATE.md
## Source Files
@resources/views/orders/show.php (linie 998-1018 — funkcja autoClickLastLabel)
@src/Modules/Shipments/ShipmentPackageRepository.php (linia 115 — ORDER BY created_at DESC)
</context>
<acceptance_criteria>
## AC-1: Auto-click klika najnowsza etykiete
```gherkin
Given zamowienie ma 2+ przesylek z przyciskiem "Drukuj"
When strona laduje sie z parametrem ?printLast=1
Then auto-click uruchamia sie na PIERWSZYM przycisku .btn-print-label (najnowsza paczka)
```
</acceptance_criteria>
<tasks>
<task type="auto">
<name>Task 1: Zmiana selektora auto-click z ostatniego na pierwszy przycisk</name>
<files>resources/views/orders/show.php</files>
<action>
W funkcji `autoClickLastLabel()` (ok. linia 1012):
- Zmien `var last = buttons[buttons.length - 1];` na `var last = buttons[0];`
- Komentarz nad funkcja juz mowi "Auto-click ostatniej etykiety" — zaktualizuj na "Auto-click najnowszej etykiety" (bo "ostatnia" jest mylaca)
</action>
<verify>Przegladaj zmieniony kod — buttons[0] powinien byc uzyty zamiast buttons[buttons.length - 1]</verify>
<done>AC-1 satisfied: auto-click klika buttons[0] = najnowsza paczka (tabela DESC)</done>
</task>
</tasks>
<boundaries>
## DO NOT CHANGE
- src/Modules/Shipments/ShipmentPackageRepository.php (sortowanie DESC jest poprawne)
- src/Modules/Shipments/ShipmentController.php (redirect z ?printLast=1 jest poprawny)
- Logika polling print queue (watchPrintQueueButton)
## SCOPE LIMITS
- Tylko zmiana selektora w autoClickLastLabel()
- Nie zmieniac kolejnosci renderowania przesylek
</boundaries>
<verification>
Before declaring plan complete:
- [ ] `buttons[0]` uzyte zamiast `buttons[buttons.length - 1]`
- [ ] Komentarz zaktualizowany
- [ ] Brak innych zmian w pliku
</verification>
<success_criteria>
- Auto-click kieruje sie na pierwszy przycisk .btn-print-label (najnowsza paczka)
- Zadne inne zachowanie nie zmienione
</success_criteria>
<output>
After completion, create `.paul/phases/103-print-autoclick-fix/103-01-SUMMARY.md`
</output>