2026-02-14 15:26:42 +01:00
|
|
|
# Phase 01 Schema Specification
|
|
|
|
|
|
|
|
|
|
## Summary
|
|
|
|
|
Introduce the canonical orchestration entities and remove legacy dependency assumptions around single `roundId` progression.
|
|
|
|
|
|
|
|
|
|
## New Canonical Tables
|
|
|
|
|
|
|
|
|
|
1. `Pipeline`
|
|
|
|
|
2. `Track`
|
|
|
|
|
3. `Stage`
|
|
|
|
|
4. `StageTransition`
|
|
|
|
|
5. `ProjectStageState`
|
|
|
|
|
6. `RoutingRule`
|
|
|
|
|
7. `Cohort`
|
|
|
|
|
8. `CohortProject`
|
|
|
|
|
9. `LiveProgressCursor`
|
|
|
|
|
10. `NotificationPolicy`
|
|
|
|
|
11. `OverrideAction`
|
|
|
|
|
12. `DecisionAuditLog`
|
|
|
|
|
|
|
|
|
|
## Award Governance Extensions
|
|
|
|
|
|
|
|
|
|
- Add `DecisionMode = JURY_VOTE | AWARD_MASTER | ADMIN`
|
|
|
|
|
- Add award-scoped governance metadata to award track configs
|
|
|
|
|
- Add award winner finalization audit event contracts
|
|
|
|
|
|
|
|
|
|
## Migration Model
|
|
|
|
|
|
|
|
|
|
- Build new schema directly as canonical target.
|
|
|
|
|
- Keep migration files deterministic and replay-safe.
|
|
|
|
|
- Do not implement dual-write or compatibility tables.
|
|
|
|
|
|
|
|
|
|
## Required Constraints
|
|
|
|
|
|
|
|
|
|
1. `trackId + sortOrder` unique in `Stage`
|
|
|
|
|
2. `projectId + trackId + stageId` unique in `ProjectStageState`
|
|
|
|
|
3. `fromStageId + toStageId` unique in `StageTransition`
|
|
|
|
|
4. `cohortId + projectId` unique in `CohortProject`
|
|
|
|
|
|
|
|
|
|
## Required Indexes
|
|
|
|
|
|
|
|
|
|
- `ProjectStageState(projectId, trackId, state)`
|
|
|
|
|
- `ProjectStageState(stageId, state)`
|
|
|
|
|
- `RoutingRule(pipelineId, isActive, priority)`
|
|
|
|
|
- `StageTransition(fromStageId, priority)`
|
|
|
|
|
- `DecisionAuditLog(entityType, entityId, createdAt)`
|
|
|
|
|
- `LiveProgressCursor(stageId, sessionId)`
|
|
|
|
|
|
|
|
|
|
## Data Initialization Rules
|
|
|
|
|
|
|
|
|
|
- Every seeded project must start with one intake-stage state.
|
|
|
|
|
- Seed must include main track plus at least two award tracks with different routing modes.
|
|
|
|
|
- Seed must include representative roles: admins, jury, applicants, observer, audience contexts.
|
|
|
|
|
|
|
|
|
|
## Integrity Checks
|
|
|
|
|
|
|
|
|
|
- No orphan states.
|
|
|
|
|
- No invalid transition targets across pipelines.
|
|
|
|
|
- No duplicate active state rows for same `(project, track, stage)`.
|
