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/finalize_payment.php

@@ -0,0 +1,79 @@
+<?php
+// هذا الملف يجب أن يستخدم ملف الاتصال الذي يتحقق من الهوية
+include "../../../jwtconnect.php";
+// يجب استدعاء دالة التحقق هنا لضمان أن الطلب قادم من تطبيقك فقط
+
+
+/*
+|--------------------------------------------------------------------------
+| ملف إتمام الدفع النهائي
+|--------------------------------------------------------------------------
+|
+| هذا الملف مسؤول عن:
+| 1. استقبال طلب من تطبيق فلاتر بعد عودة المستخدم.
+| 2. التحقق من وجود دفعة ناجحة حديثة للمستخدم في قاعدة البيانات.
+| 3. حساب المكافآت.
+| 4. استدعاء واجهات API داخلية لإضافة الرصيد إلى المحافظ.
+|
+*/
+
+// --- استقبال البيانات من تطبيق فلاتر ---
+$userId = filterRequest("userId"); // أو driverId
+$paymentMethod = filterRequest("paymentMethod") ?? 'ecash';
+
+if (empty($userId)) {
+    printFailure("معرّف المستخدم غير صالح.");
+    exit;
+}
+
+try {
+    // خطوة 1: البحث عن آخر دفعة ناجحة للمستخدم (تم تحديثها بواسطة الـ Webhook)
+    $stmt = $con->prepare(
+        "SELECT * FROM `paymentsLogSyria` 
+         WHERE user_id = :user_id 
+         AND status = 1 
+         AND updated_at >= DATE_SUB(NOW(), INTERVAL 5 MINUTE)
+         ORDER BY updated_at DESC 
+         LIMIT 1"
+    );
+    $stmt->bindParam(':user_id', $userId, PDO::PARAM_STR);
+    $stmt->execute();
+    $payment = $stmt->fetch(PDO::FETCH_ASSOC);
+
+    if (!$payment) {
+        printFailure("لم يتم العثور على دفعة ناجحة حديثة.");
+        exit;
+    }
+
+    // خطوة 2: الحصول على المبلغ (لا يحتاج للقسمة على 100)
+    $amount = $payment['amount'];
+
+    // خطوة 3: حساب المكافأة
+    $finalAmount = calculateBonus($amount); // استخدم دالة حساب المكافآت الخاصة بك
+
+    $passengerId = $userId; // نفترض أن معرّف المستخدم هو نفسه معرّف الراكب
+
+    // --- هنا تضع نفس منطق إضافة الرصيد الذي كان في ملف payment_verify.php القديم ---
+    // (مثال)
+    // $token = generatePaymentToken($passengerId, $finalAmount);
+    // addToPassengerWallet($passengerId, $finalAmount, $token);
+    // ... إلخ
+
+    // --- النجاح النهائي ---
+    printSuccess("تمت معالجة الدفع وتحديث الرصيد بنجاح.");
+
+} catch (PDOException $e) {
+    error_log("Finalize Payment Error: " . $e->getMessage());
+    printFailure("حدث خطأ في قاعدة البيانات أثناء إتمام العملية.");
+}
+
+// --- يمكنك وضع دوال المساعدة هنا (calculateBonus, etc.) ---
+function calculateBonus($amount) {
+    $result = $amount;  
+    if ($amount == 200) $result = 215;
+    else if ($amount == 400) $result = 450;
+  	else if ($amount == 100) $result = 100.0;
+    else if ($amount == 1000) $result = 1140;
+    return $result;
+}
+?>