# التأخيرات الدائمة

يمكن لسيرورات العمل التوقف مؤقتًا لمدة محددة بين الخطوات باستخدام طريقة البناء `delay()`. خطوات التأخير دائمة: تُخزّن مدة التأخير في قاعدة البيانات، لذا تبقى محفوظة بعد إعادة تشغيل العامل أو النشر أو إعادة تشغيل الخادم.

## الطريقة `->delay()`

أضف خطوة تأخير في أي موضع ضمن سلسلة سيرورة العمل:

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

ستقوم سيرورة العمل بما يلي:

1. تشغيل `SendWelcomeEmailHandler`
2. الانتظار يومًا واحدًا
3. تشغيل `SendFollowUpEmailHandler`
4. الانتظار 3 أيام
5. تشغيل `SendFinalEmailHandler`

## معلمات المدة

تقبل الطريقة `delay()` أي مجموعة من معلمات المدة المسماة:

| المعلمة | النوع | الوصف |
|---|---|---|
| `$seconds` | `int` | ثوانٍ للانتظار |
| `$minutes` | `int` | دقائق للانتظار |
| `$hours` | `int` | ساعات للانتظار |
| `$days` | `int` | أيام للانتظار |

تُجمع جميع القيم معًا. وهذان التعبيران متكافئان:

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

يمكنك دمجها:

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

## آلية عمل خطوات التأخير

عندما تصل سيرورة العمل إلى خطوة تأخير، ترسل Queuety مهمة داخلية من نوع `__queuety_delay`، مع ضبط عمود `available_at` على الوقت الحالي مضافًا إليه مدة التأخير. تبقى المهمة في قاعدة البيانات ولا يتولاها أي عامل حتى انقضاء مدة التأخير.

وهذا يعني:

- **لا استقصاء دوري.** لا تتحقق العوامل من التأخير مرارًا. تصبح المهمة متاحة ببساطة عند حلول موعدها.
- **لا استهلاك للذاكرة.** لا يعمل أي شيء أثناء الانتظار. لا يوجد التأخير إلا كسجل في قاعدة البيانات.
- **تظل محفوظة بعد إعادة التشغيل.** إذا أُعيد تشغيل العامل، تظل مهمة التأخير في قائمة الانتظار بالطابع الزمني الصحيح `available_at`.

عندما يتولى عامل مهمة التأخير بعد انقضاء المدة، تنتقل سيرورة العمل تلقائيًا إلى الخطوة التالية.

## مثال: إشعارات مؤجلة

أرسل تذكيرًا بعد ساعة من تسجيل المستخدم، ولكن فقط إذا لم يكن قد أكمل الإعداد الأولي:

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

يمكن لخطوة `CheckOnboardingHandler` فحص الحالة واستخدام [التفرع الشرطي](https://queuety.inline0.dev/ar/docs/workflows/conditional) لتخطي التذكير إذا كان الإعداد الأولي مكتملًا بالفعل.

## مثال: إعادة المحاولة مع التراجع التدريجي

أدرج تأخيرات مقصودة بين الخطوات التي تشبه إعادة المحاولة:

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

## تأخيرات متعددة

يمكن أن تتضمن سيرورة العمل أي عدد من خطوات التأخير. ويُتتبّع كل تأخير بشكل مستقل باسم تسلسلي (`delay_0`، `delay_1`، وما إلى ذلك) في حالة سيرورة العمل.

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