app.settlements
TableRow level security on
Settlements of engagements (Section 4.5.8). Lines are edited only while Proposed; the total is derived and NULL while any line is unpriced.
Primary key: id
| Column | Type | Nullable | Description |
|---|---|---|---|
| id | uuid | No | Primary key, UUID v7. |
| org_id | uuid | No | Owning org, derived from app.engagements on insert; never accepted from the caller and never changed.References app.organizations.id |
| engagement_id | uuid | No | Engagement settled.References app.engagements.id |
| project_id | uuid | No | Project of the engagement; always the engagement's project.References app.projects.id |
| settlement_number | bigint | No | Number from the project's display key sequence, issued on insert. |
| title | text | No | Settlement title, for example the show it settles. |
| currency_code | character(3) | No | ISO 4217 currency of every line.References private.currencies.currency_code |
| settled_on | date | Yes | Date of the show or period settled. |
| settlement_state | app.settlement_state | No | Settlement state. Changes only through the settlement RPCs. |
| 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 |