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/ride/ecash/driver/ecash_webhook.php

@@ -0,0 +1,91 @@
+<?php
+// استخدام ملف اتصال خاص بالـ Webhook لا يحتوي على أي تحقق من الهوية
+include "../../../jwtconnect.php";
+
+/*
+|--------------------------------------------------------------------------
+| ملف Webhook النهائي الخاص بـ eCash (مع تسجيل إضافي للتصحيح)
+|--------------------------------------------------------------------------
+*/
+
+// --- الإعدادات ---
+$ecash_merchant_id = getenv('ECASH_MERCHANT_ID');
+$ecash_merchant_secret = getenv('ECASH_MERCHANT_SECRET');
+
+// --- إعداد ملف اللوج (Log File) ---
+$log_dir = __DIR__ . '/../logs';
+$log_file = $log_dir . '/ecash_production.log';
+
+if (!is_dir($log_dir)) {
+    mkdir($log_dir, 0755, true);
+}
+
+// --- قراءة البيانات القادمة من eCash ---
+$raw_body = file_get_contents("php://input");
+$data = json_decode($raw_body, true);
+
+// --- تسجيل الـ Callback كاملاً لأغراض المراقبة ---
+file_put_contents($log_file, "--- NEW WEBHOOK ---\n" . date('Y-m-d H:i:s') . " - RAW BODY: " . $raw_body . PHP_EOL, FILE_APPEND);
+
+if (!$data || !isset($data['Token'])) {
+    http_response_code(400);
+    exit;
+}
+
+// --- استخراج البيانات ---
+$isSuccess = $data['IsSuccess'] ?? false;
+$transactionNo = $data['TransactionNo'] ?? '';
+$amount = $data['Amount'] ?? '';
+$orderRef = $data['OrderRef'] ?? '';
+$receivedToken = $data['Token'];
+
+// --- **تصحيح الأخطاء: بناء وتسجيل سلسلة التحقق** ---
+$verification_string = $ecash_merchant_id . $ecash_merchant_secret . $transactionNo . $amount . $orderRef;
+$expectedToken = strtoupper(md5($verification_string));
+
+// تسجيل السلسلة المستخدمة في التوقيع والقيم الفردية
+$debug_log = "VERIFICATION STRING: " . $verification_string . PHP_EOL;
+$debug_log .= "   - Merchant ID Used: " . $ecash_merchant_id . PHP_EOL;
+$debug_log .= "   - TransactionNo Used: " . $transactionNo . PHP_EOL;
+$debug_log .= "   - Amount Used: " . $amount . PHP_EOL;
+$debug_log .= "   - OrderRef Used: " . $orderRef . PHP_EOL;
+$debug_log .= "CALCULATED TOKEN: " . $expectedToken . PHP_EOL;
+$debug_log .= "RECEIVED TOKEN:   " . $receivedToken . PHP_EOL;
+
+file_put_contents($log_file, $debug_log, FILE_APPEND);
+
+
+// --- التحقق من صحة الـ Token ---
+if (!hash_equals($expectedToken, $receivedToken)) {
+    http_response_code(401);
+    file_put_contents($log_file, "TOKEN MISMATCH! Process stopped." . PHP_EOL, FILE_APPEND);
+    exit;
+}
+
+// --- تحديث حالة الدفعة في قاعدة البيانات ---
+file_put_contents($log_file, "TOKEN MATCH! Proceeding to update database." . PHP_EOL, FILE_APPEND);
+$payment_status = $isSuccess ? 1 : 0;
+
+try {
+    $stmt = $con->prepare(
+        "UPDATE `paymentsLogSyriaDriver` SET status = :status, updated_at = NOW() WHERE order_ref = :order_ref AND status = 2"
+    );
+    $stmt->execute([
+        ':status' => $payment_status,
+       
+        ':order_ref' => $orderRef
+    ]);
+
+    if ($stmt->rowCount() > 0) {
+        http_response_code(200);
+        file_put_contents($log_file, "SUCCESS: Database updated." . PHP_EOL, FILE_APPEND);
+    } else {
+        http_response_code(200);
+        file_put_contents($log_file, "INFO: Order not found or already processed." . PHP_EOL, FILE_APPEND);
+    }
+
+} catch (PDOException $e) {
+    http_response_code(500);
+    file_put_contents($log_file, "FATAL: Database update failed: " . $e->getMessage() . PHP_EOL, FILE_APPEND);
+}
+?>