refactor: 구조 변경

This commit is contained in:
donghyeon-ka
2026-08-28 17:24:26 +09:00
parent a6f6c663e0
commit b8626946b1
192 changed files with 2251 additions and 206 deletions
+32
View File
@@ -0,0 +1,32 @@
# 기여 가이드
## 변경 원칙
1. 변경 대상의 소유 디렉터리를 먼저 확인합니다.
2. 재사용 가능한 구현은 catalog 영역에, 환경별 조합과 차이만 live/cluster
진입점에 둡니다.
3. 하나의 리소스는 하나의 도구와 하나의 디렉터리만 소유합니다.
4. 운영 변경에는 영향 범위, 롤백 방법, 검증 결과를 함께 기록합니다.
5. `make check`를 통과한 변경만 리뷰를 요청합니다.
## 이름 규칙
- 폴더와 리소스: 소문자 `kebab-case`
- 환경: `dev`, `staging`, `prod`처럼 조직에서 합의한 고정 어휘
- 클러스터: 환경과 위치를 식별할 수 있는 안정적인 이름
- 임시 이름, 사람 이름, 티켓 번호를 장기 리소스 이름에 사용하지 않음
## Pull request 체크리스트
- [ ] 변경이 올바른 소유권 경계에 위치한다.
- [ ] 비밀, kubeconfig, state, plan 파일이 포함되지 않았다.
- [ ] 공급자, module, chart, image 버전 변경의 영향을 확인했다.
- [ ] `make check` 결과를 확인했다.
- [ ] 운영 영향이 있으면 rollback/runbook을 갱신했다.
- [ ] 구조적 선택이 바뀌면 ADR을 추가하거나 갱신했다.
## 배포
Kubernetes routine 변경은 Git PR로만 반영합니다. Terraform apply는
`TF_ROOT`, backend config, 검토된 saved plan과 `APPROVE_APPLY`가 모두
준비된 경우에만 실행합니다. `destroy` 진입점은 제공하지 않습니다.