app.work_orders
TableRow level security on
Work orders: scoped work put out for bids, awarded to one bid and carried out (Section 4.2 Work). Canceled work orders are retained.
Primary key: id
| Column | Type | Nullable | Description |
|---|---|---|---|
| id | uuid | No | Primary key, UUID v7. |
| org_id | uuid | No | Owning org, derived from app.projects on insert; never accepted from the caller and never changed.References app.organizations.id |
| project_id | uuid | No | Project. Never changes.References app.projects.id |
| scope_node_id | uuid | Yes | Scope node of the same project the work sits under.References app.scope_nodes.id |
| record_id | uuid | Yes | Record of the same project the work order delivers, for example a Build or Task record.References app.records.id |
| work_order_number | bigint | No | Sequence number within the project, issued on insert. The display key is {project_key}-WO-{number}, read through app.work_order_display_key. |
| title | text | No | What the work is. |
| scope_of_work | text | Yes | The scope bidders price, in sentence case. |
| urid | text | Yes | URID category of the work (dimension 2).References xpms.dim_category.cat_urid |
| zone_id | uuid | Yes | Zone where the work happens.References app.zones.id |
| location_text | text | Yes | Where the work happens, in words, when no zone says it. |
| scheduled_starts_at | timestamp with time zone | Yes | Planned start. |
| scheduled_ends_at | timestamp with time zone | Yes | Planned finish; not before the start. |
| estimated_hours | numeric | Yes | Estimated labor hours; NULL when unestimated. |
| bid_due_at | timestamp with time zone | Yes | When bids are due. |
| awarded_bid_id | uuid | Yes | Bid the work order was awarded to. Set only by app.award_work_order.References app.work_order_bids.id |
| work_order_state | app.work_order_state | No | Lifecycle state. Changes only through app.transition_work_order and app.award_work_order. |
| deleted_at | timestamp with time zone | Yes | Soft delete time. A row with deleted_at set is ignored by every access helper. |
| created_at | timestamp with time zone | No | When the row was inserted. Set by the database. |
| created_by | uuid | Yes | Person who inserted the row, or null for a platform process. Set by the database.References app.people.id |
| updated_at | timestamp with time zone | No | When the row last changed. Set by the database. |
| updated_by | uuid | Yes | Person who last changed the row, or null for a platform process. Set by the database.References app.people.id |
| budget_minor | bigint | Yes | Budget for the work in minor units of currency_code; NULL is unbudgeted, never zero. |
| currency_code | character(3) | No | ISO 4217 currency of the budget; the project's currency when the caller gives none.References private.currencies.currency_code |