@fleetbase/fleetops-engine 0.6.69 → 0.6.71

package/addon/controllers/operations/orders/index.js

@@ -7,6 +7,7 @@ import relationValue from '../../../utils/relation-value';
 
 export default class OperationsOrdersIndexController extends Controller {
     @service orderActions;
+    @service orderPresentation;
     @service driverActions;
     @service vehicleActions;
     @service store;
@@ -18,7 +19,7 @@ export default class OperationsOrdersIndexController extends Controller {
     @service intl;
 
     /** query params */
-    @tracked queryParams = [
+    @tracked queryParams = this.orderActions.queryParamsFor([
         'page',
         'limit',
         'sort',
@@ -46,7 +47,7 @@ export default class OperationsOrdersIndexController extends Controller {
         'drawerOpen',
         'drawerTab',
         'orderPanelOpen',
-    ];
+    ]);
     @tracked page = 1;
     @tracked limit;
     @tracked sort = '-created_at';
@@ -77,28 +78,35 @@ export default class OperationsOrdersIndexController extends Controller {
     get actionButtons() {
         return [
             {
+                id: 'refresh',
                 icon: 'refresh',
                 onClick: this.orderActions.refresh,
                 helpText: this.intl.t('common.refresh'),
             },
             {
+                id: 'create',
                 text: this.intl.t('common.new'),
                 type: 'primary',
                 icon: 'plus',
                 onClick: this.orderActions.transition.create,
+                permission: 'fleet-ops create order',
             },
             {
+                id: 'export',
                 text: this.intl.t('common.export'),
                 icon: 'long-arrow-up',
                 iconClass: 'rotate-icon-45',
                 wrapperClass: 'hidden md:flex',
                 onClick: this.orderActions.export,
+                permission: 'fleet-ops export order',
             },
             {
+                id: 'import-orders',
                 text: this.intl.t('common.import'),
                 icon: 'file-import',
                 wrapperClass: 'hidden md:flex',
                 onClick: () => this.orderActions.importOrders({ onImportComplete: this.orderActions.refresh }),
+                permission: 'fleet-ops import order',
             },
         ];
     }
@@ -107,26 +115,34 @@ export default class OperationsOrdersIndexController extends Controller {
     get bulkActions() {
         return [
             {
+                id: 'bulk-cancel',
                 label: this.intl.t('common.cancel-resource', { resource: this.intl.t('resource.orders') }),
                 icon: 'ban',
                 fn: this.orderActions.bulkCancel,
+                permission: 'fleet-ops cancel order',
             },
             {
+                id: 'bulk-delete',
                 label: this.intl.t('common.delete-resource', { resource: this.intl.t('resource.orders') }),
                 icon: 'trash',
                 class: 'text-red-500',
                 fn: this.orderActions.bulkDelete,
+                permission: 'fleet-ops delete order',
             },
             { separator: true },
             {
+                id: 'bulk-dispatch',
                 label: this.intl.t('common.dispatch-orders'),
                 icon: 'rocket',
                 fn: this.orderActions.bulkDispatch,
+                permission: 'fleet-ops dispatch order',
             },
             {
+                id: 'bulk-assign-driver',
                 label: this.intl.t('common.assign-drivers'),
                 icon: 'user-plus',
                 fn: this.orderActions.bulkAssignDriver,
+                permission: 'fleet-ops assign-driver-for order',
             },
         ];
     }
@@ -135,6 +151,7 @@ export default class OperationsOrdersIndexController extends Controller {
     get columns() {
         return [
             {
+                id: 'public-id',
                 sticky: true,
                 label: this.intl.t('column.id'),
                 valuePath: 'public_id',
@@ -148,6 +165,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 filterComponent: 'filter/string',
             },
             {
+                id: 'payload-waypoints-length',
                 label: this.intl.t('column.route-type'),
                 valuePath: 'payload.waypoints.length',
                 cellComponent: 'cell/order-route-type',
@@ -155,6 +173,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 resizable: true,
             },
             {
+                id: 'internal-id',
                 label: this.intl.t('column.internal-id'),
                 valuePath: 'internal_id',
                 cellComponent: 'click-to-copy',
@@ -167,6 +186,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 filterComponentPlaceholder: this.intl.t('order.placeholders.filter-internal-id'),
             },
             {
+                id: 'payload-public-id',
                 label: this.intl.t('column.payload'),
                 valuePath: 'payload.public_id',
                 cellComponent: 'cell/payload-identity',
@@ -179,6 +199,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 filterComponent: 'filter/string',
             },
             {
+                id: 'driver-assigned',
                 label: this.intl.t('column.driver-assigned'),
                 cellComponent: 'cell/driver-identity',
                 valuePath: 'driver_assigned',
@@ -196,6 +217,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 model: 'driver',
             },
             {
+                id: 'pickup-name',
                 label: this.intl.t('column.pickup'),
                 valuePath: 'pickupName',
                 cellComponent: 'cell/place-identity',
@@ -212,6 +234,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 model: 'place',
             },
             {
+                id: 'dropoff-name',
                 label: this.intl.t('column.dropoff'),
                 valuePath: 'dropoffName',
                 cellComponent: 'cell/place-identity',
@@ -227,6 +250,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 model: 'place',
             },
             {
+                id: 'customer-name',
                 label: this.intl.t('column.customer'),
                 valuePath: 'customer.name',
                 cellComponent: 'cell/customer-identity',
@@ -241,6 +265,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 model: 'customer',
             },
             {
+                id: 'vehicle-assigned-display-name',
                 label: this.intl.t('column.vehicle-assigned'),
                 cellComponent: 'cell/vehicle-identity',
                 valuePath: 'vehicle_assigned.display_name',
@@ -264,6 +289,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 model: 'vehicle',
             },
             {
+                id: 'facilitator-name',
                 label: this.intl.t('column.facilitator'),
                 valuePath: 'facilitator.name',
                 cellComponent: 'cell/facilitator-identity',
@@ -278,6 +304,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 model: 'vendor',
             },
             {
+                id: 'scheduled-at',
                 label: this.intl.t('column.scheduled-at'),
                 valuePath: 'scheduledAt',
                 sortParam: 'scheduled_at',
@@ -288,6 +315,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 filterComponent: 'filter/date',
             },
             {
+                id: 'item-count',
                 label: this.intl.t('column.items'),
                 cellComponent: 'table/cell/base',
                 valuePath: 'item_count',
@@ -295,6 +323,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 hidden: true,
             },
             {
+                id: 'transaction-amount',
                 label: this.intl.t('column.transaction'),
                 cellComponent: 'table/cell/currency',
                 valuePath: 'transaction_amount',
@@ -303,6 +332,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 sortable: true,
             },
             {
+                id: 'tracking-number-tracking-number',
                 label: this.intl.t('column.tracking'),
                 valuePath: 'tracking_number.tracking_number',
                 cellComponent: 'click-to-copy',
@@ -312,6 +342,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 filterComponent: 'filter/string',
             },
             {
+                id: 'type',
                 label: this.intl.t('column.type'),
                 valuePath: 'type',
                 resizable: true,
@@ -323,6 +354,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 filterComponentPlaceholder: 'Filter by order config',
             },
             {
+                id: 'status',
                 label: this.intl.t('column.status'),
                 valuePath: 'status',
                 cellComponent: 'table/cell/status',
@@ -333,6 +365,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 fetchUri: 'orders/statuses',
             },
             {
+                id: 'created-at',
                 label: this.intl.t('column.created-at'),
                 valuePath: 'createdAt',
                 sortParam: 'created_at',
@@ -343,6 +376,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 filterComponent: 'filter/date',
             },
             {
+                id: 'updated-at',
                 label: this.intl.t('column.updated-at'),
                 valuePath: 'updatedAt',
                 sortParam: 'updated_at',
@@ -354,6 +388,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 filterComponent: 'filter/date',
             },
             {
+                id: 'created-by-name',
                 label: this.intl.t('column.created-by'),
                 valuePath: 'created_by_name',
                 cellComponent: 'table/cell/user-identity',
@@ -367,6 +402,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 model: 'user',
             },
             {
+                id: 'updated-by-name',
                 label: this.intl.t('column.updated-by'),
                 valuePath: 'updated_by_name',
                 cellComponent: 'table/cell/user-identity',
@@ -390,6 +426,7 @@ export default class OperationsOrdersIndexController extends Controller {
                 hidden: true,
             },
             {
+                id: 'row-actions',
                 label: '',
                 cellComponent: 'table/cell/dropdown',
                 ddButtonText: false,
@@ -400,14 +437,16 @@ export default class OperationsOrdersIndexController extends Controller {
                 wrapperClass: 'flex items-center justify-end mx-2',
                 sticky: 'right',
                 width: 60,
-                actions: [
+                actions: this.withPresentationProfile([
                     {
+                        id: 'view',
                         label: this.intl.t('common.view-resource', { resource: this.intl.t('resource.order') }),
                         icon: 'eye',
                         fn: this.orderActions.transition.view,
                         permission: 'fleet-ops view order',
                     },
                     {
+                        id: 'dispatch',
                         label: this.intl.t('common.dispatch-order'),
                         icon: 'paper-plane',
                         fn: this.orderActions.dispatch,
@@ -415,6 +454,7 @@ export default class OperationsOrdersIndexController extends Controller {
                         isVisible: (order) => order.canBeDispatched,
                     },
                     {
+                        id: 'assign-driver',
                         label: this.intl.t('common.assign-driver'),
                         icon: 'edit',
                         fn: this.orderActions.assignDriver,
@@ -422,6 +462,7 @@ export default class OperationsOrdersIndexController extends Controller {
                         isVisible: (order) => !order.has_driver_assigned,
                     },
                     {
+                        id: 'unassign-driver',
                         label: this.intl.t('common.unassign-driver'),
                         icon: 'edit',
                         fn: this.orderActions.unassignDriver,
@@ -429,6 +470,7 @@ export default class OperationsOrdersIndexController extends Controller {
                         isVisible: (order) => order.has_driver_assigned,
                     },
                     {
+                        id: 'cancel',
                         label: this.intl.t('common.cancel-resource', { resource: this.intl.t('resource.order') }),
                         icon: 'ban',
                         fn: this.orderActions.cancel,
@@ -438,12 +480,13 @@ export default class OperationsOrdersIndexController extends Controller {
                         separator: true,
                     },
                     {
+                        id: 'delete',
                         label: this.intl.t('common.delete-resource', { resource: this.intl.t('resource.order') }),
                         icon: 'trash',
                         fn: this.orderActions.delete,
                         permission: 'fleet-ops delete order',
                     },
-                ],
+                ]),
                 sortable: false,
                 filterable: false,
                 resizable: false,
@@ -452,6 +495,25 @@ export default class OperationsOrdersIndexController extends Controller {
         ];
     }
 
+    /**
+     * Hides the row actions an order's presentation profile lists in `hidden.actions`, by id,
+     * the same way the details panel does.
+     */
+    withPresentationProfile(actions) {
+        return actions.map((item) => {
+            if (!item.id) {
+                return item;
+            }
+
+            const isVisible = item.isVisible;
+            const builtInVisible = (order, ...rest) => (typeof isVisible === 'function' ? isVisible(order, ...rest) : isVisible !== false);
+            return {
+                ...item,
+                isVisible: (order, ...rest) => !this.orderPresentation.isHidden(order, 'actions', item.id) && builtInVisible(order, ...rest),
+            };
+        });
+    }
+
     constructor() {
         super(...arguments);
         this.orderSocketEvents.startCompany();

package/addon/controllers/operations/service-rates/index.js

@@ -10,7 +10,7 @@ export default class OperationsServiceRatesIndexController extends Controller {
     @service intl;
 
     /** query params */
-    @tracked queryParams = ['page', 'query', 'limit', 'sort', 'zone', 'service_area'];
+    @tracked queryParams = this.serviceRateActions.queryParamsFor(['page', 'query', 'limit', 'sort', 'zone', 'service_area']);
     @tracked page = 1;
     @tracked limit;
     @tracked query;
@@ -20,22 +20,27 @@ export default class OperationsServiceRatesIndexController extends Controller {
     get actionButtons() {
         return [
             {
+                id: 'refresh',
                 icon: 'refresh',
                 onClick: this.serviceRateActions.refresh,
                 helpText: this.intl.t('common.refresh'),
             },
             {
+                id: 'create',
                 text: this.intl.t('common.new'),
                 type: 'primary',
                 icon: 'plus',
                 onClick: this.serviceRateActions.transition.create,
+                permission: 'fleet-ops create service-rate',
             },
             {
+                id: 'export',
                 text: this.intl.t('common.export'),
                 icon: 'long-arrow-up',
                 iconClass: 'rotate-icon-45',
                 wrapperClass: 'hidden md:flex',
                 onClick: this.serviceRateActions.export,
+                permission: 'fleet-ops export service-rate',
             },
         ];
     }
@@ -44,9 +49,11 @@ export default class OperationsServiceRatesIndexController extends Controller {
     get bulkActions() {
         return [
             {
+                id: 'bulk-delete',
                 label: 'Delete selected...',
                 class: 'text-red-500',
                 fn: this.serviceRateActions.bulkDelete,
+                permission: 'fleet-ops delete service-rate',
             },
         ];
     }
@@ -55,6 +62,7 @@ export default class OperationsServiceRatesIndexController extends Controller {
     get columns() {
         return [
             {
+                id: 'public-id',
                 sticky: true,
                 label: this.intl.t('column.id'),
                 valuePath: 'public_id',
@@ -67,6 +75,7 @@ export default class OperationsServiceRatesIndexController extends Controller {
                 filterComponent: 'filter/string',
             },
             {
+                id: 'service-name',
                 label: this.intl.t('column.service'),
                 valuePath: 'service_name',
                 cellComponent: 'table/cell/base',
@@ -75,6 +84,7 @@ export default class OperationsServiceRatesIndexController extends Controller {
                 filterable: false,
             },
             {
+                id: 'service-area-name',
                 label: this.intl.t('column.service-area'),
                 valuePath: 'service_area.name',
                 cellComponent: 'cell/service-area-identity',
@@ -90,6 +100,7 @@ export default class OperationsServiceRatesIndexController extends Controller {
                 model: 'service-area',
             },
             {
+                id: 'zone-name',
                 label: this.intl.t('column.zone'),
                 valuePath: 'zone.name',
                 cellComponent: 'cell/zone-identity',
@@ -104,6 +115,7 @@ export default class OperationsServiceRatesIndexController extends Controller {
                 model: 'zone',
             },
             {
+                id: 'created-at',
                 label: this.intl.t('column.created-at'),
                 valuePath: 'createdAt',
                 sortParam: 'created_at',
@@ -113,6 +125,7 @@ export default class OperationsServiceRatesIndexController extends Controller {
                 filterComponent: 'filter/date',
             },
             {
+                id: 'updated-at',
                 label: this.intl.t('column.updated-at'),
                 valuePath: 'updatedAt',
                 sortParam: 'updated_at',
@@ -123,6 +136,7 @@ export default class OperationsServiceRatesIndexController extends Controller {
                 filterComponent: 'filter/date',
             },
             {
+                id: 'row-actions',
                 label: '',
                 cellComponent: 'table/cell/dropdown',
                 ddButtonText: false,
@@ -134,18 +148,21 @@ export default class OperationsServiceRatesIndexController extends Controller {
                 width: 60,
                 actions: [
                     {
+                        id: 'view',
                         label: this.intl.t('common.view-resource', { resource: this.intl.t('resource.service-rate') }),
                         icon: 'eye',
                         fn: this.serviceRateActions.transition.view,
                         permission: 'fleet-ops view service-rate',
                     },
                     {
+                        id: 'edit',
                         label: this.intl.t('common.edit-resource', { resource: this.intl.t('resource.service-rate') }),
                         icon: 'pencil',
                         fn: this.serviceRateActions.transition.edit,
                         permission: 'fleet-ops view service-rate',
                     },
                     {
+                        id: 'delete',
                         label: this.intl.t('common.delete-resource', { resource: this.intl.t('resource.service-rate') }),
                         icon: 'trash',
                         fn: this.serviceRateActions.delete,

package/addon/controllers/settings/index.js

@@ -28,6 +28,12 @@ export default class SettingsIndexController extends Controller {
             description: 'Keep commerce, metadata, and visual conventions aligned.',
             links: [
                 { label: 'Payments', route: 'settings.payments', icon: 'cash-register', description: 'Payment setup for operational commerce workflows.' },
+                {
+                    label: 'Telematics',
+                    route: 'settings.telematics',
+                    icon: 'satellite-dish',
+                    description: 'Device event and position history preferences within the system retention policy.',
+                },
                 { label: 'Custom Fields', route: 'settings.custom-fields', icon: 'pen-to-square', description: 'Operational metadata fields for Fleet-Ops records.' },
                 { label: 'Avatars', route: 'settings.avatars', icon: 'icons', description: 'Visual assets for driver, vehicle, and map displays.' },
             ],
@@ -113,6 +119,13 @@ export default class SettingsIndexController extends Controller {
             title: 'Scheduling settings',
             description: 'Manage schedule templates and timing rules for planned work.',
         },
+        {
+            label: 'Telematics',
+            icon: 'satellite-dish',
+            slug: 'fleet-ops/settings/telematics',
+            title: 'Telematics Settings',
+            description: 'Choose how long your organization keeps device events and position history.',
+        },
         {
             label: 'Custom Fields',
             icon: 'pen-to-square',

package/addon/controllers/settings/telematics.js

@@ -0,0 +1,113 @@
+import Controller from '@ember/controller';
+import { tracked } from '@glimmer/tracking';
+import { inject as service } from '@ember/service';
+import { action } from '@ember/object';
+import { task } from 'ember-concurrency';
+
+/** Organization history preferences, subject to the system retention policy. */
+export default class SettingsTelematicsController extends Controller {
+    @service fetch;
+    @service notifications;
+    @service intl;
+
+    @tracked eventRetentionDays = 30;
+    @tracked positionRetentionDays = 90;
+    @tracked useDefaultEventRetention = true;
+    @tracked useDefaultPositionRetention = true;
+    @tracked defaults = {};
+    @tracked policy = {};
+    @tracked settingsLoaded = false;
+
+    get eventRetentionMinimum() {
+        return this.policy.max_event_retention_days > 0 ? 1 : 0;
+    }
+
+    get eventRetentionMaximum() {
+        return this.policy.max_event_retention_days > 0 ? this.policy.max_event_retention_days : 3650;
+    }
+
+    get positionRetentionMinimum() {
+        return this.policy.max_position_retention_days > 0 ? 1 : 0;
+    }
+
+    get positionRetentionMaximum() {
+        return this.policy.max_position_retention_days > 0 ? this.policy.max_position_retention_days : 3650;
+    }
+
+    get eventRetentionPolicyHelp() {
+        return this.retentionPolicyHelp(this.policy.max_event_retention_days);
+    }
+
+    get positionRetentionPolicyHelp() {
+        return this.retentionPolicyHelp(this.policy.max_position_retention_days);
+    }
+
+    get settingsPayload() {
+        return {
+            event_retention_days: this.useDefaultEventRetention ? null : this.eventRetentionDays,
+            position_retention_days: this.useDefaultPositionRetention ? null : this.positionRetentionDays,
+        };
+    }
+
+    @task({ restartable: true }) *getSettings() {
+        this.settingsLoaded = false;
+
+        try {
+            const settings = yield this.fetch.get('fleet-ops/settings/telematics-settings');
+            this.applySettings(settings);
+            this.settingsLoaded = true;
+        } catch (error) {
+            this.notifications.serverError(error);
+        }
+    }
+
+    @task({ drop: true }) *saveSettings() {
+        if (!this.settingsLoaded) {
+            return;
+        }
+
+        try {
+            const settings = yield this.fetch.post('fleet-ops/settings/telematics-settings', this.settingsPayload);
+            this.applySettings(settings);
+            this.notifications.success(this.intl.t('settings.telematics.settings-saved'));
+        } catch (error) {
+            this.notifications.serverError(error);
+        }
+    }
+
+    @action setUseDefaultEventRetention(enabled) {
+        this.useDefaultEventRetention = enabled;
+        if (enabled) {
+            this.eventRetentionDays = this.defaults.event_retention_days ?? this.eventRetentionDays;
+        }
+    }
+
+    @action setUseDefaultPositionRetention(enabled) {
+        this.useDefaultPositionRetention = enabled;
+        if (enabled) {
+            this.positionRetentionDays = this.defaults.position_retention_days ?? this.positionRetentionDays;
+        }
+    }
+
+    applySettings(settings = {}) {
+        const has = (object, key) => Object.prototype.hasOwnProperty.call(object ?? {}, key);
+        const hasHistoryMetadata = ['event_retention_days', 'position_retention_days'].every(
+            (key) => has(settings?.preferences, key) && has(settings?.defaults, key) && has(settings?.policy, `max_${key}`)
+        );
+
+        if (!hasHistoryMetadata) {
+            throw new Error(this.intl.t('settings.telematics.settings-unavailable'));
+        }
+
+        this.eventRetentionDays = settings.event_retention_days ?? this.eventRetentionDays;
+        this.positionRetentionDays = settings.position_retention_days ?? this.positionRetentionDays;
+        this.useDefaultEventRetention = (settings.preferences?.event_retention_days ?? null) === null;
+        this.useDefaultPositionRetention = (settings.preferences?.position_retention_days ?? null) === null;
+        this.defaults = settings.defaults ?? this.defaults;
+        this.policy = settings.policy ?? this.policy;
+    }
+
+    retentionPolicyHelp(maximum) {
+        return maximum > 0 ? this.intl.t('settings.telematics.history-policy-maximum', { days: maximum }) : this.intl.t('settings.telematics.history-policy-unlimited');
+    }
+}