Files
MOPC-Portal/docs/round-redesign-architecture-docs/mixed-round-design-implementation-docs/shared/decision-log.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

1.6 KiB

Decision Log (Locked)

ID Decision Status Rationale Impacted Phases
MX-001 Canonical model is Pipeline -> Track -> Stage Locked Supports multi-track orchestration cleanly 01-07
MX-002 Project progression stored in ProjectStageState records Locked Replaces brittle single-pointer round state 01-07
MX-003 Intake is stage-native (INTAKE) rather than implicit pre-round behavior Locked Removes hidden workflow behavior 01-04
MX-004 Full-cutover delivery with no compatibility bridge Locked Faster convergence to clean runtime 00-07
MX-005 Special awards are first-class Track entities Locked Prevents duplicated orchestration logic 01-06
MX-006 Award routing modes are parallel, exclusive, post_main Locked Supports real sponsor policy diversity 02,05
MX-007 Award governance modes include JURY_VOTE, AWARD_MASTER, ADMIN Locked Explicit and policy-aligned control surfaces 05
MX-008 Live progression source of truth is admin cursor Locked Needed for non-linear live event control 02,04
MX-009 Voting windows are explicit open/close operations Locked Schedules alone are insufficient during live operations 02,04
MX-010 Assignment engine guarantees eligible project coverage Locked Operational fairness and delivery reliability 02,04
MX-011 Overrides require reason and immutable audit entries Locked Governance and explainability 02,05,07
MX-012 Release is blocked by legacy symbol sweep failures Locked Prevents half-migrated runtime behavior 06,07