@fleetbase/fleetops-engine 0.6.48 → 0.6.49

package/addon/components/widget/operations-pulse.hbs

@@ -0,0 +1,51 @@
+<div class="fleet-ops-widget fleet-ops-operations-pulse flex flex-col h-full {{@class}}" ...attributes>
+    <div class="flex items-center justify-between px-3 py-1.5 border dark:border-gray-700 border-gray-200 dark:bg-gray-800 bg-gray-50 rounded-t-md shadow-sm">
+        <span class="text-xs font-bold text-black dark:text-gray-100">
+            {{t "widget.operations-pulse.title"}}
+        </span>
+        <button type="button" class="text-gray-400 hover:text-gray-600 dark:hover:text-gray-200 text-[10px]" {{on "click" this.refresh}} title={{t "widget.refresh"}}>
+            <FaIcon @icon="rotate" class={{if this.load.isRunning "animate-spin"}} />
+        </button>
+    </div>
+
+    <div class="flex-1 p-2.5 border border-t-0 dark:border-gray-700 border-gray-200 rounded-b-md bg-white dark:bg-gray-900">
+        {{#if this.load.isRunning}}
+            <div class="flex items-center justify-center h-full">
+                <Spinner />
+            </div>
+        {{else if this.error}}
+            <div class="flex items-center justify-center h-full text-xs text-red-500">{{this.error}}</div>
+        {{else}}
+            <div class="grid grid-cols-2 lg:grid-cols-5 gap-2 h-full">
+                {{#each this.tiles as |tile|}}
+                    <div class="fleet-ops-pulse-tile {{tile.meta.accent}} relative rounded-md border p-2 flex flex-col justify-between min-h-0 overflow-hidden">
+                        {{!-- Accent stripe along the left edge for instant status read --}}
+                        <span class="fleet-ops-pulse-stripe absolute inset-y-0 left-0"></span>
+
+                        <div class="flex items-center justify-between relative z-10">
+                            <span class="text-[9px] uppercase tracking-wider text-gray-600 dark:text-gray-300 font-bold truncate">{{tile.title}}</span>
+                            {{#if tile.meta.icon}}
+                                <div class="fleet-ops-pulse-icon flex-shrink-0">
+                                    <FaIcon @icon={{tile.meta.icon}} class="text-[10px]" />
+                                </div>
+                            {{/if}}
+                        </div>
+
+                        <div class="flex items-baseline gap-1 mt-1 relative z-10 fleet-ops-pulse-value-row">
+                            <span class="fleet-ops-pulse-value text-2xl font-bold leading-none tabular-nums">{{tile.value}}</span>
+                            {{#if tile.of}}
+                                <span class="text-[10px] text-gray-500 dark:text-gray-400">/ {{tile.of}}</span>
+                            {{/if}}
+                        </div>
+
+                        {{#let (this.deltaStatus tile) as |status|}}
+                            {{#if status}}
+                                <Badge @status={{status}} @text={{this.deltaText tile}} @hideIcon={{true}} @disableHumanize={{true}} @wrapperClass="text-[9px] py-0 px-1 leading-tight mt-1 self-start font-bold relative z-10" />
+                            {{/if}}
+                        {{/let}}
+                    </div>
+                {{/each}}
+            </div>
+        {{/if}}
+    </div>
+</div>

package/addon/components/widget/operations-pulse.js

@@ -0,0 +1,173 @@
+import Component from '@glimmer/component';
+import { tracked } from '@glimmer/tracking';
+import { action } from '@ember/object';
+import { inject as service } from '@ember/service';
+import { debug } from '@ember/debug';
+import { task } from 'ember-concurrency';
+
+const TILE_ORDER = ['active_orders', 'completed_today', 'drivers_online', 'vehicles_deployed', 'issues_open'];
+
+/**
+ * Each tile gets:
+ *  - icon: FA icon name + colored chip
+ *  - accent: CSS class on the tile root for the gradient + accent stripe palette
+ *  - deltaInverse: flip success/danger semantics (for "lower-is-better" metrics)
+ */
+const TILE_META = {
+    active_orders: { icon: 'bolt', accent: 'pulse-accent-blue' },
+    completed_today: { icon: 'circle-check', accent: 'pulse-accent-green' },
+    drivers_online: { icon: 'id-card', accent: 'pulse-accent-sky' },
+    vehicles_deployed: { icon: 'truck', accent: 'pulse-accent-indigo' },
+    issues_open: { icon: 'triangle-exclamation', accent: 'pulse-accent-amber', deltaInverse: true },
+};
+
+/** Refetch the full snapshot this often as a reconciliation guard against
+ * drift between incrementally-applied socket deltas and authoritative state. */
+const RECONCILE_INTERVAL_MS = 60_000;
+
+/**
+ * Live operational snapshot. Initial GET seeds the tiles, then subscribes to
+ * `company.{uuid}` and increments/decrements counters on order.* events
+ * without polling. Reconciles via a full refetch every 60s.
+ */
+export default class WidgetOperationsPulseComponent extends Component {
+    static widgetId = 'fleet-ops-operations-pulse-widget';
+
+    @service fetch;
+    @service socket;
+    @service currentUser;
+
+    @tracked data = null;
+    @tracked error = null;
+
+    socketChannel = null;
+    socketActive = false;
+    reconcileTimer = null;
+
+    constructor() {
+        super(...arguments);
+        this.load.perform();
+        this.subscribe();
+        this.reconcileTimer = setInterval(() => this.load.perform(), RECONCILE_INTERVAL_MS);
+    }
+
+    willDestroy() {
+        super.willDestroy(...arguments);
+        this.unsubscribe();
+        if (this.reconcileTimer) clearInterval(this.reconcileTimer);
+    }
+
+    get tiles() {
+        if (!this.data) return [];
+        return TILE_ORDER.filter((key) => this.data[key]).map((key) => ({
+            key,
+            title: this.titleFor(key),
+            ...this.data[key],
+            meta: TILE_META[key] ?? {},
+        }));
+    }
+
+    titleFor(key) {
+        return key
+            .split('_')
+            .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+            .join(' ');
+    }
+
+    deltaStatus(tile) {
+        if (typeof tile.delta_pct !== 'number' || tile.delta_pct === 0) return null;
+        const positive = tile.delta_pct > 0;
+        const isGood = tile.meta?.deltaInverse ? !positive : positive;
+        return isGood ? 'success' : 'danger';
+    }
+
+    deltaText(tile) {
+        if (typeof tile.delta_pct !== 'number') return null;
+        const sign = tile.delta_pct > 0 ? '+' : '';
+        return `${sign}${tile.delta_pct}%`;
+    }
+
+    @task *load() {
+        try {
+            this.data = yield this.fetch.get('fleet-ops/analytics/operations-pulse');
+            this.error = null;
+        } catch (e) {
+            this.error = e?.message ?? 'Failed to load operations pulse';
+        }
+    }
+
+    @action
+    refresh() {
+        this.load.perform();
+    }
+
+    async subscribe() {
+        const companyId = this.currentUser?.companyId;
+        if (!companyId) return;
+
+        try {
+            const sc = this.socket.instance();
+            const channel = sc.subscribe(`company.${companyId}`);
+            this.socketChannel = channel;
+            this.socketActive = true;
+
+            if (channel.state !== 'subscribed') {
+                await channel.subscribe();
+            }
+
+            for await (const msg of channel) {
+                if (!this.socketActive) break;
+                this.applyEvent(msg);
+            }
+        } catch (e) {
+            debug(`[operations-pulse] socket error: ${e?.message ?? e}`);
+        }
+    }
+
+    async unsubscribe() {
+        this.socketActive = false;
+        try {
+            await this.socketChannel?.unsubscribe();
+        } catch (e) {
+            debug(`[operations-pulse] unsubscribe error: ${e?.message ?? e}`);
+        }
+        this.socketChannel = null;
+    }
+
+    applyEvent(msg) {
+        if (!this.data || !msg) return;
+        const event = msg.event;
+        const next = { ...this.data };
+
+        const adjust = (key, delta) => {
+            if (!next[key]) return;
+            next[key] = { ...next[key], value: Math.max(0, (next[key].value ?? 0) + delta) };
+        };
+
+        switch (event) {
+            case 'order.created':
+            case 'order.dispatched':
+            case 'order.driver_assigned':
+                adjust('active_orders', +1);
+                break;
+            case 'order.completed':
+                adjust('active_orders', -1);
+                adjust('completed_today', +1);
+                break;
+            case 'order.canceled':
+            case 'order.failed':
+                adjust('active_orders', -1);
+                break;
+            case 'issue.created':
+                adjust('issues_open', +1);
+                break;
+            case 'issue.resolved':
+                adjust('issues_open', -1);
+                break;
+            default:
+                return;
+        }
+
+        this.data = next;
+    }
+}

package/addon/components/widget/orders-by-status.hbs

@@ -0,0 +1,26 @@
+<div class="fleet-ops-widget fleet-ops-orders-by-status flex flex-col h-full {{@class}}" ...attributes>
+    <div class="flex items-center justify-between px-3 py-1.5 border dark:border-gray-700 border-gray-200 dark:bg-gray-800 bg-gray-50 rounded-t-md shadow-sm">
+        <span class="text-xs font-bold text-black dark:text-gray-100">{{t "widget.orders-by-status.title"}}</span>
+        <div class="flex gap-0.5">
+            {{#each this.periods as |p|}}
+                <button type="button"
+                        class="text-[10px] px-1.5 py-0.5 rounded {{if (eq this.period p) 'bg-sky-600 text-white' 'text-gray-500 hover:text-gray-700 dark:hover:text-gray-200'}}"
+                        {{on "click" (fn this.setPeriod p)}}>
+                    {{p}}
+                </button>
+            {{/each}}
+        </div>
+    </div>
+
+    <div class="flex-1 p-2.5 border border-t-0 dark:border-gray-700 border-gray-200 rounded-b-md bg-white dark:bg-gray-900 min-h-0">
+        {{#if this.load.isRunning}}
+            <div class="flex items-center justify-center h-full"><Spinner /></div>
+        {{else if this.error}}
+            <div class="flex items-center justify-center h-full text-xs text-red-500">{{this.error}}</div>
+        {{else if this.data}}
+            <div class="h-full">
+                <Chart @type="bar" @labels={{this.data.labels}} @datasets={{this.data.datasets}} @options={{this.chartOptions}} />
+            </div>
+        {{/if}}
+    </div>
+</div>

package/addon/components/widget/orders-by-status.js

@@ -0,0 +1,54 @@
+import Component from '@glimmer/component';
+import { tracked } from '@glimmer/tracking';
+import { action } from '@ember/object';
+import { inject as service } from '@ember/service';
+import { task } from 'ember-concurrency';
+
+const PERIODS = ['7d', '14d', '30d'];
+
+export default class WidgetOrdersByStatusComponent extends Component {
+    static widgetId = 'fleet-ops-orders-by-status-widget';
+
+    @service fetch;
+
+    @tracked period = '14d';
+    @tracked data = null;
+    @tracked error = null;
+
+    periods = PERIODS;
+
+    constructor() {
+        super(...arguments);
+        this.load.perform();
+    }
+
+    get chartOptions() {
+        return {
+            responsive: true,
+            maintainAspectRatio: false,
+            plugins: {
+                legend: { position: 'bottom', labels: { boxWidth: 12, padding: 8 } },
+                tooltip: { mode: 'index', intersect: false },
+            },
+            scales: {
+                x: { stacked: true, grid: { display: false } },
+                y: { stacked: true, beginAtZero: true, ticks: { precision: 0 } },
+            },
+        };
+    }
+
+    @task *load() {
+        try {
+            this.data = yield this.fetch.get('fleet-ops/analytics/orders-by-status', { period: this.period });
+            this.error = null;
+        } catch (e) {
+            this.error = e?.message ?? 'Failed to load orders breakdown';
+        }
+    }
+
+    @action
+    setPeriod(period) {
+        this.period = period;
+        this.load.perform();
+    }
+}

package/addon/components/widget/revenue-trend.hbs

@@ -0,0 +1,34 @@
+<div class="fleet-ops-widget fleet-ops-revenue-trend flex flex-col h-full {{@class}}" ...attributes>
+    <div class="flex items-center justify-between px-3 py-1.5 border dark:border-gray-700 border-gray-200 dark:bg-gray-800 bg-gray-50 rounded-t-md shadow-sm">
+        <span class="text-xs font-bold text-black dark:text-gray-100">{{t "widget.revenue-trend.title"}}</span>
+        <div class="flex gap-0.5">
+            {{#each this.periods as |p|}}
+                <button type="button"
+                        class="text-[10px] px-1.5 py-0.5 rounded {{if (eq this.period p) 'bg-sky-600 text-white' 'text-gray-500 hover:text-gray-700 dark:hover:text-gray-200'}}"
+                        {{on "click" (fn this.setPeriod p)}}>
+                    {{p}}
+                </button>
+            {{/each}}
+        </div>
+    </div>
+
+    <div class="flex-1 flex flex-col p-2.5 border border-t-0 dark:border-gray-700 border-gray-200 rounded-b-md bg-white dark:bg-gray-900">
+        {{#if this.load.isRunning}}
+            <div class="flex items-center justify-center h-full"><Spinner /></div>
+        {{else if this.error}}
+            <div class="flex items-center justify-center h-full text-xs text-red-500">{{this.error}}</div>
+        {{else if this.data}}
+            <div class="flex items-baseline gap-2 mb-1.5">
+                <span class="text-base font-bold text-black dark:text-gray-100 leading-none">
+                    {{format-currency this.data.summary.total this.data.summary.currency}}
+                </span>
+                {{#if this.deltaStatus}}
+                    <Badge @status={{this.deltaStatus}} @text={{this.deltaText}} @hideIcon={{true}} @disableHumanize={{true}} @wrapperClass="text-[9px] px-1 py-0" />
+                {{/if}}
+            </div>
+            <div class="flex-1 min-h-0">
+                <Chart @type="line" @labels={{this.data.labels}} @datasets={{this.data.datasets}} @options={{this.chartOptions}} />
+            </div>
+        {{/if}}
+    </div>
+</div>

package/addon/components/widget/revenue-trend.js

@@ -0,0 +1,67 @@
+import Component from '@glimmer/component';
+import { tracked } from '@glimmer/tracking';
+import { action } from '@ember/object';
+import { inject as service } from '@ember/service';
+import { task } from 'ember-concurrency';
+
+const PERIODS = ['7d', '30d', '90d'];
+
+export default class WidgetRevenueTrendComponent extends Component {
+    static widgetId = 'fleet-ops-revenue-trend-widget';
+
+    @service fetch;
+
+    @tracked period = '30d';
+    @tracked data = null;
+    @tracked error = null;
+
+    periods = PERIODS;
+
+    constructor() {
+        super(...arguments);
+        this.load.perform();
+    }
+
+    get chartOptions() {
+        return {
+            responsive: true,
+            maintainAspectRatio: false,
+            plugins: {
+                legend: { display: false },
+                tooltip: { mode: 'index', intersect: false },
+            },
+            scales: {
+                x: { grid: { display: false } },
+                y: { beginAtZero: true, ticks: { precision: 0 } },
+            },
+            elements: { point: { radius: 0, hoverRadius: 4 } },
+        };
+    }
+
+    get deltaStatus() {
+        const pct = this.data?.summary?.delta_pct;
+        if (typeof pct !== 'number' || pct === 0) return null;
+        return pct > 0 ? 'success' : 'danger';
+    }
+
+    get deltaText() {
+        const pct = this.data?.summary?.delta_pct;
+        if (typeof pct !== 'number') return null;
+        return `${pct > 0 ? '+' : ''}${pct}%`;
+    }
+
+    @task *load() {
+        try {
+            this.data = yield this.fetch.get('fleet-ops/analytics/revenue-trend', { period: this.period });
+            this.error = null;
+        } catch (e) {
+            this.error = e?.message ?? 'Failed to load revenue trend';
+        }
+    }
+
+    @action
+    setPeriod(period) {
+        this.period = period;
+        this.load.perform();
+    }
+}

package/addon/components/widget/top-drivers.hbs

@@ -0,0 +1,44 @@
+<div class="fleet-ops-widget fleet-ops-top-drivers flex flex-col h-full {{@class}}" ...attributes>
+    <div class="flex items-center justify-between px-3 py-1.5 border dark:border-gray-700 border-gray-200 dark:bg-gray-800 bg-gray-50 rounded-t-md shadow-sm">
+        <span class="text-xs font-bold text-black dark:text-gray-100">{{t "widget.top-drivers.title"}}</span>
+        <div class="flex gap-0.5">
+            {{#each this.sorts as |s|}}
+                <button type="button"
+                        class="text-[10px] px-1.5 py-0.5 rounded {{if (eq this.sortBy s.key) 'bg-sky-600 text-white' 'text-gray-500 hover:text-gray-700 dark:hover:text-gray-200'}}"
+                        {{on "click" (fn this.setSort s.key)}}>
+                    {{s.label}}
+                </button>
+            {{/each}}
+        </div>
+    </div>
+
+    <div class="flex-1 border border-t-0 dark:border-gray-700 border-gray-200 rounded-b-md bg-white dark:bg-gray-900 overflow-auto">
+        {{#if this.load.isRunning}}
+            <div class="flex items-center justify-center h-full"><Spinner /></div>
+        {{else if this.error}}
+            <div class="flex items-center justify-center h-full text-xs text-red-500">{{this.error}}</div>
+        {{else if this.data.rows.length}}
+            <div class="divide-y dark:divide-gray-700">
+                {{#each this.data.rows as |row index|}}
+                    <div class="flex items-center gap-2 px-2 py-1.5 hover:bg-gray-50 dark:hover:bg-gray-800">
+                        <span class="text-[11px] font-bold text-gray-400 w-3 text-right">{{add index 1}}</span>
+                        <div class="w-5 h-5 rounded-full bg-gray-200 dark:bg-gray-700 flex items-center justify-center text-[9px] font-semibold text-gray-600 dark:text-gray-300 flex-shrink-0">
+                            {{first-char row.name}}
+                        </div>
+                        <div class="flex-1 min-w-0">
+                            <div class="text-[11px] font-medium text-black dark:text-gray-100 truncate leading-tight">{{row.name}}</div>
+                            <div class="text-[10px] text-gray-500 dark:text-gray-400 truncate leading-tight">
+                                {{row.orders_completed}} orders &middot; {{format-meters row.distance_m}}
+                            </div>
+                        </div>
+                        {{#if row.on_time_pct}}
+                            <Badge @status={{this.onTimeStatus row.on_time_pct}} @text={{concat row.on_time_pct "%"}} @hideIcon={{true}} @disableHumanize={{true}} @wrapperClass="text-[9px] px-1 py-0" />
+                        {{/if}}
+                    </div>
+                {{/each}}
+            </div>
+        {{else}}
+            <div class="flex items-center justify-center h-full text-[10px] text-gray-500">No driver activity in this period.</div>
+        {{/if}}
+    </div>
+</div>

package/addon/components/widget/top-drivers.js

@@ -0,0 +1,54 @@
+import Component from '@glimmer/component';
+import { tracked } from '@glimmer/tracking';
+import { action } from '@ember/object';
+import { inject as service } from '@ember/service';
+import { task } from 'ember-concurrency';
+
+const SORTS = [
+    { key: 'orders_completed', label: 'Orders' },
+    { key: 'on_time', label: 'On-time' },
+    { key: 'distance', label: 'Distance' },
+];
+
+export default class WidgetTopDriversComponent extends Component {
+    static widgetId = 'fleet-ops-top-drivers-widget';
+
+    @service fetch;
+
+    @tracked sortBy = 'orders_completed';
+    @tracked data = null;
+    @tracked error = null;
+
+    sorts = SORTS;
+
+    constructor() {
+        super(...arguments);
+        this.load.perform();
+    }
+
+    @task *load() {
+        try {
+            this.data = yield this.fetch.get('fleet-ops/analytics/top-drivers', {
+                period: '30d',
+                limit: 10,
+                sort_by: this.sortBy,
+            });
+            this.error = null;
+        } catch (e) {
+            this.error = e?.message ?? 'Failed to load top drivers';
+        }
+    }
+
+    @action
+    setSort(key) {
+        this.sortBy = key;
+        this.load.perform();
+    }
+
+    onTimeStatus(pct) {
+        if (typeof pct !== 'number') return 'info';
+        if (pct >= 95) return 'success';
+        if (pct >= 85) return 'warning';
+        return 'danger';
+    }
+}

package/addon/controllers/settings/routing.js

@@ -20,6 +20,12 @@ export default class SettingsRoutingController extends Controller {
     @tracked trackingRouteCacheTtlSeconds = 600;
     @tracked trackingStaleLocationThresholdSeconds = 300;
     @tracked trackingDefaultVehicleSpeedKph = 35;
+    @tracked lateDepartureAlertsEnabled = true;
+    @tracked lateDepartureGracePeriodMinutes = 15;
+    @tracked routeDeviationAlertsEnabled = true;
+    @tracked routeDeviationDistanceThresholdMeters = 500;
+    @tracked prolongedStoppageAlertsEnabled = true;
+    @tracked prolongedStoppageDurationThresholdMinutes = 30;
     @tracked showTrackingAdvancedSettings = false;
     @tracked trackingProviderOptions = [
         { value: 'google_routes', label: 'Google Routes' },
@@ -89,6 +95,12 @@ export default class SettingsRoutingController extends Controller {
             this.trackingRouteCacheTtlSeconds = trackingSettings.route_cache_ttl_seconds ?? 600;
             this.trackingStaleLocationThresholdSeconds = trackingSettings.stale_location_threshold_seconds ?? 300;
             this.trackingDefaultVehicleSpeedKph = trackingSettings.default_vehicle_speed_kph ?? 35;
+            this.lateDepartureAlertsEnabled = trackingSettings.alerts?.late_departures?.enabled ?? true;
+            this.lateDepartureGracePeriodMinutes = trackingSettings.alerts?.late_departures?.grace_period_minutes ?? 15;
+            this.routeDeviationAlertsEnabled = trackingSettings.alerts?.route_deviations?.enabled ?? true;
+            this.routeDeviationDistanceThresholdMeters = trackingSettings.alerts?.route_deviations?.distance_threshold_meters ?? 500;
+            this.prolongedStoppageAlertsEnabled = trackingSettings.alerts?.prolonged_stoppages?.enabled ?? true;
+            this.prolongedStoppageDurationThresholdMinutes = trackingSettings.alerts?.prolonged_stoppages?.duration_threshold_minutes ?? 30;
             this.trackingProviderOptions = this.normalizeProviderOptions(trackingSettings.providers ?? this.trackingProviderOptions);
         } catch (error) {
             this.notifications.serverError(error);
@@ -110,6 +122,20 @@ export default class SettingsRoutingController extends Controller {
             route_cache_ttl_seconds: Number(this.trackingRouteCacheTtlSeconds) || 600,
             stale_location_threshold_seconds: Number(this.trackingStaleLocationThresholdSeconds) || 300,
             default_vehicle_speed_kph: Number(this.trackingDefaultVehicleSpeedKph) || 35,
+            alerts: {
+                late_departures: {
+                    enabled: this.lateDepartureAlertsEnabled,
+                    grace_period_minutes: Number(this.lateDepartureGracePeriodMinutes) || 15,
+                },
+                route_deviations: {
+                    enabled: this.routeDeviationAlertsEnabled,
+                    distance_threshold_meters: Number(this.routeDeviationDistanceThresholdMeters) || 500,
+                },
+                prolonged_stoppages: {
+                    enabled: this.prolongedStoppageAlertsEnabled,
+                    duration_threshold_minutes: Number(this.prolongedStoppageDurationThresholdMinutes) || 30,
+                },
+            },
         };
     }