Files
social-media/docs/TASKS/approval-workflow/001-define-approval-workflow.md

1.2 KiB

Task: Define approval workflow

Feature

docs/FEATURES/approval-workflow.md

Goal

Define the v1 approval workflow behavior for ContentItem approval.

Context

Approval workflow has been split from production workflow. The object being approved is a ContentItem, and workspaces configure approval behavior without defining a fully custom state machine.

Scope

  • Define approval modes.
  • Define approval actors.
  • Define approval decisions.
  • Define the state transitions affected by approval.
  • Define notification and audit side effects.
  • Define open questions that remain outside v1.

Constraints

  • Documentation-only task.
  • Do not change backend or frontend code.
  • Keep production workflow details out of this task except where needed to explain boundaries.

Done When

  • approval modes are defined
  • actor permissions are defined
  • approval decisions are defined
  • state transition behavior is defined
  • workspace configuration fields are described
  • notification side effects are listed
  • audit requirements are listed
  • out-of-scope production behavior is explicitly separated

Validation Commands

git diff -- docs/FEATURES docs/TASKS