# 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)