docs(plans): SeaORM ↔ Supabase 마이그레이션 통합 epic 분해안 (#374)

[thxforall]

Summary

#374 epic 의 design spec 작성. 실행 PR 아님 — 분해안만 정의.

채택 방향: Option B (SeaORM 폐기 + Supabase CLI 단독화).

왜 Option B 인가

항목	A (두 시스템 동기)	B (SeaORM 폐기, 채택)
변경 비용 (장기)	매 변경마다 두 곳 + idempotent 보장	한 곳만
drift 위험	사람이 보장 → 재발 (#372 사례)	단일 SOT → 구조적 차단
실행 비용 (1회)	62 SeaORM idempotent 화 + 검증	prod schema dump → baseline + SeaORM 제거

dev 는 이미 `SKIP_DB_MIGRATIONS=1` 로 Supabase 단일이고, prod 만 두 시스템 공존. 통합 = prod 만 dev 모델로 정렬하는 작업.

분해 — 4 Phase

Phase 1 (baseline)        Phase 2 (검증)            Phase 3 (cutover)         Phase 4 (cleanup)
─────────────────         ─────────────────         ─────────────────         ─────────────────
prod schema dump          dev clean DB +            prod 에서 SKIP=1 set      migration/ 삭제
→ supabase/migrations/    Supabase migrations →    → 다음 변경부터 단일 SOT  → main.rs Migrator 제거
   <ts>_baseline.sql      drift CI green 1주        → 마지막 SeaORM 적용      → SKIP_DB_MIGRATIONS env 제거
                                                    → release noted 으로 알림  → docs 재작성

각 Phase = sub-issue 1개 + PR 1개. 자세한 acceptance / risk 는 본 spec 문서 참조.

선결 조건

• DB 운영 모델 SOT 문서화 (단일 진입점) #371 운영 모델 정착 (PR docs(db): operating-model 단일 진입점 추가 (#371) #375 — pending merge)
• post_magazines.status='failed' drift 정합화 #372 'failed' drift 정합화 (PR fix(db): post_magazines.status 4-state 정합화 (#372) #376 — pending merge)
• drift 검증 CI 게이트 (schema diff 자동화) #373 nightly drift CI 안정화 — PR feat(ci): DB drift check (nightly) — PRD vs supabase/migrations 자동 검증 (#373) #378 머지 + 1주 0-error 운영
• (선택) staging 환경 정의 — Phase 2 검증을 dev 컨테이너로 갈음하는 경우 불필요

정량화 결과 (2026-04-30)

시스템	파일 수	비고
Supabase CLI	6	신규 SOT (2026-04-09 baseline 부터)
SeaORM Rust	62	그중 43 DDL, RawSql 0 → SeaORM-native, baseline 으로 대체 가능
SeaORM SQL	3	`006_indexes_and_constraints.sql` 가 #372 진원지

CI 의존

본 PR 의 `wiki:lint` 는 PR #375 의 frontmatter 정합 commit (`81aeabe5`) 에 의존 — `docs/superpowers/specs/2026-04-23-e2e-hardening-reprioritization-design.md` 의 기존 에러 때문. 본 PR 자체가 추가하는 lint 에러 0건. PR #375 머지되면 자동 해소.

Test plan

• PR docs(db): operating-model 단일 진입점 추가 (#371) #375 머지 후 본 PR 의 wiki:lint 자동 green 확인
• 본 PR 머지 후 sub-issue 4개 등록 ([Epic] SeaORM ↔ Supabase 마이그레이션 통합 (B.3) #374-1 ~ [Epic] SeaORM ↔ Supabase 마이그레이션 통합 (B.3) #374-4)
• drift 검증 CI 게이트 (schema diff 자동화) #373 1주 0-error 검증 후 Phase 1 (baseline 작성) 착수

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
decoded-app	Ready	Preview, Comment	Apr 30, 2026 7:09am