app.handbook_articles
TableRow level security on
A handbook or SOP article (Section 4.9 Handbook and SOPs): searchable, versioned on publish, optionally a mandatory read acknowledged per version. The body is the working draft; members read the published version.
Primary key: id
| Column | Type | Nullable | Description |
|---|---|---|---|
| id | uuid | No | Primary key, UUID v7. |
| org_id | uuid | No | Owning org. A row never moves to another org.References app.organizations.id |
| handbook_section_id | uuid | Yes | Section the article sits in.References app.handbook_sections.id |
| title | text | No | Article title. |
| body | text | No | Working text; the published text lives in handbook_article_versions. |
| is_mandatory | boolean | No | Whether every member must acknowledge the current version. |
| article_state | app.handbook_article_state | No | Draft, Published or Archived. |
| published_version | integer | No | Latest published version; 0 before the first publish. |
| published_at | timestamp with time zone | Yes | When the latest version was published. |
| search_vector | tsvector | Yes | Full text search vector of the title and text, maintained by the database. |
| 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 |
| deleted_at | timestamp with time zone | Yes | Soft delete time. A row with deleted_at set is ignored by every access helper. |