runtime-role-matrix-live-20260714101723-v7/VALIDATION_CHECKLIST.md

검증 체크리스트 (Validation Checklist)

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

---

1. 사전 검증 (Pre-Validation)

1.1 환경 확인

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

1.2 의존성 확인

mvn dependency:tree
mvn dependency:analyze

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

---

2. 코드 검증 (Code Validation)

2.1 정적 분석

mvn checkstyle:check
mvn spotbugs:check
mvn pmd:check

• Checkstyle 통과
• SpotBugs 통과
• PMD 통과

2.2 코드 복잡도

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

2.3 코드 커버리지

mvn test jacoco:report

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

---

3. 기능 검증 (Functional Validation)

3.1 단위 테스트

mvn test

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

3.2 통합 테스트

mvn verify -Pintegration-test

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

3.3 E2E 테스트 (해당 시)

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

---

4. 보안 검증 (Security Validation)

4.1 보안 스캔

mvn security:scan
owasp-dependency-check:check

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

4.2 접근 제어

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

---

5. 성능 검증 (Performance Validation)

5.1 부하 테스트

k6 run tests/load-test.js

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

5.2 리소스 사용

• 메모리 사용량 정상
• CPU 사용량 정상
• 디스크 I/O 정상

---

6. 배포 검증 (Deployment Validation)

6.1 빌드

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
운영