@routebot/constants 0.3.76 → 0.3.79

package/constants/company.constants.js

@@ -24,6 +24,9 @@ const COMPANY_FEATURES = {
   // handle them). Default OFF for every plan; enabled per-company via company.features.
   // See: customer-portal.constants.js (backend module lands after this package is released).
   CUSTOMER_PORTAL: "customerPortal",
+  // Opt-in parent/operator "won't ride this service today" overlay. Default OFF for every
+  // plan; enabled per-company via company.features. See: backend/modules/ride-skip/.
+  PARENT_RIDE_SKIP: "parentRideSkip",
 };
 
 module.exports = {

package/constants/customer-portal.constants.js

@@ -30,7 +30,13 @@ const CUSTOMER_PORTAL_INVITE_EXPIRATION_DAYS = 7;
 
 const CUSTOMER_PORTAL_STUDENT_SEARCH_MIN_LENGTH = 2;
 
+// EXTRA_SERVICE is first: the school-contact form lists it above student registration
+// and selects it by default. It is a one-off trip, not a VehicleRoute.
+// Date is a calendar day. Place, time, and headcount are free text.
+// Validation lives in backend/modules/customer-portal/extra-service.js so a portal
+// can accept the type before this package version is published.
 const CUSTOMER_REQUEST_TYPES = {
+  EXTRA_SERVICE: "extra_service",
   STUDENT_ADD: "student_add",
   STUDENT_ADD_BULK: "student_add_bulk",
   STUDENT_REMOVE: "student_remove",
@@ -39,6 +45,13 @@ const CUSTOMER_REQUEST_TYPES = {
   OTHER: "other",
 };
 
+const CUSTOMER_EXTRA_SERVICE_LIMITS = {
+  PLACE: 200,
+  TIME: 80,
+  HEADCOUNT: 200,
+  TITLE: 200,
+};
+
 const CUSTOMER_REQUEST_CHANGE_KINDS = {
   ADDRESS: "address",
   SERVICE: "service",
@@ -150,6 +163,7 @@ module.exports = {
   CUSTOMER_PORTAL_INVITE_EXPIRATION_DAYS,
   CUSTOMER_PORTAL_STUDENT_SEARCH_MIN_LENGTH,
   CUSTOMER_REQUEST_TYPES,
+  CUSTOMER_EXTRA_SERVICE_LIMITS,
   CUSTOMER_REQUEST_CHANGE_KINDS,
   CUSTOMER_REQUEST_STATUSES,
   CUSTOMER_REQUEST_OPEN_STATUSES,

package/constants/plan.constants.js

@@ -168,6 +168,7 @@ const PLAN_FEATURES = {
     [COMPANY_FEATURES.UETDS]: false,
     [COMPANY_FEATURES.BUNDLED_STUDENT_ROUTES]: false,
     [COMPANY_FEATURES.CUSTOMER_PORTAL]: false,
+    [COMPANY_FEATURES.PARENT_RIDE_SKIP]: false,
   },
 
   [PLANS.FREE]: {
@@ -183,6 +184,7 @@ const PLAN_FEATURES = {
     [COMPANY_FEATURES.UETDS]: false,
     [COMPANY_FEATURES.BUNDLED_STUDENT_ROUTES]: false,
     [COMPANY_FEATURES.CUSTOMER_PORTAL]: false,
+    [COMPANY_FEATURES.PARENT_RIDE_SKIP]: false,
   },
   [PLANS.STARTER]: {
     [COMPANY_FEATURES.ACCOUNTING]: false,
@@ -197,6 +199,7 @@ const PLAN_FEATURES = {
     [COMPANY_FEATURES.UETDS]: false,
     [COMPANY_FEATURES.BUNDLED_STUDENT_ROUTES]: false,
     [COMPANY_FEATURES.CUSTOMER_PORTAL]: false,
+    [COMPANY_FEATURES.PARENT_RIDE_SKIP]: false,
   },
   [PLANS.PRO]: {
     [COMPANY_FEATURES.ACCOUNTING]: false,
@@ -211,6 +214,7 @@ const PLAN_FEATURES = {
     [COMPANY_FEATURES.UETDS]: false,
     [COMPANY_FEATURES.BUNDLED_STUDENT_ROUTES]: false,
     [COMPANY_FEATURES.CUSTOMER_PORTAL]: false,
+    [COMPANY_FEATURES.PARENT_RIDE_SKIP]: false,
   },
   [PLANS.BUSINESS]: {
     [COMPANY_FEATURES.ACCOUNTING]: false,
@@ -225,6 +229,7 @@ const PLAN_FEATURES = {
     [COMPANY_FEATURES.UETDS]: false,
     [COMPANY_FEATURES.BUNDLED_STUDENT_ROUTES]: false,
     [COMPANY_FEATURES.CUSTOMER_PORTAL]: false,
+    [COMPANY_FEATURES.PARENT_RIDE_SKIP]: false,
   },
   [PLANS.ENTERPRISE]: {
     [COMPANY_FEATURES.ACCOUNTING]: false,
@@ -239,6 +244,7 @@ const PLAN_FEATURES = {
     [COMPANY_FEATURES.UETDS]: false,
     [COMPANY_FEATURES.BUNDLED_STUDENT_ROUTES]: false,
     [COMPANY_FEATURES.CUSTOMER_PORTAL]: false,
+    [COMPANY_FEATURES.PARENT_RIDE_SKIP]: false,
   },
   [PLANS.UNLIMITED]: {
     [COMPANY_FEATURES.ACCOUNTING]: false,
@@ -253,6 +259,7 @@ const PLAN_FEATURES = {
     [COMPANY_FEATURES.UETDS]: false,
     [COMPANY_FEATURES.BUNDLED_STUDENT_ROUTES]: false,
     [COMPANY_FEATURES.CUSTOMER_PORTAL]: false,
+    [COMPANY_FEATURES.PARENT_RIDE_SKIP]: false,
   },
 };
 

package/constants/ride-skip.constants.js

@@ -0,0 +1,14 @@
+const RIDE_SKIP_SERVICE_KINDS = {
+  VEHICLE_ROUTE: "VEHICLE_ROUTE",
+  BUNDLED_ROUTE: "BUNDLED_ROUTE",
+};
+
+const RIDE_SKIP_SOURCES = {
+  PARENT: "PARENT",
+  OPERATOR: "OPERATOR",
+};
+
+module.exports = {
+  RIDE_SKIP_SERVICE_KINDS,
+  RIDE_SKIP_SOURCES,
+};

package/constants/telemetry.constants.js

@@ -1,81 +1,81 @@
-// See: backend/docs/arvento-telemetry.md (source of truth)
-// Telemetry constants — shared between backend and frontend.
-
-const TELEMETRY_PROVIDERS = {
-  ARVENTO: "ARVENTO",
-};
-
-const TELEMETRY_EVENT_TYPES = {
-  SPEED_ALARM: "SPEED_ALARM",
-  IDLING_ALARM: "IDLING_ALARM",
-  PAUSE_ALARM: "PAUSE_ALARM",
-  MOTION_ALARM: "MOTION_ALARM",
-  CONTACT_ON: "CONTACT_ON",
-  CONTACT_OFF: "CONTACT_OFF",
-  DOOR_OPEN: "DOOR_OPEN",
-  DOOR_CLOSE: "DOOR_CLOSE",
-  EMERGENCY: "EMERGENCY",
-  TEMPERATURE_ALARM: "TEMPERATURE_ALARM",
-  REGION_ENTRY: "REGION_ENTRY",
-  REGION_EXIT: "REGION_EXIT",
-  SUDDEN_ACCELERATION: "SUDDEN_ACCELERATION",
-  SUDDEN_DECELERATION: "SUDDEN_DECELERATION",
-  POSSIBLE_ACCIDENT: "POSSIBLE_ACCIDENT",
-  DEVICE_POWERED_UP: "DEVICE_POWERED_UP",
-  // Araç, o günkü kayıtlı servis penceresi dışında kullanılıyor (kontak açık / hareket halinde).
-  // See: backend/docs/arvento-telemetry.md §20.1
-  SERVICELESS_USE: "SERVICELESS_USE",
-};
-
-// GetVehicleAlarmStatusV2 yanıtındaki "Alarm Türü" (Language=0 → Türkçe) kontak metinleri.
-// Anlık kontak durumu bu üç tipin EN YENİSİNDEN türetilir (See: arvento-telemetry.md §20.1).
-const ARVENTO_ALARM_TYPES = {
-  IGNITION_ON: "Kontak Açıldı",
-  IGNITION_OFF: "Kontak Kapandı",
-  IGNITION_STATUS: "Kontak Durumu", // Değer: 1=açık, 0=kapalı
-};
-
-const TELEMETRY_VEHICLE_STATUS = {
-  OFFLINE: "OFFLINE", // Son snapshot yok veya çok eski (cihaz veri göndermiyor — kontaktan bağımsız)
-  IDLE: "IDLE", // (eski) hareketsiz — artık görüntüde IDLING/PARKED'e ayrıştırılır
-  MOVING: "MOVING", // Hareket halinde
-  ALARMED: "ALARMED", // Son snapshot'ta alarm var
-  // Görüntü durumları (taze snapshot'ta kontaktan türetilir; kalıcı SAKLANMAZ):
-  IDLING: "IDLING", // Kontak açık, hareketsiz (rölantide)
-  PARKED: "PARKED", // Kontak kapalı, cihaz online
-};
-
-const TELEMETRY_THRESHOLDS = {
-  IDLING_FUEL_LITERS_PER_HOUR: 1.8, // rölanti israfı hesabı (referans)
-  DRIVER_FATIGUE_HOURS: 4,
-  LIVE_POSITION_REFRESH_SECONDS: 15, // frontend refresh
-  ARVENTO_POLL_PERIOD_SECONDS: 30, // backend cron - Arvento min period
-  ARVENTO_DAILY_QUOTA: 100000, // request/day/user
-  ARVENTO_PER_METHOD_COOLDOWN_SECONDS: 30,
-  SNAPSHOT_FRESHNESS_SECONDS: 3600, // bu sürenin üstünde olan snapshot "stale" - 1 saat
-
-  // --- Servissiz/izinsiz kullanım uyarısı (§20.1) ---
-  // Servis başlangıç/bitiş penceresine eklenen tampon (dk). Şoför servise giderken/dönerken
-  // aracı öncesinde çalıştırır → bu marjin içindeki hareket normal sayılır.
-  // Gelecekte 1 saate çekmek istenirse yalnızca bu değer 60 yapılır.
-  SERVICELESS_USE_MARGIN_MINUTES: 120,
-  // Aynı araç için bu süre içindeki tekrar tespitler tek "episode" sayılır (spam engeli).
-  SERVICELESS_EPISODE_GAP_MINUTES: 30,
-  // Servis dışı "kullanımda" sayılması için minimum hız (km/h). Kontak açık + bu eşiğin üstü.
-  SERVICELESS_USE_MIN_SPEED_KMH: 10,
-  // Bu sürenin altındaki kapalı seanslar DB'den silinir (yanlış pozitif / gürültü).
-  SERVICELESS_USE_MIN_DURATION_MINUTES: 5,
-  // Servissiz kullanım uyarılarının geçmişte saklanma süresi (gün).
-  SERVICELESS_ALERT_RETENTION_DAYS: 30,
-
-  // --- Aşırı hız vurgusu (§20.3) — frontend-only ---
-  OVERSPEED_THRESHOLD_KMH: 100,
-};
-
-module.exports = {
-  TELEMETRY_PROVIDERS,
-  TELEMETRY_EVENT_TYPES,
-  TELEMETRY_VEHICLE_STATUS,
-  TELEMETRY_THRESHOLDS,
-  ARVENTO_ALARM_TYPES,
-};
+// See: backend/docs/arvento-telemetry.md (source of truth)
+// Telemetry constants — shared between backend and frontend.
+
+const TELEMETRY_PROVIDERS = {
+  ARVENTO: "ARVENTO",
+};
+
+const TELEMETRY_EVENT_TYPES = {
+  SPEED_ALARM: "SPEED_ALARM",
+  IDLING_ALARM: "IDLING_ALARM",
+  PAUSE_ALARM: "PAUSE_ALARM",
+  MOTION_ALARM: "MOTION_ALARM",
+  CONTACT_ON: "CONTACT_ON",
+  CONTACT_OFF: "CONTACT_OFF",
+  DOOR_OPEN: "DOOR_OPEN",
+  DOOR_CLOSE: "DOOR_CLOSE",
+  EMERGENCY: "EMERGENCY",
+  TEMPERATURE_ALARM: "TEMPERATURE_ALARM",
+  REGION_ENTRY: "REGION_ENTRY",
+  REGION_EXIT: "REGION_EXIT",
+  SUDDEN_ACCELERATION: "SUDDEN_ACCELERATION",
+  SUDDEN_DECELERATION: "SUDDEN_DECELERATION",
+  POSSIBLE_ACCIDENT: "POSSIBLE_ACCIDENT",
+  DEVICE_POWERED_UP: "DEVICE_POWERED_UP",
+  // Araç, o günkü kayıtlı servis penceresi dışında kullanılıyor (kontak açık / hareket halinde).
+  // See: backend/docs/arvento-telemetry.md §20.1
+  SERVICELESS_USE: "SERVICELESS_USE",
+};
+
+// GetVehicleAlarmStatusV2 yanıtındaki "Alarm Türü" (Language=0 → Türkçe) kontak metinleri.
+// Anlık kontak durumu bu üç tipin EN YENİSİNDEN türetilir (See: arvento-telemetry.md §20.1).
+const ARVENTO_ALARM_TYPES = {
+  IGNITION_ON: "Kontak Açıldı",
+  IGNITION_OFF: "Kontak Kapandı",
+  IGNITION_STATUS: "Kontak Durumu", // Değer: 1=açık, 0=kapalı
+};
+
+const TELEMETRY_VEHICLE_STATUS = {
+  OFFLINE: "OFFLINE", // Son snapshot yok veya çok eski (cihaz veri göndermiyor — kontaktan bağımsız)
+  IDLE: "IDLE", // (eski) hareketsiz — artık görüntüde IDLING/PARKED'e ayrıştırılır
+  MOVING: "MOVING", // Hareket halinde
+  ALARMED: "ALARMED", // Son snapshot'ta alarm var
+  // Görüntü durumları (taze snapshot'ta kontaktan türetilir; kalıcı SAKLANMAZ):
+  IDLING: "IDLING", // Kontak açık, hareketsiz (rölantide)
+  PARKED: "PARKED", // Kontak kapalı, cihaz online
+};
+
+const TELEMETRY_THRESHOLDS = {
+  IDLING_FUEL_LITERS_PER_HOUR: 1.8, // rölanti israfı hesabı (referans)
+  DRIVER_FATIGUE_HOURS: 4,
+  LIVE_POSITION_REFRESH_SECONDS: 15, // frontend refresh
+  ARVENTO_POLL_PERIOD_SECONDS: 30, // backend cron - Arvento min period
+  ARVENTO_DAILY_QUOTA: 100000, // request/day/user
+  ARVENTO_PER_METHOD_COOLDOWN_SECONDS: 30,
+  SNAPSHOT_FRESHNESS_SECONDS: 3600, // bu sürenin üstünde olan snapshot "stale" - 1 saat
+
+  // --- Servissiz/izinsiz kullanım uyarısı (§20.1) ---
+  // Servis başlangıç/bitiş penceresine eklenen tampon (dk). Şoför servise giderken/dönerken
+  // aracı öncesinde çalıştırır → bu marjin içindeki hareket normal sayılır.
+  // Gelecekte 1 saate çekmek istenirse yalnızca bu değer 60 yapılır.
+  SERVICELESS_USE_MARGIN_MINUTES: 120,
+  // Aynı araç için bu süre içindeki tekrar tespitler tek "episode" sayılır (spam engeli).
+  SERVICELESS_EPISODE_GAP_MINUTES: 30,
+  // Servis dışı "kullanımda" sayılması için minimum hız (km/h). Kontak açık + bu eşiğin üstü.
+  SERVICELESS_USE_MIN_SPEED_KMH: 10,
+  // Bu sürenin altındaki kapalı seanslar DB'den silinir (yanlış pozitif / gürültü).
+  SERVICELESS_USE_MIN_DURATION_MINUTES: 5,
+  // Servissiz kullanım uyarılarının geçmişte saklanma süresi (gün).
+  SERVICELESS_ALERT_RETENTION_DAYS: 30,
+
+  // --- Aşırı hız vurgusu (§20.3) — frontend-only ---
+  OVERSPEED_THRESHOLD_KMH: 100,
+};
+
+module.exports = {
+  TELEMETRY_PROVIDERS,
+  TELEMETRY_EVENT_TYPES,
+  TELEMETRY_VEHICLE_STATUS,
+  TELEMETRY_THRESHOLDS,
+  ARVENTO_ALARM_TYPES,
+};

package/index.js

@@ -16,4 +16,5 @@ module.exports = {
   ...require("./constants/telemetry.constants.js"),
   ...require("./constants/login-code.constants.js"),
   ...require("./constants/customer-portal.constants.js"),
+  ...require("./constants/ride-skip.constants.js"),
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@routebot/constants",
-  "version": "0.3.76",
+  "version": "0.3.79",
   "description": "Shared constants for RouteBot FE/BE",
   "main": "index.js",
   "files": [