Electrician Portal

Electrician users submit work through both browser and API surfaces.

Browser routes

Portal/ElectricianController.php is rooted at /electrician and handles:

• dashboard
• projects
• notifications
• timesheets
• creating and updating timesheets
• expenses
• creating, updating, and resubmitting expenses
• project detail

Timesheet submission

The electrician portal builds project-specific options for materials, cost codes, work conditions, and manual/selectable allowances. Auto allowances are not shown as selectable manual inputs because they are calculated by AllowanceMatrixCalculator after submission.

Manual allowance selections are stored on TimeEntry.allowances_data. Calculated allowance results are stored separately on TimesheetAllowanceLine rows.

Mobile API parity

The mobile app uses /api/v2/electrician endpoints for similar work. The API payload supports project distance checks, cost-code validation, location metadata, supervisor targeting, and per-entry allowance/material/work-condition arrays.