2026-02-14 15:26:42 +01:00
|
|
|
# Domain Model and Contracts
|
|
|
|
|
|
|
|
|
|
## Canonical Enums
|
|
|
|
|
|
|
|
|
|
- `StageType = INTAKE | FILTER | EVALUATION | SELECTION | LIVE_FINAL | RESULTS`
|
|
|
|
|
- `TrackKind = MAIN | AWARD | SHOWCASE`
|
|
|
|
|
- `RoutingMode = PARALLEL | EXCLUSIVE | POST_MAIN`
|
|
|
|
|
- `StageStatus = DRAFT | ACTIVE | CLOSED | ARCHIVED`
|
|
|
|
|
- `ProjectStageStateValue = PENDING | IN_PROGRESS | PASSED | REJECTED | ROUTED | COMPLETED | WITHDRAWN`
|
|
|
|
|
- `DecisionMode = JURY_VOTE | AWARD_MASTER | ADMIN`
|
|
|
|
|
- `OverrideReasonCode = DATA_CORRECTION | POLICY_EXCEPTION | JURY_CONFLICT | SPONSOR_DECISION | ADMIN_DISCRETION`
|
|
|
|
|
|
|
|
|
|
## Core Entities
|
|
|
|
|
|
|
|
|
|
### Pipeline
|
|
|
|
|
|
|
|
|
|
- `id`
|
|
|
|
|
- `programId`
|
|
|
|
|
- `name`
|
|
|
|
|
- `slug`
|
|
|
|
|
- `status`
|
|
|
|
|
- `settingsJson`
|
|
|
|
|
- `createdAt`, `updatedAt`
|
|
|
|
|
|
|
|
|
|
### Track
|
|
|
|
|
|
|
|
|
|
- `id`
|
|
|
|
|
- `pipelineId`
|
|
|
|
|
- `kind`
|
|
|
|
|
- `specialAwardId?`
|
|
|
|
|
- `name`
|
|
|
|
|
- `slug`
|
|
|
|
|
- `sortOrder`
|
|
|
|
|
- `routingModeDefault?`
|
|
|
|
|
- `decisionMode?`
|
|
|
|
|
|
|
|
|
|
### Stage
|
|
|
|
|
|
|
|
|
|
- `id`
|
|
|
|
|
- `trackId`
|
|
|
|
|
- `stageType`
|
|
|
|
|
- `name`
|
|
|
|
|
- `slug`
|
|
|
|
|
- `sortOrder`
|
|
|
|
|
- `status`
|
|
|
|
|
- `configVersion`
|
|
|
|
|
- `configJson`
|
|
|
|
|
- `windowOpenAt?`, `windowCloseAt?`
|
|
|
|
|
|
|
|
|
|
### StageTransition
|
|
|
|
|
|
|
|
|
|
- `id`
|
|
|
|
|
- `fromStageId`
|
|
|
|
|
- `toStageId`
|
|
|
|
|
- `priority`
|
|
|
|
|
- `isDefault`
|
|
|
|
|
- `guardJson`
|
|
|
|
|
- `actionJson`
|
|
|
|
|
|
|
|
|
|
### ProjectStageState
|
|
|
|
|
|
|
|
|
|
- `id`
|
|
|
|
|
- `projectId`
|
|
|
|
|
- `trackId`
|
|
|
|
|
- `stageId`
|
|
|
|
|
- `state`
|
|
|
|
|
- `enteredAt`, `exitedAt`
|
|
|
|
|
- `decisionRef?`
|
|
|
|
|
- `outcomeJson`
|
|
|
|
|
|
|
|
|
|
### RoutingRule
|
|
|
|
|
|
|
|
|
|
- `id`
|
|
|
|
|
- `pipelineId`
|
|
|
|
|
- `scope` (`GLOBAL|TRACK|STAGE`)
|
|
|
|
|
- `predicateJson`
|
|
|
|
|
- `destinationTrackId`
|
|
|
|
|
- `destinationStageId?`
|
|
|
|
|
- `priority`
|
|
|
|
|
- `isActive`
|
|
|
|
|
|
|
|
|
|
### Cohort and Live Runtime
|
|
|
|
|
|
|
|
|
|
- `Cohort(id, stageId, name, votingMode, isOpen, windowOpenAt?, windowCloseAt?)`
|
|
|
|
|
- `CohortProject(cohortId, projectId, sortOrder)`
|
|
|
|
|
- `LiveProgressCursor(id, stageId, sessionId, activeProjectId?, activeOrderIndex?, updatedBy, updatedAt)`
|
|
|
|
|
|
|
|
|
|
### Governance Entities
|
|
|
|
|
|
|
|
|
|
- `OverrideAction(id, entityType, entityId, oldValueJson, newValueJson, reasonCode, reasonText, actedBy, actedAt)`
|
|
|
|
|
- `DecisionAuditLog(id, entityType, entityId, eventType, payloadJson, actorId?, createdAt)`
|
|
|
|
|
|
|
|
|
|
## Stage Config Union Contracts
|
|
|
|
|
|
|
|
|
|
### IntakeConfig
|
|
|
|
|
|
|
|
|
|
- file requirements
|
|
|
|
|
- accepted MIME and size constraints
|
|
|
|
|
- deadline and late policy
|
|
|
|
|
- team invite policy
|
|
|
|
|
|
|
|
|
|
### FilterConfig
|
|
|
|
|
|
|
|
|
|
- deterministic gates
|
|
|
|
|
- AI rubric
|
|
|
|
|
- confidence thresholds
|
|
|
|
|
- manual queue policy
|
|
|
|
|
- rejection notification policy
|
|
|
|
|
|
|
|
|
|
### EvaluationConfig
|
|
|
|
|
|
|
|
|
|
- criteria schema
|
|
|
|
|
- assignment strategy
|
|
|
|
|
- review thresholds
|
|
|
|
|
- COI policy
|
|
|
|
|
- visibility rules
|
|
|
|
|
|
|
|
|
|
### SelectionConfig
|
|
|
|
|
|
|
|
|
|
- ranking source
|
|
|
|
|
- finalist target
|
|
|
|
|
- override permissions
|
|
|
|
|
- promotion mode (`auto_top_n`, `hybrid`, `manual`)
|
|
|
|
|
|
|
|
|
|
### LiveFinalConfig
|
|
|
|
|
|
|
|
|
|
- session behavior
|
|
|
|
|
- jury voting config
|
|
|
|
|
- audience voting config
|
|
|
|
|
- cohort policy
|
|
|
|
|
- reveal policy
|
|
|
|
|
- schedule hints (advisory)
|
|
|
|
|
|
|
|
|
|
### ResultsConfig
|
|
|
|
|
|
|
|
|
|
- ranking weight rules
|
|
|
|
|
- publication policy
|
|
|
|
|
- winner override rules
|
|
|
|
|
|
|
|
|
|
## Constraint Rules
|
|
|
|
|
|
|
|
|
|
1. Stage ordering unique per track (`trackId + sortOrder`).
|
|
|
|
|
2. `ProjectStageState` unique on (`projectId`, `trackId`, `stageId`).
|
|
|
|
|
3. `StageTransition` unique on (`fromStageId`, `toStageId`).
|
|
|
|
|
4. Transition destination must remain in same pipeline unless explicit routing rule applies.
|
|
|
|
|
5. Override records immutable after insert.
|
|
|
|
|
6. Decision audit log append-only.
|
|
|
|
|
|
|
|
|
|
## Index Priorities
|
|
|
|
|
|
|
|
|
|
1. `ProjectStageState(projectId, trackId, state)`
|
|
|
|
|
2. `ProjectStageState(stageId, state)`
|
|
|
|
|
3. `RoutingRule(pipelineId, isActive, priority)`
|
|
|
|
|
4. `StageTransition(fromStageId, priority)`
|
|
|
|
|
5. `LiveProgressCursor(stageId, sessionId)`
|
|
|
|
|
6. `DecisionAuditLog(entityType, entityId, createdAt)`
|
