app.timesheets
TableRow level security on
A person's time on a project for a period. Hours are derived from the time entries (app.timesheet_hours). The submitter and the worker cannot approve (invariant 18), and an approval is voided when the hours change (invariant 19).
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.References app.projects.id |
| membership_id | uuid | Yes | Membership of the person whose time it is; NULL for external crew, who work through engagement_id.References app.memberships.id |
| period_start | date | No | First day covered. |
| period_end | date | No | Last day covered. |
| submitted_by | uuid | Yes | Person who submitted it, set by app.submit_timesheet.References app.people.id |
| timesheet_state | app.timesheet_state | No | Timesheet state. Changes only through the timesheet RPCs and the void trigger. |
| 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 |
| engagement_id | uuid | Yes | Engagement of the external person whose time it is. Exactly one of membership_id and engagement_id.References app.engagements.id |