Job States
The different states a job can be in within the system. All job types (Installation, Service, Repair, Callout, Remedial) share the same state model.
Complete List of States
| State | Display Label | Description |
|---|---|---|
preallocated | RESERVED | Job is reserved for the engineer but not yet accepted |
waiting_for_acceptance | OFFER | Job is offered to the engineer, awaiting their acceptance |
issue | OFFER | Regional offer - unassigned job available for any engineer in the region |
unallocated | UNALLOCATED | Job is not yet allocated to anyone |
job_pending | BOOKED | Job is booked and scheduled |
visit_pending | BOOKED | Job has visits pending (used for repair/callout jobs) |
ready_for_audit | UNDER REVIEW | Job work is complete, submitted for audit review |
signed_off | COMPLETED | Job has been signed off by audit |
ready_to_invoice | SIGNED OFF | Job is ready for invoicing |
completed | COMPLETED | Job is completed (general completion state) |
completed_manual_invoice | COMPLETED | Job completed with manual invoicing |
invoiced | COMPLETED | Job has been invoiced |
cancelled | CANCELLED | Job has been cancelled |
State Categories
Job Offers (Pre-Booking)
States where the engineer has not yet accepted the job:
preallocated- Job is reserved specifically for this engineerwaiting_for_acceptance- Job is offered and awaiting engineer responseissue- Regional offer available to any engineer in the area
Active Jobs
States for jobs the engineer is actively working on:
job_pending- Standard booked job awaiting completionvisit_pending- Repair/callout job with scheduled visits
Completion States
States indicating the job work is done:
ready_for_audit- Submitted for reviewsigned_off- Passed audit reviewready_to_invoice- Approved for invoicingcompleted- General completioncompleted_manual_invoice- Completed with manual invoiceinvoiced- Fully invoiced and closed
State Transitions
┌─────────────────────────────────────────────────────────────────────┐
│ JOB OFFERS │
│ ┌──────────────┐ ┌─────────────────────┐ ┌────────┐ │
│ │ preallocated │ │waiting_for_acceptance│ │ issue │ │
│ └──────┬───────┘ └──────────┬──────────┘ └───┬────┘ │
│ │ │ │ │
│ └──────────────────────┴───────────────────┘ │
│ │ │
│ Accept Job │
└────────────────────────────────┼────────────────────────────────────┘
▼
┌─────────────────────────────────────────────────────────────────────┐
│ ACTIVE JOBS │
│ ┌─────────────┐ ┌───────────────┐ │
│ │ job_pending │ │ visit_pending │ │
│ └──────┬──────┘ └───────┬───────┘ │
│ │ │ │
│ └────────────┬─────────────┘ │
│ │ │
│ Submit Job │
└─────────────────────────────┼───────────────────────────────────────┘
▼
┌─────────────────────────────────────────────────────────────────────┐
│ COMPLETION FLOW │
│ │
│ ┌────────────────┐ ┌────────────┐ ┌──────────────────┐ │
│ │ ready_for_audit│ ──▶ │ signed_off │ ──▶ │ ready_to_invoice │ │
│ └────────────────┘ └────────────┘ └────────┬─────────┘ │
│ │ │
│ ▼ │
│ ┌───────────┐ ┌──────────────┐ │
│ │ completed │ │ invoiced │ │
│ └───────────┘ └──────────────┘ │
│ │
│ ┌──────────────────────────┐ │
│ │ completed_manual_invoice │ (alternative path) │
│ └──────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────┘
┌───────────┐
│ cancelled │ (can occur from most states)
└───────────┘Selector Functions
The app provides helper functions to check job state categories:
| Function | Returns true for |
|---|---|
isJobOffer() | waiting_for_acceptance, preallocated, issue |
isBookedJob() | job_pending, visit_pending |
isCompletedJob() | signed_off, completed, ready_to_invoice, completed_manual_invoice, invoiced, ready_for_audit |
isWaitingForAcceptance() | waiting_for_acceptance |
isRegionalOffer() | issue |
Special Behaviors
Past Jobs with Pending State
Jobs with state job_pending that have a job date in the past are displayed as "FORMS REQUIRED" to prompt the engineer to complete outstanding forms.
Regional Offers
Jobs with state issue are regional offers - unallocated jobs available to any engineer in the region. These can be declined without penalty.