app.comments
TableRow level security on
Comments in a thread. Editing keeps every earlier text in comment_versions; deleting is soft and clears the text from view.
Primary key: id
| Column | Type | Nullable | Description |
|---|---|---|---|
| id | uuid | No | Primary key, UUID v7. |
| org_id | uuid | No | Owning org, derived from app.comment_threads on insert; never accepted from the caller and never changed.References app.organizations.id |
| comment_thread_id | uuid | No | Thread the comment is in.References app.comment_threads.id |
| author_person_id | uuid | No | Person who wrote it, set from the session.References app.people.id |
| body | text | No | Comment text (Markdown subset), empty once deleted. |
| source | app.comment_source | No | App, Email or API. |
| edited_at | timestamp with time zone | Yes | When the text was last edited. |
| 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. |