---
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>
