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>

backend/api/location/sync_location.php

@@ -0,0 +1,42 @@
+<?php
+/**
+ * sync_location.php
+ * Unified endpoint for receiving passenger location updates from:
+ * - App Usage (Primary)
+ * - Geofencing Events (Secondary)
+ * - Silent Push Wakeups (Tertiary)
+ */
+
+require_once __DIR__ . '/../../connect.php';
+// require_once __DIR__ . '/../../functions.php';
+require_once __DIR__ . '/../../core/Services/LocationIntelligenceEngine.php';
+
+// Validate JWT or traditional auth if needed. For now, rely on standard filterRequest if used.
+$passengerId = filterRequest('passenger_id');
+$lat = filterRequest('lat', 'float');
+$lng = filterRequest('lng', 'float');
+$source = filterRequest('source') ?? 'app_usage'; // 'app_usage', 'geofence', 'silent_push'
+$batteryLevel = filterRequest('battery_level', 'int');
+
+if (!$passengerId || !$lat || !$lng) {
+    http_response_code(400);
+    echo json_encode(['status' => 'failure', 'message' => 'Missing required parameters (passenger_id, lat, lng).']);
+    exit;
+}
+
+try {
+    $engine = new LocationIntelligenceEngine($con);
+    $newGeofences = $engine->processLocationUpdate($passengerId, $lat, $lng, $source, $batteryLevel);
+    
+    // Respond with success and optionally new geofences
+    echo json_encode([
+        'status' => 'success',
+        'message' => 'Location synced successfully',
+        'update_geofences' => $newGeofences // App can use this array to update device geofencing regions
+    ]);
+} catch (Exception $e) {
+    error_log("[sync_location.php] Error: " . $e->getMessage());
+    http_response_code(500);
+    echo json_encode(['status' => 'failure', 'message' => 'Internal server error.']);
+}
+?>