44 lines
1.0 KiB
Markdown
44 lines
1.0 KiB
Markdown
# 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)
|