Workforce Productivity Route Reference
Understand aggregate engineer workload, attendance, acknowledgement, late and rebooked work, QA follow-up, and date-range controls.
Before you start
- You need management-level workforce signals rather than individual job editing.
Expected outcome
You can read aggregate workforce metrics and drill into the desk that owns follow-up work.
What this route is for
Workforce Productivity shows completed work, attendance signals, acknowledgement, late or rebooked jobs, and QA follow-up by engineer for a selected operating period.
Visibility and capability notes
| Item | Details |
|---|---|
| Route id | workforce-productivity |
| Visibility | Customer-facing admin route for admin users. |
| Capability notes | Requires analytics capability. Work Orders, Scheduler, and Reports badges show source coverage. |
| Direct inbound | Shell navigation and management dashboard workflows. |
Main regions and controls
| Surface | What it does |
|---|---|
| Range control | Switches between 30 days, 90 days, and this month. |
| Stats | Shows completed jobs, assets inspected, late/rebooked jobs, and QA follow-up. |
| Coverage | Shows source capability coverage. |
| Engineer Workload | Shows engineer-level aggregate rows. |
| Metric Definitions | Explains how the dashboard defines each metric. |
Engineer workload columns
| Column | Meaning |
|---|---|
| Engineer | Display name, role, and schedulable state. |
| Completed | Completed jobs in the selected period. |
| Split | Inspection, work-order, and scheduler-task split. |
| Assets | Assets inspected in the selected period. |
| Average Hours | Average duration across completed work. |
| Acknowledged | Deployed work acknowledgement rate. |
| Late / Rebooked | Delivery reliability signal. |
| QA | Follow-up count. |
| Drill-Down | Links to jobs and QA follow-up. |
Key actions
- Change the period.
- Open Scheduling for completed jobs.
- Open Defects for QA follow-up.
- Use the metric definitions before comparing engineers.
Filters and URL state
The visible control is the period selector. The API receives start and end dates derived from the selected range.
Outputs and side effects
- Read-only aggregate dashboard.
- Does not mutate engineer, job, or QA records.
- Drill-down links open Scheduling or Defects.
Troubleshooting
| Symptom | What to check |
|---|---|
| No completed work appears | Check the selected date range and whether jobs are completed. |
| Work-order split is empty | Confirm work-order capability is enabled and completed work orders exist. |
| Acknowledgement looks low | Check deployment state and whether engineers opened their day run. |
| QA count seems high | Open the QA drill-down and review source defects or inspection follow-up. |
Data Quality Route Reference
Understand the operational data-quality dashboard, capability-aware rules, samples, remediation links, and reviewed state.
Inspections Route Reference
Understand the inspection queue, create and detail dialogs, reassignment and rescheduling flows, and certificate or quote handoffs.