Form Fields Specifications

Comprehensive documentation of all form fields and data structures used throughout the ERP Logistics Equipment Management Module. Each form includes field types, validation rules, and business logic requirements.

Equipment Management Forms

Create/Edit Equipment Form

Comprehensive form for creating and editing equipment records with all necessary specifications.

Basic Information

name string Required Equipment display name
type string Required Equipment type (select from predefined list)
model string Required Equipment model
serialNumber string Required Unique serial number
ownership 'owned' | 'rented' Required Ownership type

Financial Information

dailyRate number Optional Required for rented equipment
currency string Required Default: 'USD'
purchaseDate Date Optional Required for owned equipment
purchasePrice number Optional Purchase price for owned equipment

Rental Information

subcontractorId string Optional Required for rented equipment
rentalStartDate Date Optional Rental contract start date
rentalEndDate Date Optional Rental contract end date
rentalContractRef string Optional Rental contract reference

Documentation

licenseNumber string Optional Equipment license number
certificateNumber string Optional Certificate number
plateNumber string Optional Vehicle plate number
licenseExpiryDate Date Optional License expiry date
insuranceExpiryDate Date Optional Insurance expiry date

Work Status Rates

Configure percentage rates for different work statuses:

  • W (Working): Equipment actively working
  • S (Standby): Equipment on standby
  • NW (Not Working): Equipment not operational
  • TG (Transport Going): Equipment being transported to site
  • TB (Transport Back): Equipment being transported from site
interface WorkStatusRate {
  status: 'W' | 'S' | 'NW' | 'TG' | 'TB';
  rate: number;              // Percentage (0-100)
  description?: string;      // Status description
}

Equipment Request Forms

Equipment Request Form

Standard form for requesting equipment with comprehensive specifications and justification.

Request Information

projectId string Required Target project
equipmentType string Required Type of equipment needed
model string Required Preferred model
quantity number Required Number of units needed

Requestor Information

constructionManagerName string Required Construction manager name
requestorName string Required Person submitting request
requestorRole string Required Requestor's role
contactNumber string Required Contact number
email string Required Email address

Timeline

startDate Date Required Equipment needed from date
finishDate Date Required Equipment needed until date
urgency 'low' | 'medium' | 'high' Required Request urgency

Requirements

operatorRequired boolean Required Whether operator is required
maintenanceIncluded boolean Required Whether maintenance is included
fuelIncluded boolean Required Whether fuel is included
transportationRequired boolean Required Whether transportation is needed

Equipment Extension Request Form

Form for requesting extensions to existing equipment rental contracts with multi-level approval workflow.

Multi-Level Approval Workflow

1
Project Leader (PL)

Initial approval for project requirements

2
Project Management Office (PMO)

Budget and resource allocation approval

3
Operations Manager

Operational feasibility and logistics approval

4
Board of Directors (BOD)

Final approval for high-value extensions

interface ExtensionApproval {
  approverRole: 'PL' | 'PMO' | 'Operations Manager' | 'BOD';
  approverName?: string;     // Name of approver
  status: 'pending' | 'approved' | 'rejected';
  comments?: string;         // Approval comments
  approvalDate?: Date;       // Date of approval/rejection
  order: number;             // Order in approval chain
}

Equipment Mobilization Form

Comprehensive form for processing equipment mobilization with all required documentation, licenses, and operator details.

Mobilization Information

mobilisationId string Auto-generated Auto-generated mobilization ID
processedBy string Required Who is processing the mobilization
requestId string Required Selected approved request

Basic Equipment Details

projectId string Required Project assignment
equipmentType string Required Equipment type
model string Required Equipment model
serialNumber string Required Equipment serial number
plateNumber string Required Vehicle plate number
constructionManagerName string Required Construction manager name

Subcontractor Information

subcontractorId string Required Equipment subcontractor

Timeline

startDate Date Required Mobilization start date
finishDate Date Required Demobilization date

License & Registration Details

licenseNumber string Required Equipment license number
licenseExpiryDate Date Required License expiry date
registrationNumber string Required Registration number
registrationExpiryDate Date Required Registration expiry date
licenseDocuments File[] Required License documents upload

Operator Details

driverName string Required Driver/operator name
driverLicense string Required Driver license number
driverLicenseDocuments File[] Required Driver license upload

Inspection Details

inspectionCertificate string Required Inspection certificate number
inspectionExpiryDate Date Required Inspection certificate expiry
inspectionDocuments File[] Required Inspection certificates upload

Processing Information

processedDate Date Auto-generated When mobilization was processed
status 'pending' | 'in_progress' | 'completed' | 'cancelled' Required Mobilization status
notes string Optional Additional notes about mobilization

Payment Processing Forms

Subcontractor Payment Processing Form

Comprehensive form for processing subcontractor payments with equipment cost calculations and timesheet validation.

Payment Selection

selectedSubcontractor string Required Subcontractor to pay
selectedProject string Required Project for payment
selectedEquipment string[] Required Equipment included in payment

Payment Period

startDate Date Required Payment period start date
endDate Date Required Payment period end date

Cost Calculation

totalCost number Auto-calculated Auto-calculated total cost
dailyRates number[] Auto-filled Daily rates for selected equipment
workStatusRates Object Auto-applied Work status rate multipliers

Accounting Information

costCenter string Required Cost center for payment
approvalRequired boolean System-determined Whether approval is required
budgetValidation boolean Auto-validated Budget availability validation

Timesheet Integration

timesheetData Object[] Auto-generated Generated timesheet data for selected period
workStatusBreakdown Object Auto-calculated Breakdown by work status (W/S/NW/TG/TB)
printableTimesheet boolean Feature Generate printable timesheet

Payment Processing Validation

  • Equipment Availability: Validate equipment was assigned to subcontractor during payment period
  • Timesheet Validation: Ensure timesheet data exists for the payment period
  • Cost Calculation: Verify total cost calculation matches daily rates and work status
  • Budget Approval: Validate cost center has sufficient budget
  • Duplicate Prevention: Prevent duplicate payments for same period/equipment

Equipment Request Forms

Equipment Request Form

Standard form for requesting equipment with comprehensive specifications and justification.

Request Information

projectId string Required Target project
equipmentType string Required Type of equipment needed
model string Required Preferred model
quantity number Required Number of units needed

Requestor Information

constructionManagerName string Required Construction manager name
requestorName string Required Person submitting request
requestorRole string Required Requestor's role
contactNumber string Required Contact number
email string Required Email address

Timeline

startDate Date Required Equipment needed from date
finishDate Date Required Equipment needed until date
urgency 'low' | 'medium' | 'high' Required Request urgency

Requirements

operatorRequired boolean Required Whether operator is required
maintenanceIncluded boolean Required Whether maintenance is included
fuelIncluded boolean Required Whether fuel is included
transportationRequired boolean Required Whether transportation is needed

Equipment Extension Request Form

Form for requesting extensions to existing equipment rental contracts with multi-level approval workflow.

Multi-Level Approval Workflow

1
Project Leader (PL)

Initial approval for project requirements

2
Project Management Office (PMO)

Budget and resource allocation approval

3
Operations Manager

Operational feasibility and logistics approval

4
Board of Directors (BOD)

Final approval for high-value extensions

interface ExtensionApproval {
  approverRole: 'PL' | 'PMO' | 'Operations Manager' | 'BOD';
  approverName?: string;     // Name of approver
  status: 'pending' | 'approved' | 'rejected';
  comments?: string;         // Approval comments
  approvalDate?: Date;       // Date of approval/rejection
  order: number;             // Order in approval chain
}

Equipment Mobilization Form

Comprehensive form for processing equipment mobilization with all required documentation, licenses, and operator details.

Mobilization Information

mobilisationId string Auto-generated Auto-generated mobilization ID
processedBy string Required Who is processing the mobilization
requestId string Required Selected approved request

Basic Equipment Details

projectId string Required Project assignment
equipmentType string Required Equipment type
model string Required Equipment model
serialNumber string Required Equipment serial number
plateNumber string Required Vehicle plate number
constructionManagerName string Required Construction manager name

Subcontractor Information

subcontractorId string Required Equipment subcontractor

Timeline

startDate Date Required Mobilization start date
finishDate Date Required Demobilization date

License & Registration Details

licenseNumber string Required Equipment license number
licenseExpiryDate Date Required License expiry date
registrationNumber string Required Registration number
registrationExpiryDate Date Required Registration expiry date
licenseDocuments File[] Required License documents upload

Operator Details

driverName string Required Driver/operator name
driverLicense string Required Driver license number
driverLicenseDocuments File[] Required Driver license upload

Inspection Details

inspectionCertificate string Required Inspection certificate number
inspectionExpiryDate Date Required Inspection certificate expiry
inspectionDocuments File[] Required Inspection certificates upload

Processing Information

processedDate Date Auto-generated When mobilization was processed
status 'pending' | 'in_progress' | 'completed' | 'cancelled' Required Mobilization status
notes string Optional Additional notes about mobilization

Subcontractor Management Forms

Create/Edit Subcontractor Form

Comprehensive form for managing subcontractor information including contact details, banking, and certifications.

Basic Information

name string Required gets-company name
country Country Required Operating country
registrationNumber string Required gets-company registration number
taxNumber string Required Tax identification number

Banking Information

bankName string Required Bank name
bankAccount string Required Account number
swiftCode string Optional SWIFT/BIC code
iban string Optional IBAN number

Certifications and Compliance

certifications string[] Optional Array of certification names
licenses string[] Optional Array of license numbers
safetyRating string Optional Safety rating
qualityRating string Optional Quality rating

Subcontractor Evaluation Form

Comprehensive evaluation form for assessing subcontractor performance across multiple criteria.

Performance Metrics

  • Equipment Availability Percentage
  • On-Time Delivery Rate
  • Safety Incidents Count
  • Quality Issues Count
  • Budget Adherence Percentage

Assessment Categories

  • Excellent: Exceeds expectations
  • Good: Meets expectations
  • Satisfactory: Adequate performance
  • Needs Improvement: Below expectations
  • Poor: Significant issues

Timesheet Management Forms

Timesheet Entry Form

Daily timesheet entry form for tracking equipment usage, work activities, and performance metrics.

Work Status Codes

W Working Equipment actively working
S Standby Equipment on standby
NW Not Working Equipment not operational
TG Transport Going Transport to site
TB Transport Back Transport from site

Basic Information

date Date Required Work date
equipmentId string Required Equipment used
projectId string Required Project being billed for
workStatus WorkStatus Required Work status (W/S/NW/TG/TB)

Time Tracking

startTime string Optional Work start time (HH:MM)
endTime string Optional Work end time (HH:MM)
totalHours number Optional Total working hours
overtimeHours number Optional Overtime hours

Performance Metrics

productivityRate number Optional Productivity rate (%)
fuelConsumption number Optional Fuel consumption (liters)
materialsMoved number Optional Materials moved (tons/cubic meters)
distanceCovered number Optional Distance covered (kilometers)

Safety Information

safetyIncidents boolean Optional Whether safety incidents occurred
incidentDescription string Optional Description of safety incidents
nearMisses string Optional Near miss incidents
safetyMeasures string Optional Safety measures taken

Bulk Timesheet Entry Form

Efficient form for entering multiple timesheet entries across date ranges and equipment, with exception handling for specific dates.

Date Range

startDate Date Required Start date for bulk entry
endDate Date Required End date for bulk entry

Equipment Selection

equipmentIds string[] Required Array of equipment IDs
projectId string Required Project for all entries

Common Information

workStatus WorkStatus Required Work status for all entries
operatorAssignments Object[] Required Operator assignments for each equipment
shiftType 'day' | 'night' | 'overtime' Required Shift type for all entries
workLocation string Required Common work location
activityDescription string Required Common activity description

Time Information

startTime string Required Common start time (HH:MM)
endTime string Required Common end time (HH:MM)
breakHours number Optional Common break hours

Exceptions

exceptions Object[] Optional Exceptions for specific dates/equipment
exceptions.date Date Required Exception date
exceptions.equipmentId string Required Equipment for exception
exceptions.workStatus WorkStatus Optional Different work status for exception
exceptions.noWork boolean Optional Whether no work occurred on this date

Additional Information

notes string Optional Common notes for all entries
submittedBy string Required Who is submitting the bulk entry

Bulk Entry Validation Rules

  • Date Range: End date must be after start date
  • Equipment Availability: All equipment must be available for the date range
  • Operator Assignment: Each equipment must have an assigned operator
  • Exception Handling: Exceptions must be within the specified date range
  • Duplicate Prevention: System prevents duplicate entries for same equipment/date
  • Approval Chain: Bulk entries follow same approval workflow as individual entries

Project Management Forms

Project Equipment Summary Filters

Comprehensive filtering and reporting options for project equipment analysis.

Date Range

Select start and end dates for analysis period

Equipment Types

Filter by specific equipment types or categories

Status

Filter by equipment operational status

Grouping Options

  • By Type: Group equipment by type
  • By Status: Group by operational status
  • By Subcontractor: Group by rental provider
  • By Month: Group by time period

Inspection Forms

Schedule Inspection Form

Comprehensive form for scheduling equipment inspections with detailed requirements and notifications.

Inspection Types

Routine Regular scheduled inspections
Preventive Preventive maintenance inspections
Safety Safety compliance inspections
Certification Certification and compliance inspections
Pre-Operation Before operation inspections
Post-Operation After operation inspections

Inspector Information

inspectorName string Required Inspector name
inspectorCertification string Optional Inspector certification details
contactNumber string Optional Inspector contact number

Notification Requirements

notifyManager boolean Optional Notify equipment manager
notifyOperator boolean Optional Notify equipment operator
notifyProjectManager boolean Optional Notify project manager

Equipment Inspection Form

Comprehensive form for conducting equipment inspections with detailed checklist items and assessment results.

Inspection Results

overallCondition 'excellent' | 'good' | 'fair' | 'poor' | 'critical' Required Overall equipment condition
nextInspectionDate Date Required Next inspection due date
certification boolean Required Certification checkbox

Issues and Recommendations

issuesFound InspectionIssue[] Optional Issues identified during inspection
recommendations string[] Optional Inspector recommendations
immediateActions string[] Optional Immediate actions required 
interface InspectionItemResult {
  checklistItemId: string;         // Checklist item ID
  name: string;                    // Item name
  status?: 'pass' | 'fail' | 'n/a' | string; // Item status/result
  value?: string | number | boolean; // Item value for different input types
  notes?: string;                  // Item-specific notes
  issueFound?: boolean;            // Whether issue was found
  severity?: 'low' | 'medium' | 'high' | 'critical'; // Issue severity
  completed: boolean;              // Whether item is completed
}

Start Inspection Form (Real-time)

Real-time inspection form with progress tracking and immediate results capture.

Progress Tracking

completedItems Set<string> Auto-calculated Set of completed item IDs
progressPercentage number Auto-calculated Overall progress percentage
duration number Auto-calculated Inspection duration in minutes

Create Inspection Checklist Form

Form for creating new inspection checklists for different equipment types.

Checklist Configuration

equipmentType string Required Equipment type for checklist
defaultFrequency InspectionFrequency Required Default inspection frequency
estimatedDuration number Required Estimated completion time (minutes)

Requirements

requiredCertifications string[] Optional Required inspector certifications
safetyRequirements string[] Optional Safety requirements
tools string[] Optional Required tools

Warehouse Management Forms

Warehouse Equipment Edit Form

Form for managing equipment stored in warehouse with location tracking and status updates.

Warehouse Location

warehouseLocation string Required Specific warehouse location
binLocation string Optional Bin/slot location
zone string Optional Warehouse zone
row string Optional Row number

Storage Information

storageDate Date Required Date stored in warehouse
receivedCondition 'excellent' | 'good' | 'fair' | 'poor' Required Condition when received
cleaningRequired boolean Optional Whether cleaning is required
repairsNeeded boolean Optional Whether repairs are needed

Availability and Reservation

availability Date Required When available for use
reservedFor string Optional Reserved for project/user
reservationDate Date Optional Reservation date

Warehouse Equipment Transfer Form

Form for transferring equipment between warehouse locations with approval workflow.

Transfer Approval Workflow

1
Office Logistics Approval

Initial logistics coordination approval

2
Supply Chain Manager Approval

Final supply chain management approval

Transfer Details

transferType 'internal' | 'external' | 'project_assignment' Required Type of transfer
sourceLocation string Required Current location
destinationLocation string Required Destination location
reason string Required Reason for transfer

Transportation

transportationMethod string Optional Method of transportation
transportationCost number Optional Estimated transportation cost
trackingNumber string Optional Tracking number

Warehouse Inspection Form

Form for conducting warehouse-based equipment inspections including receiving, routine, and pre-dispatch inspections.

Warehouse Inspection Types

Receiving Inspection upon receipt
Routine Regular warehouse inspections
Pre-Dispatch Before sending to project
Maintenance Maintenance-related inspection

Specific Checks

structuralIntegrity 'pass' | 'fail' | 'needs_attention' Required Structural integrity check
hydraulicSystems 'pass' | 'fail' | 'needs_attention' | 'n/a' Optional Hydraulic systems check
electricalSystems 'pass' | 'fail' | 'needs_attention' | 'n/a' Optional Electrical systems check
safetyDevices 'pass' | 'fail' | 'needs_attention' Required Safety devices check

Status Determination

inspectionStatus 'pass' | 'pass_with_conditions' | 'fail' Required Overall inspection status
approvedForUse boolean Required Whether approved for use
restrictions string Optional Any usage restrictions

Filter and Search Forms

Equipment Search/Filter Form

Comprehensive filtering options for equipment search and listing functionality.

Basic Filters

search string Optional General search term
type string[] Optional Equipment types
status EquipmentStatus[] Optional Equipment statuses
ownership EquipmentOwnership[] Optional Ownership types

Date Filters

Date range filtering for various equipment date fields:

dateRange?: {
  field: 'purchaseDate' | 'rentalStartDate' | 'lastMaintenanceDate' | 'nextMaintenanceDate';
  startDate?: Date;
  endDate?: Date;
};

Sorting and Pagination

sortBy 'name' | 'type' | 'status' | 'dailyRate' | 'lastMaintenanceDate' Optional Sort field
sortOrder 'asc' | 'desc' Optional Sort direction
page number Optional Page number
limit number Optional Items per page

Equipment Request Filters

Filtering options for equipment request management and tracking.

Status Filters

status ('pending' | 'approved' | 'rejected' | 'in_progress')[] Optional Request statuses
approvalLevel ('pending_pl' | 'pending_pmo' | 'pending_operations' | 'pending_bod')[] Optional Approval levels
priority ('low' | 'medium' | 'high')[] Optional Request priorities

Equipment Inspection Filters

Filtering options for equipment inspection scheduling and tracking.

Maintenance and Inspection Filters

maintenanceDue boolean Optional Equipment with maintenance due
inspectionOverdue boolean Optional Equipment with overdue inspections
nextInspectionDate Date Optional Filter by next inspection date

Form Validation Rules

All forms include comprehensive validation rules to ensure data integrity and business logic compliance.

Field Validation

  • Required Field Validation: All required fields must be completed
  • Data Type Validation: Proper data types for each field
  • Format Validation: Email, phone, date formats
  • Range Validation: Numeric ranges, date ranges

Business Logic Validation

  • Date Logic: End dates after start dates
  • Equipment Availability: Equipment availability checks
  • Budget Approvals: Budget validation and approval limits
  • Role-based Permissions: User role and permission validation

Cross-Field Validation

  • Dependencies: Field dependencies and conditional requirements
  • Unique Constraints: Serial numbers, registration numbers
  • File Validation: File types, sizes for attachments
  • Integration Checks: External system validation