Update: 2026-08-08 12:58:16

docker/crontab.production

@@ -82,13 +82,25 @@ DEX=/usr/bin/docker compose -f $SIRO/docker-compose.yml exec -T php php
 */1 * * * *  $DEX /var/www/backend/bot/cron_sms_requests.php          >> /var/log/sms_requests.log 2>&1
 
 # ============================================================
-# التأمين للسائق
+# التزامات السائق (تأمين، وقود، صيانة)
 # ============================================================
-# يقيّد قسط كل وثيقة نشطة بلغت دورتها. لا يخصم من رصيد أحد — الرصيد
-# في payment_server، وهذا دفتر استحقاق تقرأه التسوية.
+# مُصدِر الاستحقاق: يقيّد استحقاق كل التزام دوري بلغت دورته في
+# obligation_ledger. لا يخصم من رصيد أحد — الرصيد في payment_server.
 # مرة يومياً بعد منتصف الليل: القيد اليومي مرتبط بالتاريخ لا بالساعة.
 15 0 * * *   $DEX /var/www/backend/bot/cron_insurance_premiums.php    >> /var/log/insurance.log 2>&1
 
+# محرك التسوية: الجهة الوحيدة التي تخصم فعلياً من محفظة السائق.
+#
+# لماذا 23:30 لا بعد المُصدِر مباشرة؟
+# لأن السقف اليومي نسبة من أرباح *اليوم*، وهي تُقرأ من صفوف محفظة
+# السائق المؤرخة بتاريخ اليوم. تشغيله الساعة 00:45 يعني قراءة يومٍ
+# عمره خمس وأربعون دقيقة — أرباحه صفر، فالسقف صفر، فلا يُخصم شيء
+# أبداً. المحرك كان سيعمل كل ليلة بلا خطأ واحد وبلا تحصيل قرش.
+#
+# 23:30 تقرأ يوم عمل مكتملاً تقريباً. النصف ساعة المتبقية ليست ضياعاً:
+# ما لم يُحصَّل يبقى في الدفتر ويُلاحَق غداً.
+30 23 * * *  $DEX /var/www/backend/bot/cron_obligation_settlement.php >> /var/log/obligations.log 2>&1
+
 # ============================================================
 # الإشعارات والتسويق
 # ============================================================