@fleetbase/fleetops-engine 0.6.47 → 0.6.49

package/addon/components/order/details/tracking.js

@@ -1,10 +1,13 @@
 import Component from '@glimmer/component';
 import { inject as service } from '@ember/service';
+import { action } from '@ember/object';
 import { debug } from '@ember/debug';
 import { task } from 'ember-concurrency';
 
 export default class OrderDetailsTrackingComponent extends Component {
     @service orderActions;
+    @service fetch;
+    @service notifications;
 
     constructor() {
         super(...arguments);
@@ -12,10 +15,464 @@ export default class OrderDetailsTrackingComponent extends Component {
     }
 
     @task *loadTrackerData() {
+        if (!this.args.resource || typeof this.args.resource.loadTrackerData !== 'function') {
+            return;
+        }
+
         try {
             yield this.args.resource.loadTrackerData();
         } catch (err) {
             debug('Failed to load order tracker data: ' + err.message);
         }
     }
+
+    get trackerData() {
+        return this.args.resource?.tracker_data;
+    }
+
+    get hasTrackerData() {
+        return Boolean(this.trackerData);
+    }
+
+    get activeEtaSeconds() {
+        return this.trackerData?.eta?.active_stop_seconds;
+    }
+
+    get hasActiveEta() {
+        return this.activeEtaSeconds !== null && this.activeEtaSeconds !== undefined;
+    }
+
+    get smartAdjustedEtaSeconds() {
+        return (
+            this.firstPositiveNumber(this.activeEtaSeconds) ??
+            this.firstPositiveNumber(this.trackerData?.route?.duration_in_traffic_s) ??
+            this.firstPositiveNumber(this.trackerData?.route?.duration_s) ??
+            this.firstPositiveNumber(this.reportedEtaSeconds) ??
+            null
+        );
+    }
+
+    get hasSmartAdjustedEta() {
+        return this.smartAdjustedEtaSeconds !== null && this.smartAdjustedEtaSeconds !== undefined;
+    }
+
+    get smartAdjustedEtaUnavailableLabel() {
+        if (this.driverSignal === 'Unassigned') {
+            return 'Pending driver assignment';
+        }
+
+        if (this.driverSignal === 'Missing' || this.driverSignal === 'Stale') {
+            return 'Pending GPS fix';
+        }
+
+        return 'Pending start';
+    }
+
+    get hasCompletionEta() {
+        return Boolean(this.trackerData?.eta?.completion_at);
+    }
+
+    get hasRemainingDistance() {
+        return this.trackerData?.route?.distance_m !== null && this.trackerData?.route?.distance_m !== undefined;
+    }
+
+    get hasAssignedDriver() {
+        const order = this.args.resource;
+
+        return Boolean(order?.driver_assigned || order?.driver_assigned_uuid);
+    }
+
+    get driverSignal() {
+        const trackerData = this.trackerData;
+
+        if (!this.hasAssignedDriver) {
+            return 'Unassigned';
+        }
+
+        if (!trackerData?.driver?.location) {
+            return 'Missing';
+        }
+
+        if (trackerData?.insights?.is_location_stale) {
+            return 'Stale';
+        }
+
+        return trackerData?.driver?.online ? 'Live' : 'Offline';
+    }
+
+    get driverStatusLabel() {
+        switch (this.driverSignal) {
+            case 'Live':
+                return 'Driver live';
+            case 'Stale':
+                return 'Driver stale';
+            case 'Missing':
+                return 'Driver missing GPS';
+            case 'Unassigned':
+                return 'No driver assigned';
+            default:
+                return 'Driver offline';
+        }
+    }
+
+    get hasDriverLocationAge() {
+        return this.trackerData?.driver?.location_age_seconds !== null && this.trackerData?.driver?.location_age_seconds !== undefined;
+    }
+
+    get driverSignalClass() {
+        switch (this.driverSignal) {
+            case 'Live':
+                return 'text-green-600 dark:text-green-400';
+            case 'Stale':
+                return 'text-yellow-600 dark:text-yellow-400';
+            case 'Missing':
+                return 'text-red-600 dark:text-red-400';
+            case 'Unassigned':
+                return 'text-yellow-600 dark:text-yellow-400';
+            default:
+                return 'text-gray-600 dark:text-gray-300';
+        }
+    }
+
+    get routeQualityItems() {
+        const trackerData = this.trackerData;
+
+        if (!trackerData) {
+            return [];
+        }
+
+        const items = [`${this.humanize(trackerData.provider)} route`];
+
+        if (trackerData.confidence) {
+            items.push(`${this.humanize(trackerData.confidence)} confidence`);
+        }
+
+        if (trackerData.fallback_provider) {
+            items.push(`Fallback: ${this.humanize(trackerData.fallback_provider)}`);
+        }
+
+        return items;
+    }
+
+    get confidenceLabel() {
+        return this.humanize(this.trackerData?.confidence || 'unknown');
+    }
+
+    get confidencePercent() {
+        const score = this.trackerData?.confidence_score ?? this.trackerData?.confidence_percent ?? this.trackerData?.confidence_percentage;
+
+        if (score !== null && score !== undefined && !Number.isNaN(Number(score))) {
+            return Math.max(0, Math.min(100, Math.round(Number(score))));
+        }
+
+        switch (this.trackerData?.confidence) {
+            case 'high':
+                return 92;
+            case 'medium':
+                return 68;
+            case 'low':
+                return 34;
+            default:
+                return 0;
+        }
+    }
+
+    get providerLabel() {
+        return this.humanize(this.trackerData?.provider);
+    }
+
+    get fallbackProviderLabel() {
+        return this.humanize(this.trackerData?.fallback_provider);
+    }
+
+    get confidenceToneClass() {
+        switch (this.trackerData?.confidence) {
+            case 'high':
+                return 'tracking-intelligence-pill--good';
+            case 'medium':
+                return 'tracking-intelligence-pill--warn';
+            case 'low':
+                return 'tracking-intelligence-pill--bad';
+            default:
+                return 'tracking-intelligence-pill--muted';
+        }
+    }
+
+    get confidenceSegments() {
+        const confidence = this.trackerData?.confidence;
+        const litCount = confidence === 'high' ? 5 : confidence === 'medium' ? 3 : confidence === 'low' ? 2 : 1;
+
+        return Array.from({ length: 5 }, (_, index) => ({
+            lit: index < litCount,
+        }));
+    }
+
+    get activeStopIndex() {
+        const stops = this.trackerData?.stops ?? [];
+        const activeStop = this.trackerData?.active_stop;
+        const index = stops.findIndex((stop) => this.matchesStop(stop, activeStop));
+
+        return index >= 0 ? index + 1 : null;
+    }
+
+    get totalStops() {
+        return this.trackerData?.stops?.length ?? 0;
+    }
+
+    get activeStopLabel() {
+        if (!this.activeStopIndex || !this.totalStops) {
+            return 'NOW HEADING TO';
+        }
+
+        return `NOW HEADING TO - STOP ${this.activeStopIndex} OF ${this.totalStops}`;
+    }
+
+    get activeStopMarkerLabel() {
+        const activeStop = this.trackerData?.active_stop;
+
+        if (activeStop?.type === 'pickup') {
+            return 'P';
+        }
+
+        if (activeStop?.type === 'dropoff') {
+            return 'D';
+        }
+
+        return this.activeStopIndex ?? '•';
+    }
+
+    get reportedEtaSeconds() {
+        const activeStop = this.trackerData?.active_stop;
+        const eta = this.args.resource?.eta ?? {};
+
+        return activeStop?.eta_seconds ?? eta?.[activeStop?.id] ?? eta?.[activeStop?.uuid] ?? eta?.[activeStop?.public_id] ?? null;
+    }
+
+    get displayedReportedEtaSeconds() {
+        return (
+            this.firstPositiveNumber(this.reportedEtaSeconds) ??
+            this.firstPositiveNumber(this.activeEtaSeconds) ??
+            this.firstPositiveNumber(this.trackerData?.route?.duration_in_traffic_s) ??
+            this.firstPositiveNumber(this.trackerData?.route?.duration_s) ??
+            null
+        );
+    }
+
+    get hasDisplayedReportedEta() {
+        return this.displayedReportedEtaSeconds !== null && this.displayedReportedEtaSeconds !== undefined;
+    }
+
+    get isReportedEtaUntrusted() {
+        const trackerData = this.trackerData;
+
+        if (!trackerData) {
+            return false;
+        }
+
+        return !trackerData?.driver?.location || trackerData?.insights?.is_location_stale || trackerData.fallback_provider || (trackerData.confidence && trackerData.confidence !== 'high');
+    }
+
+    get reportedEtaWarning() {
+        if (!this.isReportedEtaUntrusted) {
+            return 'Reported from existing route data';
+        }
+
+        return this.operatorWarning ?? 'Reported ETA may not reflect the latest tracking signal.';
+    }
+
+    get etaUnavailableLabel() {
+        if (this.driverSignal === 'Unassigned') {
+            return 'Pending driver assignment';
+        }
+
+        if (this.driverSignal === 'Missing' || this.driverSignal === 'Stale') {
+            return 'Pending GPS fix';
+        }
+
+        return '-';
+    }
+
+    get operatorWarningTitle() {
+        switch (this.driverSignal) {
+            case 'Unassigned':
+                return 'No driver assigned';
+            case 'Missing':
+                return 'Pending GPS fix';
+            case 'Stale':
+                return 'Stale driver location';
+            default:
+                return 'Tracking estimate warning';
+        }
+    }
+
+    get canAssignDriver() {
+        return this.driverSignal === 'Unassigned';
+    }
+
+    get canPingDriver() {
+        return this.driverSignal === 'Missing' || this.driverSignal === 'Stale';
+    }
+
+    get warningsCount() {
+        return (this.trackerData?.warnings ?? []).length;
+    }
+
+    get diagnosticsSummaryLabel() {
+        return this.warningsCount === 1 ? '1 warning' : `${this.warningsCount} warnings`;
+    }
+
+    get totalProgressPercentage() {
+        const percentage = Number(this.trackerData?.progress?.percentage);
+
+        if (Number.isFinite(percentage)) {
+            return Math.max(0, Math.min(100, percentage));
+        }
+
+        const stops = this.trackerData?.stops ?? [];
+        const completedStops = stops.filter((stop) => stop.completed).length;
+
+        if (stops.length) {
+            return Math.max(0, Math.min(100, Math.round((completedStops / stops.length) * 100)));
+        }
+
+        return 0;
+    }
+
+    get totalProgressStyle() {
+        const percentage = this.hasRemainingDistance && this.totalProgressPercentage === 0 ? 2 : this.totalProgressPercentage;
+
+        return `width: ${percentage}%;`;
+    }
+
+    get currentLeg() {
+        return this.trackerData?.route?.legs?.[0] ?? null;
+    }
+
+    get hasCurrentLegDistance() {
+        return this.currentLeg?.distance_m !== null && this.currentLeg?.distance_m !== undefined;
+    }
+
+    get currentLegProgressPercentage() {
+        const explicit = Number(this.currentLeg?.progress_percentage ?? this.trackerData?.progress?.active_leg_percentage);
+
+        if (Number.isFinite(explicit)) {
+            return Math.max(0, Math.min(100, explicit));
+        }
+
+        if (this.driverSignal === 'Unassigned' || this.driverSignal === 'Missing') {
+            return 0;
+        }
+
+        if (this.driverSignal === 'Stale') {
+            return 18;
+        }
+
+        return Math.max(8, Math.min(92, this.totalProgressPercentage));
+    }
+
+    get currentLegProgressStyle() {
+        return `width: ${this.currentLegProgressPercentage}%;`;
+    }
+
+    get hasWarnings() {
+        return (this.trackerData?.warnings ?? []).length > 0;
+    }
+
+    get diagnostics() {
+        const trackerData = this.trackerData;
+
+        if (!trackerData) {
+            return [];
+        }
+
+        return [
+            { label: 'Provider', value: this.humanize(trackerData.provider) },
+            { label: 'Fallback', value: trackerData.fallback_provider ? this.humanize(trackerData.fallback_provider) : 'No' },
+            { label: 'Traffic aware', value: trackerData.options?.traffic_enabled ? 'Yes' : 'No' },
+            { label: 'Confidence', value: this.confidenceLabel },
+            { label: 'Driver signal', value: this.driverSignal },
+            { label: 'Warnings', value: String((trackerData.warnings ?? []).length) },
+        ];
+    }
+
+    get operatorWarning() {
+        const trackerData = this.trackerData;
+
+        if (!trackerData) {
+            return null;
+        }
+
+        if (!this.hasAssignedDriver) {
+            return 'Assign a driver to start live tracking and improve ETA accuracy.';
+        }
+
+        if (!trackerData?.driver?.location) {
+            return 'Driver location is missing, so ETA accuracy may be limited.';
+        }
+
+        if (trackerData?.insights?.is_location_stale) {
+            return 'Driver location is stale. ETA may not reflect the latest movement.';
+        }
+
+        if (trackerData.fallback_provider) {
+            return `Using ${this.humanize(trackerData.fallback_provider)} fallback because the preferred tracking provider was unavailable.`;
+        }
+
+        if (trackerData.confidence && trackerData.confidence !== 'high') {
+            return `${this.humanize(trackerData.confidence)} confidence ETA. Treat the estimate as directional.`;
+        }
+
+        if ((trackerData.warnings ?? []).some((warning) => String(warning).startsWith('provider_failed'))) {
+            return 'Tracking provider returned an error. Showing the best available estimate.';
+        }
+
+        return null;
+    }
+
+    humanize(value) {
+        return String(value ?? '')
+            .replace(/[_:-]+/g, ' ')
+            .replace(/\s+/g, ' ')
+            .trim()
+            .replace(/\b\w/g, (character) => character.toUpperCase());
+    }
+
+    firstPositiveNumber(value) {
+        const number = Number(value);
+
+        return Number.isFinite(number) && number > 0 ? number : null;
+    }
+
+    matchesStop(stop, activeStop) {
+        if (!stop || !activeStop) {
+            return false;
+        }
+
+        return stop.uuid === activeStop.uuid || stop.public_id === activeStop.public_id || stop.id === activeStop.id;
+    }
+
+    @action assignDriver() {
+        const order = this.args.resource;
+
+        if (!order || typeof this.orderActions.assignDriver !== 'function') {
+            return;
+        }
+
+        return this.orderActions.assignDriver(order);
+    }
+
+    @task *pingDriver() {
+        const order = this.args.resource;
+
+        if (!order) {
+            return;
+        }
+
+        try {
+            yield this.fetch.post(`orders/${order.id}/ping-driver`);
+            this.notifications.success('Driver app ping sent.');
+        } catch (err) {
+            this.notifications.error(err.message ?? 'Unable to ping driver app.');
+        }
+    }
 }

package/addon/components/order/form.hbs

@@ -17,7 +17,7 @@
         <Order::Form::Details @resource={{@resource}} />
         <Order::Form::Route @resource={{@resource}} />
         <RegistryYield @registry="fleet-ops:component:order:form" as |RegistryComponent|>
-            <RegistryComponent @order={{@order}} />
+            <RegistryComponent @order={{@resource}} @resource={{@resource}} />
         </RegistryYield>
         <Order::Form::Payload @resource={{@resource}} />
         <Order::Form::ServiceRate @resource={{@resource}} />
@@ -25,4 +25,4 @@
         <Order::Form::Documents @resource={{@resource}} />
         <Order::Form::Metadata @resource={{@resource}} />
     {{/if}}
-</div>
+</div>

package/addon/components/order/kanban-card.hbs

@@ -15,10 +15,25 @@
         <div class="order-listing-row-progress mb-2">
             <OrderProgressBar
                 @card={{@card}}
-                @progress={{@card.tracker_data.progress_percentage}}
-                @firstWaypointCompleted={{@card.tracker_data.first_waypoint_completed}}
-                @lastWaypointCompleted={{@card.tracker_data.last_waypoint_completed}}
+                @progress={{@card.tracker_data.progress.percentage}}
+                @firstWaypointCompleted={{gt @card.tracker_data.progress.completed_stops 0}}
+                @lastWaypointCompleted={{eq @card.tracker_data.progress.percentage 100}}
             />
+            {{#if @card.tracker_data.insights.is_location_stale}}
+                <div class="flex mt-1">
+                    <Badge @status="warning" @hideStatusDot={{true}}>Stale GPS</Badge>
+                </div>
+            {{else if @card.tracker_data.fallback_provider}}
+                <div class="flex mt-1">
+                    <Badge @status="warning" @hideStatusDot={{true}}>Fallback ETA</Badge>
+                </div>
+            {{else if @card.tracker_data.confidence}}
+                {{#unless (eq @card.tracker_data.confidence "high")}}
+                    <div class="flex mt-1">
+                        <Badge @status="warning" @hideStatusDot={{true}}>Low ETA Confidence</Badge>
+                    </div>
+                {{/unless}}
+            {{/if}}
         </div>
         <div class="order-listing-row-body flex flex-row">
             <div class="flex-1 order-listing-row-body-address start">

package/addon/components/order-list-overlay/order.hbs

@@ -26,10 +26,25 @@
             <div class="order-listing-row-progress">
                 <OrderProgressBar
                     @order={{@order}}
-                    @progress={{@order.tracker_data.progress_percentage}}
-                    @firstWaypointCompleted={{@order.tracker_data.first_waypoint_completed}}
-                    @lastWaypointCompleted={{@order.tracker_data.last_waypoint_completed}}
+                    @progress={{@order.tracker_data.progress.percentage}}
+                    @firstWaypointCompleted={{gt @order.tracker_data.progress.completed_stops 0}}
+                    @lastWaypointCompleted={{eq @order.tracker_data.progress.percentage 100}}
                 />
+                {{#if @order.tracker_data.insights.is_location_stale}}
+                    <div class="flex mt-1">
+                        <Badge @status="warning" @hideStatusDot={{true}}>Stale GPS</Badge>
+                    </div>
+                {{else if @order.tracker_data.fallback_provider}}
+                    <div class="flex mt-1">
+                        <Badge @status="warning" @hideStatusDot={{true}}>Fallback ETA</Badge>
+                    </div>
+                {{else if @order.tracker_data.confidence}}
+                    {{#unless (eq @order.tracker_data.confidence "high")}}
+                        <div class="flex mt-1">
+                            <Badge @status="warning" @hideStatusDot={{true}}>Low ETA Confidence</Badge>
+                        </div>
+                    {{/unless}}
+                {{/if}}
             </div>
             <div class="order-listing-row-body">
                 <div class="order-listing-row-body-address start">

package/addon/components/order-progress-card.hbs

@@ -16,11 +16,26 @@
     <div class="order-progress-card-progress">
         <OrderProgressBar
             @order={{this.order}}
-            @progress={{this.order.tracker_data.progress_percentage}}
-            @firstWaypointCompleted={{this.order.tracker_data.first_waypoint_completed}}
-            @lastWaypointCompleted={{this.order.tracker_data.last_waypoint_completed}}
+            @progress={{this.order.tracker_data.progress.percentage}}
+            @firstWaypointCompleted={{gt this.order.tracker_data.progress.completed_stops 0}}
+            @lastWaypointCompleted={{eq this.order.tracker_data.progress.percentage 100}}
         />
     </div>
+    {{#if this.order.tracker_data.insights.is_location_stale}}
+        <div class="flex px-1 mt-1">
+            <Badge @status="warning" @hideStatusDot={{true}}>Stale GPS</Badge>
+        </div>
+    {{else if this.order.tracker_data.fallback_provider}}
+        <div class="flex px-1 mt-1">
+            <Badge @status="warning" @hideStatusDot={{true}}>Fallback ETA</Badge>
+        </div>
+    {{else if this.order.tracker_data.confidence}}
+        {{#unless (eq this.order.tracker_data.confidence "high")}}
+            <div class="flex px-1 mt-1">
+                <Badge @status="warning" @hideStatusDot={{true}}>Low ETA Confidence</Badge>
+            </div>
+        {{/unless}}
+    {{/if}}
     <div class="order-progress-card-details">
         <div class="order-progress-card-details-address start">
             {{#if this.order.payload.isMultiDrop}}
@@ -41,11 +56,11 @@
         <div class="grid grid-cols-2 gap-2 mt-1 px-1">
             <div class="flex flex-col text-xs">
                 <div class="font-semibold">{{t "order.fields.current-eta"}}:</div>
-                <div class="">{{format-duration this.order.tracker_data.current_destination_eta}}</div>
+                <div class="">{{format-duration this.order.tracker_data.eta.active_stop_seconds}}</div>
             </div>
             <div class="flex flex-col text-xs">
                 <div class="font-semibold">{{t "order.fields.ect"}}:</div>
-                <div class="">{{n-a this.order.tracker_data.estimated_completion_time_formatted}}</div>
+                <div class="">{{n-a this.order.tracker_data.eta.completion_at}}</div>
             </div>
             <div class="flex flex-col text-xs">
                 <div class="font-semibold">{{t "order.fields.driver"}}:</div>
@@ -57,7 +72,7 @@
             </div>
             <div class="flex flex-col text-xs">
                 <div class="font-semibold">{{t "order.fields.current-destination"}}:</div>
-                <div class="truncate">{{n-a this.order.tracker_data.current_destination.address}}</div>
+                <div class="truncate">{{n-a this.order.tracker_data.active_stop.address}}</div>
             </div>
         </div>
     </div>

package/addon/components/order-tracking-lookup.hbs

@@ -90,27 +90,27 @@
                                     <div class="order-progress-card-progress">
                                         <OrderProgressBar
                                             @order={{this.order}}
-                                            @progress={{this.order.tracker_data.progress_percentage}}
-                                            @firstWaypointCompleted={{this.order.tracker_data.first_waypoint_completed}}
-                                            @lastWaypointCompleted={{this.order.tracker_data.last_waypoint_completed}}
+                                            @progress={{this.order.tracker_data.progress.percentage}}
+                                            @firstWaypointCompleted={{gt this.order.tracker_data.progress.completed_stops 0}}
+                                            @lastWaypointCompleted={{eq this.order.tracker_data.progress.percentage 100}}
                                         />
                                     </div>
                                     <div class="grid grid-cols-2 gap-2 mt-1 px-1">
                                         <div class="flex flex-col text-xs">
                                             <div class="font-semibold">Current ETA:</div>
-                                            <div class="">{{format-duration this.order.tracker_data.current_destination_eta}}</div>
+                                            <div class="">{{format-duration this.order.tracker_data.eta.active_stop_seconds}}</div>
                                         </div>
                                         <div class="flex flex-col text-xs">
                                             <div class="font-semibold">ECT:</div>
-                                            <div class="">{{n-a this.order.tracker_data.estimated_completion_time_formatted}}</div>
+                                            <div class="">{{n-a this.order.tracker_data.eta.completion_at}}</div>
                                         </div>
                                         <div class="col-span-2 flex flex-col text-xs">
                                             <div class="font-semibold">Current Destination:</div>
-                                            <div class="truncate">{{n-a this.order.tracker_data.current_destination.address}}</div>
+                                            <div class="truncate">{{n-a this.order.tracker_data.active_stop.address}}</div>
                                         </div>
                                         <div class="col-span-2 flex flex-col text-xs">
                                             <div class="font-semibold">Next Destination:</div>
-                                            <div class="truncate">{{n-a this.order.tracker_data.next_destination.address}}</div>
+                                            <div class="truncate">{{n-a this.order.tracker_data.next_stop.address}}</div>
                                         </div>
                                     </div>
                                 </div>

package/addon/components/order-tracking-lookup.js

@@ -50,7 +50,7 @@ export default class OrderTrackingLookupComponent extends Component {
         try {
             this.order = yield this.fetch.get('fleet-ops/lookup', { tracking: this.trackingNumber }, { normalizeToEmberData: true, normalizeModelType: 'order' });
             this.urlSearchParams.addParamToCurrentUrl('order', this.order.tracking);
-            const driverCurrentLocation = this.order.get('tracker_data.driver_current_location');
+            const driverCurrentLocation = this.order.get('tracker_data.driver.location');
             if (driverCurrentLocation) {
                 this.latitude = driverCurrentLocation.coordinates[1];
                 this.longitude = driverCurrentLocation.coordinates[0];