Testovanie

Workflows::fake() vymení manažéra za Testing\WorkflowsFake za fasádou aj v kontajneri a vráti ho:

use RoundlyConsulting\Workflows\Facades\Workflows;

$fake = Workflows::fake();   // swaps the facade root AND the container binding, so injected managers are faked

$this->post('/purchase-requests', [...]);

$fake->assertStarted('purchase-approval');
$fake->assertStarted('purchase-approval', fn (StartData $data) => $data->subject?->is($request), times: 1);
$fake->assertEmitted('purchase_request.submitted', fn (EmitData $data) => $data->payload['amount'] === '1200');
$fake->assertEdited('purchase-approval', fn (array $graph) => count($graph['nodes']) === 5);
$fake->assertFlagResolved('purchase-approval', node: 'notify', path: '/recipients');
$fake->assertTouched($request);
$fake->assertWoken(times: 2);
$fake->assertNothingRecorded();

$fake->recorded(WorkflowOperation::Signal);   // list<RecordedOperation{operation, context}>

• Len zaznamenáva: každé volanie, ktoré niečo mení — start, emit, signal, webhook, create, edit, discard, publish, retire, activate, restore, vyriešenie príznaku, obnova webhooku, import, sync, retry, cancel, touch, wake, prune — sa zaznamená a nespustí. Zaznamenajú sa aj volania cez trait HasWorkflows (touch po aktualizácii, zrušenie po zmazaní).
• Čítanie prechádza do skutočného úložiska: definície, katalóg, subjekty, validácia, porovnania, prehľady behov, exporty, skúšobné behy a zostavovanie grafu (Workflows::graph()).
• Rozoslanie emitu sa nespustí: overujte emit, nie spustenia, ktoré by vyvolal. Kľúč udalosti sa však najprv overí rovnakou kontrolou ako pri skutočnom emite: interný kľúč s @ alebo chybný kľúč (Order Placed) vyhodí InvalidEventKeyException a nič sa nezaznamená.
• Náhrady, nikdy null: pod fake metóda, ktorá niečo mení, vráti neuloženú náhradu (exists === false) vytvorenú cez nastavené triedy modelov — definíciu s kľúčom, názvom a rozsahom vlastníka z volania, koncept verzie s grafom, ImportResult s neuloženou definíciou a verziou. retry a cancel vrátia inštanciu, ktorú dostali. Spustenie vráti StartResult{instance: null, created: false, skipped: 'faked'}; emity, wake, prune a sync vrátia prázdne reporty; touch() a signal() vrátia 0. Overujte cez fake, nie cez databázu.

->passthrough() zaznamenáva a zároveň spúšťa:

$fake = Workflows::fake()->passthrough();   // record AND run
$fake->passthrough(false);                   // back to record-only

Asercie

Každá zaznamenaná operácia má pozitívnu aj negatívnu aserciu (signály a skúšobné behy, ktoré sú interné alebo sa nezaznamenávajú, ich nemajú). Každá asercia je uvedená na fasáde a chybové správy uvádzajú kľúč alebo ULID inštancie:

Zaznamenané operácie

$fake->recorded(?WorkflowOperation $operation = null) vráti list<RecordedOperation> (operation, context) od najstaršej, pre vlastné asercie:

Spúšťanie workflowov v teste

use RoundlyConsulting\Workflows\Testing\InteractsWithWorkflows;

uses(InteractsWithWorkflows::class);

it('escalates after two business days', function () {
    $this->travelTo(CarbonImmutable::parse('2026-11-06 15:00', 'Europe/Bratislava'));   // Friday
    $instance = Workflows::start('purchase-approval', $request, $team)->dispatch()->instance;

    $this->travelAndWake('P4D');    // move the clock, run workflows:wake, drain the queue

    $this->assertInstanceAt($instance, 'approve');
    $this->assertInstanceStatus($instance, InstanceStatus::Waiting);
});

S workflows.queue.enabled = off beží všetko priamo a runWorkflows() nemá čo robiť.

Falošné kroky

Workflow otestujete od začiatku do konca bez jeho skutočných vedľajších efektov: určíte výsledok typu kroku a skutočný engine beží ďalej — zámky, čakania, eskalácie, záznam krokov aj autorizačný hook (zamietnutie vo vašich policy krok stále ukončí, takže test ho nikdy neobíde):

uses(InteractsWithWorkflows::class);

$this->fakeStep('approval', 'rejected', outcomes: ['approved', 'rejected', 'expired']);  // approvals not installed: name its outcomes
$this->fakeStep('acme.create_task', fn (StepContext $c) => StepResult::complete(output: ['task_id' => 7]));

Workflows::start('purchase-approval', $request, $team)->dispatch();
$this->runWorkflows();

$this->assertStepRan('acme.create_task', times: 1, where: fn (StepContext $c) => $c->config()['title'] === 'Order');

• Reťazec je výsledok; StepResult sa vráti tak, ako je; closure ho vytvorí pri každom behu.
• Registrovaný typ si ponechá kľúč, názov, schému konfigurácie, výsledky, vedľajšie efekty, oprávnenie aj podporu eskalácií, takže validácia pri publikovaní aj autorizácia sa správajú ako v produkcii.
• Typ, ktorý nie je registrovaný (prepojený typ, ktorého balík chýba), potrebuje $outcomes; prijme akúkoľvek konfiguráciu (aj eskaláciu reassign, ktorá nič nerobí) a nemá vedľajšie efekty.
• Funguje so zapnutým aj vypnutým frontom. Skutočný typ sa vráti na konci testu.

Pest expectations

Registrujú sa automaticky cez Pest plugin balíka; každá najprv obnoví inštanciu z databázy:

expect($instance)->toBeWaitingAt('approve');
expect($instance)->toHaveCompletedVia(['start', 'approve', 'done']);
expect($instance)->toHaveFailedWith('no_approvers');

Skúšobné behy v testoch

Skúšobný beh je lacný spôsob, ako overiť smerovanie bez vedľajších efektov:

expect(Workflows::definition('purchase-approval', $team)->dryRun()->sample(['amount' => '60000'])->run()->nodes())
    ->toBe(['start', 'big', 'legal_cfo', 'notify_approved', 'done']);

Každý model má factory (Database\Factories\*Factory), takže definície, verzie a inštancie pripravíte aj priamo.