# Trwałe opóźnienia

Przepływy pracy mogą wstrzymywać się na określony czas między krokami za pomocą metody konstruktora `delay()`. Kroki opóźnienia są trwałe: opóźnienie jest zapisywane w bazie danych, więc przetrwa ponowne uruchomienie procesów roboczych, wdrożenia i restarty serwera.

## Metoda `->delay()`

Dodaj krok opóźnienia w dowolnym miejscu łańcucha przepływu pracy:

```php
use Queuety\Queuety;

Queuety::workflow( 'drip_campaign' )
    ->then( SendWelcomeEmailHandler::class )
    ->delay( days: 1 )
    ->then( SendFollowUpEmailHandler::class )
    ->delay( days: 3 )
    ->then( SendFinalEmailHandler::class )
    ->dispatch( [ 'user_id' => 42 ] );
```

Przepływ pracy wykona następujące czynności:

1. Uruchomi `SendWelcomeEmailHandler`
2. Zaczeka 1 dzień
3. Uruchomi `SendFollowUpEmailHandler`
4. Zaczeka 3 dni
5. Uruchomi `SendFinalEmailHandler`

## Parametry czasu trwania

Metoda `delay()` przyjmuje dowolną kombinację nazwanych parametrów czasu trwania:

| Parametr | Typ | Opis |
|---|---|---|
| `$seconds` | `int` | Liczba sekund oczekiwania |
| `$minutes` | `int` | Liczba minut oczekiwania |
| `$hours` | `int` | Liczba godzin oczekiwania |
| `$days` | `int` | Liczba dni oczekiwania |

Wszystkie wartości są sumowane. Poniższe zapisy są równoważne:

```php
->delay( seconds: 3600 )
->delay( minutes: 60 )
->delay( hours: 1 )
```

Możesz łączyć te parametry:

```php
->delay( hours: 1, minutes: 30 ) // 90 minutes total
```

## Jak działają kroki opóźnienia

Gdy przepływ pracy dochodzi do kroku opóźnienia, Queuety wysyła wewnętrzne zadanie `__queuety_delay` z kolumną `available_at` ustawioną na bieżący czas plus czas opóźnienia. Zadanie pozostaje w bazie danych i żaden proces roboczy go nie pobierze, dopóki opóźnienie nie upłynie.

Oznacza to, że:

- **Bez odpytywania.** Procesy robocze nie sprawdzają wielokrotnie opóźnienia. Zadanie staje się dostępne, gdy nadejdzie odpowiedni czas.
- **Bez zużycia pamięci.** Podczas oczekiwania nic nie działa. Opóźnienie istnieje wyłącznie jako wiersz w bazie danych.
- **Przetrwa restarty.** Po ponownym uruchomieniu procesu roboczego zadanie opóźnienia nadal znajduje się w kolejce z prawidłowym znacznikiem czasu `available_at`.

Gdy zadanie opóźnienia zostanie pobrane po upływie opóźnienia, przepływ pracy automatycznie przechodzi do następnego kroku.

## Przykład: opóźnione powiadomienia

Wyślij przypomnienie godzinę po rejestracji użytkownika, ale tylko wtedy, gdy nie ukończył on wdrożenia:

```php
Queuety::workflow( 'onboarding_reminder' )
    ->then( CreateAccountHandler::class )
    ->delay( hours: 1 )
    ->then( CheckOnboardingHandler::class )
    ->then( SendReminderHandler::class )
    ->dispatch( [ 'email' => 'user@example.com' ] );
```

Krok `CheckOnboardingHandler` może sprawdzić stan i użyć [warunkowego rozgałęzienia](https://queuety.inline0.dev/pl/docs/workflows/conditional), aby pominąć przypomnienie, jeśli wdrożenie zostało już ukończone.

## Przykład: ponawianie z narastającym opóźnieniem

Wstaw celowe opóźnienia między krokami przypominającymi ponawianie:

```php
Queuety::workflow( 'poll_external_api' )
    ->then( CheckStatusHandler::class, 'check' )
    ->delay( minutes: 5 )
    ->then( CheckStatusHandler::class, 'recheck' )
    ->delay( minutes: 15 )
    ->then( CheckStatusHandler::class, 'final_check' )
    ->then( ProcessResultHandler::class )
    ->dispatch( [ 'external_id' => 'abc-123' ] );
```

## Wiele opóźnień

Przepływ pracy może zawierać dowolną liczbę kroków opóźnienia. Każde opóźnienie jest niezależne i śledzone pod sekwencyjną nazwą (`delay_0`, `delay_1` itd.) w stanie przepływu pracy.

```php
Queuety::workflow( 'multi_step_drip' )
    ->then( StepA::class )
    ->delay( hours: 2 )
    ->then( StepB::class )
    ->delay( days: 1 )
    ->then( StepC::class )
    ->delay( minutes: 30 )
    ->then( StepD::class )
    ->dispatch( $payload );
```