@fleetbase/fleetops-engine 0.2.8 → 0.3.0

package/addon/components/vehicle-panel.js

@@ -1,21 +1,82 @@
 import Component from '@glimmer/component';
 import { tracked } from '@glimmer/tracking';
-import { action, computed } from '@ember/object';
+import { action } from '@ember/object';
 import { inject as service } from '@ember/service';
 import { isArray } from '@ember/array';
 import VehiclePanelDetailComponent from './vehicle-panel/details';
+import contextComponentCallback from '../utils/context-component-callback';
+import applyContextComponentArguments from '../utils/apply-context-component-arguments';
 
+/**
+ * Represents the vehicle panel component, handling vehicle information display and editing.
+ *
+ * @class VehiclePanelComponent
+ * @extends Component
+ */
 export default class VehiclePanelComponent extends Component {
+    /**
+     * Service for fetching data.
+     *
+     * @type {Service}
+     */
     @service fetch;
+
+    /**
+     * Service for managing modals.
+     *
+     * @type {Service}
+     */
     @service modalsManager;
+
+    /**
+     * Universe service for managing global data and settings.
+     *
+     * @type {Service}
+     */
     @service universe;
+
+    /**
+     * Ember data store service.
+     *
+     * @type {Service}
+     */
     @service store;
+
+    /**
+     * Service for managing routing within the host app.
+     *
+     * @type {Service}
+     */
     @service hostRouter;
-    @tracked currentTab;
-    @tracked devices = [];
-    @tracked deviceApi = {};
+
+    /**
+     * Service for managing the context panel.
+     *
+     * @type {Service}
+     */
+    @service contextPanel;
+
+    /**
+     * The current active tab.
+     *
+     * @type {Object}
+     * @tracked
+     */
+    @tracked tab;
+
+    /**
+     * The vehicle being displayed or edited.
+     *
+     * @type {VehicleModel}
+     * @tracked
+     */
     @tracked vehicle;
 
+    /**
+     * Returns the array of tabs available for the panel.
+     *
+     * @type {Array}
+     */
     get tabs() {
         const registeredTabs = this.universe.getMenuItemsFromRegistry('component:vehicle-panel');
         // this.universe._createMenuItem('Tracking', null, { icon: 'satellite-dish', component: VehiclePanelTrackingComponent }),
@@ -28,30 +89,79 @@ export default class VehiclePanelComponent extends Component {
         return defaultTabs;
     }
 
-    @computed('currentTab', 'tabs') get tab() {
-        if (this.currentTab) {
-            return this.tabs.find(({ slug }) => slug === this.currentTab);
-        }
-
-        return null;
-    }
-
+    /**
+     * Initializes the vehicle panel component.
+     */
     constructor() {
         super(...arguments);
         this.vehicle = this.args.vehicle;
-        this.changeTab(this.args.tab || 'details');
+        this.tab = this.getTabUsingSlug(this.args.tab);
+        applyContextComponentArguments(this);
+    }
+
+    /**
+     * Sets the overlay context.
+     *
+     * @action
+     * @param {OverlayContextObject} overlayContext
+     */
+    @action setOverlayContext(overlayContext) {
+        this.context = overlayContext;
+        contextComponentCallback(this, 'onLoad', ...arguments);
+    }
+
+    /**
+     * Handles changing the active tab.
+     *
+     * @method
+     * @param {String} tab - The new tab to switch to.
+     * @action
+     */
+    @action onTabChanged(tab) {
+        this.tab = this.getTabUsingSlug(tab);
+        contextComponentCallback(this, 'onTabChanged', tab);
     }
 
-    @action async changeTab(tab) {
-        this.currentTab = tab;
+    /**
+     * Handles edit action for the vehicle.
+     *
+     * @method
+     * @action
+     */
+    @action onEdit() {
+        const isActionOverrided = contextComponentCallback(this, 'onEdit', this.vehicle);
 
-        if (typeof this.args.onTabChanged === 'function') {
-            this.args.onTabChanged(tab);
+        if (!isActionOverrided) {
+            this.contextPanel.focus(this.vehicle, 'editing', {
+                onAfterSave: () => {
+                    this.contextPanel.clear();
+                },
+            });
         }
     }
 
-    @action editVehicle() {
-        const { vehicle } = this.args;
-        return this.hostRouter.transitionTo('console.fleet-ops.management.vehicles.index.edit', vehicle.public_id);
+    /**
+     * Handles the cancel action.
+     *
+     * @method
+     * @action
+     * @returns {Boolean} Indicates whether the cancel action was overridden.
+     */
+    @action onPressCancel() {
+        return contextComponentCallback(this, 'onPressCancel', this.vehicle);
+    }
+
+    /**
+     * Finds and returns a tab based on its slug.
+     *
+     * @param {String} tabSlug - The slug of the tab.
+     * @returns {Object|null} The found tab or null.
+     */
+    getTabUsingSlug(tabSlug) {
+        if (tabSlug) {
+            return this.tabs.find(({ slug }) => slug === tabSlug);
+        }
+
+        return this.tabs[0];
     }
 }

package/addon/controllers/management/drivers/index/details.js

@@ -1,8 +1,61 @@
 import Controller from '@ember/controller';
+import { tracked } from '@glimmer/tracking';
 import { action } from '@ember/object';
 
+/**
+ * Controller for managing the details view within the "Management -> Drivers -> Index" route.
+ *
+ * @class ManagementDriversIndexDetailsController
+ * @extends Controller
+ */
 export default class ManagementDriverIndexDetailsController extends Controller {
+    /**
+     * The currently active view tab ('details' by default).
+     *
+     * @type {String}
+     * @tracked
+     */
+    @tracked view = 'details';
+
+    /**
+     * An array of query parameters to be serialized in the URL.
+     *
+     * @type {String[]}
+     * @tracked
+     */
+    @tracked queryParams = ['view'];
+
+    /**
+     * Transitions back to the "management.drivers.index" route.
+     *
+     * @method
+     * @action
+     * @returns {Transition} The transition object representing the route change.
+     */
     @action transitionBack() {
         return this.transitionToRoute('management.drivers.index');
     }
+
+    /**
+     * Transitions to the edit view for a specific vehicle.
+     *
+     * @method
+     * @param {DriverModel} driver - The vehicle to be edited.
+     * @action
+     * @returns {Transition} The transition object representing the route change.
+     */
+    @action onEdit(driver) {
+        return this.transitionToRoute('management.drivers.index.edit', driver);
+    }
+
+    /**
+     * Updates the active view tab.
+     *
+     * @method
+     * @param {String} tab - The name of the tab to activate.
+     * @action
+     */
+    @action onTabChanged(tab) {
+        this.view = tab;
+    }
 }

package/addon/controllers/management/drivers/index/edit.js

@@ -5,76 +5,107 @@ import { action } from '@ember/object';
 
 export default class ManagementDriversIndexEditController extends Controller {
     /**
-     * True if updating service rate.
+     * Inject the `hostRouter` service
      *
-     * @var {Boolean}
+     * @memberof ManagementDriversIndexEditController
      */
-    @tracked isUpdatingDriver = false;
+    @service hostRouter;
+
     /**
-     * Inject the `loader` service
+     * Inject the `hostRouter` service
      *
-     * @var {Service}
+     * @memberof ManagementDriversIndexEditController
      */
-    @service loader;
+    @service modalsManager;
+
     /**
-     * Inject the `notifications` service
+     * The overlay component context.
      *
-     * @var {Service}
+     * @memberof ManagementDriversIndexEditController
      */
-    @service notifications;
+    @tracked overlay;
+
     /**
-     * Inject the `hostRouter` service
+     * When exiting the overlay.
      *
-     * @var {Service}
+     * @return {Transition}
+     * @memberof ManagementDriversIndexEditController
      */
-    @service hostRouter;
+    @action transitionBack(driver) {
+        // check if driver record has been edited and prompt for confirmation
+        if (driver.hasDirtyAttributes) {
+            return this.confirmContinueWithUnsavedChanges(driver, {
+                confirm: () => {
+                    driver.rollbackAttributes();
+                    return this.transitionToRoute('management.drivers.index');
+                },
+            });
+        }
+
+        return this.transitionToRoute('management.drivers.index');
+    }
+
     /**
-     * Inject the `currentUser` service
+     * Set the overlay component context object.
      *
-     * @var {Service}
+     * @param {OverlayContext} overlay
+     * @memberof ManagementDriversIndexEditController
      */
-    @service store;
+    @action setOverlayContext(overlay) {
+        this.overlay = overlay;
+    }
+
     /**
-     * Updates the drivers to server
+     * When driver details button is clicked in overlay.
      *
-     * @void
+     * @param {VehicleModel} driver
+     * @return {Promise}
+     * @memberof ManagementDriversIndexEditController
      */
-    @action updateDriver() {
-        const { driver } = this;
+    @action onViewDetails(driver) {
+        // check if driver record has been edited and prompt for confirmation
+        if (driver.hasDirtyAttributes) {
+            return this.confirmContinueWithUnsavedChanges(driver);
+        }
 
-        this.isUpdatingDriver = true;
-        this.loader.showLoader('.overlay-inner-content', 'Updating driver...');
+        return this.transitionToRoute('management.drivers.index.details', driver);
+    }
 
-        try {
-            return driver
-                .save()
-                .then((driver) => {
-                    return this.transitionToRoute('management.drivers.index').then(() => {
-                        this.notifications.success(`Driver '${driver.name}' updated`);
-                        this.resetForm();
-                        this.hostRouter.refresh();
-                    });
-                })
-                .catch(this.notifications.serverError)
-                .finally(() => {
-                    this.isUpdatingDriver = false;
-                    this.loader.removeLoader();
-                });
-        } catch (error) {
-            this.isUpdatingDriver = false;
-            this.loader.removeLoader();
+    /**
+     * Trigger a route refresh and focus the new driver created.
+     *
+     * @param {VehicleModel} driver
+     * @return {Promise}
+     * @memberof ManagementDriversIndexEditController
+     */
+    @action onAfterSave(driver) {
+        if (this.overlay) {
+            this.overlay.close();
         }
-    }
 
-    @action transitionBack() {
-        return this.transitionToRoute('management.drivers.index');
+        this.hostRouter.refresh();
+        return this.transitionToRoute('management.drivers.index.details', driver);
     }
+
     /**
-     * Resets the driver form
+     * Prompts the user to confirm if they wish to continue with unsaved changes.
      *
-     * @void
+     * @method
+     * @param {VehicleModel} driver - The driver object with unsaved changes.
+     * @param {Object} [options={}] - Additional options for configuring the modal.
+     * @returns {Promise} A promise that resolves when the user confirms, and transitions to a new route.
+     * @memberof ManagementDriversIndexEditController
      */
-    @action resetForm() {
-        this.driver = this.store.createRecord('driver');
+    confirmContinueWithUnsavedChanges(driver, options = {}) {
+        return this.modalsManager.confirm({
+            title: 'Continue Without Saving?',
+            body: 'Unsaved changes to this driver will be lost. Click continue to proceed.',
+            acceptButtonText: 'Continue without saving',
+            confirm: () => {
+                driver.rollbackAttributes();
+                return this.transitionToRoute('management.drivers.index.details', driver);
+            },
+            ...options,
+        });
     }
 }

package/addon/controllers/management/drivers/index/new.js

@@ -1,128 +1,88 @@
-import Controller, { inject as controller } from '@ember/controller';
-import { inject as service } from '@ember/service';
+import Controller from '@ember/controller';
 import { tracked } from '@glimmer/tracking';
+import { inject as service } from '@ember/service';
 import { action } from '@ember/object';
-import generateSlug from '@fleetbase/ember-core/utils/generate-slug';
 
 export default class ManagementDriversIndexNewController extends Controller {
     /**
-     * Inject the `management.drivers.index` controller
+     * Inject the `store` service
      *
-     * @var {Controller}
-     */
-    @controller('management.drivers.index') index;
-
-    /**
-     * Inject the `currentUser` service
-     *
-     * @var {Service}
+     * @memberof ManagementDriversIndexNewController
      */
     @service store;
 
     /**
      * Inject the `hostRouter` service
      *
-     * @var {Service}
+     * @memberof ManagementDriversIndexNewController
      */
     @service hostRouter;
 
     /**
-     * Inject the `notifications` service
+     * Inject the `hostRouter` service
      *
-     * @var {Service}
+     * @memberof ManagementDriversIndexNewController
      */
-    @service notifications;
+    @service modalsManager;
 
     /**
-     * Inject the `loader` service
+     * The overlay component context.
      *
-     * @var {Service}
+     * @memberof ManagementDriversIndexNewController
      */
-    @service loader;
+    @tracked overlay;
 
     /**
      * The driver being created.
      *
      * @var {DriverModel}
      */
-    @tracked driver = this.store.createRecord('driver', {
-        status: `active`,
-        slug: generateSlug(),
-    });
-
-    /**
-     * Different service types available, based on order type.
-     *
-     * @var {Array}
-     */
-    @tracked serviceTypes = [];
-
-    /**
-     * Service areas.
-     *
-     * @var {Array}
-     */
-    @tracked serviceAreas = [];
+    @tracked driver = this.store.createRecord('driver');
 
     /**
-     * Zones.
+     * Set the overlay component context object.
      *
-     * @var {Array}
+     * @param {OverlayContext} overlay
+     * @memberof ManagementDriversIndexNewController
      */
-    @tracked zones = [];
+    @action setOverlayContext(overlay) {
+        this.overlay = overlay;
+    }
 
     /**
-     * True if creating driver.
+     * When exiting the overlay.
      *
-     * @var {Boolean}
+     * @return {Transition}
+     * @memberof ManagementDriversIndexNewController
      */
-    @tracked isCreatingDriver = false;
+    @action transitionBack() {
+        return this.transitionToRoute('management.drivers.index');
+    }
 
     /**
-     * Saves the driver to server
+     * Trigger a route refresh and focus the new driver created.
      *
-     * @void
+     * @param {DriverModel} driver
+     * @return {Promise}
+     * @memberof ManagementDriversIndexNewController
      */
-    @action createDriver() {
-        const { driver } = this;
-
-        this.isCreatingDriver = true;
-        this.loader.showLoader('.overlay-inner-content', 'Creating driver...');
-
-        try {
-            return driver
-                .save()
-                .then((driver) => {
-                    return this.transitionToRoute('management.drivers.index').then(() => {
-                        this.notifications.success(`New Driver ${driver.name} Created`);
-                        this.resetForm();
-                        this.hostRouter.refresh();
-                    });
-                })
-                .catch((error) => {
-                    console.log(error);
-                    this.notifications.serverError(error);
-                })
-                .finally(() => {
-                    this.isCreatingDriver = false;
-                    this.loader.removeLoader();
-                });
-        } catch (error) {
-            this.isCreatingDriver = false;
-            this.loader.removeLoader();
+    @action onAfterSave(driver) {
+        if (this.overlay) {
+            this.overlay.close();
         }
+
+        this.hostRouter.refresh();
+        return this.transitionToRoute('management.drivers.index.details', driver).then(() => {
+            this.resetForm();
+        });
     }
 
     /**
-     * Resets the driver form
+     * Resets the form with a new driver record
      *
-     * @void
+     * @memberof ManagementDriversIndexNewController
      */
-    @action resetForm() {
+    resetForm() {
         this.driver = this.store.createRecord('driver');
     }
-
-    @action transitionBack() {
-        return this.transitionToRoute('management.drivers.index');
-    }
 }