# Trvalé prodlevy

Workflow lze mezi kroky pozastavit na pevně stanovenou dobu pomocí metody builderu `delay()`. Kroky s prodlevou jsou trvalé: prodleva se ukládá do databáze, takže přetrvá restarty pracovního procesu, nasazení i restarty serveru.

## Metoda `->delay()`

Krok s prodlevou přidáte kamkoli do řetězce workflow:

```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 ] );
```

Workflow provede následující:

1. Spustí `SendWelcomeEmailHandler`
2. Počká 1 day
3. Spustí `SendFollowUpEmailHandler`
4. Počká 3 days
5. Spustí `SendFinalEmailHandler`

## Parametry doby trvání

Metoda `delay()` přijímá libovolnou kombinaci pojmenovaných parametrů doby trvání:

| Parametr | Typ | Popis |
|---|---|---|
| `$seconds` | `int` | Počet sekund čekání |
| `$minutes` | `int` | Počet minut čekání |
| `$hours` | `int` | Počet hodin čekání |
| `$days` | `int` | Počet dní čekání |

Všechny hodnoty se sčítají. Tyto varianty jsou rovnocenné:

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

Můžete je kombinovat:

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

## Jak fungují kroky s prodlevou

Když workflow dospěje ke kroku s prodlevou, Queuety zařadí interní úlohu `__queuety_delay`, jejíž sloupec `available_at` je nastaven na aktuální čas plus délku prodlevy. Úloha zůstane v databázi a žádný pracovní proces ji nepřevezme, dokud prodleva neuplyne.

To znamená:

- **Bez opakovaných kontrol.** Pracovní procesy prodlevu opakovaně nekontrolují. Úloha se jednoduše zpřístupní, až nadejde její čas.
- **Bez využití paměti.** Během čekání nic neběží. Prodleva existuje pouze jako řádek v databázi.
- **Přetrvá restarty.** Pokud se pracovní proces restartuje, úloha s prodlevou zůstane ve frontě se správnou časovou značkou `available_at`.

Po převzetí úlohy s prodlevou po jejím uplynutí workflow automaticky pokračuje dalším krokem.

## Příklad: odložená oznámení

Odešlete připomenutí 1 hodinu poté, co se uživatel zaregistruje, ale pouze pokud ještě nedokončil úvodní nastavení:

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

Krok `CheckOnboardingHandler` může zkontrolovat stav a pomocí [podmíněného větvení](https://queuety.inline0.dev/cs/docs/workflows/conditional) přeskočit připomenutí, pokud už je úvodní nastavení dokončeno.

## Příklad: opakování s prodlevou

Vložte záměrné prodlevy mezi kroky podobné opakovaným pokusům:

```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' ] );
```

## Více prodlev

Workflow může obsahovat libovolný počet kroků s prodlevou. Každá prodleva je nezávislá a ve stavu workflow se sleduje pod sekvenčním názvem (`delay_0`, `delay_1` atd.).

```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 );
```