# Noturīgas aizkaves

Darbplūsmas var ieturēt noteikta ilguma pauzi starp soļiem, izmantojot veidotāja metodi `delay()`. Aizkaves soļi ir noturīgi: aizkave tiek saglabāta datubāzē, tāpēc tā saglabājas pēc darbinieku restartēšanas, izvietošanas un serveru pārstartēšanas.

## Metode `->delay()`

Pievienojiet aizkaves soli jebkur darbplūsmas ķēdē:

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

Darbplūsma veiks tālāk norādīto:

1. Izpilda `SendWelcomeEmailHandler`
2. Gaidīs 1 dienu
3. Izpilda `SendFollowUpEmailHandler`
4. Gaidīs 3 dienas
5. Izpilda `SendFinalEmailHandler`

## Ilguma parametri

Metode `delay()` pieņem jebkuru nosaukto ilguma parametru kombināciju:

| Parametrs | Tips | Apraksts |
|---|---|---|
| `$seconds` | `int` | Sekunžu skaits, ko gaidīt |
| `$minutes` | `int` | Minūšu skaits, ko gaidīt |
| `$hours` | `int` | Stundu skaits, ko gaidīt |
| `$days` | `int` | Dienu skaits, ko gaidīt |

Visas vērtības tiek summētas. Tālāk norādītais ir līdzvērtīgs:

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

Varat tās kombinēt:

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

## Kā darbojas aizkaves soļi

Kad darbplūsma sasniedz aizkaves soli, Queuety nosūta iekšēju `__queuety_delay` uzdevumu, kura kolonnai `available_at` tiek iestatīts pašreizējais laiks plus aizkaves ilgums. Uzdevums atrodas datubāzē, un neviens darbinieks to nepieprasa, līdz aizkave ir beigusies.

Tas nozīmē:

- **Nav periodiskas pārbaudes.** Darbinieki atkārtoti nepārbauda aizkavi. Kad pienāk laiks, uzdevums vienkārši kļūst pieejams.
- **Netiek izmantota atmiņa.** Gaidīšanas laikā nekas nedarbojas. Aizkave pastāv tikai kā datubāzes rinda.
- **Saglabājas pēc restartēšanas.** Ja darbinieks tiek restartēts, aizkaves uzdevums joprojām ir rindā ar pareizo laika zīmogu `available_at`.

Kad aizkaves uzdevums pēc aizkaves beigām tiek pieprasīts, darbplūsma automātiski pāriet uz nākamo soli.

## Piemērs: aizkavēti paziņojumi

Nosūtiet atgādinājumu 1 stundu pēc lietotāja reģistrēšanās, taču tikai tad, ja viņš nav pabeidzis sākotnējo iestatīšanu:

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

Solis `CheckOnboardingHandler` var pārbaudīt stāvokli un izmantot [nosacījuma atzarošanu](https://queuety.inline0.dev/lv/docs/workflows/conditional), lai izlaistu atgādinājumu, ja sākotnējā iestatīšana jau ir pabeigta.

## Piemērs: atkārtoti mēģinājumi ar pieaugošu aizkavi

Ievietojiet apzinātas aizkaves starp atkārtotu mēģinājumu soļiem:

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

## Vairākas aizkaves

Darbplūsmā var būt jebkāds skaits aizkaves soļu. Katra aizkave ir neatkarīga un darbplūsmas stāvoklī tiek uzskaitīta ar secīgu nosaukumu (`delay_0`, `delay_1` u.c.).

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