MOPC-App/docs/round-redesign-architecture-docs/mixed-round-design-implementation-docs/phase-01-schema-runtime-foundation/migration-cutover-plan.md

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