Skip to main content

DRIVER

👷🏼 Technical Specification: Driver Setup


📋 Feature Overview

Attribute Detail
Module 📂 Directory (DRIVER)
Feature Name Driver Management
Description Manages driver profiles, personal details, licensing (GDL, Passport), and bank beneficiary info. Handles system user creation for Driver PWA access.
Page & Detail
1. Listing Page: /listing-driver-manage
Displays grid of drivers, filters, delete actions, and navigation to sub-pages.
2. Add/Edit Page: /add-driver-manage
Form for creating new drivers, updating details, and linking system users.
3. Bank Info Page: /add-driver-bank-info
Additional function in driver setup for managing beneficiary details.
User Guide 📄 [Ekajaya Admin User Guide - Directory Module, Section 2]

🛠️ Technical Implementation

A. Permissions & Access Control

Note: Access is controlled via PermissionGuard and component-level checks.
Scope Permission Code Description & Page Usage
Menu Visibility DRIVER.MENU

Sidebar menu visibility.visibility for 
\listing-driver-manage

\add-driver-manage
Page AccessRouting DRIVER.LISTING Access to listing route.
\listing-driver-manage
CreatePage ActionRoutingDRIVER.VIEW

Access to add/edit route.

\add-driver-manage

Add Permission DRIVER.UPDATE Controls the + Add button visibility.
\listing-driver-manage
View PermissionDRIVER.VIEW

Access to the Driver Listing.

\listing-driver-manage

Delete ActionPermission DRIVER.DELETE Visibility of the Delete 🗑️ icon.
\listing-driver-manage
Bank Info View Permission DRIVER_BANK_INFO.VIEW Visibility of the Bank icon in listing.
\listing-driver-manage
View AccessDRIVER.VIEWAccess to the edit form.
\add-driver-manage
Edit/Save ActionPermission DRIVER.UPDATE Ability to save changes on Add/Edit screen.page.
\add-driver-manage
Bank Info UpdateDRIVER_BANK_INFO.UPDATEAbility to save bank details.
\add-driver-bank-info

B. API Interaction

Base URL: ${environment.baseApiUrl}
1. Retrieve Driver List \listing-driver-manage
EndpointGet List
/drivers/getQuery
Method
POST
Key Params
filter: isDeleted||$eq||0 (plus fullName/companyId).
join: company
2. DeleteRetrieve DriverCompany (Soft Delete)Name \listing-driver-manage
EndpointGet Company Name
/drivers/update
Methodcompanies/getQuery
POST
3. Check Driver In Carriers \listing-driver-manage
{ "id": Number, "isDeleted": true }
Get Driver ID
3./carriers/getQuery
POST
4. Delete Driver \listing-driver-manage
Delete
/drivers/update
POST
4. Get Single Driver (Edit Mode) \add-driver-manage
EndpointGet Single
/drivers/getQuery
Method
POST
Query Params
filter: id||$eq||{id}
join: user, district, district.state
4.5. Create/Update Driver Profile \add-driver-manage
Create
/drivers/create
POST
Update
/drivers/update
POST
{
  "companyId": Number,
  "fullName": "String",
  "identificationNumber": "String",
  "nationality": "String",
  "mobileNumber": "String",
  "drivingLicenseClass": "String",
  "licenseExpiryDate": "yyyy-MM-dd",
  "gdlExpiryDate": "yyyy-MM-dd",
  "isDeleted": 0
}
5.6. User Activation (Driver App Access) \add-driver-manage
Create User
/admin/createUser
POST
Link User
/drivers/update (Updates driver with returned userId)
POST
Detach User
/driver/detachDriver (Payload: { driverId })
POST
6. Manage Bank Info (Sub-Page) \add-driver-bank-info
Get Info
/driverBankInfos/getQuery (filter: driverId)
POST
Create/Update
/driverBankInfos/create OR /update
POST
{
  "driverId": Number,
  "accountCode": "String",
  "bankBeneficiaryName": "String",
  "bankBeneficiaryNric": "String",
  "bankBeneficiaryAccountNo": "String",
  "driverBeneficiaryRelationship": "String"
}
7. Helper APIs (Dropdowns) \add-driver-manage
Companies
/companies/getQuery
POST
Nationalities
/settings/getQuery (Type: Nationality)
POST
Relationships
/settings/getQuery (Type: Driver Beneficiary Relation)
POST
Address
/countries/getQuery, /states/getQuery, /districts/getQuery
POST

C. Validation & Business Logic

1. Dependency Checks (Pre-Delete) \listing-driver-manage

Before deleting a driver, the system ensures they are not assigned to an active Carrier.

ModuleEndpointFilter Logic
🚚 Carriers/carriers/getQuerydriverId
Error: "Unable to delete Driver due to tagging to carrier."

2. Unique ID Validation \add-driver-manage

  • Trigger: On Save.
  • Logic: Calls /drivers/getQuery. Filter: identificationNumber||$eq||{inputID};isDeleted||$eq||0.
  • Error: "Driver identification number already exists".

3. Date Formatting \add-driver-manage

  • Library: Luxon (DateTime).
  • Logic: Before saving, all date fields (malaysiaRoadTaxExpiry, etc.) are converted to standard yyyy-MM-dd format. Null strings converted to null.
Back to top