update
This commit is contained in:
163
.paul/phases/87-shipment-delete/87-01-PLAN.md
Normal file
163
.paul/phases/87-shipment-delete/87-01-PLAN.md
Normal file
@@ -0,0 +1,163 @@
|
||||
---
|
||||
phase: 87-shipment-delete
|
||||
plan: 01
|
||||
type: execute
|
||||
wave: 1
|
||||
depends_on: []
|
||||
files_modified:
|
||||
- src/Modules/Shipments/ShipmentPackageRepository.php
|
||||
- src/Modules/Shipments/ShipmentController.php
|
||||
- routes/web.php
|
||||
- resources/views/orders/show.php
|
||||
autonomous: true
|
||||
delegation: off
|
||||
---
|
||||
|
||||
<objective>
|
||||
## Goal
|
||||
Dodanie możliwości usuwania przesyłek (shipment_packages) z zakładki Przesyłki w szczegółach zamówienia, z pytaniem potwierdzającym przed usunięciem.
|
||||
|
||||
## Purpose
|
||||
Użytkownik potrzebuje możliwości usunięcia błędnie utworzonej lub niepotrzebnej przesyłki bez konieczności ingerencji w bazę danych.
|
||||
|
||||
## Output
|
||||
- Przycisk "Usuń" przy każdej przesyłce w tabeli na /orders/{id}#shipments
|
||||
- Potwierdzenie przez OrderProAlerts.confirm przed wysłaniem żądania
|
||||
- Endpoint POST /orders/{id}/shipment/{packageId}/delete z walidacją CSRF
|
||||
- Usunięcie rekordu z shipment_packages + pliku etykiety (jeśli istnieje)
|
||||
- Wpis w activity log zamówienia
|
||||
</objective>
|
||||
|
||||
<context>
|
||||
## Project Context
|
||||
@.paul/PROJECT.md
|
||||
@.paul/ROADMAP.md
|
||||
@.paul/STATE.md
|
||||
|
||||
## Source Files
|
||||
@src/Modules/Shipments/ShipmentPackageRepository.php
|
||||
@src/Modules/Shipments/ShipmentController.php
|
||||
@routes/web.php
|
||||
@resources/views/orders/show.php
|
||||
</context>
|
||||
|
||||
<skills>
|
||||
No specialized flows required.
|
||||
</skills>
|
||||
|
||||
<acceptance_criteria>
|
||||
|
||||
## AC-1: Przycisk usuwania widoczny przy przesyłce
|
||||
```gherkin
|
||||
Given zamówienie ma co najmniej jedną przesyłkę w shipment_packages
|
||||
When użytkownik otwiera szczegóły zamówienia i zakładkę Przesyłki
|
||||
Then przy każdej przesyłce w tabeli "Wygenerowane przesylki" widoczny jest przycisk "Usuń"
|
||||
```
|
||||
|
||||
## AC-2: Potwierdzenie przed usunięciem
|
||||
```gherkin
|
||||
Given użytkownik widzi przycisk "Usuń" przy przesyłce
|
||||
When kliknie przycisk "Usuń"
|
||||
Then wyświetla się okno potwierdzenia OrderProAlerts.confirm z pytaniem "Czy na pewno chcesz usunąć tę przesyłkę?"
|
||||
And przesyłka NIE jest usuwana dopóki użytkownik nie potwierdzi
|
||||
```
|
||||
|
||||
## AC-3: Usunięcie przesyłki po potwierdzeniu
|
||||
```gherkin
|
||||
Given użytkownik potwierdził usunięcie przesyłki
|
||||
When żądanie POST trafia do /orders/{id}/shipment/{packageId}/delete
|
||||
Then rekord shipment_packages jest usuwany z bazy danych
|
||||
And plik etykiety (label_path) jest usuwany z dysku (jeśli istnieje)
|
||||
And w activity log zamówienia pojawia się wpis "shipment_deleted"
|
||||
And użytkownik jest przekierowany z powrotem na /orders/{id} z komunikatem sukcesu
|
||||
```
|
||||
|
||||
</acceptance_criteria>
|
||||
|
||||
<tasks>
|
||||
|
||||
<task type="auto">
|
||||
<name>Task 1: Backend — repository delete + controller endpoint + route</name>
|
||||
<files>src/Modules/Shipments/ShipmentPackageRepository.php, src/Modules/Shipments/ShipmentController.php, routes/web.php</files>
|
||||
<action>
|
||||
1. ShipmentPackageRepository — dodaj metodę `delete(int $id): void`:
|
||||
- DELETE FROM shipment_packages WHERE id = :id
|
||||
- Prepared statement, spójne z resztą repo
|
||||
|
||||
2. ShipmentController — dodaj metodę `delete(Request $request): Response`:
|
||||
- Pobierz orderId i packageId z requestu
|
||||
- Waliduj CSRF token (wzorzec z metody create)
|
||||
- Pobierz pakiet przez packageRepository->findById
|
||||
- Sprawdź czy pakiet istnieje i należy do tego zamówienia (order_id match)
|
||||
- Jeśli label_path istnieje na dysku — usuń plik (unlink)
|
||||
- Wywołaj packageRepository->delete($packageId)
|
||||
- Zapisz activity log: ordersRepository->recordActivity($orderId, 'shipment_deleted', opis z tracking_number/provider/id, null, 'user', $actorName)
|
||||
- Flash::set('order.success', 'Przesylka zostala usunieta.')
|
||||
- Redirect do /orders/{orderId}
|
||||
|
||||
3. routes/web.php — dodaj route tuż po linii z /shipment/manual:
|
||||
- $router->post('/orders/{id}/shipment/{packageId}/delete', [$shipmentController, 'delete'], [$authMiddleware]);
|
||||
</action>
|
||||
<verify>Grep for 'delete' in ShipmentController.php and ShipmentPackageRepository.php; check route in web.php</verify>
|
||||
<done>AC-3 satisfied: przesyłka usuwana z DB, etykieta z dysku, activity log zapisany, redirect z flash message</done>
|
||||
</task>
|
||||
|
||||
<task type="auto">
|
||||
<name>Task 2: Frontend — przycisk Usuń z potwierdzeniem w widoku zamówienia</name>
|
||||
<files>resources/views/orders/show.php</files>
|
||||
<action>
|
||||
W tabeli "Wygenerowane przesylki" (sekcja packagesList), dodaj kolumnę "Akcje" w thead.
|
||||
W tbody, w nowej kolumnie dla każdej przesyłki dodaj formularz POST:
|
||||
- action="/orders/{orderId}/shipment/{packageId}/delete"
|
||||
- hidden _token (CSRF)
|
||||
- przycisk "Usuń" klasy btn btn--sm btn--danger
|
||||
- Na submit formularza: event.preventDefault(), wywołaj window.OrderProAlerts.confirm z pytaniem "Czy na pewno chcesz usunąć tę przesyłkę?" i w onConfirm: form.submit()
|
||||
|
||||
Skrypt JS inline (lub w bloku script na dole) obsługujący confirm:
|
||||
- Delegacja na .btn-delete-package click
|
||||
- preventDefault, pobranie closest form
|
||||
- OrderProAlerts.confirm({title: 'Usuwanie przesyłki', message: 'Czy na pewno chcesz usunąć tę przesyłkę?', onConfirm: () => form.submit()})
|
||||
</action>
|
||||
<verify>Otworzyć /orders/{id} z przesyłkami — widoczny przycisk Usuń, kliknięcie pokazuje confirm dialog</verify>
|
||||
<done>AC-1 i AC-2 satisfied: przycisk widoczny, potwierdzenie wymagane przed usunięciem</done>
|
||||
</task>
|
||||
|
||||
</tasks>
|
||||
|
||||
<boundaries>
|
||||
|
||||
## DO NOT CHANGE
|
||||
- shipment_packages table schema (no migrations)
|
||||
- Logika tworzenia przesyłek (create, createManual)
|
||||
- Sekcja "Wysylki z Allegro" (to dane zewnętrzne, nie lokalne pakiety)
|
||||
- Automation triggers (nie emituj eventu przy usuwaniu)
|
||||
|
||||
## SCOPE LIMITS
|
||||
- Usuwanie dotyczy tylko rekordów z tabeli shipment_packages (lokalne przesyłki)
|
||||
- Nie usuwamy przesyłek z API przewoźnika (tylko lokalny rekord)
|
||||
- Brak soft-delete — twarde usunięcie z bazy
|
||||
|
||||
</boundaries>
|
||||
|
||||
<verification>
|
||||
Before declaring plan complete:
|
||||
- [ ] Metoda delete() w ShipmentPackageRepository działa (prepared statement)
|
||||
- [ ] Endpoint POST /orders/{id}/shipment/{packageId}/delete zwraca redirect
|
||||
- [ ] CSRF walidacja działa (bez tokena = błąd)
|
||||
- [ ] Plik etykiety usuwany z dysku gdy istnieje
|
||||
- [ ] Activity log zapisany po usunięciu
|
||||
- [ ] Przycisk "Usuń" widoczny w tabeli przesyłek
|
||||
- [ ] OrderProAlerts.confirm wyświetla się przed usunięciem
|
||||
- [ ] Wszystkie acceptance criteria spełnione
|
||||
</verification>
|
||||
|
||||
<success_criteria>
|
||||
- Wszystkie zadania ukończone
|
||||
- Wszystkie weryfikacje przeszły
|
||||
- Brak błędów PHP/JS
|
||||
- Przesyłka usuwana po potwierdzeniu, z cleanup etykiety i wpisem w logu
|
||||
</success_criteria>
|
||||
|
||||
<output>
|
||||
After completion, create `.paul/phases/87-shipment-delete/87-01-SUMMARY.md`
|
||||
</output>
|
||||
Reference in New Issue
Block a user