Update: 2026-07-12 18:53:59

backend/transit/schema_transit.sql

@@ -198,7 +198,7 @@ CREATE TABLE IF NOT EXISTS `transit_trips` (
   `route_id`        INT UNSIGNED  NOT NULL,
   `org_id`          INT UNSIGNED  NOT NULL,
   `driver_id`       INT UNSIGNED  NOT NULL,
-  `vehicle_id`      INT UNSIGNED  NOT NULL,
+  `vehicle_id`      INT UNSIGNED  DEFAULT NULL COMMENT 'NULL إن كان الجدول بلا باص مخصص',
   `trip_date`       DATE          NOT NULL,
   `status`          ENUM('scheduled','started','completed','cancelled','no_show') NOT NULL DEFAULT 'scheduled',
   `started_at`      TIMESTAMP     DEFAULT NULL,
@@ -221,7 +221,7 @@ CREATE TABLE IF NOT EXISTS `transit_trips` (
 CREATE TABLE IF NOT EXISTS `transit_enrollments` (
   `id`              INT UNSIGNED  NOT NULL AUTO_INCREMENT,
   `org_id`          INT UNSIGNED  NOT NULL,
-  `passenger_id`    VARCHAR(100)  NOT NULL COMMENT 'معرّف في جدول passengers الرئيسي',
+  `passenger_id`    VARCHAR(100)  DEFAULT NULL COMMENT 'معرّف في جدول passengers الرئيسي — NULL لصفوف الكشف قبل تفعيل الطالب',
   `student_id`      VARCHAR(50)   NOT NULL COMMENT 'الرقم الجامعي/الوظيفي (encrypted)',
   `member_name`     VARCHAR(120)  DEFAULT NULL COMMENT 'الاسم من كشف الجامعة',
   `preferred_stop_id` INT UNSIGNED DEFAULT NULL COMMENT 'محطتي المفضلة',
@@ -331,6 +331,14 @@ CREATE TABLE IF NOT EXISTS `transit_otp_log` (
 
 SET FOREIGN_KEY_CHECKS = 1;
 
+-- -----------------------------------------------------------------
+-- ترحيل (Migration) لقاعدة أُنشئت قبل 2026-07-12 — نفّذ مرة واحدة:
+-- ALTER TABLE transit_enrollments MODIFY passenger_id VARCHAR(100) DEFAULT NULL
+--   COMMENT 'معرّف في جدول passengers الرئيسي — NULL لصفوف الكشف قبل تفعيل الطالب';
+-- ALTER TABLE transit_trips MODIFY vehicle_id INT UNSIGNED DEFAULT NULL
+--   COMMENT 'NULL إن كان الجدول بلا باص مخصص';
+-- -----------------------------------------------------------------
+
 -- -----------------------------------------------------------------
 -- ملاحظات الـ Redis (keys تُكتب من PHP — ليست في SQL)
 -- transit:trip:{trip_id}:pos      → آخر موقع GPS للباص (Hash: lat,lng,ts)