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

49 lines
1.3 KiB
Markdown

# 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
```sql
-- 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