Reguły automatyzacji

Moduł Reguły automatyzacji uruchamia akcje (email, SMS, zmiana statusu, notatka, tag klienta, webhook) na podstawie zdarzeń w sklepie. Reguły definiujesz w panelu WooCommerce > Automation Rules poprzez React SPA, a silnik wykonuje je w odpowiedzi na trigger.

Architektura

Element	Opis
Trigger	Zdarzenie WooCommerce uruchamiające regułę (`new_order`, `order_status_changed`, …)
Filter	Warunek logiczny (`order_total > 100`, `geo_scope in eu`, …)
Action	Operacja do wykonania (`send_email`, `add_order_note`, `webhook`, …)
Match mode	`all` - wszystkie filtry spełnione, `any` - wystarczy jeden
Priority	Kolejność wykonywania (mniejsze = wcześniej)

Reguły są zapisywane w tabeli wp_polski_pro_automation_rules. Wykonania (matched/skipped, dry run, wynik akcji, błąd) trafiają do wp_polski_pro_automation_logs.

Triggery

Wartość	Kiedy wystrzeliwane
`new_order`	`woocommerce_new_order`
`order_status_changed`	`woocommerce_order_status_changed`
`new_customer`	`user_register`
`cart_abandoned`	(rezerwa - integracja z `AbandonedCartService`)
`product_saved`	`save_post_product`

Filtry

Pola dostępne w filtrach (FilterField):

Pole	Źródło	Operatory
`order_total`	`WC_Order::get_total()`	`equals`, `gt`, `lt`, `not_equals`
`order_status`	`WC_Order::get_status()`	`equals`, `in`, `not_in`
`item_count`	`WC_Order::get_item_count()`	`gt`, `lt`, `equals`
`billing_country`	ISO 3166-1 alpha-2	`equals`, `in`, `not_in`
`shipping_country`	ISO 3166-1 alpha-2 (fallback do billing)	`equals`, `in`, `not_in`
`geo_scope`	`pl`, `eu`, `eea`, `non_eu`	`equals`
`customer_email`	`WC_Order::get_billing_email()`	`equals`, `contains`
`payment_method`	`WC_Order::get_payment_method()`	`equals`, `in`
`shipping_method`	Lista metod z pozycji wysyłki	`in`, `not_in`
`product_id`	Lista ID produktów w zamówieniu	`in`, `not_in`
`category`	Lista ID `product_cat` z pozycji zamówienia	`in`, `not_in`

Operator in / not_in przyjmuje listę rozdzieloną przecinkami (PL,DE,FR).

Filtry geograficzne

Pole geo_scope zwraca jedną z czterech wartości dla zamówienia/użytkownika:

Wartość	Zakres
`pl`	Polska (PL)
`eu`	Kraje UE (27 państw członkowskich)
`eea`	EOG = UE + Norwegia, Islandia, Liechtenstein
`non_eu`	Reszta świata

Przykład użycia: reguła wysyła inny szablon emaila marketingowego klientom z UE (z notką RODO) niż spoza UE.

Akcje

Typ	Parametry
`send_email`	`to` (opcjonalne), `subject`, `body`, `marketing` (boolean wymuszające zgodę)
`send_sms`	Delegowane do `polski_pro/automation/send_sms` (wymaga `SmsNotificationService`)
`change_order_status`	`status`, `note`
`add_order_note`	`note`, `customer_note` (boolean)
`add_customer_tag`	`tag` (zapisuje do user_meta `polski_customer_tags`)
`webhook`	`url` - POST z `{subject_type, subject_id}`

Zgoda marketingowa

Akcje z params.marketing = true są pomijane, jeśli klient nie ma ważnej zgody marketingowej w polski_consent_log. Filtr polski_pro/automation/has_marketing_consent pozwala zastąpić domyślną logikę sprawdzania zgody.

Rozszerzanie akcji

Aby dodać niestandardową akcję (np. integrację z FreshMail/GetResponse), użyj filtru:

add_filter('polski_pro/automation/action', function ($override, $action, $subject, $dryRun) {
    if ($action->type->value === 'send_email' && ($action->params['provider'] ?? '') === 'freshmail') {
        if ($dryRun) {
            return ['dry_run' => true, 'provider' => 'freshmail'];
        }
        // ... wywołanie API FreshMail ...
        return ['provider' => 'freshmail', 'sent' => true];
    }

    return $override;
}, 10, 4);

REST API

Wszystkie endpointy wymagają manage_woocommerce + nagłówka X-WP-Nonce.

Metoda	Ścieżka	Opis
GET	`/polski-pro/v1/automation/rules`	Lista reguł
POST	`/polski-pro/v1/automation/rules`	Utworzenie reguły
GET	`/polski-pro/v1/automation/rules/{id}`	Pobranie pojedynczej reguły
PUT	`/polski-pro/v1/automation/rules/{id}`	Aktualizacja reguły
DELETE	`/polski-pro/v1/automation/rules/{id}`	Usunięcie + czyszczenie logów
POST	`/polski-pro/v1/automation/rules/{id}/dry-run`	Symulacja na zamówieniu/użytkowniku (`order_id` lub `user_id`)
GET	`/polski-pro/v1/automation/logs?limit=200`	Dziennik audytu (max 500)
GET	`/polski-pro/v1/automation/schema`	Schemat triggerów/filtrów/akcji

Dry run

W edytorze reguły podaj Order ID i kliknij Run dry run. Silnik:

Ewaluuje filtry względem podanego zamówienia.
Sprawdza zgodę marketingową.
Wykonuje akcje w trybie dry-run (nie modyfikuje stanu) i zwraca planowany rezultat.
Zapisuje wpis w dzienniku audytu z flagą dry_run = 1.

Limity i wydajność

Indeksy na enabled, trigger_type, priority, group_label - silnik pobiera tylko reguły pasujące do triggera.
recent($limit) w AutomationLogRepository jest ograniczone do 500 rekordów na zapytanie.
Webhooki mają timeout 10s.