[Domínios API]

Work Order Domain

The Work Order domain manages the complete lifecycle of utility work orders from creation through completion. It supports six order types across six utility sectors, with crew assignment, location tracking, scheduling, m

Metadados do modulo

The Work Order domain manages the complete lifecycle of utility work orders from creation through completion. It supports six order types across six utility sectors, with crew assignment, location tracking, scheduling, m

Voltar a Todos os Módulos

Referencia de origem

content/modules/domain-work-order.md

Última Atualização

24 de fev. de 2026

Categoria

Domínios API

Etiquetas

api-domainscompliance

Documentacao renderizada

Esta pagina renderiza o Markdown e Mermaid do modulo diretamente da fonte publica de documentacao.

Overview#

The Work Order domain manages the complete lifecycle of utility work orders from creation through completion. It supports six order types across six utility sectors, with crew assignment, location tracking, scheduling, materials usage, labor hours tracking, and a full status history audit trail that records every state transition with user attribution.

Key Features#

  • Multiple Work Order Types - Create emergency, planned, preventive, corrective, construction, and inspection work orders to cover the full range of utility field operations.

  • Multi-Utility Support - Manage work orders across electric, water, gas, sewer, telecom, and waste utility types within a unified system.

  • Lifecycle Management - Track work orders through nine status stages (created, assigned, dispatched, en route, on site, in progress, pending review, completed, cancelled) with automatic timestamp recording at each transition.

  • Priority Management - Classify work orders by five priority levels (critical, high, medium, low, routine) with priority-based query ordering to surface the most urgent work first.

  • Status History Audit Trail - Record every status transition as an immutable history entry with the user who made the change, timestamp, GPS coordinates, and optional notes for complete accountability.

  • Crew Assignment and Scheduling - Assign crews to work orders with scheduling support including estimated duration, scheduled start and end times, and due dates.

  • Materials and Labor Tracking - Record materials used and labor hours for each work order to support job costing, inventory management, and operational analysis.

  • Cross-Domain Linking - Link work orders to incidents, outages, infrastructure assets, service territories, customers, and parent work orders for comprehensive context.

  • Dispatch Integration - Support intelligent dispatch with required skills tracking, critical facility flagging, life-support customer identification, and approval workflows.

  • Dashboard Statistics - View work order counts by status for operational oversight and workload management.

Work Order Types#

TypeDescription
EmergencyUrgent unplanned work
PlannedScheduled future work
PreventiveProactive maintenance
CorrectiveReactive repairs
ConstructionNew infrastructure
InspectionAssessment and review

Use Cases#

  • Emergency Response - Create and dispatch emergency work orders with critical priority, tracking crew progress from dispatch through arrival and completion.

  • Preventive Maintenance - Schedule and manage routine maintenance work orders with materials planning and labor hour tracking.

  • Outage Restoration - Link work orders to outage records and customer impacts to coordinate restoration efforts with full status tracking.

  • Operational Reporting - Use dashboard statistics and status history to report on work order throughput, response times, and completion rates.

Integration#

The Work Order domain connects with utility operations across the platform:

  • Utility Infrastructure - Work orders reference specific infrastructure assets
  • Customer Management - Customer accounts provide context for field work
  • Outage Management - Work orders link to outage events for restoration tracking
  • SLA Tracking - Work order timestamps feed into SLA compliance monitoring
  • Utility Inventory - Material usage records connect to the parts catalog
  • Service Territory - Work orders route to crews based on territory assignments

Last Reviewed: 2026-02-24