update

2026-03-31 00:30:50 +02:00
parent 5435209b08
commit af48e84449
30 changed files with 2706 additions and 111 deletions
--- a/.paul/phases/57-payment-automation-event/57-01-PLAN.md
+++ b/.paul/phases/57-payment-automation-event/57-01-PLAN.md
@@ -0,0 +1,219 @@
+---
+phase: 57-payment-automation-event
+plan: 01
+type: execute
+wave: 1
+depends_on: ["56-01"]
+files_modified:
+  - src/Modules/Automation/AutomationController.php
+  - src/Modules/Automation/AutomationService.php
+  - src/Modules/Orders/OrdersController.php
+  - src/Modules/Settings/ShopproPaymentStatusSyncService.php
+  - src/Modules/Cron/CronHandlerFactory.php
+  - resources/views/automation/form.php
+  - public/assets/js/modules/automation-form.js
+  - routes/web.php
+  - DOCS/ARCHITECTURE.md
+  - DOCS/TECH_CHANGELOG.md
+autonomous: true
+---
+
+<objective>
+## Goal
+Dodanie zdarzenia automatyzacji `payment.status_changed` emitowanego przy zmianie statusu platnosci zamowienia. Warunek `payment_status` pozwala filtrowac po konkretnym statusie (oplacone, czesciowo oplacone, nieoplacone).
+
+## Purpose
+Sprzedawca moze tworzyc reguly automatyzacji reagujace na zmiane statusu platnosci — np. wyslij email po oplaceniu, zmien status zamowienia, wystaw paragon.
+
+## Output
+- Nowy event `payment.status_changed` w silniku automatyzacji
+- Nowy warunek `payment_status` z checkboxami statusow
+- Emisja eventu z OrdersController::addPayment() i ShopproPaymentStatusSyncService
+- UI: event i warunek widoczne w formularzu regul
+</objective>
+
+<context>
+## Project Context
+@.paul/PROJECT.md
+@.paul/ROADMAP.md
+
+## Prior Work
+@.paul/phases/56-order-payments/56-01-SUMMARY.md (addPayment, payment_status update)
+
+## Source Files
+@src/Modules/Automation/AutomationController.php (ALLOWED_EVENTS linia 19, ALLOWED_CONDITION_TYPES linia 20)
+@src/Modules/Automation/AutomationService.php (evaluateSingleCondition, evaluateShipmentStatusCondition — wzorzec)
+@src/Modules/Orders/OrdersController.php (addPayment — miejsce emisji eventu)
+@src/Modules/Settings/ShopproPaymentStatusSyncService.php (syncSingleOrderPayment — miejsce emisji eventu)
+@src/Modules/Cron/CronHandlerFactory.php (kompozycja ShopproPaymentStatusSyncService)
+@resources/views/automation/form.php (eventLabels, condition select, JS data)
+@public/assets/js/modules/automation-form.js (addCondition, onConditionTypeChange, buildShipmentStatusCheckboxes — wzorzec)
+@routes/web.php (tworzenie $automationService linia 253, $ordersController linia 264)
+</context>
+
+<acceptance_criteria>
+
+## AC-1: Event payment.status_changed dostepny w formularzu
+```gherkin
+Given otwieram Ustawienia > Zadania automatyczne > Nowa regula
+When klikam dropdown "Zdarzenie"
+Then widze opcje "Zmiana statusu platnosci" obok istniejacych zdarzen
+```
+
+## AC-2: Warunek payment_status dostepny w formularzu
+```gherkin
+Given wybralem zdarzenie "Zmiana statusu platnosci"
+When dodaje warunek i wybieram typ "Status platnosci"
+Then widze checkboxy: Nieoplacone, Czesciowo oplacone, Oplacone
+And moge zaznaczyc jeden lub wiecej statusow
+```
+
+## AC-3: Event emitowany przy recznym dodaniu platnosci
+```gherkin
+Given istnieje aktywna regula: event=payment.status_changed, warunek=payment_status IN [oplacone], akcja=update_order_status
+When dodaje platnosc pokrywajaca pelna kwote zamowienia
+Then regula sie odpala i status zamowienia zmienia sie automatycznie
+And w historii automatyzacji widze wpis o wykonaniu reguly
+```
+
+## AC-4: Event emitowany przy sync platnosci z shopPRO
+```gherkin
+Given zamowienie source=shoppro zmienia payment_status przez cron sync
+When nowy payment_status rozni sie od poprzedniego
+Then event payment.status_changed jest emitowany z kontekstem (old/new status)
+```
+
+## AC-5: Warunek filtruje poprawnie
+```gherkin
+Given regula z warunkiem payment_status = [oplacone]
+When event jest emitowany z new_payment_status = 1 (czesciowo oplacone)
+Then regula NIE odpala sie
+When event jest emitowany z new_payment_status = 2 (oplacone)
+Then regula odpala sie
+```
+
+</acceptance_criteria>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Backend — event + warunek w silniku automatyzacji</name>
+  <files>src/Modules/Automation/AutomationController.php, src/Modules/Automation/AutomationService.php</files>
+  <action>
+    1. W AutomationController:
+       - Dodaj 'payment.status_changed' do ALLOWED_EVENTS (linia 19)
+       - Dodaj 'payment_status' do ALLOWED_CONDITION_TYPES (linia 20)
+       - W metodzie parseConditions(): obsluz 'payment_status' — zbierz payment_status_keys[] z POST, zapisz jako condition_value.status_keys (wzorzec jak shipment_status)
+
+    2. W AutomationService::evaluateSingleCondition():
+       - Dodaj branch: if ($type === 'payment_status') return $this->evaluatePaymentStatusCondition($value, $context);
+
+    3. Dodaj metode evaluatePaymentStatusCondition(array $value, array $context): bool:
+       - Pobierz status_keys z $value (tablica dozwolonych statusow: '0', '1', '2')
+       - Pobierz new_payment_status z $context (string)
+       - Return true jesli new_payment_status jest w status_keys
+       - Mapowanie: 0=nieoplacone, 1=czesciowo_oplacone, 2=oplacone
+
+    Wzoruj sie dokladnie na evaluateShipmentStatusCondition() — analogiczna logika.
+  </action>
+  <verify>PHP lint — brak bledow skladniowych</verify>
+  <done>AC-1, AC-2, AC-5 satisfied: event i warunek zarejestrowane w silniku</done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Emisja eventu z OrdersController i ShopproPaymentStatusSyncService</name>
+  <files>src/Modules/Orders/OrdersController.php, src/Modules/Settings/ShopproPaymentStatusSyncService.php, src/Modules/Cron/CronHandlerFactory.php, routes/web.php</files>
+  <action>
+    1. W OrdersController:
+       - Dodaj ?AutomationService $automation = null do konstruktora (po $shopproIntegrations)
+       - W addPayment(), po zapisie platnosci i activity log, przed pushPaymentToShoppro:
+         try { $this->automation?->trigger('payment.status_changed', $orderId, [
+           'new_payment_status' => (string) $result['payment_status'],
+           'total_paid' => $result['total_paid'],
+           'payment_type_id' => $paymentTypeId,
+         ]); } catch (Throwable) {}
+
+    2. W routes/web.php:
+       - Przekaz $automationService do OrdersController (juz istnieje w scope na linii 253)
+       - Dodaj do wywolania new OrdersController(..., $automationService)
+
+    3. W ShopproPaymentStatusSyncService:
+       - Dodaj ?AutomationService $automation = null do konstruktora (po $pdo)
+       - W syncSingleOrderPayment(), po uaktualnieniu payment status (po commit, przed recordActivity):
+         if ($existingPaymentStatus !== $newPaymentStatus) {
+           try { $this->automation?->trigger('payment.status_changed', $orderId, [
+             'new_payment_status' => (string) $newPaymentStatus,
+             'old_payment_status' => $existingPaymentStatus !== null ? (string) $existingPaymentStatus : '',
+             'total_paid' => $newTotalPaid,
+             'payment_method' => $paymentMethod,
+           ]); } catch (Throwable) {}
+         }
+
+    4. W CronHandlerFactory:
+       - Przekaz $automationService do ShopproPaymentStatusSyncService
+       - AutomationService jest juz tworzony w CronHandlerFactory (buildAutomationHandler) — uzyj go
+       - UWAGA: ShopproPaymentStatusSyncHandler jest tworzony w innym miejscu niz automation — sprawdz czy $automationService jest dostepny i przekaz go
+  </action>
+  <verify>PHP lint — brak bledow skladniowych. Przejrzyj CronHandlerFactory ze szczegolna uwaga na kolejnosc tworzenia obiektow.</verify>
+  <done>AC-3, AC-4 satisfied: event emitowany z obu zrodel</done>
+</task>
+
+<task type="auto">
+  <name>Task 3: UI — event i warunek w formularzu automatyzacji</name>
+  <files>resources/views/automation/form.php, public/assets/js/modules/automation-form.js, DOCS/ARCHITECTURE.md, DOCS/TECH_CHANGELOG.md</files>
+  <action>
+    1. W resources/views/automation/form.php:
+       - Dodaj do $eventLabels: 'payment.status_changed' => 'Zmiana statusu platnosci'
+       - W sekcji warunków (condition select): dodaj option value="payment_status">Status platnosci
+       - W sekcji renderowania warunku (PHP): dodaj branch elseif ($conditionType === 'payment_status') z checkboxami:
+         Statusy: ['0' => 'Nieoplacone', '1' => 'Czesciowo oplacone', '2' => 'Oplacone']
+         Input name: conditions[idx][payment_status_keys][]
+       - Dodaj paymentStatusOptions do window.AutomationFormData
+
+    2. W public/assets/js/modules/automation-form.js:
+       - Dodaj function buildPaymentStatusCheckboxes(namePrefix) — analogicznie do buildShipmentStatusCheckboxes ale z paymentStatusOptions
+       - W addCondition(): dodaj option value="payment_status">Status platnosci w select
+       - W onConditionTypeChange(): dodaj branch if (select.value === 'payment_status') { configDiv.innerHTML = buildPaymentStatusCheckboxes(namePrefix); }
+
+    3. Zaktualizuj DOCS/ARCHITECTURE.md i DOCS/TECH_CHANGELOG.md.
+  </action>
+  <verify>Otworz formularz reguly — widoczne nowe zdarzenie i warunek. PHP lint.</verify>
+  <done>AC-1, AC-2 satisfied: UI gotowe</done>
+</task>
+
+</tasks>
+
+<boundaries>
+
+## DO NOT CHANGE
+- database/migrations/* (brak zmian schematu — event_type to VARCHAR, nowy typ nie wymaga migracji)
+- src/Modules/Automation/AutomationRepository.php (warstwa danych bez zmian)
+- src/Modules/Automation/AutomationExecutionLogRepository.php
+
+## SCOPE LIMITS
+- Tylko event payment.status_changed i warunek payment_status
+- Nie dodajemy nowych akcji (istniejace: send_email, issue_receipt, update_shipment_status, update_order_status wystarczaja)
+- Nie modyfikujemy istniejacych eventow ani warunkow
+
+</boundaries>
+
+<verification>
+Before declaring plan complete:
+- [ ] PHP lint — brak bledow we wszystkich zmodyfikowanych plikach
+- [ ] Formularz reguly: widoczne zdarzenie "Zmiana statusu platnosci"
+- [ ] Formularz reguly: warunek "Status platnosci" z checkboxami
+- [ ] Dodanie platnosci emituje event
+- [ ] Sync platnosci z shopPRO emituje event
+- [ ] DOCS zaktualizowane
+</verification>
+
+<success_criteria>
+- Wszystkie taski ukonczone
+- Nowy event i warunek widoczne w UI
+- Event emitowany z obu zrodel (reczne + cron sync)
+- Warunek filtruje po statusie platnosci
+</success_criteria>
+
+<output>
+After completion, create `.paul/phases/57-payment-automation-event/57-01-SUMMARY.md`
+</output>