Status Reference

type JobStatus = 
  | "draft"       // Created but not ready
  | "scheduled"   // Assigned and dated
  | "in_progress" // Work underway
  | "on_hold"     // Temporarily paused
  | "completed"   // Work finished
  | "cancelled"   // Job cancelled
  | "invoiced";   // Invoice generated

type QuoteStatus =
  | "draft"     // Being prepared
  | "sent"      // Sent to customer
  | "viewed"    // Customer opened
  | "accepted"  // Customer approved
  | "rejected"  // Customer declined
  | "expired"   // Validity passed
  | "converted"; // Became a job

type InvoiceStatus =
  | "draft"     // Being prepared
  | "pending"   // Ready to send
  | "unpaid"    // Sent, awaiting payment
  | "partial"   // Partially paid
  | "paid"      // Fully paid
  | "canceled"; // Voided

type FaultStatus = 
  | "open"          // Just reported
  | "investigating" // Being assessed
  | "resolved"      // Work completed
  | "closed";       // Finalized

type POStatus =
  | "draft"      // Being prepared
  | "submitted"  // Sent for approval
  | "approved"   // Approved by customer
  | "rejected"   // Declined
  | "converted"  // Became quote or job
  | "expired"    // Validity passed
  | "cancelled"; // Voided

type ExpenseStatus =
  | "draft"     // Being prepared
  | "submitted" // Sent for approval
  | "approved"  // Approved
  | "rejected"  // Declined
  | "paid";     // Reimbursed

type TimesheetStatus =
  | "draft"     // Time being entered
  | "submitted" // Sent for approval
  | "approved"  // Time approved
  | "rejected"  // Time rejected
  | "billed";   // Included in invoice

type ComplianceStatus =
  | "upcoming"   // Future due date
  | "due"        // Due date approaching
  | "overdue"    // Past due date
  | "completed"  // Work finished
  | "cancelled"; // Schedule cancelled

type AssetStatus =
  | "active"      // In service
  | "inactive"    // Not in use
  | "maintenance" // Under repair
  | "disposed";   // Removed from service

-- Example: Job status enum
CREATE TYPE job_status AS ENUM (
  'draft',
  'scheduled', 
  'in_progress',
  'on_hold',
  'completed',
  'cancelled',
  'invoiced'
);

// apps/workbooks-api/src/trpc/routers/workbooks-jobs.ts

const validTransitions: Record<JobStatus, JobStatus[]> = {
  draft: ["scheduled", "cancelled"],
  scheduled: ["in_progress", "cancelled"],
  in_progress: ["completed", "on_hold", "cancelled"],
  on_hold: ["in_progress", "cancelled"],
  completed: ["invoiced"],
  cancelled: [],
  invoiced: [],
};

function isValidTransition(from: JobStatus, to: JobStatus): boolean {
  return validTransitions[from]?.includes(to) ?? false;
}