app.shifts
TableRow level security on
Crew shifts: one person (or an open slot) in one role for one block of time on a project. A shift cannot end before it starts (invariant 20).
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 the shift works on.References app.projects.id |
| record_id | uuid | Yes | Shift record of the same project the shift staffs, when planned through one.References app.records.id |
| scope_node_id | uuid | Yes | Scope node of the same project, such as the show.References app.scope_nodes.id |
| membership_id | uuid | Yes | Membership of the assigned person; NULL for an open shift.References app.memberships.id |
| role_code | text | Yes | Canon role worked (Roles Library).References xpms.role.role_code |
| starts_at | timestamp with time zone | No | Call time. |
| ends_at | timestamp with time zone | No | End of the shift; after starts_at. |
| time_zone | text | No | IANA zone the shift times were typed in. |
| 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 |
| shift_state | app.shift_state | No | Shift state. Changes only through app.transition_shift, app.publish_shifts, app.accept_shift and app.claim_open_shift. |
| engagement_id | uuid | Yes | Engagement of the external person assigned, when the shift is worked by someone without a membership. At most one of membership_id and engagement_id; neither is an open shift.References app.engagements.id |
| scheduled_break_minutes | integer | Yes | Meal break scheduled within the shift, in minutes. |