# 검증 체크리스트 (Validation Checklist)

## 프로젝트: runtime-role-matrix-live-20260714101723-v7

---

## 1. 사전 검증 (Pre-Validation)

### 1.1 환경 확인

- [ ] Java 버전: 17 이상
- [ ] Maven 버전: 3.8 이상
- [ ] Node.js 버전 (해당 시): 18 이상

### 1.2 의존성 확인

```bash
mvn dependency:tree
mvn dependency:analyze
```

- [ ] 의존성 충돌 없음
- [ ] 취약한 의존성 없음
- [ ] 사용하지 않는 의존성 없음

---

## 2. 코드 검증 (Code Validation)

### 2.1 정적 분석

```bash
mvn checkstyle:check
mvn spotbugs:check
mvn pmd:check
```

- [ ] Checkstyle 통과
- [ ] SpotBugs 통과
- [ ] PMD 통과

### 2.2 코드 복잡도

- [ ] 메서드당 라인 수 < 50
- [ ] 순환 복잡도 < 10
- [ ] 클래스당 메서드 수 < 20

### 2.3 코드 커버리지

```bash
mvn test jacoco:report
```

- [ ] 라인 커버리지 >= 80%
- [ ] 브랜치 커버리지 >= 75%
- [ ] 메서드 커버리지 >= 85%

---

## 3. 기능 검증 (Functional Validation)

### 3.1 단위 테스트

```bash
mvn test
```

- [ ] 모든 단위 테스트 통과
- [ ] 새로운 기능에 대한 테스트 존재
- [ ] 버그 수정에 대한 회귀 테스트 존재

### 3.2 통합 테스트

```bash
mvn verify -Pintegration-test
```

- [ ] API 엔드포인트 테스트 통과
- [ ] 데이터베이스 연동 테스트 통과
- [ ] 외부 서비스 연동 테스트 통과

### 3.3 E2E 테스트 (해당 시)

- [ ] 주요 사용자 플로우 테스트 통과
- [ ] 브라우저 호환성 테스트 통과

---

## 4. 보안 검증 (Security Validation)

### 4.1 보안 스캔

```bash
mvn security:scan
owasp-dependency-check:check
```

- [ ] 알려진 취약점 없음
- [ ] OWASP Top 10 준수
- [ ] 민감 정보 하드코딩 없음

### 4.2 접근 제어

- [ ] 역할 기반 접근 제어 구현
- [ ] 인증/인가 검증
- [ ] 세션 관리 적절

---

## 5. 성능 검증 (Performance Validation)

### 5.1 부하 테스트

```bash
k6 run tests/load-test.js
```

- [ ] 응답 시간 < 200ms (P95)
- [ ] 처리량 >= 목표 TPS
- [ ] 오류율 < 0.1%

### 5.2 리소스 사용

- [ ] 메모리 사용량 정상
- [ ] CPU 사용량 정상
- [ ] 디스크 I/O 정상

---

## 6. 배포 검증 (Deployment Validation)

### 6.1 빌드

```bash
mvn clean package -DskipTests
```

- [ ] 빌드 성공
- [ ] JAR/WAR 파일 생성
- [ ] 크기 정상

### 6.2 환경 설정

- [ ] 개발 환경 설정 완료
- [ ] 스테이징 환경 설정 완료
- [ ] 프로덕션 환경 설정 완료

### 6.3 롤백 계획

- [ ] 이전 버전 정의
- [ ] 롤백 스크립트 준비
- [ ] 롤백 테스트 완료

---

## 7. 문서 검증 (Documentation Validation)

- [ ] API 문서 업데이트
- [ ] README 업데이트
- [ ] 배포 가이드 업데이트
- [ ] 변경 로그 기록

---

## 8. 리뷰 승인 (Review Approval)

### 8.1 코드 리뷰

- [ ] 최소 1명 이상 리뷰어 승인
- [ ] 리뷰 코멘트 처리 완료
- [ ] 코드 변경 사항 설명

### 8.2 최종 승인

- [ ] 모든 체크리스트 항목 완료
- [ ] CI/CD 파이프라인 통과
- [ ] QA 팀 승인
- [ ] 운영 팀 승인

---

## 검증 결과 요약

| 카테고리 | 항목 수 | 완료 | 미완료 |
|----------|---------|------|--------|
| 사전 검증 | 5 | 0 | 0 |
| 코드 검증 | 8 | 0 | 0 |
| 기능 검증 | 6 | 0 | 0 |
| 보안 검증 | 6 | 0 | 0 |
| 성능 검증 | 5 | 0 | 0 |
| 배포 검증 | 7 | 0 | 0 |
| 문서 검증 | 4 | 0 | 0 |
| 리뷰 승인 | 4 | 0 | 0 |
| **합계** | **45** | **0** | **0** |

---

## 서명

| 역할 | 이름 | 날짜 | 서명 |
|------|------|------|------|
| 개발자 | | | |
| 리뷰어 | | | |
| QA | | | |
| 운영 | | | |