feat: استيراد كود سيرو إلى تريبز (سيرو @ecfe7568) — بلا تعديل

قرار المالك 2026-07-27: باك إند سيرو PHP هو المعتمد، وتطبيقاته المجرّبة
ميدانياً تحل محل إعادة البناء المؤرشفة. سيرو نفسه لم يُمسّ.

الخريطة:
  backend · payment_server · loction_server · ride_server ·
  passenger_server · docker · dashboard · stress_test  → الجذر
  siro_rider  → apps/rider          siro_driver  → apps/driver
  siro_admin  → dashboards/admin    siro_service → dashboards/service
  android_bot → apps/android_bot    socialBot    → apps/socialBot

نُسخ المتعقَّب في git سيرو فقط عبر `git archive` (3,198 ملفاً / ~169 م.ب)
لا `cp -r` — فاستُثنيت مخلفات البناء تلقائياً. بلا أي تعديل محتوى عمداً:
كل ما يلي يصير فرقاً مقروءاً مقابل المصدر.

لم يُستورد وسببه: siromove.com (الموقع التسويقي يبقى marketing/ في تريبز،
سيرو فيه 8 ملفات) · docs و planning (تريبز له docs/ الخاص) · deploy.sh
(ليس نشراً على سيرفر بل `git add . && git push origin --all` — فخّ في
مستودع آخر) · transit_dashboard (بانتظار قرار مصير backend-transit و
dashboards/transit-web).

⚠️ لا يبني بعد — ثلاثة نواقص متوقعة ومقصودة:
1. `.env` و `lib/env/env.g.dart` غير متعقَّبين في سيرو (أسرار لكل مستأجر):
   كل تطبيق فلاتر يحتاج .env خاصاً ثم توليد env.g.dart بـ build_runner.
2. إعدادات Firebase (9 ملفات google-services.json و GoogleService-Info.plist)
   يستبعدها .gitignore تريبز — ولكل مستأجر مشروع Firebase خاص أصلاً.
3. apps/driver في سيرو يشير إلى `../../Intaleq/packages/get` خارج المستودع →
   يجب ضمّ الحزم داخله أسوة بـ apps/rider.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

payment_server/v2/main/sms_webhook/request_payout.php

@@ -0,0 +1,147 @@
+<?php
+// request_payout.php
+include "../connect.php"; // This initializes $decodedToken and $encryptionHelper
+
+error_log("[RequestPayout] --- Request Started ---");
+
+// --- 1. Security Fix (S1): Extract ID from JWT instead of request body ---
+$driverId = null;
+if (isset($decodedToken) && isset($decodedToken->sub)) {
+    $driverId = $decodedToken->sub;
+} else {
+    printFailure("Unauthorized. Valid token required.");
+    exit;
+}
+
+$amount_raw  = filterRequest("amount");
+$wallet_type = filterRequest("wallet_type") ?? 'Sham Cash';
+$otp         = filterRequest("otp");
+
+$amount = is_numeric($amount_raw) ? (float)$amount_raw : 0.0;
+
+// تحقق أساسي
+if (empty($driverId) || $amount <= 0) {
+    printFailure("driverId and a valid amount are required.");
+    exit;
+}
+
+if (empty($otp)) {
+    printFailure("OTP code is required for payout.");
+    exit;
+}
+
+try {
+    // --- 2. Fetch Driver info & Dynamic Fee (S3) ---
+    $stmtDriver = $con->prepare("SELECT phone, site FROM driver WHERE id = :id");
+    $stmtDriver->execute([':id' => $driverId]);
+    $driverInfo = $stmtDriver->fetch(PDO::FETCH_ASSOC);
+
+    if (!$driverInfo) {
+        printFailure("Driver not found.");
+        exit;
+    }
+
+    $phone = $encryptionHelper->decryptData($driverInfo['phone']);
+    $site = $encryptionHelper->decryptData($driverInfo['site']);
+
+    $payout_fee = 0.0;
+    if (strtolower($site) === 'syria') {
+        $payout_fee = 35.00;
+    } elseif (strtolower($site) === 'egypt') {
+        $payout_fee = 10.00;
+    } elseif (strtolower($site) === 'jordan') {
+        $payout_fee = 0.00;
+    } else {
+        $payout_fee = 35.00; // Default fallback
+    }
+
+    $total_deduction = $amount + $payout_fee;
+
+    // --- 3. OTP Verification (S6) ---
+    $encryptedPhone = $encryptionHelper->encryptData($phone);
+    $encryptedOtp = $encryptionHelper->encryptData($otp);
+
+    $stmtOtp = $con->prepare("SELECT id FROM token_verification_driver 
+                              WHERE phone_number = ? AND token = ? 
+                              AND expiration_time > NOW() AND verified = 0 
+                              LIMIT 1");
+    $stmtOtp->execute([$encryptedPhone, $encryptedOtp]);
+    $otpRow = $stmtOtp->fetch(PDO::FETCH_ASSOC);
+
+    if (!$otpRow) {
+        printFailure("Invalid or expired OTP. Please request a new one.");
+        exit;
+    }
+
+    // --- 4. Atomic balance check + deduction + insert (S2, S4) ---
+    $con->beginTransaction();
+
+    $stmt_balance = $con->prepare("
+        SELECT COALESCE(SUM(amount), 0) AS balance
+        FROM driverWallet
+        WHERE driverID = :id
+        FOR UPDATE
+    ");
+    $stmt_balance->execute([':id' => $driverId]);
+    $wallet = $stmt_balance->fetch(PDO::FETCH_ASSOC);
+
+    if ($wallet['balance'] < $total_deduction) {
+        $con->rollBack();
+        printFailure("Insufficient balance. Required: $total_deduction");
+        exit;
+    }
+
+    // S4 Fix: Deduct the balance IMMEDIATELY
+    $insertDriver = $con->prepare("INSERT INTO driverWallet (driverID, paymentID, amount, paymentMethod) VALUES (:driverID, NULL, :amount, :paymentMethod)");
+    $insertDriver->execute([
+        ':driverID' => $driverId, 
+        ':amount' => -$total_deduction,
+        ':paymentMethod' => 'payout_reserved'
+    ]);
+
+    $sql = "
+        INSERT INTO payout_requests (driver_id, driver_phone, amount, wallet_type)
+        VALUES (:did, :phone, :amount, :wallet)
+    ";
+    $stmt = $con->prepare($sql);
+    $stmt->execute([
+        ':did'   => $driverId,
+        ':phone' => $phone,
+        ':amount'=> $amount,
+        ':wallet'=> $wallet_type
+    ]);
+
+    // Mark OTP as verified
+    $con->prepare("UPDATE token_verification_driver SET verified = 1 WHERE id = ?")->execute([$otpRow['id']]);
+
+    $con->commit();
+
+    if ($stmt->rowCount() > 0) {
+        $customerServicePhone = getenv('CUSTOMER_SERVICE_PHONE');
+
+        $message = 
+            "⚠️ طلب دفع جديد:\n" .
+            "ID السائق: {$driverId}\n" .
+            "هاتف السائق: {$phone}\n" .
+            "البلد: {$site}\n" .
+            "نوع المحفظة: {$wallet_type}\n" .
+            "المبلغ المطلوب: {$amount}\n" .
+            "الرسوم المخصومة: {$payout_fee}\n\n" .
+            "الرجاء من فريق خدمة العملاء تنفيذ عملية الدفع الآن.";
+
+        sendWhatsAppFromServer($customerServicePhone, $message);      
+
+        error_log("[RequestPayout] Successfully created payout request for driver ID: $driverId");
+        printSuccess("Payout request created successfully. It will be processed shortly.");
+    } else {
+        printFailure("Failed to create payout request.");
+    }
+
+} catch (PDOException $e) {
+    if ($con->inTransaction()) {
+        $con->rollBack();
+    }
+    error_log("[RequestPayout] PDOException: " . $e->getMessage());
+    printFailure("A database error occurred.");
+}
+?>