Files
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.2 KiB

Phase 01 Migration and Cutover Plan

Strategy

Perform architecture rebuild with reset/reseed as the official path.

Steps

  1. Finalize schema migration scripts.
  2. Run local reset/reseed rehearsal.
  3. Run staging reset/reseed rehearsal.
  4. Execute integrity verification suite.
  5. Lock schema contracts and produce baseline snapshot.

Verification Script Requirements

  • count checks for canonical entities
  • FK integrity checks
  • expected stage graph checks
  • expected project intake state checks

Example Verification Queries

-- orphan project stage states
SELECT COUNT(*)
FROM "ProjectStageState" pss
LEFT JOIN "Project" p ON p.id = pss."projectId"
LEFT JOIN "Stage" s ON s.id = pss."stageId"
LEFT JOIN "Track" t ON t.id = pss."trackId"
WHERE p.id IS NULL OR s.id IS NULL OR t.id IS NULL;

-- project intake state coverage
SELECT COUNT(DISTINCT p.id) AS projects_without_intake
FROM "Project" p
LEFT JOIN "ProjectStageState" pss
  ON pss."projectId" = p.id
LEFT JOIN "Stage" s
  ON s.id = pss."stageId"
WHERE s."stageType" = 'INTAKE'
  AND pss.id IS NULL;

Cutover Readiness Artifacts Produced in Phase 01

  • schema migration files
  • seed scripts
  • integrity query scripts
  • reset/reseed execution logs