# Penundaan Persisten

Alur kerja dapat dijeda selama durasi tetap di antara langkah menggunakan metode pembuat `delay()`. Langkah penundaan bersifat persisten: penundaannya disimpan di database, sehingga tetap berlaku setelah worker dimulai ulang, deployment, dan server dinyalakan ulang.

## Metode `->delay()`

Tambahkan langkah penundaan di bagian mana pun dalam rangkaian alur kerja:

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

Alur kerja akan:

1. Menjalankan `SendWelcomeEmailHandler`
2. Menunggu 1 hari
3. Menjalankan `SendFollowUpEmailHandler`
4. Menunggu 3 hari
5. Menjalankan `SendFinalEmailHandler`

## Parameter durasi

Metode `delay()` menerima kombinasi parameter durasi bernama apa pun:

| Parameter | Jenis | Deskripsi |
|---|---|---|
| `$seconds` | `int` | Detik untuk menunggu |
| `$minutes` | `int` | Menit untuk menunggu |
| `$hours` | `int` | Jam untuk menunggu |
| `$days` | `int` | Hari untuk menunggu |

Semua nilai dijumlahkan. Contoh berikut setara:

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

Anda dapat menggabungkannya:

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

## Cara kerja langkah penundaan

Saat alur kerja mencapai langkah penundaan, Queuety mengirim tugas internal `__queuety_delay` dengan kolom `available_at` yang diatur ke waktu saat ini ditambah durasi penundaan. Tugas tersebut berada di database dan tidak diklaim oleh worker mana pun sampai penundaannya berakhir.

Artinya:

- **Tanpa polling.** Worker tidak berulang kali memeriksa penundaan. Tugas cukup menjadi tersedia saat waktunya tiba.
- **Tanpa penggunaan memori.** Tidak ada proses yang berjalan selama menunggu. Penundaan hanya ada sebagai baris database.
- **Tetap ada setelah dimulai ulang.** Jika worker dimulai ulang, tugas penundaan tetap berada dalam antrean dengan stempel waktu `available_at` yang benar.

Saat tugas penundaan diklaim setelah masa penundaan, alur kerja otomatis berlanjut ke langkah berikutnya.

## Contoh: notifikasi tertunda

Kirim pengingat 1 jam setelah pengguna mendaftar, tetapi hanya jika mereka belum menyelesaikan orientasi awal:

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

Langkah `CheckOnboardingHandler` dapat memeriksa status dan menggunakan [percabangan bersyarat](https://queuety.inline0.dev/id/docs/workflows/conditional) untuk melewati pengingat jika orientasi awal sudah selesai.

## Contoh: percobaan ulang dengan jeda bertahap

Sisipkan penundaan yang disengaja di antara langkah-langkah mirip percobaan ulang:

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

## Beberapa penundaan

Alur kerja dapat berisi langkah penundaan dalam jumlah berapa pun. Setiap penundaan bersifat independen dan dilacak dengan nama berurutan (`delay_0`, `delay_1`, dan seterusnya) dalam status alur kerja.

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