app.client_approval_requests
TableRow level security on
Items the org asks its Client party to approve (Section 4.4.4 Client): a change order or a record of the engagement's project. The client decides once; the decision is never changed. One open request per item and engagement.
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 | Client engagement asked to approve.References app.engagements.id |
| subject_kind | app.client_approval_subject | No | Change Order or Record. |
| change_order_id | uuid | Yes | Change order of the same project, for a Change Order request.References app.change_orders.id |
| record_id | uuid | Yes | Record of the same project, for a Record request.References app.records.id |
| message | text | Yes | What the org asks, shown to the client. |
| requested_by | uuid | Yes | Org member who asked, set from the session.References app.people.id |
| decision | app.approval_decision | Yes | Approved or Rejected; NULL while open. |
| response | text | Yes | The client's comment with the decision, shown to the org. |
| decided_by | uuid | Yes | Client person who decided, set from the session.References app.people.id |
| decided_at | timestamp with time zone | Yes | When decided, set by the database. |
| 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 |