docs: redefine approval workflow
This commit is contained in:
46
docs/TASKS/approval-workflow/001-define-approval-workflow.md
Normal file
46
docs/TASKS/approval-workflow/001-define-approval-workflow.md
Normal file
@@ -0,0 +1,46 @@
|
||||
# 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
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user