# Trajne zakasnitve

Poteki dela se lahko med koraki za določen čas začasno ustavijo z metodo gradnika `delay()`. Koraki zakasnitve so trajni: zakasnitev je shranjena v zbirki podatkov, zato se ohrani ob ponovnem zagonu delavcev, uvedbah in ponovnih zagonih strežnika.

## Metoda `->delay()`

Dodajte korak zakasnitve kjer koli v verigo poteka dela:

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

Potek dela bo:

1. Izvedel `SendWelcomeEmailHandler`
2. Počakal 1 dan
3. Izvedel `SendFollowUpEmailHandler`
4. Počakal 3 dni
5. Izvedel `SendFinalEmailHandler`

## Parametri trajanja

Metoda `delay()` sprejema poljubno kombinacijo poimenovanih parametrov trajanja:

| Parameter | Vrsta | Opis |
|---|---|---|
| `$seconds` | `int` | Sekunde čakanja |
| `$minutes` | `int` | Minute čakanja |
| `$hours` | `int` | Ure čakanja |
| `$days` | `int` | Dnevi čakanja |

Vse vrednosti se seštejejo. Naslednja primera sta enakovredna:

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

Lahko jih kombinirate:

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

## Kako delujejo koraki zakasnitve

Ko potek dela doseže korak zakasnitve, Queuety razpošlje interno opravilo `__queuety_delay`, pri katerem je stolpec `available_at` nastavljen na trenutni čas plus trajanje zakasnitve. Opravilo je shranjeno v zbirki podatkov in ga noben delavec ne prevzame, dokler zakasnitev ne poteče.

To pomeni:

- **Brez preverjanja v zanki.** Delavci zakasnitve ne preverjajo znova in znova. Opravilo preprosto postane na voljo, ko nastopi čas.
- **Brez porabe pomnilnika.** Med čakanjem nič ne teče. Zakasnitev obstaja samo kot vrstica v zbirki podatkov.
- **Preživi ponovne zagone.** Če se delavec znova zažene, je opravilo zakasnitve še vedno v čakalni vrsti s pravilnim časovnim žigom `available_at`.

Ko je opravilo zakasnitve prevzeto po njenem poteku, potek dela samodejno nadaljuje z naslednjim korakom.

## Primer: odložena obvestila

Pošljite opomnik 1 uro po prijavi uporabnika, vendar samo, če še ni dokončal uvajanja:

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

Korak `CheckOnboardingHandler` lahko pregleda stanje in uporabi [pogojno razvejanje](https://queuety.inline0.dev/sl/docs/workflows/conditional), da preskoči opomnik, če je uvajanje že zaključeno.

## Primer: ponovni poskus z naraščajočim čakanjem

Med korake, podobne ponovnim poskusom, vstavite načrtovane zakasnitve:

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

## Več zakasnitev

Potek dela lahko vsebuje poljubno število korakov zakasnitve. Vsaka zakasnitev je neodvisna in se v stanju poteka dela spremlja z zaporednim imenom (`delay_0`, `delay_1` itd.).

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