Comments
The comment system provides a review feedback layer on top of any entity in the system. Comments support a resolved/unresolved workflow, allowing reviewers to flag issues and editors to mark them as addressed.
Data model​
| Field | Type | Description |
|---|---|---|
id | number | Primary key |
entityType | string | Type of the target entity (episode, scene, scene_block, etc.) |
entityId | number | ID of the target entity |
text | string | Comment body |
authorId | number | User who created the comment |
isResolved | boolean | Whether the comment has been resolved |
batchId | string | null | Groups multiple related comments |
createdAt | Date | — |
Resolution workflow​
- Reviewer creates a comment on any entity
- Any team member with access can resolve it via
PATCH /comments/:id/resolve - If a resolved comment turns out to be relevant again, it can be unresolved via
PATCH /comments/:id/unresolve
Frontend​
Comments are displayed in a side panel in the Studio. The panel filters comments by the currently viewed entity. Resolved comments are visually distinguished and can be toggled on/off.
Permission scopes​
| Scope | What it guards |
|---|---|
COMMENT_CREATE | Creating a comment |
Update, resolve, unresolve, and delete are available to any authenticated user (ownership or admin check applies in the service layer).