Files
MOPC-Portal/docs/round-redesign-architecture-docs/mixed-round-design-implementation-docs/phase-05-special-awards-governance/award-track-and-governance-spec.md
Matt 331b67dae0 Round system redesign: Phases 1-7 complete
Full pipeline/track/stage architecture replacing the legacy round system.

Schema: 11 new models (Pipeline, Track, Stage, StageTransition,
ProjectStageState, RoutingRule, Cohort, CohortProject, LiveProgressCursor,
OverrideAction, AudienceVoter) + 8 new enums.

Backend: 9 new routers (pipeline, stage, routing, stageFiltering,
stageAssignment, cohort, live, decision, award) + 6 new services
(stage-engine, routing-engine, stage-filtering, stage-assignment,
stage-notifications, live-control).

Frontend: Pipeline wizard (17 components), jury stage pages (7),
applicant pipeline pages (3), public stage pages (2), admin pipeline
pages (5), shared stage components (3), SSE route, live hook.

Phase 6 refit: 23 routers/services migrated from roundId to stageId,
all frontend components refitted. Deleted round.ts (985 lines),
roundTemplate.ts, round-helpers.ts, round-settings.ts, round-type-settings.tsx,
10 legacy admin pages, 7 legacy jury pages, 3 legacy dialogs.

Phase 7 validation: 36 tests (10 unit + 8 integration files) all passing,
TypeScript 0 errors, Next.js build succeeds, 13 integrity checks,
legacy symbol sweep clean, auto-seed on first Docker startup.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-13 13:57:09 +01:00

40 lines
1.1 KiB
Markdown

# Award Track and Governance Specification
## Award Track Principle
Awards share the same orchestration engine as the main competition; they are tracks, not detached side workflows.
## Routing Modes
- `PARALLEL`: award path runs while main path continues
- `EXCLUSIVE`: project exits main continuation path and runs award-only
- `POST_MAIN`: award route starts after configured main gate
## Governance Modes
- `JURY_VOTE`: assigned award jurors vote
- `AWARD_MASTER`: designated award owner decides within scope
- `ADMIN`: program/super admin decides
## Decision Requirements
- every winner/finalist decision emits audit entry
- manual overrides require reason code and text
- tie-break policy explicit and deterministic
## Permission Enforcement
- governance mode checked server-side on every decision mutation
- unauthorized attempts return `FORBIDDEN`
## Representative Decision Payload
```json
{
"awardId": "award_123",
"decisionMode": "AWARD_MASTER",
"winnerProjectId": "project_789",
"reasonCode": "SPONSOR_DECISION",
"reasonText": "Award sponsor selected based on category fit"
}
```