docs(db): operating-model 단일 진입점 추가 (#371)#375
Merged
Conversation
PRD→dev 시드 작업 중 발견된 post_magazines.status='failed' drift를 계기로, dev/prod/assets 3 영역과 Supabase CLI / SeaORM / TS 상수 3종 사실상 SOT 의 운영 모델 정리 로드맵을 4단계로 분해. GitHub 이슈 등록: - #371 DB 운영 모델 SOT 문서화 (P0) - #372 post_magazines.status='failed' drift 정합화 (P1) - #373 drift 검증 CI 게이트 (P2) - #374 [Epic] SeaORM ↔ Supabase 마이그레이션 통합 B.3 (P3) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
DB 운영을 1페이지로 정리한 docs/database/operating-model.md 추가. PRD→dev 시드 작업 중 발견된 post_magazines.status='failed' drift (#372) 가 보여준 것처럼, 마이그레이션이 SeaORM/Supabase CLI/TS 상수 세 SOT 에 분산돼 drift 가 반복 발생. 본 문서가 영역/시스템 매트릭스 + "어디 추가하나" 결정 트리 + drift 회피 가이드를 한 장에 모음. 변경: - docs/database/operating-model.md 신규 — 진입점 (사람용) - docs/database/04-supabase-cli-setup.md — PRD ref 갱신 (womgfycekpzodibauiyl → tdchmitwczlwydzkyczu), warehouse 드롭 (#335) 반영, dev=self-hosted 명시 - docs/agent/database-summary.md — operating-model 을 1순위 canonical source 로 표시 - CLAUDE.md — 참조 인벤토리 표 최상단에 operating-model 추가 Closes part of #371 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This was referenced Apr 30, 2026
- 2026-04-30-db-operating-model-design.md: `date` → `updated` 필드명, tags 를 허용 어휘 [db, ops, architecture] 로 교체 (이전 [database, migration, supabase, seaorm, drift, documentation] — 어휘 외 6건). - 2026-04-23-e2e-hardening-reprioritization-design.md: `title` 더블쿼트로 감싸 `#170)` 의 YAML comment 절단 해소 → H1_TITLE_MISMATCH 제거. tags 를 [testing, ops] 로 정합화 (이전 infrastructure/hardening 어휘 외). `bun run wiki:lint` 결과: 10 errors → 0 errors (TOO_MANY_RELATED 1건은 warning, CI 통과). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This was referenced Apr 30, 2026
thxforall
added a commit
that referenced
this pull request
Apr 30, 2026
) (#379) #371 PR #375 의 operating-model.md 후속. 동시기 머지될 #372/#373/#377/#378 의 산출물을 진입점 문서에 cross-reference 한다. 변경: - 'dev → prod 동기화 (시드)' 섹션의 13줄 bash 블록을 `just seed-from-prod` (#377) 한 줄로 단축. 자세한 동작은 scripts/seed-from-prod.sh 로 위임. - drift 패턴 표의 'SeaORM 만 변경' 행에 `post_magazines.status='failed'` (#372) 사례 inline 인용 (commit 6351e7c, 2026-04-22 → 45 row → 2026-04-30 발견). nightly drift CI (#373) 도 같은 패턴 자동 감지로 안내. - '관련 문서' 표에 nightly drift CI (#373, #378) 와 PRD→dev 시드 스크립트 (#377) 추가. - 변경 이력에 후속 항목 기록. 검증: bun run wiki:lint 통과 (0 errors, 1 warning). Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
thxforall
added a commit
that referenced
this pull request
Apr 30, 2026
#374 epic 의 design spec — 본 PR 은 spec 작성만, 실행 X. 채택된 방향 + sub-issue 4개 후보를 정의하며, 실행은 #373 (PR #378) 의 1주 0-error 검증 후 시작. 분석 결과: - 현재 SeaORM 62개 vs Supabase CLI 6개 (RawSql 미사용 → SeaORM-native DDL) - dev 는 SKIP_DB_MIGRATIONS=1 로 이미 Supabase 단일, prod 만 두 시스템 공존 - → Option B (SeaORM 폐기) 채택 Phase 분해: 1. baseline — prod schema dump → 1개 idempotent Supabase 마이그레이션 2. 검증 — drift CI 1주 0-error + 수동 dump diff 3. cutover — prod SKIP_DB_MIGRATIONS=1 4. cleanup — migration/ 디렉토리 + main.rs Migrator + env 제거 본 PR 의 wiki:lint 는 #375 의 frontmatter 정합 commit (81aeabe) 의존 (e2e-hardening-reprioritization-design.md 의 기존 에러). 본 PR 머지 후 e2e 파일 에러는 #375 머지로 해소됨. Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
thxforall
added a commit
that referenced
this pull request
Apr 30, 2026
) (#386) #371 PR #375 의 operating-model.md 후속. 동시기 머지될 #372/#373/#377/#378 의 산출물을 진입점 문서에 cross-reference 한다. 변경: - 'dev → prod 동기화 (시드)' 섹션의 13줄 bash 블록을 `just seed-from-prod` (#377) 한 줄로 단축. 자세한 동작은 scripts/seed-from-prod.sh 로 위임. - drift 패턴 표의 'SeaORM 만 변경' 행에 `post_magazines.status='failed'` (#372) 사례 inline 인용 (commit 6351e7c, 2026-04-22 → 45 row → 2026-04-30 발견). nightly drift CI (#373) 도 같은 패턴 자동 감지로 안내. - '관련 문서' 표에 nightly drift CI (#373, #378) 와 PRD→dev 시드 스크립트 (#377) 추가. - 변경 이력에 후속 항목 기록. 검증: bun run wiki:lint 통과 (0 errors, 1 warning). Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/database/operating-model.md신규04-supabase-cli-setup.mdPRD ref 갱신 + warehouse 드롭 반영agent/database-summary.md와CLAUDE.md가 operating-model 을 1순위로 가리키도록 업데이트Closes part of #371
배경
PRD→dev 시드 작업 중
post_magazines.status='failed'drift (#372) 발견. SeaORM 단독 변경이 prod 에 흘러들어가 다른 SOT 와 어긋나는 패턴이 반복 발생. 운영 모델이 여러 문서에 흩어져 "어디 추가하나" 판단이 어려웠던 게 근본 원인 중 하나.상위 spec:
docs/superpowers/specs/2026-04-30-db-operating-model-design.md(dev의 6883a2c 에 단독 커밋, 본 PR 분기 직전)변경 파일
docs/database/operating-model.mddocs/database/04-supabase-cli-setup.mdwomgfycekpzodibauiyl→tdchmitwczlwydzkyczu, warehouse 드롭(#335) 반영, dev=self-hosted 명시, link 명령 정리docs/agent/database-summary.mdCLAUDE.mdAcceptance (#371)
docs/agent/database-summary.md가 본 문서를 가리키도록 업데이트 — canonical sources 1순위 + 권장 진입점 명시후속 (별도 이슈)
post_magazines.status='failed'drift 정합화 (PRD UPDATE 포함)just seed-from-prod자동화 — post_magazines.status='failed' drift 정합화 #372 해결 후Out of scope
docs/database/01-schema-usage.md/03-data-flow.md의 outdated 내용 (image/item/post→posts/spots/solutions) 은 별도 정리 필요. 본 PR 범위 밖.Test plan
🤖 Generated with Claude Code