# Conflicts: # docs/ci-cd/template-vs-consumer.md # src/platforms/grpc/CLAUDE.md
48 lines
2.5 KiB
Markdown
48 lines
2.5 KiB
Markdown
# Template maintainer와 Template consumer의 검증은 다르다
|
|
|
|
## 결론
|
|
|
|
이 저장소에는 성격이 다른 두 종류의 검증이 섞여 있다.
|
|
|
|
1. **스켈레톤을 만드는 사람**에게 필요한 검증 — optional 모듈 조합이 모두 빌드되는가, 레지스트리가
|
|
확장 가능한가.
|
|
2. **스켈레톤을 가져다 서비스를 만드는 사람**에게 필요한 검증 — 내 애플리케이션의 테스트,
|
|
아키텍처 방향, 보안, 릴리스.
|
|
|
|
파생 프로젝트가 1번을 그대로 물려받으면, 자기 서비스와 아무 상관 없는 게이트를 평생 유지하게 된다.
|
|
이 문서는 어느 쪽이 어느 쪽인지 적어 둔다.
|
|
|
|
## Template 전용 (파생 프로젝트는 삭제해도 된다)
|
|
|
|
| 대상 | 무엇을 지키는가 |
|
|
| --- | --- |
|
|
| `docs/design/**`, `docs/history/**` | 이 템플릿을 만든 과정의 설계서·계획서·납품 패키지·증거·학습 기록 |
|
|
| `gradle/qualification/**` | 이 템플릿이 벤더링한 플랫폼(JPA, messaging)의 인증 체계 |
|
|
| `*-certification.yml`, `*-qualification.yml`, `jpa-next-*.yml` | 템플릿이 광고하는 지원 매트릭스의 근거 |
|
|
|
|
## Consumer 필수 (파생 프로젝트가 유지해야 한다)
|
|
|
|
| 대상 | 무엇을 지키는가 |
|
|
| --- | --- |
|
|
| `architectureCheck` | Clean Architecture 의존 방향. 이 템플릿의 존재 이유 |
|
|
| 각 leaf의 `check` | 컴파일 · 단위 테스트 · 포맷 · 스타일 · Error Prone |
|
|
| `qualityCheck` | SpotBugs / FindSecBugs |
|
|
| `configContractCheck` | 환경변수 계약 |
|
|
| `verifyDependencyLocks` | 재현 가능한 의존성 해석 |
|
|
| `dependency-vulnerability.yml` | dependency-review + Trivy |
|
|
| `ci-quality-gates.yml` | PR 게이트 |
|
|
| `release.yml` | 이미지 · SBOM 생산 |
|
|
| action의 full SHA 핀 | 공급망 |
|
|
|
|
## 파생 프로젝트가 할 일
|
|
|
|
1. Template 전용 표의 항목을 삭제한다. 삭제는 대부분 파일 삭제 + `config/architecture/modules.json`
|
|
에서 leaf 항목 제거로 끝난다 — 레지스트리가 leaf 목록의 SSOT이고, 개수를 따로 적어 둔 곳은 없다.
|
|
2. `docs/ci-cd/boundary.md`의 경계를 그대로 유지한 채 자기 GitOps 저장소를 연결한다.
|
|
3. `.trivyignore.yaml`과 CODEOWNERS는 그대로 쓴다.
|
|
|
|
## 아직 하지 않은 것
|
|
|
|
Template CI와 Generated Application CI를 **물리적으로** 분리하지는 않았다(생성기 없음). 지금은 이
|
|
문서가 그 경계다. 생성기를 만든다면, 위 표의 "Template 전용" 열이 생성기가 벗겨 내야 할 목록이다.
|