# Runtime Role Matrix Live - 검증 체크리스트

## 1. 변경 파일 검증 (Changed Files Verification)

### 1.1 Git 변경 이력 확인
- [ ] `git diff --name-only HEAD~1` 실행하여 변경된 파일 목록 확인
- [ ] 변경된 파일이预期的 디렉토리 구조에 있는지 확인
- [ ] 불필요한 파일(.class, .log, .tmp)이 포함되지 않았는지 확인

### 1.2 변경 내용 검토
- [ ] 각 변경 파일의 diff 내용 확인
- [ ] breaking change 여부 검토
- [ ] API 호환성 영향 분석

### 1.3 검증 명령어
```bash
# 변경 파일 목록
git diff --name-only origin/main...HEAD

# 상세 diff
git diff origin/main...HEAD

# 새로 추가된 파일
git diff --name-only --diff-filter=A origin/main...HEAD
```

---

## 2. 테스트 검증 (Test Verification)

### 2.1 단위 테스트
- [ ] `mvn test` 또는 `gradle test` 실행 성공 확인
- [ ] 테스트 커버리지 보고서 생성 확인
- [ ] 실패한 테스트 케이스 없음 확인

### 2.2 통합 테스트
- [ ] `mvn verify` 또는 `gradle integrationTest` 실행
- [ ] 테스트 환경 구성 요소 가동 상태 확인
- [ ] 데이터베이스 마이그레이션 정상 동작 확인

### 2.3 검증 명령어
```bash
# 단위 테스트 실행
mvn clean test -DskipITs=true

# 통합 테스트 실행
mvn verify -DskipUnitTests=false

# 테스트 커버리지
mvn test jacoco:report
```

---

## 3. CI/CD 검증 (CI Verification)

### 3.1 파이프라인 단계
- [ ] 빌드 단계 성공
- [ ] 테스트 단계 성공
- [ ] 정적 분석 단계 성공
- [ ] 보안 스캔 단계 성공
- [ ] 배포 단계 성공

### 3.2 CI 설정 파일 확인
- [ ] `.github/workflows/` 또는 `Jenkinsfile` 존재 확인
- [ ] 환경 변수 설정 적절성 확인
- [ ] 캐시 전략 적절성 확인

### 3.3 검증 명령어
```bash
# GitHub Actions 로컬 시뮬레이션
act -l  # 워크플로우 목록
act -W .github/workflows/ci.yml --dryrun
```

---

## 4. 운영 리스크 검증 (Operational Risk Verification)

### 4.1 배포 리스크
- [ ] 롤링 배포 vs 블루-그린 배포 전략 확인
- [ ] 이전 버전으로 롤백 절차 문서화 확인
- [ ] 배포 시 서비스 중단 시간 최소화 확인

### 4.2 모니터링 및 알림
- [ ] 메트릭 수집 설정 확인 (Prometheus, CloudWatch 등)
- [ ] 로그 수집 설정 확인 (ELK, Loki 등)
- [ ] 알림 채널 설정 확인 (Slack, PagerDuty 등)

### 4.3 데이터 리스크
- [ ] 스키마 마이그레이션 후방 호환성 확인
- [ ] 데이터 백업 정책 확인
- [ ]灾难恢复 절차 문서화 확인

### 4.4 보안 리스크
- [ ] 시크릿 관리 방식 확인 (Vault, AWS Secrets Manager 등)
- [ ] 네트워크 정책 확인
- [ ] 취약점 스캔 결과 확인

---

## 5. 검증 결과 기록

| 검증 항목 | 상태 | 검증자 | 검증 일시 | 비고 |
|-----------|------|--------|-----------|------|
| 변경 파일 | ⬜ 미검증 | - | - | - |
| 단위 테스트 | ⬜ 미검증 | - | - | - |
| 통합 테스트 | ⬜ 미검증 | - | - | - |
| CI/CD | ⬜ 미검증 | - | - | - |
| 배포 리스크 | ⬜ 미검증 | - | - | - |
| 모니터링 | ⬜ 미검증 | - | - | - |
| 보안 | ⬜ 미검증 | - | - | - |

---

## 6. 체크리스트 실행 가이드

```bash
# 1. 검증 디렉토리 생성
mkdir -p verification

# 2. 변경 파일 추출
git diff --name-only origin/main...HEAD > verification/changed-files.txt

# 3. 테스트 실행 및 결과 저장
mvn test 2>&1 | tee verification/test-output.log

# 4. 검증 체크리스트 실행
./verification/smoke-test.sh

# 5. 증적 보고서 생성
./verification/generate-evidence.sh
```