---
phase: 84-order-imported-automation-event
plan: 01
type: execute
wave: 1
depends_on: []
files_modified:
- src/Modules/Automation/AutomationController.php
- src/Modules/Settings/AllegroOrderImportService.php
- src/Modules/Settings/ShopproOrdersSyncService.php
- src/Modules/Cron/CronHandlerFactory.php
- resources/views/automation/form.php
- resources/views/automation/index.php
- routes/web.php
autonomous: true
delegation: off
---
## Goal
Dodac nowe zdarzenie automatyzacji `order.imported` wyzwalane przy kazdym pobraniu zamowienia (Allegro i shopPRO). Umozliwi tworzenie regul automatycznych reagujacych na import zamowien (np. wyslij e-mail, zmien status, wystaw paragon).
## Purpose
Obecnie automatyzacja reaguje na zmiany statusow, przesylki, platnosci i paragony. Brakuje zdarzenia na sam moment pobrania zamowienia — user nie moze automatycznie reagowac na nowe zamowienie.
## Output
- Nowy event type `order.imported` w ALLOWED_EVENTS
- Trigger w AllegroOrderImportService i ShopproOrdersSyncService
- Warunek `integration` dostepny dla tego eventu (filtrowanie po zrodle)
- Etykieta w UI automatyzacji
## Project Context
@.paul/PROJECT.md
@.paul/ROADMAP.md
@.paul/STATE.md
## Source Files
@src/Modules/Automation/AutomationController.php — ALLOWED_EVENTS (linia 19), ALLOWED_CONDITION_TYPES (linia 20)
@src/Modules/Automation/AutomationService.php — trigger() method, evaluateConditions()
@src/Modules/Settings/AllegroOrderImportService.php — importSingleOrder() linia 69-96
@src/Modules/Settings/ShopproOrdersSyncService.php — processOrder() linia 225-269
@src/Modules/Cron/CronHandlerFactory.php — kompozycja obiektow
@resources/views/automation/form.php — $eventLabels (linia 9)
@resources/views/automation/index.php — $eventLabels (linia 14)
## AC-1: Event zarejestrowany w systemie
```gherkin
Given system automatyzacji z lista dozwolonych zdarzen
When user tworzy nowa regule automatyzacji
Then w dropdownie zdarzen dostepna jest opcja "Pobranie zamowienia" (order.imported)
```
## AC-2: Event wyzwalany przy imporcie Allegro
```gherkin
Given aktywna regula z event_type = order.imported
When zamowienie zostaje zaimportowane z Allegro (nowe lub re-import)
Then AutomationService.trigger('order.imported', orderId, context) jest wywolany
And context zawiera: source, created (bool), integration_id
```
## AC-3: Event wyzwalany przy imporcie shopPRO
```gherkin
Given aktywna regula z event_type = order.imported
When zamowienie zostaje zaimportowane z shopPRO
Then AutomationService.trigger('order.imported', orderId, context) jest wywolany
And context zawiera: source, created (bool), integration_id
```
## AC-4: Warunek integration dziala z nowym eventem
```gherkin
Given regula order.imported z warunkiem integration = [konkretna integracja]
When zamowienie jest importowane z innej integracji
Then regula NIE jest wykonywana (warunek nie speliony)
```
Task 1: Rejestracja eventu + UI
src/Modules/Automation/AutomationController.php, resources/views/automation/form.php, resources/views/automation/index.php
1. W AutomationController dodac 'order.imported' do ALLOWED_EVENTS (linia 19)
2. W resources/views/automation/form.php dodac do $eventLabels:
'order.imported' => 'Pobranie zamowienia'
3. W resources/views/automation/index.php dodac to samo do $eventLabels
Avoid: nie zmieniac ALLOWED_CONDITION_TYPES — warunek 'integration' juz istnieje i dziala
PHP lint na 3 plikach; event widoczny w dropdownie formularza
AC-1 satisfied: event order.imported zarejestrowany i widoczny w UI
Task 2: Trigger w AllegroOrderImportService
src/Modules/Settings/AllegroOrderImportService.php, src/Modules/Cron/CronHandlerFactory.php, routes/web.php
1. W AllegroOrderImportService dodac opcjonalna zaleznosc AutomationService (konstruktor):
private readonly ?AutomationService $automationService = null
2. Po bloku recordActivity (po linii 95), dodac trigger:
if ($savedOrderId > 0 && $this->automationService !== null) {
$this->automationService->trigger('order.imported', $savedOrderId, [
'source' => 'allegro',
'created' => $wasCreated,
'integration_id' => (int) ($mapped['order']['integration_id'] ?? 0),
]);
}
3. W CronHandlerFactory wstrzyknac $automationService do AllegroOrderImportService
4. W routes/web.php wstrzyknac $automationService do AllegroOrderImportService
Avoid: nie triggerowac wewnatrz upsertOrderAggregate — trigger ma byc na poziomie serwisu importu
Uwaga: import use App\Modules\Automation\AutomationService w AllegroOrderImportService
PHP lint; import zamowienia Allegro wyzwala event order.imported
AC-2 satisfied: import Allegro triggeruje order.imported z kontekstem
Task 3: Trigger w ShopproOrdersSyncService
src/Modules/Settings/ShopproOrdersSyncService.php, src/Modules/Cron/CronHandlerFactory.php
1. W ShopproOrdersSyncService dodac opcjonalna zaleznosc AutomationService (konstruktor):
private readonly ?AutomationService $automationService = null
2. Po bloku recordActivity w processOrder() (po linii 269), dodac trigger:
if ($savedOrderId > 0 && $this->automationService !== null) {
$this->automationService->trigger('order.imported', $savedOrderId, [
'source' => 'shoppro',
'created' => $wasCreated,
'integration_id' => $integrationId,
]);
}
3. W CronHandlerFactory wstrzyknac $automationService do ShopproOrdersSyncService
Avoid: nie triggerowac przy payment_transition (to jest re-import ze zmiana platnosci, nie nowy import)
PHP lint; import zamowienia shopPRO wyzwala event order.imported
AC-3, AC-4 satisfied: import shopPRO triggeruje order.imported; warunek integration dziala
## DO NOT CHANGE
- src/Modules/Automation/AutomationService.php — logika ewaluacji warunkow juz obsluguje 'integration'
- src/Modules/Orders/OrderImportRepository.php — trigger na poziomie serwisu, nie repozytorium
- database/migrations/* — brak zmian DB (event type jest stringiem, nie wymaga migracji)
## SCOPE LIMITS
- Nie dodawac nowych typow warunkow — 'integration' juz istnieje i wystarczy
- Nie dodawac warunku 'source' (allegro/shoppro) — 'integration' filtruje po konkretnej integracji
- Nie triggerowac przy payment_transition w shopPRO
Before declaring plan complete:
- [ ] PHP lint na wszystkich zmodyfikowanych plikach
- [ ] Event 'order.imported' widoczny w dropdown formularza automatyzacji
- [ ] AllegroOrderImportService triggeruje event po imporcie
- [ ] ShopproOrdersSyncService triggeruje event po imporcie
- [ ] AutomationService wstrzykniety w CronHandlerFactory i routes/web.php
- [ ] Brak bledow PHP
- Wszystkie taski wykonane
- Wszystkie verification checks pass
- User moze tworzyc reguly automatyzacji na zdarzenie "Pobranie zamowienia"