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>

apps/rider/lib/controller/auth/otp_controller.dart

@@ -0,0 +1,178 @@
+import 'package:siro_rider/constant/links.dart';
+import 'package:get/get.dart';
+import '../../../constant/box_name.dart';
+import '../../../main.dart';
+import '../../../print.dart';
+import '../../views/auth/otp_page.dart';
+import '../../views/widgets/error_snakbar.dart';
+import '../functions/crud.dart';
+import '../functions/encrypt_decrypt.dart';
+import '../functions/package_info.dart';
+import '../functions/country_logic.dart';
+import 'login_controller.dart';
+
+// --- Helper Class for Phone Authentication ---
+
+class PhoneAuthHelper {
+  // Define your server URLs
+  static final String _sendOtpUrl = '${AppLink.server}/auth/otp/request.php';
+  static final String _verifyOtpUrl = '${AppLink.server}/auth/otp/verify.php';
+  static final String _registerUrl =
+      '${AppLink.server}/auth/passenger/register.php';
+
+  // removed formatSyrianPhone
+
+  /// Sends an OTP to the provided phone number.
+  static Future<bool> sendOtp(String phoneNumber) async {
+    try {
+      final detectedCountry = AppLink.detectCountryFromPhone(phoneNumber);
+      if (detectedCountry.isNotEmpty) {
+        await box.write(BoxName.countryCode, detectedCountry);
+      }
+      // إصلاح الرقم قبل الإرسال
+      final fixedPhone = CountryLogic.formatCurrentCountryPhone(phoneNumber);
+
+      final response = await CRUD().post(
+        link: _sendOtpUrl,
+        payload: {
+          'receiver': fixedPhone,
+          'context': 'login',
+          'user_type': 'passenger'
+        },
+      );
+
+      if (response != 'failure') {
+        final data = response;
+
+        if (data['status'] == 'success') {
+          mySnackbarSuccess('An OTP has been sent to your number.'.tr);
+          return true;
+        } else {
+          mySnackbarError(data['message'] ?? 'Failed to send OTP.');
+          return false;
+        }
+      } else {
+        mySnackbarError('Server error. Please try again.'.tr);
+        return false;
+      }
+    } catch (e) {
+      return false;
+    }
+  }
+
+  /// Verifies the OTP and logs the user in.
+
+  static Future<void> verifyOtp(String phoneNumber, String otpCode) async {
+    try {
+      final fixedPhone = CountryLogic.formatCurrentCountryPhone(phoneNumber);
+      final String fingerPrint = await DeviceHelper.getDeviceFingerprint();
+      final response = await CRUD().post(
+        link: _verifyOtpUrl,
+        payload: {
+          'phone_number': fixedPhone,
+          'token_code': otpCode,
+          'context': 'login',
+          'user_type': 'passenger',
+          'fingerPrint': fingerPrint,
+        },
+      );
+
+      if (response != 'failure') {
+        final data = (response);
+        Log.print('data: ${data}');
+
+        if (data['status'] == 'success') {
+          final isRegistered = data['message']['isRegistered'] ?? false;
+          Log.print('isRegistered: ${isRegistered}');
+
+          if (isRegistered) {
+            final jwtToken = data['message']?['jwt'] ??
+                data['message']?['token'] ??
+                data['message']?['access_token'];
+            if (jwtToken != null && jwtToken.toString().isNotEmpty) {
+              box.write(BoxName.jwt, c(jwtToken.toString()));
+              await storage.write(
+                  key: BoxName.jwt, value: c(jwtToken.toString()));
+            }
+            // ✅ المستخدم موجود مسبقاً -> تسجيل دخول مباشر
+            await _handleSuccessfulLogin(data['message']['passenger']);
+          } else {
+            // ✅ مستخدم جديد -> الذهاب لصفحة التسجيل
+            mySnackbarSuccess(
+                'Phone verified. Please complete registration.'.tr);
+            Get.to(() => RegistrationScreen(phoneNumber: phoneNumber));
+          }
+        } else {
+          mySnackbarError(data['message']);
+        }
+      } else {
+        mySnackbarError('Server error. Please try again.'.tr);
+      }
+    } catch (e) {
+      mySnackbarError('An error occurred: $e');
+    }
+  }
+
+  static Future<void> _addTokens() async {
+    String fingerPrint = await DeviceHelper.getDeviceFingerprint();
+
+    var res = await CRUD()
+        // this for register and login //
+        .post(link: "${AppLink.server}/ride/firebase/addToken.php", payload: {
+      'token': (box.read(BoxName.tokenFCM)),
+      'passengerID': box.read(BoxName.passengerID).toString(),
+      "fingerPrint": fingerPrint
+    });
+    Log.print('res token: ${res}');
+  }
+
+  static Future<void> registerUser({
+    required String phoneNumber,
+    required String firstName,
+    required String lastName,
+    String? email,
+  }) async {
+    try {
+      final fixedPhone = CountryLogic.formatCurrentCountryPhone(phoneNumber);
+      final response = await CRUD().post(
+        link: _registerUrl,
+        payload: {
+          'phone_number': fixedPhone,
+          'first_name': firstName,
+          'last_name': lastName,
+          'email': email ?? '', // Send empty string if null
+        },
+      );
+      final data = (response);
+      if (data != 'failure') {
+        // Registration successful, log user in
+
+        await _handleSuccessfulLogin(data['message']['data']);
+      } else {
+        mySnackbarError(
+            "User with this phone number or email already exists.".tr);
+      }
+    } catch (e) {
+      Log.print('e: ${e}');
+      mySnackbarError('An error occurred: $e');
+    }
+  }
+
+  static Future<void> _handleSuccessfulLogin(
+      Map<String, dynamic> userData) async {
+    mySnackbarSuccess('Welcome, ${userData['first_name']}!');
+
+    // Save user data to local storage (Hive box) using new keys
+    box.write(BoxName.passengerID, userData['id']);
+    box.write(BoxName.name, userData['first_name']);
+    box.write(BoxName.lastName, userData['last_name']);
+    box.write(BoxName.email, userData['email']);
+    box.write(BoxName.phone, userData['phone']);
+    box.write(BoxName.isVerified, '1');
+    await _addTokens();
+    await Get.put(LoginController()).loginUsingCredentials(
+      box.read(BoxName.passengerID).toString(),
+      box.read(BoxName.email).toString(),
+    ); // Navigate to home
+  }
+}