diff --git a/VALIDATION_CHECKLIST.md b/VALIDATION_CHECKLIST.md new file mode 100644 index 0000000..6bb9203 --- /dev/null +++ b/VALIDATION_CHECKLIST.md @@ -0,0 +1,205 @@ +# 검증 체크리스트 (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 | | | | +| 운영 | | | |