EKAJAYA - MOVER

🚛 Technical Specification: Mover Setup

📋 Feature Overview

Attribute	Detail
Module	📂 Directory (MOVER)
Feature Name	Mover Management (Prime Movers)
Description	Manages fleet of prime movers (truck heads). Tracks vehicle ID, specs, and compliance expiry dates (Road Tax, Permits).
User Guide	📄 [Ekajaya Admin User Guide - Directory Module, Section 3]

🕹️ Functional Workflow

🛠️ Technical Implementation

A. Permissions & Access Control

Note: Access is controlled via PermissionGuard and component-level checks.

Scope	Permission Code	Description
Menu Visibility	`MOVER.MENU`	Sidebar menu visibility.
Page Access	`MOVER.LISTING`	Access to `/listing-mover-manage`.
Create Action	`MOVER.UPDATE`	Controls the + Add button on listing.
View Access	`MOVER.VIEW`	Access to `/add-mover-manage`.
Edit/Save Action	`MOVER.UPDATE`	Ability to save changes.
Delete Action	`MOVER.DELETE`	Visibility of the Delete 🗑️ icon.

B. API Interaction

Base URL: ${environment.baseApiUrl}

1. Retrieve Mover List

Endpoint

/movers/getQuery

Method

POST

Key Params

filter: isDeleted||$eq||0 (plus dynamic filters).
join: vehicleBrand, company

2. Get Single Mover (Edit Mode)

Endpoint

/movers/getQuery

Method

POST

Query Params

filter: id||$eq||{id}
limit: 1

3. Create/Update Mover

Create EP

/movers/create

Update EP

/movers/update

Method

POST

{
  "companyId": Number,
  "plateNo": "String",
  "vehicleBrandId": Number,
  "model": "String",
  "chassisNumber": "String",
  "bdm": "String",
  "spadPermitOwner": "String",
  "malaysiaRoadTaxExpiry": "yyyy-MM-dd",
  "isDeleted": 0
}

4. Delete Mover

Endpoint

/movers/update

Method

POST

{ "id": Number, "isDeleted": true }

5. Helper APIs (Dropdowns)

Companies

/companies/getQuery

POST

Vehicle Brands

/vehicleBrands/getQuery

POST

Permit Owners

/settings/getQuery (type="SPAD Permit Owner")

POST

Gear Box Types

/settings/getQuery (type="Gear Box Type")

POST

C. Validation & Business Logic

1. Unique Plate Number Validation

Trigger: On Save.

Logic: Calls /movers/getQuery. Filter: plateNo||$eq||{input}.

Error: Blocking error: "Mover plate number already exists".

2. Dependency Checks (Pre-Delete)

Before deleting a mover, the system ensures it is not assigned to an active Carrier.

Module	Endpoint	Filter Logic	Method
🚛 Carriers	`/carriers/getQuery`	moverId	POST

Error: "Unable to delete Mover due to tagging to carrier."

3. Date Formatting

Library: Luxon (DateTime).

Logic: Before saving, all date fields (malaysiaRoadTaxExpiry, etc.) are converted to standard yyyy-MM-dd format.