MOPC-App/docs/round-redesign-architecture.../mixed-round-design-implemen.../phase-01-schema-runtime-fou.../overview.md

# Phase 01 Overview: Schema and Runtime Foundation

## Objective
Implement the canonical schema and reset/reseed capability that supports stage-native orchestration with award and live runtime primitives.

## In Scope

- prisma schema rebuild for canonical entities
- indexes and constraints for hot paths
- reset/reseed strategy and scripts
- data integrity verification scripts

## Out of Scope

- end-user UI behavior
- full router refit

## Key Design Choice

This phase uses full reset/reseed and does not attempt compatibility bridges.

## Exit Criteria

1. Schema compiles and generates client successfully.
2. Reset/reseed produces runnable dataset.
3. Integrity verification passes for FK/index and state initialization rules.
4. Phase 01 gates complete.
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			`# Phase 01 Overview: Schema and Runtime Foundation`

			`## Objective`
			`Implement the canonical schema and reset/reseed capability that supports stage-native orchestration with award and live runtime primitives.`

			`## In Scope`

			`- prisma schema rebuild for canonical entities`
			`- indexes and constraints for hot paths`
			`- reset/reseed strategy and scripts`
			`- data integrity verification scripts`

			`## Out of Scope`

			`- end-user UI behavior`
			`- full router refit`

			`## Key Design Choice`

			`This phase uses full reset/reseed and does not attempt compatibility bridges.`

			`## Exit Criteria`

			`1. Schema compiles and generates client successfully.`
			`2. Reset/reseed produces runnable dataset.`
			`3. Integrity verification passes for FK/index and state initialization rules.`
			`4. Phase 01 gates complete.`