State diagrams of annotation moderation state changes

[seanh]

We're planning to add a new moderation feature in which each annotation has one of five moderation states Pending, Approved, Denied, Spam or NULL (for private annotations). See ERD: Moderation.

A group's moderators, admins and owners will be able to change any shared annotation's state from any of the four states to any of the four states whenever they want.

In addition there are some state changes that will happen automatically. Here are a couple of state diagrams depicting those automatic state changes:

Pre-moderation disabled

Automatic annotation moderation state changes when the group has pre-moderation disabled:

stateDiagram-v2
    [*] --> Approved: Create shared annotation
    [*] --> NULL: Create private annotation
    NULL --> Approved: edit private annotation and make shared
    Denied --> Pending: edit annotation
    Spam

Loading

Pre-moderation enabled

Automatic annotation moderation state changes when the group has pre-moderation enabled:

stateDiagram-v2
    [*] --> Pending: Create shared annotation
    [*] --> NULL: Create private annotation
    NULL --> Pending: edit private annotation and make shared
    Approved --> Pending: edit annotation
    Denied --> Pending: edit annotation
    Spam

Loading

Automatic state changes for shared annotations

stateDiagram-v2
    [*] --> Approved: create annotation (pre-moderation **disabled**)
    [*] --> Pending: create annotation (pre-moderation **enabled**)
    Approved --> Pending:  edit annotation (pre-moderation **enabled**)
    Denied --> Pending: edit annotation (pre-moderation enabled **or** disabled)

Loading