# 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