Skip to main content

CARRIER

🚛 Technical Specification: Carrier Setup


📋 Feature Overview

Attribute Detail
Module 📂 Fleet (CARRIER)
Feature Name Carrier Management (Fleet Panel)
Description Links a Driver, Mover, and Tanker to form a deployable operational unit. Tracks operational Availability based on component schedules.
Page & Detail
1. Listing Page: /listing-fleet-panel-mover
Displays grid of carriers, filters, availability status, and actions.
2. Add/Edit Page: /add-edit-carrier
Form for linking assets (Driver/Mover/Tanker) to create a carrier unit.
3. Calendar View: /carrier-calendar
Consolidated calendar view of block days for all linked assets.
User Guide 📄 [Ekajaya Admin User Guide - Fleet 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 CARRIER.MENU

Sidebar menu visibility.

\listing-fleet-panel-mover

\add-edit-carrier

Page Routing CARRIER.VIEW

Access to route.
\listing-fleet-panel-mover

\add-edit-carrier

/carrier-calendar

Create Action CARRIER.UPDATE Controls the + Add button on listing.
\listing-fleet-panel-mover
Delete Action CARRIER.DELETE Visibility of the Delete 🗑️ icon.
\listing-fleet-panel-mover
Edit/Save Action CARRIER.UPDATE Ability to save changes on Add/Edit screen.
\add-edit-carrier

B. API Interaction

Base URL: ${environment.baseApiUrl}
1. Listing Carrier Manage \listing-fleet-panel-mover
/carrier/getListing
POST
Filter: statusStartDatetime, statusEndDatetime, availability
/movers/getQuery
POST
Filter: plateNo (Filter Dropdown)
/tankers/getQuery
POST
Filter: tankerNumber (Filter Dropdown)
/drivers/getQuery
POST
Filter: fullName (Filter Dropdown)
/driverUser/getUserList
POST
Purpose: Populate User Filter
/carriers/update
POST
Purpose: Delete (isDeleted=true)
2. Add Carrier Manage \add-edit-carrier
/companies/getQuery
POST
Filter: isDeleted=0
/carriers/getQuery
POST
Filter: id (Fetch record or check uniqueness)
/movers/getQuery
POST
Filter: id!$in... (Exclude active assets), companyId
/tankers/getQuery
POST
Filter: id!$in... (Exclude active assets), companyId
/drivers/getQuery
POST
Filter: id!$in... (Exclude active assets), companyId
/carriers/create
POST
Purpose: Create new dataSource record
/carriers/update
POST
Purpose: Update existing dataSource record
3. Carrier Calendar \carrier-calendar
/carriers/getQuery
POST
Purpose: Fetch carrier details (driver/mover/tanker IDs)
/driverBlockDayDetails/getQuery
POST
Filter: driverId, blockStatus (Blocked, Released, etc.)
/moverBlockDayDetails/getQuery
POST
Filter: moverId, blockStatus
/tankerBlockDayDetails/getQuery
POST
Filter: tankerId, blockStatus