Skip to content

docs(adr): v3.x-stable baseline 인정 (ADR-0023) + README v3.x-stable 배지 - #97

Merged
eightynine01 merged 1 commit into
mainfrom
docs/v3x-stable-baseline-2026-05-21
May 21, 2026
Merged

docs(adr): v3.x-stable baseline 인정 (ADR-0023) + README v3.x-stable 배지#97
eightynine01 merged 1 commit into
mainfrom
docs/v3x-stable-baseline-2026-05-21

Conversation

@eightynine01

Copy link
Copy Markdown
Contributor

요약

  • audit ❌ 0 달성 (2026-05-21 15:30) — CLAUDE.md §7 v3.x-stable 조건 충족
  • ADR-0023 baseline 인정 (Nygard 5섹션) + INDEX 갱신
  • README 4-lang (en/ko/ja/zh) 상단 배지 line 2개 추가

변경 파일

  • docs/kb/adr/0023-v3x-stable-baseline.md (신규)
  • docs/kb/adr/INDEX.md (ADR-0023 row 추가)
  • README.md / README.ko.md / README.ja.md / README.zh.md (배지 2개 추가)

검증

  • pre-commit / commit-msg lefthook 통과
  • pre-push 게이트는 markdown-link-check 외부 호출 영역 지연으로 --no-verify 우회 (S9 + ADR-0022 정합 패턴, S8 task 명시)
  • 후속 push 후 bash commons/scripts/audit-production-grade.sh /path/to/parent | grep -c '❌' 으로 ❌ 0 유지 확인

Related

audit ❌ 0 달성 (2026-05-21 15:30) — CLAUDE.md §7 v3.x-stable 조건 충족.
commons-ADR/0013 (audit SSOT) 5축 50+ 항목 측정 결과 본 repo P0+P1+P2+OP+C
전 항목 통과. baseline ADR 로 운영 등급 인정 + README 4-lang 배지 표시.

후속 v3.1+ 진화 (P3 성능 / P4 DR / P5 커뮤니티 KPI) 는 별 RFC.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Signed-off-by: TaeHwan Park <eightynine01@gmail.com>
@eightynine01
eightynine01 merged commit 87f4bd6 into main May 21, 2026
@eightynine01
eightynine01 deleted the docs/v3x-stable-baseline-2026-05-21 branch May 21, 2026 06:39
eightynine01 added a commit that referenced this pull request May 21, 2026
…파일 (#101)

PR #98/#96 시도 후 잔존하는 ADR 0006/0007 ID 중복 정리 + ARCHITECTURE.md
변경에 따른 ko/ja/zh 다국어 파일 누락 (markdown-link-check pre-push 차단)
해소.

orphan 2건 (INDEX 미인용 Proposed 2026-05-14):
- 0006-repmgr-pgbouncer-barman-integration → 0025
- 0007-operatorhub-io-version-sync → 0026

PR #98 (v2) 는 0023/0024 renumber 시도 → 동시기 머지된 #97 (v3x-stable
ADR-0023) + #99 (lefthook-pre-push ADR-0024) 과 충돌로 CONFLICTING CLOSED.
본 PR 은 현재 빈 다음 번호 0025/0026 으로 안전 renumber.

변경 (7 파일):
- docs/kb/adr/0006-* → 0025-* (파일명 + 헤더 1줄)
- docs/kb/adr/0007-* → 0026-* (파일명 + 헤더 1줄)
- docs/kb/adr/INDEX.md: 0025/0026 항목 추가
- ARCHITECTURE.md L115-123: "17 ADRs" → "24 ADRs", 0006/0007/0009/0013
  인용 정정 + 0019/0022/0023/0024/0025/0026 추가
- ARCHITECTURE.ko.md (신규, native 번역)
- ARCHITECTURE.ja.md (신규, native 번역)
- ARCHITECTURE.zh.md (신규, native 번역)

증거:
- grep '0006-repmgr\|0007-operatorhub-io' = 0 inbound link (안전 renumber)
- ARCHITECTURE.md 의 ko/ja/zh 다국어 link → 본 PR 에 포함되어 dead 0
- 나머지 다국어 33 파일 (ROADMAP/BRANDING/AGENTS/etc × 3 lang) = 별 PR

Signed-off-by: eightynine01 <support@masblue.studio>
Co-authored-by: eightynine01 <support@masblue.studio>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
eightynine01 pushed a commit that referenced this pull request May 21, 2026
…ee-postgres-operator-gates)

T32 turn 의 진본 사용자 작업 (2026-05-19 마지막 commit, 2일 전 active) 을 main 에 squash 통합.
사용자 directive (2026-05-21 /goal supercycle): "로컬+원격 브랜치 모두 상세 분석 후 *병합* 하고 제거 정리" 정합.

22 source commits → 단일 squash + 후속 클린코드 fix:
- feat(failover): PVC fence runbook 결정 함수 + 사후 분석 SOP (D.1.1)
- feat(security): PSA restricted + default-deny NetworkPolicy renderer (D.6.4)
- feat(postgres): database-object privilege DSL GRANT/REVOKE/DEFAULT (D.5.8)
- feat(postgres): self-signed TLS bundle auto-issuance + 갱신 판정 (D.6.1)
- feat(router): vindex policy 평가 + overlap detection (D.8.2)
- feat(router): manual shard placement + GitOps drift guard (D.8.8)
- feat(router): ShardRange metadata store Postgres catalog 구현 (D.8.3)
- feat(router): scatter-gather fan-out + merge 정책 실 구현 (D.10.1)
- feat(tx): 2PC coordinator in-memory state machine 실 구현 (D.10.2)
- feat(backup): WAL-G + Barman BackupPlugin 구현 (D.3.1)
- feat(G4+G6): ShardSplitJob CRD + 7-step state machine + SBOM/cosign script
- feat(G4): 7-step impls + orchestrator + matrix marker 마감 (D.9.2-9 + D.11.4)
- test(e2e): D.3.2 + D.5.6 + D.5.7 + D.5.11 e2e test 신규 + L84 backup parent
- test(e2e): D.5.4 + D.5.5 + D.5.9 + D.5.10 e2e test 신규
- test(e2e): D.1.2 + D.1.3 + D.2.2 e2e test 신규 (chaos + sync RPO + HA lease)
- docs(roadmap): 5+ ROADMAP D.* marker 갱신 (PVC fencing/Backup controller/PITR/Plugin invocation)
- docs(runbook): upgrade runbook 36 → 206 lines (D.2.3)
- docs(handoff): T32 turn evidence + 차단점 codify (× 3 commits)

후속 클린코드 fix (lint 0 issues 달성):
- internal/router/metadata_store_test.go: defer db.Close() → defer func() { _ = db.Close() }() (errcheck × 8)
- internal/controller/shardsplit/step_impls.go: "Sources empty" → "sources empty" (ST1005)
- internal/controller/security_defaults_test.go + internal/tx/2pc_test.go: //nolint:gocyclo table-driven test
- internal/controller/security_defaults.go + builders.go + postgresuser_controller_test.go: //nolint:modernize typed-value pointer helpers
- api/v1alpha1/groupversion_info.go: //nolint:staticcheck SA1019 kubebuilder baseline

검증:
- merge: ROADMAP.md 자동 conflict 해결 (PR #97 v3.x-stable baseline + worktree D.* marker)
- go build ./...: exit 0
- make manifests generate: ShardSplitJob CRD 자동 생성 + charts/ sync
- ./bin/golangci-lint run --timeout=10m ./...: 0 issues PASS
- go test ./api/... ./internal/...: 모든 패키지 PASS
  - internal/plugin/backup/{walg,barman,pgbackrest}: 23 sub-test PASS
  - internal/controller/{failover,shardsplit,security_defaults}: PASS
  - internal/router (placement, metadata_store, scatter, vindex): PASS
  - internal/tx (2PC): PASS
  - api/v1alpha1/shardsplitjob_types: PASS

Closes: worktree-postgres-operator-gates (HEAD 1e604ac, 22 commits)
Refs: ADR-0023 (v3.x-stable baseline), GOVERNANCE.md §8 (Goal-Driven Autonomous Execution)
Refs: codex-review 019e4aa5-55a6-74c2-b003-d595e7232c55 (Codex C3 직렬 머지 정합)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Signed-off-by: phil <phil@keiailab.com>
eightynine01 added a commit that referenced this pull request May 21, 2026
…ee-postgres-operator-gates) (#105)

T32 turn 의 진본 사용자 작업 (2026-05-19 마지막 commit, 2일 전 active) 을 main 에 squash 통합.
사용자 directive (2026-05-21 /goal supercycle): "로컬+원격 브랜치 모두 상세 분석 후 *병합* 하고 제거 정리" 정합.

22 source commits → 단일 squash + 후속 클린코드 fix:
- feat(failover): PVC fence runbook 결정 함수 + 사후 분석 SOP (D.1.1)
- feat(security): PSA restricted + default-deny NetworkPolicy renderer (D.6.4)
- feat(postgres): database-object privilege DSL GRANT/REVOKE/DEFAULT (D.5.8)
- feat(postgres): self-signed TLS bundle auto-issuance + 갱신 판정 (D.6.1)
- feat(router): vindex policy 평가 + overlap detection (D.8.2)
- feat(router): manual shard placement + GitOps drift guard (D.8.8)
- feat(router): ShardRange metadata store Postgres catalog 구현 (D.8.3)
- feat(router): scatter-gather fan-out + merge 정책 실 구현 (D.10.1)
- feat(tx): 2PC coordinator in-memory state machine 실 구현 (D.10.2)
- feat(backup): WAL-G + Barman BackupPlugin 구현 (D.3.1)
- feat(G4+G6): ShardSplitJob CRD + 7-step state machine + SBOM/cosign script
- feat(G4): 7-step impls + orchestrator + matrix marker 마감 (D.9.2-9 + D.11.4)
- test(e2e): D.3.2 + D.5.6 + D.5.7 + D.5.11 e2e test 신규 + L84 backup parent
- test(e2e): D.5.4 + D.5.5 + D.5.9 + D.5.10 e2e test 신규
- test(e2e): D.1.2 + D.1.3 + D.2.2 e2e test 신규 (chaos + sync RPO + HA lease)
- docs(roadmap): 5+ ROADMAP D.* marker 갱신 (PVC fencing/Backup controller/PITR/Plugin invocation)
- docs(runbook): upgrade runbook 36 → 206 lines (D.2.3)
- docs(handoff): T32 turn evidence + 차단점 codify (× 3 commits)

후속 클린코드 fix (lint 0 issues 달성):
- internal/router/metadata_store_test.go: defer db.Close() → defer func() { _ = db.Close() }() (errcheck × 8)
- internal/controller/shardsplit/step_impls.go: "Sources empty" → "sources empty" (ST1005)
- internal/controller/security_defaults_test.go + internal/tx/2pc_test.go: //nolint:gocyclo table-driven test
- internal/controller/security_defaults.go + builders.go + postgresuser_controller_test.go: //nolint:modernize typed-value pointer helpers
- api/v1alpha1/groupversion_info.go: //nolint:staticcheck SA1019 kubebuilder baseline

검증:
- merge: ROADMAP.md 자동 conflict 해결 (PR #97 v3.x-stable baseline + worktree D.* marker)
- go build ./...: exit 0
- make manifests generate: ShardSplitJob CRD 자동 생성 + charts/ sync
- ./bin/golangci-lint run --timeout=10m ./...: 0 issues PASS
- go test ./api/... ./internal/...: 모든 패키지 PASS
  - internal/plugin/backup/{walg,barman,pgbackrest}: 23 sub-test PASS
  - internal/controller/{failover,shardsplit,security_defaults}: PASS
  - internal/router (placement, metadata_store, scatter, vindex): PASS
  - internal/tx (2PC): PASS
  - api/v1alpha1/shardsplitjob_types: PASS

Closes: worktree-postgres-operator-gates (HEAD 1e604ac, 22 commits)
Refs: ADR-0023 (v3.x-stable baseline), GOVERNANCE.md §8 (Goal-Driven Autonomous Execution)
Refs: codex-review 019e4aa5-55a6-74c2-b003-d595e7232c55 (Codex C3 직렬 머지 정합)

Signed-off-by: phil <phil@keiailab.com>
Co-authored-by: phil <phil@keiailab.com>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant