maintainx-core-workflow-a

# MaintainX Core Workflow A: Work Order Lifecycle ## Overview Master the complete work order lifecycle in MaintainX -- from creation through completion. Work orders are the core unit of maintenance operations. ## Prerequisites - Completed `maintainx-install-auth` setup - `MAINTAINX_API_KEY` environment variable configured - MaintainX account with work order permissions ## Status Transition Flow ``` OPEN ──→ IN_PROGRESS ──→ COMPLETED ──→ CLOSED │ │ ↑ │ ↓ │ │ ON_HOLD ───────────┘ │ └──→ CLOSED (cancelled) ``` ## Instructions ### Step 1: Create a Work Order ```typescript import { MaintainXClient } from './maintainx/client'; const client = new MaintainXClient(); // Create a corrective work order const { data: wo } = await client.createWorkOrder({ title: 'Pump Station #3 - Seal Leak Repair', description: 'Detected water leak at the mechanical seal. Needs immediate attention.', priority: 'HIGH', status: 'OPEN', assignees: [{ type: 'USER', id: 4521 }], assetId: 8901, locationId: 2345, dueDate: '2026-03-21T17:00:00Z', categories: ['CORRECTIVE'], }); console.log(`Work order #${wo.id} created`); ``` ### Step 2: Update Status Through Lifecycle ```typescript // Technician starts work await client.updateWorkOrder(wo.id, { status: 'IN_PROGRESS', }); // Put on hold (waiting for parts) await client.updateWorkOrder(wo.id, { status: 'ON_HOLD', onHoldReason: 'Waiting for replacement seal kit fr...