الجدولة (cron)

تُشغّل قناة الجدولة pipeline وفق تقويم محدَّد. وهي مكافئة لـcron، لكنها مُوجَّهة من لوحة الإدارة ومُسجَّلة كأي exchange آخر.

لماذا هذه القناة

ليست كل الـpipelines تفاعلية (استجابةً لبريد أو مكالمة أو webhook). فكثير منها استباقي: تقرير يومي، متابعة أسبوعية، فحص لنظام خارجي كل ساعة. وذلك ما تغطيه قناة الجدولة.

التهيئة

1. الإدارة ← الجدولة ← مهمّة جديدة.
2. اختر:
   • الـpipeline المستهدَف
   • التقويم — ابنِه بصريًا عبر CronBuilder (يوميًا، أسبوعيًا، الأيام والساعات)، أو أدخِل تعبير cron كلاسيكيًا (0 8 * * 1-5 = 8 صباحًا في أيام الأسبوع) أو اختصارًا (@daily، @hourly). لا حاجة إلى معرفة صياغة cron.
   • المنطقة الزمنية — افتراضيًا، المنطقة الزمنية للمؤسسة. قابلة للتهيئة لكل مهمّة.
   • الهدف — تسمية حرّة (مثال: briefing_hebdo، alerte_impayes) تُمرَّر إلى الـpipeline لتوجيهه.
   • حمولة ثابتة — JSON حرّ يُمرَّر كإدخال إلى الـpipeline.

ما يستقبله الـpipeline

عند كل تشغيل، يُنشأ exchange يحتوي على:

• schedule.task_id — مُعرِّف المهمّة المجدولة
• schedule.objectif — تسمية الهدف المُهيَّأ (للتوجيه متعدّد المهام)
• schedule.scheduled_at — الطابع الزمني المخطَّط له
• schedule.actual_at — الطابع الزمني الفعلي (في حال الانحراف)
• schedule.payload — JSON الثابت المُهيَّأ (إن وُجد)

التسامح والاستدراك

إذا كان betool غير متاح لحظة التشغيل (صيانة، حادث)، تُستدرَك المهمّة تلقائيًا عند إعادة التشغيل، ضمن نافذة التسامح التي تهيّئها (ساعة واحدة افتراضيًا).

وبعد النافذة، يُوسَم التشغيل بأنه فائت في السجلّ ولا يُعاد تشغيله — فالتقرير المفقود أفضل من تقرير متأخّر وغير متزامن.

حالات استخدام نموذجية

• تقرير يومي في الساعة 8 صباحًا — وكيل يستعلم من عدّة أنظمة، ويلخّص ويرسل موجزًا عبر البريد الإلكتروني.
• مزامنة كل ساعة — pipeline يسحب العناصر الجديدة من نظام خارجي، ويمرّرها إلى وكيل تصنيف، ويدفع النتائج إلى CRM لديك.
• فحص أسبوعي — وكيل يدقّق حالة بنية تحتية ويشير إلى التباينات.
• متابعة بعد 7 أيام — على العملاء المحتملين المُقدَّمين قبل أسبوع ولا يزالون بلا ردّ.

أفضل الممارسات

• تجنّب البدء في بداية الدقيقة تمامًا — كثير من الأنظمة تنبض عند 0 * * * *. فضّل 7 * * * * لتوزيع الحِمل.
• سجّل المهام التي لا شيء لديها لتفعله. المهمّة التي تعمل ولا تفعل شيئًا (لعدم وجود عناصر للمعالجة) يجب أن تتتبّع ذلك صراحةً. وإلا، فلن تتمكّن من التمييز بين «كل شيء على ما يُرام» و*«المهمّة لم تعد تعمل»*.
• نبّه عند فوات المهام. راجع الأرصدة والقياس ← التنبيهات.