Files
social-media/docs/FEATURES/review-workflows.md
Jonathan Bourdon b6eb692c27
Some checks failed
Backend CI/CD / build_and_deploy (push) Has been cancelled
Frontend CI/CD / build_and_deploy (push) Has been cancelled
chore: moving towards agentic development
2026-04-24 21:12:26 -04:00

91 lines
2.0 KiB
Markdown

# Review Workflows
## Status
Active
## Use Case 1: Internal Review Before Client Review
### Actors
- Content contributor
- Provider
- Internal reviewer
- Manager
### Scenario
1. A contributor or provider creates or updates a draft.
2. The team links assets and updates the content item metadata.
3. An internal reviewer leaves comments or requests changes.
4. Revisions are linked or uploaded.
5. A manager decides the content item is ready for client review.
### Outcome
- the content item has an internal review history
- revisions are traceable
- the item advances to client review only after internal readiness
## Use Case 2: Client Approval
### Actors
- Social media manager
- Client approver
### Scenario
1. The team sends a content item for client review.
2. The client reviews assets, caption/copy, dates, and notes.
3. The client records a decision:
- approve
- reject
- request changes
4. The team responds with comments or revisions when necessary.
### Outcome
- the decision is captured in the system
- the audit trail shows who decided what and when
- the team knows whether the item is approved, blocked, or requires changes
## Use Case 3: Revision Loop
### Actors
- Provider or internal contributor
- Reviewer
### Scenario
1. A reviewer requests changes.
2. The owner of the work creates a revised asset or revised copy.
3. The new revision is linked to the content item.
4. The reviewer can compare current state against prior feedback context.
### Outcome
- the latest revision is identifiable
- older revisions remain traceable
- feedback does not get detached from the work item
## Use Case 4: Ready For Publishing Handoff
### Actors
- Manager
- Publishing owner
### Scenario
1. All required review and approval work is complete.
2. The content item transitions to `Ready to publish`.
3. The downstream publishing owner uses the item as the approved handoff package.
### Outcome
- publishing handoff is based on an approved state
- the approved revision and metadata are clear
- the workflow history remains visible