@routebot/constants 0.3.65 → 0.3.67

package/constants/constants.js

@@ -10,6 +10,11 @@ const USER_TYPES = {
   SCHOOL_PARENT: "2",
   PERSONEL: "10",
   ADMIN: "1000",
+  // POI (Point of Interest) — NOT a real person/app user. A lightweight reusable "place"
+  // (hotel, park, venue) used as an ordered stop inside a Tour service. Has no phone/
+  // relations and is excluded from all normal user/personel/parent listings.
+  // See: backend/modules/tour-builder/.
+  POI: "POI",
 };
 
 const CLIENT_ROLES = {

package/constants/service.constants.js

@@ -6,6 +6,10 @@ const SERVICE_TYPES = {
   TRANSFER_PERSONEL: "TRANSFER_PERSONEL", // happens 1 time, date required
   TRANSFER_STUDENT: "TRANSFER_STUDENT", // happens 1 time, date required
   TRANSFER_RANDOM: "TRANSFER_RANDOM", // happens 1 time, date required
+  // TOUR — one-time, place-to-place trip authored via the Tour Builder. Stored as a
+  // PersonelService (school = destination/venue, users = ordered POI stops, routeType =
+  // PICK_UP). Distinct serviceType keeps tours out of the other personel/transfer tabs.
+  TOUR: "TOUR", // happens 1 time, date required
 };
 
 const ROUTE_TYPES = {

package/constants/telemetry.constants.js

@@ -36,10 +36,13 @@ const ARVENTO_ALARM_TYPES = {
 };
 
 const TELEMETRY_VEHICLE_STATUS = {
-  OFFLINE: "OFFLINE", // Son snapshot yok veya çok eski
-  IDLE: "IDLE", // Kontak açık veya kapalı ama hareketsiz
+  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 = {
@@ -49,7 +52,7 @@ const TELEMETRY_THRESHOLDS = {
   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: 180, // bu sürenin üstünde olan snapshot "stale"
+  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

package/constants/tour.constants.js

@@ -0,0 +1,66 @@
+// Tour Builder — shared constants + pure helpers used across backend, frontend and
+// (implicitly) mobile. Keeping the tour stop-ordering logic here is the SINGLE source of
+// truth so the operator's arrangement (web), the persisted order (backend) and the driver's
+// view (mobile) never diverge.
+//
+// Data model recap (see backend/modules/tour-builder/):
+//   A Tour is a standard PersonelService with:
+//     - serviceType = SERVICE_TYPES.TOUR
+//     - routeType   = TOUR_ROUTE_TYPE (PICK_UP): collect guests at each stop, arrive at anchor
+//     - school      = the anchor / final destination (a venue School record)
+//     - users       = ordered POI stops (usertype: USER_TYPES.POI)
+//     - usersdetails = [{ user, transfertime }] carrying the optional per-stop pickup time
+//
+// Mobile (backend/modules/mobile/driver/driver.mobile.controller.js) sorts a personel
+// service's passengers by `transfertime` ascending (timed first, untimed keep order).
+// `orderTourStops` below replicates that EXACT rule so the web preview matches mobile.
+
+// Tours are modeled as PICK_UP so that:
+//   1) the anchor (venue) is the final navigation destination, and
+//   2) per-stop pickup times are shown to the driver (mobile shows transfertime on PICK_UP only).
+const TOUR_ROUTE_TYPE = "PICK_UP";
+
+/**
+ * Validates an "HH:mm" (24h) time string. Empty/invalid → false.
+ * @param {string} value
+ * @returns {boolean}
+ */
+function isValidTourStopTime(value) {
+  if (typeof value !== "string") return false;
+  return /^([01]\d|2[0-3]):([0-5]\d)$/.test(value.trim());
+}
+
+/**
+ * Orders tour stops the same way mobile does: stops WITH a valid transfertime come first
+ * (ascending by time), stops WITHOUT a time keep their original relative order and go last.
+ * The sort is STABLE (insertion index tie-breaker). Pure + side-effect free.
+ *
+ * @template T
+ * @param {T[]} stops - objects exposing a `transfertime` string
+ * @returns {T[]} a new, ordered array (input is not mutated)
+ */
+function orderTourStops(stops) {
+  if (!Array.isArray(stops)) return [];
+
+  return stops
+    .map((stop, index) => ({ stop, index }))
+    .sort((a, b) => {
+      const validA = isValidTourStopTime(a.stop && a.stop.transfertime);
+      const validB = isValidTourStopTime(b.stop && b.stop.transfertime);
+
+      if (validA && validB) {
+        const compared = a.stop.transfertime.localeCompare(b.stop.transfertime);
+        return compared !== 0 ? compared : a.index - b.index;
+      }
+      if (validA && !validB) return -1;
+      if (!validA && validB) return 1;
+      return a.index - b.index;
+    })
+    .map((entry) => entry.stop);
+}
+
+module.exports = {
+  TOUR_ROUTE_TYPE,
+  isValidTourStopTime,
+  orderTourStops,
+};

package/index.js

@@ -5,6 +5,7 @@ module.exports = {
   ...require("./constants/company.constants.js"),
   ...require("./constants/process.constants.js"),
   ...require("./constants/service.constants.js"),
+  ...require("./constants/tour.constants.js"),
   ...require("./constants/sms.constants.js"),
   ...require("./constants/stock.constants.js"),
   ...require("./constants/maps.constants.js"),

package/package.json

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