crowdsourcing-task-review-workflow

name	crowdsourcing-task-review-workflow
description	Understand and modify the full Madoc TS crowdsourcing contribution and review pipeline. Use when changing claim creation rules, crowdsourcing-task and crowdsourcing-review lifecycle behavior, reviewer assignment policy, or project settings that control submission/review flow in services/madoc-ts.

Crowdsourcing Task & Review Workflow (Madoc TS)

Goal

Provide a reliable map of how contribution tasks and review tasks are created, transitioned, and gated by project/template/site settings.

Scope

• Claim preparation and task creation decisions
• Task hierarchy creation (project -> manifest/canvas -> user tasks)
• Contribution status transitions and review task creation
• Reviewer assignment, review actions, and merge flow
• Settings that materially affect task/review behavior

Non-scope

• Generic queue infrastructure details unrelated to crowdsourcing task types
• Capture model editor UI implementation details
• Non-crowdsourcing task types

Primary Entry Points

• Contribution task handler: services/madoc-ts/src/gateway/tasks/crowdsourcing-task.ts
• Review task handler: services/madoc-ts/src/gateway/tasks/crowdsourcing-review.ts
• Claim routes: services/madoc-ts/src/routes/projects/create-resource-claim.ts
• Claim status update: services/madoc-ts/src/routes/projects/update-resource-claim.ts
• Reviewer assignment policy: services/madoc-ts/src/routes/projects/assign-review.ts
• Revision-task update guard: services/madoc-ts/src/routes/projects/update-revision-task.ts
• Claim gating helper: services/madoc-ts/src/utility/claim-utilities.ts
• Review action APIs: