Update: 2026-08-07 01:35:27

backend/ride/rides/add_ride.php

@@ -16,22 +16,20 @@ try {
 // =================================================================================
 // 🛠️ دالة مساعدة: إرسال الرحلة لسوق السائقين (Marketplace Broadcast)
 // =================================================================================
-function broadcastRideToMarket($rideId, $lat, $lng, $payloadData, $extraMarketData = []) {
-    $url = getenv('LOCATION_SOCKET_URL') ?: 'http://socket_driver:2021';
-    if (strpos($url, 'localhost') !== false || strpos($url, '127.0.0.1') !== false) {
-        if (file_exists('/.dockerenv')) {
-            $url = str_replace(['localhost', '127.0.0.1'], 'socket_driver', $url);
-        }
-    }
-    $INTERNAL_KEY = function_exists('getInternalSocketKey') ? getInternalSocketKey() : '';
-    // ⚠️ هذه الحمولة تُبَثّ لكل سائق قريب (وليس للفائز فقط) — لا نضع فيها أي
-    // بيانات راكب حسّاسة (هاتف/إيميل/FCM token). ما ينقص السائق من تفاصيل
-    // الراكب يجلبه بعد نجاح القبول، والسيرفر يحلّ التوكن بنفسه في acceptRide.php.
-    //
-    // أسماء الحقول تطابق getRideWaiting.php لأن available_rides_page.dart يحشر
-    // رحلات الـ socket في نفس القائمة ويقرأ منها بنفس المفاتيح — أي حقل ناقص
-    // يصل للسيرفر لاحقاً كنص "null".
-    $marketPayload = array_merge([
+/**
+ * ‏حمولة الرحلة كما يراها السائق قبل القبول.
+ *
+ * ‏مشتركة بين البثّ الحر والإسناد بالدفعات عمداً: أي حقل يظهر في أحدهما
+ * ‏ولا يظهر في الآخر يصل للسيرفر لاحقاً كنص "null".
+ *
+ * ⚠️ ‏لا تضع هنا أي بيانات راكب حسّاسة (هاتف/إيميل/FCM token) — هذه الحمولة
+ * ‏تصل سائقين لن يقودوا الرحلة. التفاصيل تُجلب بعد نجاح القبول.
+ *
+ * ‏أسماء الحقول تطابق getRideWaiting.php لأن available_rides_page.dart يحشر
+ * ‏رحلات الـ socket في نفس القائمة ويقرأ منها بنفس المفاتيح.
+ */
+function buildMarketPayload($rideId, $lat, $lng, $payloadData, $extraMarketData = []) {
+    return array_merge([
         'id'             => (string)$rideId,
         'start_lat'      => $lat,
         'start_lng'      => $lng,
@@ -48,6 +46,52 @@ function broadcastRideToMarket($rideId, $lat, $lng, $payloadData, $extraMarketDa
         'passengerRate'  => $payloadData[33],
         'passengerId'    => $payloadData[7],
     ], $extraMarketData);
+}
+
+/**
+ * ‏يوقظ العرض المتسلسل في السوكِت بعد أن بنى dispatchStartBatched الطابور.
+ * ‏السوكِت هو صاحب المؤقّت لأنه العملية الوحيدة طويلة العمر (Workerman
+ * ‏Timer) — كرون كل دقيقة لا يصلح لمهلة عشر ثوانٍ.
+ */
+function notifySocketStartBatchedDispatch($rideId) {
+    $url = getenv('LOCATION_SOCKET_URL') ?: 'http://socket_driver:2021';
+    if (file_exists('/.dockerenv')) {
+        $url = str_replace(['localhost', '127.0.0.1'], 'socket_driver', $url);
+    }
+    $INTERNAL_KEY = function_exists('getInternalSocketKey') ? getInternalSocketKey() : '';
+
+    $ch = curl_init();
+    curl_setopt($ch, CURLOPT_URL, $url);
+    curl_setopt($ch, CURLOPT_POST, 1);
+    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
+        'action'  => 'start_batched_dispatch',
+        'ride_id' => $rideId,
+    ]));
+    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+    curl_setopt($ch, CURLOPT_TIMEOUT_MS, 2000);
+    if ($INTERNAL_KEY) {
+        curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-internal-key: $INTERNAL_KEY"]);
+    }
+    curl_exec($ch);
+    curl_close($ch);
+}
+
+function broadcastRideToMarket($rideId, $lat, $lng, $payloadData, $extraMarketData = []) {
+    $url = getenv('LOCATION_SOCKET_URL') ?: 'http://socket_driver:2021';
+    if (strpos($url, 'localhost') !== false || strpos($url, '127.0.0.1') !== false) {
+        if (file_exists('/.dockerenv')) {
+            $url = str_replace(['localhost', '127.0.0.1'], 'socket_driver', $url);
+        }
+    }
+    $INTERNAL_KEY = function_exists('getInternalSocketKey') ? getInternalSocketKey() : '';
+    // ⚠️ هذه الحمولة تُبَثّ لكل سائق قريب (وليس للفائز فقط) — لا نضع فيها أي
+    // بيانات راكب حسّاسة (هاتف/إيميل/FCM token). ما ينقص السائق من تفاصيل
+    // الراكب يجلبه بعد نجاح القبول، والسيرفر يحلّ التوكن بنفسه في acceptRide.php.
+    //
+    // أسماء الحقول تطابق getRideWaiting.php لأن available_rides_page.dart يحشر
+    // رحلات الـ socket في نفس القائمة ويقرأ منها بنفس المفاتيح — أي حقل ناقص
+    // يصل للسيرفر لاحقاً كنص "null".
+    $marketPayload = buildMarketPayload($rideId, $lat, $lng, $payloadData, $extraMarketData);
 
     $postData = [
         'action'  => 'market_new_ride', 
@@ -428,15 +472,44 @@ try {
         }
     }
 
-    if (!empty($driversData)) {
-        dispatchRideToDrivers($driversData, $insertedId, $payload, $start_name_loc, $encryptionHelper, $extraDispatchData);
-        error_log("[add_ride] Dispatched RideID=$insertedId to " . count($driversData) . " drivers.");
-    } else {
-        error_log("[add_ride] No direct drivers found for RideID=$insertedId — market only.");
+    // ═══════════════════════════════════════════════════════════
+    // الإسناد — بالدفعات أو بالبثّ الحر
+    //
+    // ‏batched: عرض حصري متسلسل على مرشحين مرتبين. لا بثّ للسوق، ولا
+    // ‏إشعار جماعي — وإلا لضاع معنى الحصرية.
+    // ‏broadcast (الافتراضي): السلوك القائم حرفياً بلا أي تغيير.
+    // ═══════════════════════════════════════════════════════════
+    require_once __DIR__ . '/../dispatch/dispatch_helper.php';
+
+    $batchedStarted = false;
+    if (dispatchIsBatched((string) ($payload[31] ?? ''))) {
+        $batchedStarted = dispatchStartBatched(
+            $redisLocation ?? null,
+            $insertedId,
+            $driversData ?: [],
+            buildMarketPayload($insertedId, $startLat, $startLng, $payload, $extraDispatchData)
+        );
+
+        if ($batchedStarted) {
+            notifySocketStartBatchedDispatch($insertedId);
+            error_log("[add_ride] RideID=$insertedId أُسند بالدفعات.");
+        } else {
+            error_log("[add_ride] تعذّر الإسناد بالدفعات RideID=$insertedId"
+                . " — السقوط للبثّ الحر.");
+        }
     }
 
-    // Broadcast للـ marketplace دائماً
-    broadcastRideToMarket($insertedId, $startLat, $startLng, $payload, $extraDispatchData);
+    if (!$batchedStarted) {
+        if (!empty($driversData)) {
+            dispatchRideToDrivers($driversData, $insertedId, $payload, $start_name_loc, $encryptionHelper, $extraDispatchData);
+            error_log("[add_ride] Dispatched RideID=$insertedId to " . count($driversData) . " drivers.");
+        } else {
+            error_log("[add_ride] No direct drivers found for RideID=$insertedId — market only.");
+        }
+
+        // Broadcast للـ marketplace دائماً
+        broadcastRideToMarket($insertedId, $startLat, $startLng, $payload, $extraDispatchData);
+    }
 
     // رد النجاح للتطبيق
     printSuccess($insertedId);