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

47 lines
1.2 KiB
Markdown

# 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
```bash
git diff -- docs/FEATURES docs/TASKS
```