---
phase: 59-order-status-automation-event
plan: 01
type: execute
wave: 1
depends_on: []
files_modified:
  - src/Modules/Automation/AutomationController.php
  - src/Modules/Automation/AutomationService.php
  - src/Modules/Orders/OrdersController.php
  - resources/views/automation/form.php
  - resources/views/automation/index.php
  - public/assets/js/modules/automation-form.js
autonomous: true
---

<objective>
## Goal
Dodanie zdarzenia automatyzacji `order.status_changed` emitowanego przy zmianie statusu zamowienia. Warunek `order_status` pozwala filtrowac po konkretnym statusie docelowym.

## Purpose
Uzytkownik moze tworzyc reguly automatyzacji reagujace na zmiane statusu zamowienia — np. wyslanie maila po zmianie na "wyslane" lub wystawienie paragonu po zmianie na "oplacone".

## Output
- Event `order.status_changed` dostepny w formularzu automatyzacji
- Warunek `order_status` z checkboxami aktywnych statusow
- Emisja eventu z OrdersController (reczna zmiana) i AutomationService (chain z akcji update_order_status)
</objective>

<context>
## Project Context
@.paul/PROJECT.md
@.paul/ROADMAP.md
@.paul/STATE.md

## Prior Work
@.paul/phases/57-payment-automation-event/57-01-SUMMARY.md — identyczny wzorzec (event + warunek + emisja)

## Source Files
@src/Modules/Automation/AutomationController.php
@src/Modules/Automation/AutomationService.php
@src/Modules/Orders/OrdersController.php
@resources/views/automation/form.php
@resources/views/automation/index.php
@public/assets/js/modules/automation-form.js
</context>

<acceptance_criteria>

## AC-1: Event order.status_changed dostepny w formularzu
```gherkin
Given uzytkownik otwiera formularz nowego zadania automatycznego
When rozwija dropdown "Zdarzenie"
Then widzi opcje "Zmiana statusu zamowienia"
```

## AC-2: Warunek order_status z checkboxami statusow
```gherkin
Given uzytkownik wybrarl zdarzenie "Zmiana statusu zamowienia"
When dodaje warunek "Status zamowienia"
Then widzi checkboxy z aktywnymi statusami zamowien
And moze zaznaczyc jeden lub wiecej statusow
```

## AC-3: Emisja eventu przy recznej zmianie statusu
```gherkin
Given istnieje aktywna regula: event=order.status_changed, warunek=order_status IN [wyslane], akcja=send_email
When uzytkownik zmienia status zamowienia na "wyslane" (ze strony szczegolw lub inline z listy)
Then event order.status_changed jest emitowany z kontekstem (old_status, new_status)
And regula jest dopasowana i akcja wykonana
```

## AC-4: Chain emission z akcji update_order_status
```gherkin
Given regula A: event=payment.status_changed, akcja=update_order_status(wyslane)
And regula B: event=order.status_changed, warunek=order_status IN [wyslane], akcja=send_email
When platnosc sie zmienia i regula A zmienia status zamowienia
Then regula B jest wyzwalana przez chain event order.status_changed
```

## AC-5: Etykieta w widoku listy regul i historii
```gherkin
Given istnieja reguly z event_type=order.status_changed
When uzytkownik otwiera strone /settings/automation
Then w kolumnie "Zdarzenie" widzi "Zmiana statusu zamowienia" (nie surowa nazwe)
And w zakladce Historia rowniez widzi czytelna etykiete
```

</acceptance_criteria>

<tasks>

<task type="auto">
  <name>Task 1: Backend — event + warunek + emisja</name>
  <files>src/Modules/Automation/AutomationController.php, src/Modules/Automation/AutomationService.php, src/Modules/Orders/OrdersController.php</files>
  <action>
    **AutomationController.php:**
    - Dodaj `'order.status_changed'` do `ALLOWED_EVENTS` (linia 19)
    - Dodaj `'order_status'` do `ALLOWED_CONDITION_TYPES` (linia 20)
    - W `buildRuleFromRequest()` dodaj branch `elseif ($type === 'order_status')` analogiczny do `payment_status` — klucz `order_status_codes`, wartosc z `$cond['order_status_codes']`
    - W `parseConditionValue()` dodaj branch `if ($type === 'order_status')` — walidacja kodow statusow vs `$this->repository->listActiveOrderStatuses()` (analogicznie do payment_status ale kody z DB)

    **AutomationService.php:**
    - Dodaj metode `evaluateOrderStatusCondition(array $value, array $context): bool` — porownuje `$context['new_status']` z `$value['order_status_codes']`
    - W `evaluateSingleCondition()` dodaj branch: `if ($type === 'order_status') return $this->evaluateOrderStatusCondition($value, $context);`
    - W `handleUpdateOrderStatus()` po udanej zmianie (`$updated === true`) dodaj `$this->emitEvent('order.status_changed', ...)` z kontekstem `old_status`, `new_status`, `automation_source`, `automation_rule` — analogicznie do `handleUpdateShipmentStatus()`
    - Potrzeba pobrac old_status przed zmiana: dodaj query lub uzyj `$this->orders->findDetails()` do pobrania aktualnego statusu PRZED wywolaniem `updateOrderStatus()`

    **OrdersController.php:**
    - Po udanym `updateOrderStatus()` (linia 280, `$success === true`) dodaj emisje:
      ```php
      try {
          $this->automation?->trigger('order.status_changed', $orderId, [
              'old_status' => $oldStatus,
              'new_status' => $newStatus,
          ]);
      } catch (Throwable) {}
      ```
    - Pobierz `$oldStatus` PRZED wywolaniem `updateOrderStatus()` — dodaj query do pobrania aktualnego `external_status_id`
  </action>
  <verify>Grep ALLOWED_EVENTS zawiera order.status_changed; grep evaluateOrderStatusCondition istnieje; grep trigger('order.status_changed' w OrdersController</verify>
  <done>AC-3, AC-4 satisfied: event emitowany z obu zrodel, warunek ewaluowany poprawnie</done>
</task>

<task type="auto">
  <name>Task 2: Frontend — formularz + widok listy</name>
  <files>resources/views/automation/form.php, resources/views/automation/index.php, public/assets/js/modules/automation-form.js</files>
  <action>
    **form.php:**
    - Dodaj do `$eventLabels`: `'order.status_changed' => 'Zmiana statusu zamowienia'`
    - W sekcji renderowania warunkow dodaj branch `elseif ($condType === 'order_status')` — renderuj checkboxy z `$orderStatusOptions` (juz przekazywane do widoku przez renderForm), analogicznie do `payment_status` ale z kodem statusu jako value i nazwa jako label

    **index.php:**
    - Dodaj do `$eventLabels`: `'order.status_changed' => 'Zmiana statusu zamowienia'`

    **automation-form.js:**
    - W `addConditionRow()` dodaj opcje `<option value="order_status">Status zamowienia</option>` do selecta typu warunku
    - Dodaj renderowanie checkboxow statusow zamowien gdy type === 'order_status' — uzyj danych z `window.__orderStatusOptions` (lub analogicznego mechanizmu jak payment/shipment status)
    - W form.php dodaj `<script>window.__orderStatusOptions = <?= json_encode($orderStatusOptions) ?>;</script>` jesli jeszcze nie istnieje (sprawdz czy juz jest dla akcji update_order_status)
    - W `onConditionTypeChange()` pokaz/ukryj panel checkboxow order_status
  </action>
  <verify>Otworz /settings/automation/create, sprawdz ze "Zmiana statusu zamowienia" jest w dropdown zdarzenia, ze warunek "Status zamowienia" renderuje checkboxy, i ze lista regul pokazuje czytelna etykiete</verify>
  <done>AC-1, AC-2, AC-5 satisfied: event w dropdown, warunek z checkboxami, etykiety czytelne</done>
</task>

</tasks>

<boundaries>

## DO NOT CHANGE
- database/migrations/* (brak nowych tabel/kolumn)
- src/Modules/Automation/AutomationRepository.php (bez zmian)
- src/Modules/Orders/OrdersRepository.php (bez zmian — `updateOrderStatus()` juz istnieje)

## SCOPE LIMITS
- Tylko event `order.status_changed` i warunek `order_status`
- Nie dodajemy nowych akcji
- Import zamowien z Allegro/shopPRO NIE emituje tego eventu (import ustawia status poczatkowy, nie zmienia istniejacego)
- Emisja tylko z recznej zmiany (OrdersController) i chain z akcji automatyzacji (AutomationService)

</boundaries>

<verification>
Before declaring plan complete:
- [ ] `order.status_changed` widoczny w dropdown zdarzenia w formularzu
- [ ] Warunek `order_status` renderuje checkboxy z aktywnymi statusami
- [ ] Reczna zmiana statusu zamowienia emituje event
- [ ] Akcja `update_order_status` emituje chain event `order.status_changed`
- [ ] Etykieta "Zmiana statusu zamowienia" wyswietlana w tabeli regul i historii
- [ ] Zapis i edycja reguly z tym zdarzeniem/warunkiem dziala poprawnie
- [ ] Brak petli: chain protection (depth + dedup) zapobiega nieskonczonej rekurencji
</verification>

<success_criteria>
- Wszystkie taski wykonane
- Wszystkie AC spelnione
- Brak bledow PHP/JS
- Formularz zachowuje dane warunku order_status po bledzie walidacji (wzorzec z Phase 58)
</success_criteria>

<output>
After completion, create `.paul/phases/59-order-status-automation-event/59-01-SUMMARY.md`
</output>
