app.engagement_deliverables
TableRow level security on
What an engaged party owes on an engagement (Section 4.4.4 Contractor: deliverables or milestones): a record of the same project, handed in with a document and accepted or returned by the org.
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 that owes the deliverable.References app.engagements.id |
| record_id | uuid | No | Record of the engagement's project that names what is owed and when.References app.records.id |
| document_id | uuid | Yes | Document of the org handed in with the latest submission.References app.documents.id |
| submission_message | text | Yes | The party's message with the latest submission. |
| submitted_by | uuid | Yes | Person who last submitted, set from the session.References app.people.id |
| submitted_at | timestamp with time zone | Yes | When last submitted. |
| return_reason | text | Yes | Why the org returned it, shown to the party; cleared on the next submission. |
| decided_by | uuid | Yes | Org member who last accepted or returned it, set from the session; never the party.References app.people.id |
| decided_at | timestamp with time zone | Yes | When last accepted or returned. |
| deliverable_state | app.deliverable_state | No | Deliverable state. Changes only through the deliverable 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 |
| fee_minor | bigint | Yes | Agreed price of the milestone in minor units of the engagement's currency; NULL is unpriced. Fixed once accepted; billed by self-billing. |