docs(db): operating-model 후속 — seed-from-prod 단축 + drift 사례 inline (#371)

[thxforall]

Summary

#371 PR #375 의 operating-model.md 후속. 동시기 머지될 #372/#373/#377/#378 의 산출물을 진입점 문서에 cross-reference.

stacked on PR #375 — base 가 `feature/371-db-operating-model`. PR #375 머지되면 자동으로 base 가 dev 로 전환됨.

변경

섹션	before	after
dev → prod 동기화 (시드)	13줄 bash 블록 (수동 export PRD_DB_URL → pg_dump → docker exec → import)	`just seed-from-prod` (#377) 한 줄. 내부 동작 / 옵션은 `scripts/seed-from-prod.sh` 로 위임
drift 패턴 표 row 1	"SeaORM 추가 금지. 변경은 위 결정 트리대로"	+ `post_magazines.status='failed'` (#372) 사례 inline 인용 (commit `6351e7c3`, 2026-04-22 → 45 row → 2026-04-30 발견) + nightly drift CI (#373) 안내
drift 패턴 표 row 4	"`pg_dump --data-only --schema public` 로 PRD 데이터 시드 (이슈 #371 의 follow-up: `just seed-from-prod` 후보)"	`just seed-from-prod` 한 줄 + 시드 섹션 anchor link
관련 문서 표	7행	+ nightly drift CI (#373, #378) + PRD→dev 시드 스크립트 (#377) → 9행
변경 이력	1행	+ 2026-04-30 후속 항목

의존

이 PR 은 다음 PR 들의 산출물을 cross-reference 한다. 모두 같은 `dev` 머지를 향한 stack 의 구성요소:

• PR docs(db): operating-model 단일 진입점 추가 (#371) #375 (DB 운영 모델 SOT 문서화 (단일 진입점) #371) — operating-model.md 자체 도입. 본 PR 의 base. → 머지되어야 본 PR base 가 dev 로 자동 전환
• PR fix(db): post_magazines.status 4-state 정합화 (#372) #376 (post_magazines.status='failed' drift 정합화 #372) — `post_magazines.status='failed'` 정합화. 본 PR 이 사례로 인용
• PR feat(scripts): just seed-from-prod 으로 PRD→dev 시드 자동화 (#371 follow-up) #377 (DB 운영 모델 SOT 문서화 (단일 진입점) #371 follow-up) — `just seed-from-prod` + `scripts/seed-from-prod.sh`. 본 PR 의 시드 섹션이 link
• PR feat(ci): DB drift check (nightly) — PRD vs supabase/migrations 자동 검증 (#373) #378 (drift 검증 CI 게이트 (schema diff 자동화) #373) — `docs/database/drift-check.md`. 본 PR 의 drift CI 안내가 link

PR #375 만 머지되면 본 PR 도 dev 머지 가능 (본 문서가 link 한 #377/#378 산출물은 본 PR 머지 시점에 dev 에 없을 수 있으나, link 가 잠시 404 일 뿐 lint 는 통과).

검증

• `bun run wiki:lint` 통과 (0 errors, 1 warning — TOO_MANY_RELATED 는 `docs/wiki/schema/conventions.md` 의 기존 warning, 본 PR 변경 없음)
• 본 문서 자체에 `related:` 추가 없음, 따라서 BROKEN_RELATED 위험 없음

Test plan

• PR docs(db): operating-model 단일 진입점 추가 (#371) #375 머지 후 본 PR base 가 dev 로 자동 전환 확인
• PR feat(scripts): just seed-from-prod 으로 PRD→dev 시드 자동화 (#371 follow-up) #377/feat(ci): DB drift check (nightly) — PRD vs supabase/migrations 자동 검증 (#373) #378 머지 후 본 PR 의 markdown link (`scripts/seed-from-prod.sh`, `drift-check.md`) 가 GitHub 에서 정상 렌더링되는지 확인
• (옵션) PR docs(db): operating-model 단일 진입점 추가 (#371) #375 머지 후 dev 의 `docs/database/operating-model.md` 를 직접 GitHub 에서 열어 시드 섹션이 한 줄로 보이는지 확인

🤖 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:01am