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/transit/driver/activate_by_app.php

@@ -0,0 +1,64 @@
+<?php
+// transit/driver/activate_by_app.php — السائق يفعّل حسابه بتوكن الدعوة (عبر JWT)
+// POST: invite_token
+// المصادقة: JWT السائق الرئيسي من connect_app.php
+
+require_once __DIR__ . '/../../transit/connect_app.php';
+
+if ($transit_user_role !== 'driver') jsonError('Only drivers can access this endpoint', 403);
+
+$inviteToken = filterRequest('invite_token');
+if (!$inviteToken) jsonError('invite_token is required', 400);
+
+// البحث بالتوكن فقط — لا نثق بأي معرّف آخر من العميل
+$st = $transit_con->prepare(
+    "SELECT d.id, d.org_id, d.name, d.status, o.name_ar AS org_name
+     FROM transit_drivers d
+     JOIN transit_orgs o ON o.id = d.org_id
+     WHERE d.invite_token=? LIMIT 1"
+);
+$st->execute([$inviteToken]);
+$driver = $st->fetch();
+
+if (!$driver) jsonError('Invalid invite token', 404);
+if ($driver['status'] === 'suspended') jsonError('Account suspended', 403);
+
+// تحقق أن main_driver_id ليس مضبوطاً لحساب آخر
+if ($driver['status'] === 'active') {
+    $chk = $transit_con->prepare(
+        "SELECT main_driver_id FROM transit_drivers WHERE id=? LIMIT 1"
+    );
+    $chk->execute([$driver['id']]);
+    $row = $chk->fetch();
+    if ($row && $row['main_driver_id'] && (string)$row['main_driver_id'] !== (string)$transit_user_id) {
+        jsonError('This invite token is already linked to another account', 409);
+    }
+    // إذا كان نفس الحساب — رد نجاح مباشرة
+    if ($row && (string)$row['main_driver_id'] === (string)$transit_user_id) {
+        jsonSuccess([
+            'driver_id'  => (int)$driver['id'],
+            'org_id'     => (int)$driver['org_id'],
+            'org_name'   => $driver['org_name'],
+            'name'       => $driver['name'],
+        ], 'Already activated');
+    }
+}
+
+// ضبط main_driver_id وتفعيل الحساب
+$transit_con->prepare(
+    "UPDATE transit_drivers
+     SET main_driver_id=?, status='active', activated_at=NOW(), invite_token=NULL, updated_at=NOW()
+     WHERE id=?"
+)->execute([(string)$transit_user_id, $driver['id']]);
+
+// إبطال أي كاش قديم لهذا الحساب (قد يكون كُوش كـ null سابقاً أو بحالة أخرى)
+transitInvalidateDriverCache((string)$transit_user_id);
+
+appLog("[TRANSIT][DRIVER] activated driver #{$driver['id']} (org#{$driver['org_id']}) linked to main_driver_id={$transit_user_id}", 'INFO');
+
+jsonSuccess([
+    'driver_id'  => (int)$driver['id'],
+    'org_id'     => (int)$driver['org_id'],
+    'org_name'   => $driver['org_name'],
+    'name'       => $driver['name'],
+], 'Account activated successfully. Welcome to مواصلاتي!');

backend/transit/driver/invite.php

@@ -0,0 +1,35 @@
+<?php
+// transit/driver/invite.php — المشرف يضيف سائق جديد
+
+require_once __DIR__ . '/../../transit/connect_admin.php';
+
+requireTransitFields(['name', 'phone']);
+$name    = filterRequest('name');
+$phone   = normalizePhone(filterRequest('phone'));
+$license = filterRequest('license_number');
+
+// تشفير الهاتف مثل باقي أرقام الهواتف
+$phoneEnc = $encryptionHelper->encryptData($phone);
+
+$chk = $transit_con->prepare(
+    "SELECT id FROM transit_drivers WHERE phone=? AND org_id=? LIMIT 1"
+);
+$chk->execute([$phoneEnc, $transit_org_id]);
+if ($chk->fetch()) jsonError('Driver phone already registered in this organization', 409);
+
+$inviteToken  = bin2hex(random_bytes(24));
+$mainDriverId = filterRequest('main_driver_id');
+
+$transit_con->prepare(
+    "INSERT INTO transit_drivers
+     (org_id,name,phone,license_number,main_driver_id,invite_token,invite_sent_at,status)
+     VALUES (?,?,?,?,?,?,NOW(),'invited')"
+)->execute([$transit_org_id, $name, $phoneEnc, $license, $mainDriverId, $inviteToken]);
+
+$driverId = (int)$transit_con->lastInsertId();
+
+$appLink = getenv('APP_DEEP_LINK_BASE') ?: 'https://siromove.com/driver/transit-activate';
+$message = "مرحباً {$name}، تمت إضافتك كسائق في منصة مواصلاتي.\nفعّل حسابك: {$appLink}?token={$inviteToken}";
+sendWhatsAppFromServer($phone, $message);
+
+jsonSuccess(['driver_id' => $driverId, 'invite_token' => $inviteToken], 'Driver invited successfully');

backend/transit/driver/list.php

@@ -0,0 +1,27 @@
+<?php
+// transit/driver/list.php
+
+require_once __DIR__ . '/../../transit/connect_admin.php';
+
+$status  = filterRequest('status') ?: 'active';
+$allowed = ['all','invited','active','suspended'];
+if (!in_array($status, $allowed)) $status = 'active';
+
+$sql    = "SELECT id, name, phone, status, activated_at, created_at FROM transit_drivers WHERE org_id=?";
+$params = [$transit_org_id];
+if ($status !== 'all') { $sql .= " AND status=?"; $params[] = $status; }
+$sql .= " ORDER BY name ASC";
+
+$st = $transit_con->prepare($sql);
+$st->execute($params);
+$drivers = $st->fetchAll();
+
+// فك تشفير هواتف السائقين للعرض
+foreach ($drivers as &$d) {
+    if (!empty($d['phone'])) {
+        $d['phone'] = $encryptionHelper->decryptData($d['phone']) ?: '***';
+    }
+}
+unset($d);
+
+jsonSuccess(['drivers' => $drivers]);

backend/transit/driver/me.php

@@ -0,0 +1,30 @@
+<?php
+// transit/driver/me.php — السائق يتحقق هل هو سائق باص، ويحصل على معرّفه في مواصلاتي
+// المصادقة: JWT السائق الرئيسي (نفس main_driver_id)
+
+require_once __DIR__ . '/../../transit/connect_app.php';
+
+if ($transit_user_role !== 'driver') jsonError('Only drivers can access this endpoint', 403);
+
+$st = $transit_con->prepare(
+    "SELECT d.id, d.org_id, d.name, d.status,
+            o.name_ar AS org_name, o.type AS org_type
+     FROM transit_drivers d
+     JOIN transit_orgs o ON o.id = d.org_id
+     WHERE d.main_driver_id = ? LIMIT 1"
+);
+$st->execute([(string)$transit_user_id]);
+$driver = $st->fetch();
+
+if (!$driver) {
+    jsonSuccess(['is_bus_driver' => false]);
+}
+
+jsonSuccess([
+    'is_bus_driver'     => true,
+    'driver_transit_id' => (int)$driver['id'],
+    'org_id'            => (int)$driver['org_id'],
+    'org_name'          => $driver['org_name'],
+    'org_type'          => $driver['org_type'],
+    'status'            => $driver['status'],
+]);

backend/transit/driver/suspend.php

@@ -0,0 +1,32 @@
+<?php
+// transit/driver/suspend.php — تعليق/إعادة تفعيل سائق
+// POST: driver_id, action (suspend|activate)
+
+require_once __DIR__ . '/../../transit/connect_admin.php';
+
+$driverId = filterRequest('driver_id', 'int');
+$action   = filterRequest('action');
+if (!$driverId) jsonError('driver_id is required', 400);
+if (!in_array($action, ['suspend', 'activate'])) jsonError('action must be suspend or activate', 400);
+
+$chk = $transit_con->prepare("SELECT id, status, main_driver_id FROM transit_drivers WHERE id=? AND org_id=? LIMIT 1");
+$chk->execute([$driverId, $transit_org_id]);
+$driver = $chk->fetch();
+if (!$driver) jsonError('Driver not found or access denied', 404);
+
+// إعادة التفعيل غير ممكنة إلا لسائق سبق تفعيله عبر الدعوة (status كان suspended)
+if ($action === 'activate' && $driver['status'] !== 'suspended') {
+    jsonError('Only a suspended driver can be reactivated', 409);
+}
+
+$newStatus = $action === 'suspend' ? 'suspended' : 'active';
+$transit_con->prepare("UPDATE transit_drivers SET status=? WHERE id=?")->execute([$newStatus, $driverId]);
+
+// إبطال كاش السائق فوراً — عند التعليق يجب أن تُرفض رحلاته في الطلب التالي مباشرة
+if (!empty($driver['main_driver_id'])) {
+    transitInvalidateDriverCache((string)$driver['main_driver_id']);
+}
+
+appLog("[TRANSIT][DRIVER][suspend] driver #{$driverId} org#{$transit_org_id} → {$newStatus}");
+
+jsonSuccess(['driver_id' => $driverId, 'status' => $newStatus]);