82 lines
3.9 KiB
Markdown
82 lines
3.9 KiB
Markdown
---
|
|
title: blog-topic / contract-verification-suite-release-gates
|
|
source_type: blog-topic
|
|
status: raw
|
|
related_branches: [feature-contract-verification-test-suite]
|
|
related_projects: [ca-tmpl]
|
|
tags: [blog-topic, ca-tmpl, testing, ci-cd, junit5, api-contract, static-analysis]
|
|
created: 2026-07-02
|
|
status_label: ready-for-canonical
|
|
target_audience: backend-engineer
|
|
inspiration_url:
|
|
archive_url:
|
|
---
|
|
|
|
# blog-topic: contract-verification-suite-release-gates
|
|
|
|
> Layer: `raw/blog-topics/` — 작업 중 나온 블로그 글감 원석. 최종 블로그는 canonical 정제 후 `wiki/blog/`에서 작성한다.
|
|
|
|
## Parent / 부모
|
|
|
|
- [[raw/branch-notes/feature-contract-verification-test-suite]] — release-blocking contract suite 구현과 검증에서 나온 글감.
|
|
|
|
## 트리거 / Trigger
|
|
|
|
- 트리거 유형: `branch-work`
|
|
- 트리거 날짜: 2026-07-02
|
|
- 트리거 연결 노트: [[raw/branch-notes/feature-contract-verification-test-suite]]
|
|
|
|
## 글감 / Topic seed
|
|
|
|
- 한 문장 요지: skeleton의 운영 계약을 문서로만 두지 않고 release-blocking test suite로 묶은 이유와 설계 단위를 정리한다.
|
|
- 예상 제목 후보:
|
|
- 운영 계약을 release gate로 바꾸는 방법
|
|
- Clean Architecture skeleton에서 contract verification suite를 둔 이유
|
|
|
|
## 핵심 주장 후보 / Claim candidates
|
|
|
|
- 사실 후보:
|
|
- 11개 release-blocking gate, ApprovalTests/OpenAPI snapshot, optional adapter skip proof, masking regex 함정이 branch에 정리되어 있다 — 근거 후보: [[raw/branch-notes/feature-contract-verification-test-suite]] D6/D7 line `:134-136`, 구현 `:104-107`, blog seeds `:349-354`.
|
|
- 경험 후보:
|
|
- registry drift, ArchUnit isolation, OpenAPI committed snapshot은 각각 다른 실패 모드를 잡기 때문에 하나의 "품질 테스트"로 뭉개기 어렵다.
|
|
- 의견/해석 후보:
|
|
- skeleton project의 핵심은 기능 수가 아니라 복제 후 깨지면 안 되는 계약을 실행 가능하게 만드는 데 있다.
|
|
|
|
## Outline seed
|
|
|
|
1. contract verification은 단일 테스트가 아니다 — registry, API snapshot, architecture rule, adapter skip proof가 서로 다른 drift를 본다.
|
|
2. release-blocking과 advisory check를 구분해야 한다 — 모든 검사를 같은 severity로 두면 운영이 어려워진다.
|
|
3. snapshot nondeterminism도 계약 설계의 일부다 — 재현 가능한 출력이 있어야 gate가 신뢰된다.
|
|
|
|
## Canonical 전환 후보 / Canonical extraction candidates
|
|
|
|
- `wiki/projects/ca-tmpl/skeleton-governance-registry-verification-test-scorecard.md` 후보:
|
|
- ca-tmpl contract verification suite 구현 사실.
|
|
- `wiki/concepts/skeleton-governance-registry-verification-test-scorecard.md` 후보:
|
|
- registry, verification test, scorecard 일반 개념.
|
|
- 필요한 추가 검증:
|
|
- 11개 gate의 목록, release-blocking 여부, 실제 CI/Gradle 연결 상태.
|
|
|
|
## Sources / 근거 후보
|
|
|
|
- [[raw/branch-notes/feature-contract-verification-test-suite]] — release-blocking suite와 blog seed 근거.
|
|
|
|
## 미해결 / Unknown
|
|
|
|
- 아직 확인해야 할 사실: hosted CI에서 gate가 실제 release를 차단한 사례가 있는지.
|
|
- 과장하면 안 되는 부분: local verification과 hosted CI/prod evidence를 섞으면 안 된다.
|
|
- 블로그로 쓰기 전에 필요한 canonical 정제: project 문서의 gate matrix와 evidence grade 보강.
|
|
|
|
## Decision / 처리 결정
|
|
|
|
- 액션: `promote-to-canonical`
|
|
- 이유: `wiki/projects/ca-tmpl/skeleton-governance-registry-verification-test-scorecard.md` 에 verification suite/release gate 글감으로 반영했다.
|
|
- 다음 단계: target canonical이 아직 `draft` 이므로 `blogify` 전 review/verify가 필요하다. local verification과 hosted CI/prod evidence를 섞지 않는다.
|
|
|
|
## Related / 관련
|
|
|
|
- 관련 branch: [[raw/branch-notes/feature-contract-verification-test-suite]]
|
|
- 관련 error:
|
|
- 관련 interview prep:
|
|
- derived blog: 생성 전. 생성 시 `wiki/blog/contract-verification-suite-release-gates-YYYY-MM-DD.md` 후보
|