MOPC-Portal/docs/round-redesign-architecture-docs/mixed-round-design-implementation-docs/phase-02-backend-orchestration/assignment-spec.md

Assignment Engine Specification

Objective

Generate high-quality, fair assignments while guaranteeing eligible project coverage.

Inputs

• stage ID
• eligible project set
• assignee pool
• required reviews per project
• assignment strategy config
• availability and COI policies

Hard Constraints

1. COI exclusion
2. role/status eligibility
3. explicit max-load cap
4. minimum review floor

Soft Scoring Dimensions

• expertise overlap
• bio/project similarity
• availability weighting
• workload balancing
• optional geo diversity
• optional prior-familiarity weighting

Guarantee Rules

1. No eligible project left uncovered.
2. If capacity insufficient, create overflow assignments with warning markers.
3. Preview and execution must match constraints and scoring semantics.

Output Contract

• assigned count
• uncovered count (must be zero unless in explicit error mode)
• overflow assignment list
• conflict skips list
• fairness metrics (median load, max load)