app.engagement_documents
TableRow level security on
Documents exchanged on an engagement: offers, agreements, statements of work, riders, settlements (Section 4.4.4), each moving through the Engagement-Document lifecycle.
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 the document belongs to.References app.engagements.id |
| document_kind | app.engagement_document_kind | No | Kind of document. |
| title | text | No | Document title. |
| document_id | uuid | Yes | Stored document and its versions (A03 knowledge documents), once uploaded.References app.documents.id |
| expires_on | date | Yes | Last day the document is valid, for documents that expire. |
| engagement_document_state | app.engagement_document_state | No | Document state. Changes only through app.transition_engagement_document. |
| 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 |