Work Order Flow

This page describes the complete lifecycle of a work order in the system.

Flow Diagram

┌─────────────────┐
│      OPEN       │ ← Order created
└────────┬────────┘
         │
         ├── Direct dispatch ─────────────────┐
         │                                     │
         ▼                                     ▼
┌─────────────────┐                  ┌─────────────────┐
│ PENDING REVIEW   │                  │    ASSIGNED     │
│ (FM Review)      │                  │                 │
└────────┬────────┘                  └────────┬────────┘
         │                                     │
         │ FM Approval                         │
         ├─────────────────────────────────────┤
         │                                     │
         ▼                                     ▼
┌─────────────────┐                  ┌─────────────────┐
│    ASSIGNED     │                  │  IN PROGRESS    │
└────────┬────────┘                  └────────┬────────┘
         │                                     │
         ▼                                     ▼
┌─────────────────┐                  ┌─────────────────┐
│  IN PROGRESS    │                  │   COMPLETED     │
└────────┬────────┘                  └─────────────────┘
         │
         ▼
┌─────────────────┐
│   COMPLETED     │
└─────────────────┘

* At any stage, the order can be CANCELLED

Stage Details

1. Open (OPEN)

• The order was just created
• The user has selected the asset, problem type and priority
• The workflow is chosen: direct dispatch or review

2. Pending Review (PENDING_REVIEW)

• Only for the "Send to Organization" workflow
• The Facility Manager reviews the order
• Can change priority, due date, contractor
• Can add photos and comments

3. Assigned (ASSIGNED)

• The order has been assigned to a contractor
• The contractor has been notified (email with PDF)
• The SLA response time clock starts

4. In Progress (IN_PROGRESS)

• The contractor has started work
• Progress photos can be uploaded

5. Completed (COMPLETED)

• The work is finished
• The completion date is recorded
• Reports are updated

6. Cancelled (CANCELLED)

• The order was cancelled at any stage
• The cancellation reason is recorded

Notifications per Stage

Transition	Notification
→ Pending Review	Email to Facility Manager
→ Assigned	Email to contractor (with PDF)
→ Completed	Notification to the creator
Status change	Notification to related users