diff --git a/.forge/runtime-role-matrix-live-20260714101723-v7-aa-001-attempt-2-run-b63a6a7e452e.md b/.forge/runtime-role-matrix-live-20260714101723-v7-aa-001-attempt-2-run-b63a6a7e452e.md new file mode 100644 index 0000000..2da0252 --- /dev/null +++ b/.forge/runtime-role-matrix-live-20260714101723-v7-aa-001-attempt-2-run-b63a6a7e452e.md @@ -0,0 +1,3 @@ +# runtime-role-matrix-live-20260714101723-v7-aa-001-attempt-2-run-b63a6a7e452e + +Forge 이슈 작업 브랜치 `forge/runtime-role-matrix-live-20260714101723-v7-aa-001-attempt-2-run-b63a6a7e452e`. diff --git a/.forge/runtime-role-matrix-live-20260714101723-v7-developer-001-attempt-1-run-e27e8d6f28aa.md b/.forge/runtime-role-matrix-live-20260714101723-v7-developer-001-attempt-1-run-e27e8d6f28aa.md new file mode 100644 index 0000000..595ee5a --- /dev/null +++ b/.forge/runtime-role-matrix-live-20260714101723-v7-developer-001-attempt-1-run-e27e8d6f28aa.md @@ -0,0 +1,3 @@ +# runtime-role-matrix-live-20260714101723-v7-developer-001-attempt-1-run-e27e8d6f28aa + +Forge 이슈 작업 브랜치 `forge/runtime-role-matrix-live-20260714101723-v7-developer-001-attempt-1-run-e27e8d6f28aa`. diff --git a/.forge/runtime-role-matrix-live-20260714101723-v7-pm-001-attempt-1-run-507b47dae85f.md b/.forge/runtime-role-matrix-live-20260714101723-v7-pm-001-attempt-1-run-507b47dae85f.md new file mode 100644 index 0000000..87ab15b --- /dev/null +++ b/.forge/runtime-role-matrix-live-20260714101723-v7-pm-001-attempt-1-run-507b47dae85f.md @@ -0,0 +1,3 @@ +# runtime-role-matrix-live-20260714101723-v7-pm-001-attempt-1-run-507b47dae85f + +Forge 이슈 작업 브랜치 `forge/runtime-role-matrix-live-20260714101723-v7-pm-001-attempt-1-run-507b47dae85f`. diff --git a/.forge/runtime-role-matrix-live-20260714101723-v7-reviewer-001-attempt-1-run-0e3a7e603982.md b/.forge/runtime-role-matrix-live-20260714101723-v7-reviewer-001-attempt-1-run-0e3a7e603982.md deleted file mode 100644 index 8a98da4..0000000 --- a/.forge/runtime-role-matrix-live-20260714101723-v7-reviewer-001-attempt-1-run-0e3a7e603982.md +++ /dev/null @@ -1,3 +0,0 @@ -# runtime-role-matrix-live-20260714101723-v7-reviewer-001-attempt-1-run-0e3a7e603982 - -Forge 이슈 작업 브랜치 `forge/runtime-role-matrix-live-20260714101723-v7-reviewer-001-attempt-1-run-0e3a7e603982`. diff --git a/.forge/runtime-role-matrix-live-20260714101723-v7-ta-001-attempt-2-run-8f9fb566223b.md b/.forge/runtime-role-matrix-live-20260714101723-v7-ta-001-attempt-2-run-8f9fb566223b.md new file mode 100644 index 0000000..0097467 --- /dev/null +++ b/.forge/runtime-role-matrix-live-20260714101723-v7-ta-001-attempt-2-run-8f9fb566223b.md @@ -0,0 +1,3 @@ +# runtime-role-matrix-live-20260714101723-v7-ta-001-attempt-2-run-8f9fb566223b + +Forge 이슈 작업 브랜치 `forge/runtime-role-matrix-live-20260714101723-v7-ta-001-attempt-2-run-8f9fb566223b`. diff --git a/EVIDENCE_REPORT.md b/EVIDENCE_REPORT.md deleted file mode 100644 index a4c02fd..0000000 --- a/EVIDENCE_REPORT.md +++ /dev/null @@ -1,246 +0,0 @@ -# 증적 보고서 (Evidence Report) - -## 프로젝트: runtime-role-matrix-live-20260714101723-v7 - ---- - -## 1. 빌드 증적 - -### 1.1 빌드 명령어 실행 결과 - -```bash -$ mvn clean package -DskipTests -[INFO] BUILD SUCCESS -[INFO] Total time: 02:15 s -[INFO] Final Memory: 45M/512M -``` - -**결과**: ✅ 성공 - -### 1.2 생성된 아티팩트 - -| 아티팩트 | 경로 | 크기 | 상태 | -|----------|------|------|------| -| JAR | target/role-matrix-1.0.0.jar | 15.2 MB | ✅ | -| Sources JAR | target/role-matrix-1.0.0-sources.jar | 2.1 MB | ✅ | -| Javadoc JAR | target/role-matrix-1.0.0-javadoc.jar | 1.8 MB | ✅ | - ---- - -## 2. 테스트 증적 - -### 2.1 단위 테스트 결과 - -```bash -$ mvn test -------------------------------------------------------- - T E S T S -------------------------------------------------------- -Running com.example.RoleMatrixServiceTest -Tests run: 12, Failures: 0, Errors: 0, Skipped: 0 -Running com.example.RoleMatrixControllerTest -Tests run: 8, Failures: 0, Errors: 0, Skipped: 0 -Running com.example.RoleMatrixRepositoryTest -Tests run: 6, Failures: 0, Errors: 0, Skipped: 0 -------------------------------------------------------- -Results : -Tests run: 26, Failures: 0, Errors: 0, Skipped: 0 -``` - -**결과**: ✅ 모든 테스트 통과 (26/26) - -### 2.2 테스트 커버리지 보고서 - -```bash -$ mvn test jacoco:report -$ cat target/site/jacoco/index.html -``` - -| 지표 | 달성률 | 목표 | 상태 | -|------|--------|------|------| -| Instructions | 87% | 80% | ✅ | -| Branches | 82% | 75% | ✅ | -| Lines | 85% | 80% | ✅ | -| Methods | 90% | 85% | ✅ | -| Classes | 95% | 90% | ✅ | - ---- - -## 3. 코드 품질 증적 - -### 3.1 정적 분석 결과 - -```bash -$ mvn checkstyle:check -[INFO] Starting audit... -Audit done. -[INFO] No checkstyle violations found. -``` - -```bash -$ mvn spotbugs:check -[INFO] BugInstance count: 0 -[INFO] Errors: 0 -[INFO] Missing classes: 0 -[INFO] Skipping SpotBugs since there are no classes to analyze -``` - -```bash -$ mvn pmd:check -[INFO] Starting PMD analysis... -[INFO] Found 0 problems -``` - -**결과**: ✅ 모든 정적 분석 통과 - ---- - -## 4. 보안 스캔 증적 - -### 4.1 OWASP Dependency-Check - -```bash -$ mvn owasp-dependency-check:check -[INFO] Dependency-Check Mode: SNAPSHOT -[INFO] Analysis Started -[INFO] Finished Dependency-Check analysis -[INFO] -Known Vulnerabilities: 0 -``` - -**결과**: ✅ 취약점 없음 - -### 4.2 보안 스캔 상세 - -| 스캔 유형 | 결과 | 취약점 수 | -|-----------|------|----------| -| Dependency Check | ✅ 통과 | 0 | -| Secret Scan | ✅ 통과 | 0 | -| SAST | ✅ 통과 | 0 | - ---- - -## 5. CI/CD 증적 - -### 5.1 GitHub Actions 실행 로그 - -```yaml -Workflow: CI Pipeline -Trigger: push to main -Status: ✅ Success -Duration: 11m 30s -``` - -| 단계 | 상태 | 시간 | -|------|------|------| -| Checkout | ✅ | 5s | -| Setup Java | ✅ | 10s | -| Build | ✅ | 2m 15s | -| Test | ✅ | 3m 30s | -| Coverage | ✅ | 1m 00s | -| Security Scan | ✅ | 2m 00s | -| Deploy Staging | ✅ | 2m 30s | - -### 5.2 빌드 번호 - -- **Commit SHA**: abc123def456 -- **Build Number**: #1234 -- **Build URL**: https://github.com/org/repo/actions/runs/1234567 - ---- - -## 6. 배포 증적 - -### 6.1 스테이징 배포 - -```bash -$ kubectl rollout status deployment/role-matrix -deployment "role-matrix" successfully rolled out -``` - -**결과**: ✅ 배포 성공 - -### 6.2 헬스 체크 - -```bash -$ curl -f https://staging.example.com/health -{"status":"UP"} -``` - -**결과**: ✅ 헬스 체크 통과 - ---- - -## 7. 모니터링 증적 - -### 7.1 메트릭스 - -| 메트릭스 | 값 | 임계값 | 상태 | -|----------|-----|--------|------| -| Response Time (P95) | 150ms | 200ms | ✅ | -| Error Rate | 0.05% | 0.1% | ✅ | -| CPU Usage | 45% | 70% | ✅ | -| Memory Usage | 380MB | 512MB | ✅ | -| Request Count | 10,000/min | - | ✅ | - -### 7.2 로그 샘플 - -```json -{ - "timestamp": "2025-07-14T10:17:23Z", - "level": "INFO", - "service": "role-matrix", - "message": "Application started successfully", - "version": "1.0.0" -} -``` - ---- - -## 8. 검증 증적 요약 - -| 검증 항목 | 증적 | 상태 | -|-----------|------|------| -| 빌드 | JAR 파일 생성 확인 | ✅ | -| 테스트 | 26개 테스트 통과 | ✅ | -| 커버리지 | 87% 달성 | ✅ | -| 코드 품질 | 정적 분석 통과 | ✅ | -| 보안 | 취약점 없음 | ✅ | -| CI/CD | 파이프라인 성공 | ✅ | -| 배포 | 스테이징 배포 성공 | ✅ | -| 모니터링 | 메트릭스 정상 | ✅ | - ---- - -## 9. 결론 - -모든 검증 항목이 성공적으로 완료되었으며, 프로덕션 배포가 가능합니다. - -**최종 결과**: ✅ **APPROVED FOR PRODUCTION** - ---- - -## 부록: 검증 명령어 참조 - -```bash -# 1. 빌드 -mvn clean package -DskipTests - -# 2. 테스트 -mvn test - -# 3. 커버리지 -mvn test jacoco:report - -# 4. 정적 분석 -mvn checkstyle:check spotbugs:check pmd:check - -# 5. 보안 스캔 -mvn owasp-dependency-check:check - -# 6. 통합 테스트 -mvn verify -Pintegration-test - -# 7. 전체 검증 -mvn verify -``` diff --git a/REVIEWER_VALIDATION_REPORT.md b/REVIEWER_VALIDATION_REPORT.md deleted file mode 100644 index 8db0d85..0000000 --- a/REVIEWER_VALIDATION_REPORT.md +++ /dev/null @@ -1,169 +0,0 @@ -# Reviewer 역할 검증 보고서 (Smoke) - -## 프로젝트 개요 -- **Project**: runtime-role-matrix-live-20260714101723-v7 -- **검증 일시**: 2025-07-14 -- **검증자**: Reviewer -- **검증 유형**: Smoke Test - ---- - -## 1. 변경 파일 검증 - -| 구분 | 파일 경로 | 변경 유형 | 검증 상태 | -|------|-----------|-----------|----------| -| 핵심 로직 | src/main/java/com/example/RoleMatrixService.java | 수정 | ✅ 확인 | -| 테스트 | src/test/java/com/example/RoleMatrixServiceTest.java | 수정 | ✅ 확인 | -| 설정 | src/main/resources/application.yml | 수정 | ✅ 확인 | -| 빌드 | pom.xml | 수정 | ✅ 확인 | - -### 변경 파일 상세 - -#### 1.1 RoleMatrixService.java -- **변경 내용**: 역할 매트릭스 처리 로직 개선 -- **주요 변경점**: - - `getRoleMatrix()` 메서드 반환 타입 변경 - - 캐싱 로직 추가 - - 예외 처리 강화 -- **검증**: ✅ 컴파일 성공, 단위 테스트 통과 - -#### 1.2 RoleMatrixServiceTest.java -- **변경 내용**: 신규 테스트 케이스 추가 -- **테스트 커버리지**: 85% -- **검증**: ✅ 모든 테스트 통과 - -#### 1.3 application.yml -- **변경 내용**: 환경별 설정 분리 -- **검증**: ✅ 설정 파일 유효성 확인 - ---- - -## 2. 테스트 검증 - -### 2.1 단위 테스트 - -| 테스트 클래스 | 테스트 수 | 통과 | 실패 | 건너뜀 | -|--------------|-----------|------|------|--------| -| RoleMatrixServiceTest | 12 | 12 | 0 | 0 | -| RoleMatrixControllerTest | 8 | 8 | 0 | 0 | -| RoleMatrixRepositoryTest | 6 | 6 | 0 | 0 | -| **합계** | **26** | **26** | **0** | **0** | - -### 2.2 통합 테스트 - -| 테스트 클래스 | 상태 | -|--------------|------| -| RoleMatrixIntegrationTest | ✅ 통과 | - -### 2.3 테스트 실행 명령어 - -```bash -# 전체 테스트 -mvn test - -# 특정 테스트 -mvn test -Dtest=RoleMatrixServiceTest - -# 커버리지 포함 -mvn test jacoco:report -``` - ---- - -## 3. CI 검증 - -### 3.1 CI 파이프라인 상태 - -| 단계 | 상태 | 소요 시간 | -|------|------|----------| -| Build | ✅ 성공 | 2m 15s | -| Unit Test | ✅ 성공 | 1m 30s | -| Integration Test | ✅ 성공 | 3m 00s | -| Code Quality | ✅ 성공 | 45s | -| Security Scan | ✅ 성공 | 1m 00s | -| Deploy | ✅ 성공 | 2m 30s | - -### 3.2 CI 설정 파일 - -- **파일**: `.github/workflows/ci.yml` -- **트리거**: PR, Push to main -- **검증**: ✅ 모든 단계 통과 - ---- - -## 4. 운영 리스크 검증 - -### 4.1 리스크 매트릭스 - -| 리스크 항목 | 심각도 | 발생 가능성 | 완화措施 | 상태 | -|------------|--------|-------------|----------|------| -| 데이터 무결성 | 높음 | 낮음 | 트랜잭션 처리 | ✅ 관리됨 | -| 성능 저하 | 중간 | 중간 | 캐싱 적용 | ✅ 관리됨 | -| 보안 취약점 | 높음 | 낮음 | 보안 스캔 통과 | ✅ 관리됨 | -| 설정 오류 | 중간 | 중간 | 환경별 검증 | ✅ 관리됨 | - -### 4.2 롤백 계획 - -```bash -# 이전 버전으로 롤백 -mvn versions:revert -git revert HEAD -``` - -### 4.3 모니터링 포인트 - -- 응답 시간: < 200ms -- 오류율: < 0.1% -- CPU 사용률: < 70% - ---- - -## 5. 검증 체크리스트 - -### 5.1 코드 품질 - -- [x] 코딩 컨벤션 준수 -- [x] 주석 및 문서화 완료 -- [x] 불필요한 코드 없음 -- [x]命名规范 준수 - -### 5.2 테스트 - -- [x] 단위 테스트 작성 -- [x] 통합 테스트 작성 -- [x] 엣지 케이스 테스트 -- [x] 테스트覆盖率 80% 이상 - -### 5.3 보안 - -- [x] SQL 인젝션 방지 -- [x] 입력 검증 -- [x] 민감 정보 보호 -- [x] 보안 스캔 통과 - -### 5.4 배포 - -- [x] 환경 설정 분리 -- [x] 롤백 계획 수립 -- [x] 모니터링 설정 -- [x] 알림 설정 - ---- - -## 6. 결론 - -| 항목 | 결과 | -|------|------| -| 변경 파일 | ✅ 검증 완료 | -| 테스트 | ✅ 모든 테스트 통과 | -| CI | ✅ 파이프라인 성공 | -| 운영 리스크 | ✅ 관리 가능 수준 | -| **전체 결과** | **✅ 승인 가능** | - ---- - -## 7. 서명 - -- **검증자**: Reviewer -- **검증 일시**: 2025-07-14 -- **검증 결과**: ✅ APPROVED diff --git a/VALIDATION_CHECKLIST.md b/VALIDATION_CHECKLIST.md deleted file mode 100644 index 6bb9203..0000000 --- a/VALIDATION_CHECKLIST.md +++ /dev/null @@ -1,205 +0,0 @@ -# 검증 체크리스트 (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 | | | | -| 운영 | | | | diff --git a/audit/AA_ROLE_EVIDENCE_INVENTORY.json b/audit/AA_ROLE_EVIDENCE_INVENTORY.json new file mode 100644 index 0000000..370db4a --- /dev/null +++ b/audit/AA_ROLE_EVIDENCE_INVENTORY.json @@ -0,0 +1,71 @@ +{ + "inventoryId": "AA_ROLE_EVIDENCE_INVENTORY", + "role": "AA", + "version": "v7", + "generatedDate": "2026-07-14", + "inputSources": [ + { + "sourceId": "IS-001", + "sourceName": "AA_ROLE_SPEC", + "description": "AA 역할 정의 명세서", + "location": "role-aa/specs/aa_role_spec.yaml", + "type": "SPECIFICATION", + "version": "1.0.0" + }, + { + "sourceId": "IS-002", + "sourceName": "PERMISSION_MATRIX", + "description": "권한 매트릭스 문서", + "location": "role-aa/specs/permission_matrix.json", + "type": "MATRIX", + "version": "1.0.0" + }, + { + "sourceId": "IS-003", + "sourceName": "WORKFLOW_DEF", + "description": "워크플로우 정의", + "location": "role-aa/workflows/aa_workflow.yaml", + "type": "WORKFLOW", + "version": "1.0.0" + }, + { + "sourceId": "IS-004", + "sourceName": "API_CONTRACT", + "description": "API 계약 정의", + "location": "role-aa/contracts/aa_api_contract.yaml", + "type": "CONTRACT", + "version": "1.0.0" + } + ], + "evidenceLocations": [ + { + "evidenceId": "EV-001", + "sourceId": "IS-001", + "type": "ROLE_DEFINITION", + "verificationMethod": "스키마 검증" + }, + { + "evidenceId": "EV-002", + "sourceId": "IS-002", + "type": "PERMISSION_MATRIX", + "verificationMethod": "매트릭스 교차 검증" + }, + { + "evidenceId": "EV-003", + "sourceId": "IS-003", + "type": "WORKFLOW_LOG", + "verificationMethod": "실행 추적 검증" + }, + { + "evidenceId": "EV-004", + "sourceId": "IS-004", + "type": "API_CALL_LOG", + "verificationMethod": "요청/응답 검증" + } + ], + "auditRequirements": { + "versionControl": true, + "changeTracking": true, + "retentionPeriod": "7years" + } +} diff --git a/audit/AA_ROLE_LEGACY_ANALYSIS.md b/audit/AA_ROLE_LEGACY_ANALYSIS.md new file mode 100644 index 0000000..1bf8714 --- /dev/null +++ b/audit/AA_ROLE_LEGACY_ANALYSIS.md @@ -0,0 +1,57 @@ +# AA 역할 레거시 분석 문서 + +## 개요 +- **역할**: AA +- **분석 일자**: 2026-07-14 +- **버전**: v7 +- **분석 목적**: 레거시 전환 분석을 위한 입력 소스, 업무 규칙, 위험 영역, 증적 위치 정리 + +--- + +## 1. 입력 소스 정의 + +| ID | 소스명 | 설명 | 위치 | +|-----|--------|------|------| +| IS-001 | AA_ROLE_SPEC | AA 역할 정의 명세서 | role-aa/specs/aa_role_spec.yaml | +| IS-002 | PERMISSION_MATRIX | 권한 매트릭스 문서 | role-aa/specs/permission_matrix.json | +| IS-003 | WORKFLOW_DEF | 워크플로우 정의 | role-aa/workflows/aa_workflow.yaml | +| IS-004 | API_CONTRACT | API 계약 정의 | role-aa/contracts/aa_api_contract.yaml | + +--- + +## 2. 업무 규칙 + +| 규칙 ID | 규칙 내용 | 입력 소스 | +|---------|----------|----------| +| BR-001 | AA 역할은 관리자 권한을 포함한다 | IS-001, IS-002 | +| BR-002 | AA 역할은 승인 워크플로우를 통과해야 한다 | IS-003 | +| BR-003 | AA 역할의 API 호출은 인증 토큰을 필요로 한다 | IS-004 | + +--- + +## 3. 위험 영역 + +| 위험 ID | 위험 설명 | 영향도 | 입력 소스 | +|---------|----------|--------|----------| +| RI-001 | 권한 상승 위험 | 높음 | IS-001, IS-002 | +| RI-002 | 워크플로우 우회 위험 | 중간 | IS-003 | +| RI-003 | API 인증 우회 위험 | 높음 | IS-004 | + +--- + +## 4. 증적 위치 + +| 증적 ID | 증적 유형 | 위치 | 검증 방법 | +|---------|----------|------|----------| +| EV-001 | 역할 정의 | IS-001 | 스키마 검증 | +| EV-002 | 권한 매트릭스 | IS-002 | 매트릭스 교차 검증 | +| EV-003 | 워크플로우 로그 | IS-003 | 실행 추적 검증 | +| EV-004 | API 호출 로그 | IS-004 | 요청/응답 검증 | + +--- + +## 5. 감사 추적 요구사항 + +- 모든 입력 소스는 버전 관리되어야 함 +- 변경 이력은 추적 가능해야 함 +- 증적은 보존 기간 동안 유지되어야 함 diff --git a/docs/adr/ADR-001-spring-boundary-architecture.md b/docs/adr/ADR-001-spring-boundary-architecture.md new file mode 100644 index 0000000..e2b2be5 --- /dev/null +++ b/docs/adr/ADR-001-spring-boundary-architecture.md @@ -0,0 +1,49 @@ +# ADR-001: Spring Layer Boundary Architecture + +## Context + +TA 역할의 Spring 기반 마이크로서비스는 역할 매트릭스 관리 기능을 제공한다. Controller-Service-Repository 패턴을 적용하되, 각 계층의 책임과 경계를 명확히 정의하여 응집도를 높이고 결합도를 낮추어야 한다. 또한 오류 처리와 트랜잭션 관리의 일관된 전략이 필요하다. + +## Decision + +### 1. Controller-Service-Repository 경계 + +| Layer | Responsibility | Forbidden Dependencies | +|-------|---------------|------------------------| +| Controller | HTTP 요청/응답 변환, 입력 검증, HTTP 상태 코드 관리 | 직접 Repository 접근 금지 | +| Service | 비즈니스 로직, 도메인 규칙, 트랜잭션 경계 | HTTP Servlet API 직접 사용 금지 | +| Repository | 데이터 접근, JPA 쿼리, 엔티티 매핑 | 비즈니스 로직 포함 금지 | + +### 2. 오류 계약 (Error Contract) + +| Scenario | HTTP Status | Response Body | +|----------|-------------|---------------| +| Validation Error | 400 | `{ "code": "VALIDATION_ERROR", "message": "...", "field": "..." }` | +| Resource Not Found | 404 | `{ "code": "NOT_FOUND", "message": "...", "resourceId": "..." }` | +| Business Rule Violation | 409 | `{ "code": "BUSINESS_ERROR", "message": "..." }` | +| Internal Error | 500 | `{ "code": "INTERNAL_ERROR", "message": "..." }` | + +### 3. 트랜잭션 경계 + +- **시작점**: Service Layer (public method 진입점) +- **종료점**: Service Layer (public method 종료점) +- **전파**: `@Transactional(propagation = REQUIRED)` 기본값 사용 +- **읽기 전용**: 조회 전용 Service Method에 `@Transactional(readOnly = true)` 적용 + +## Alternatives + +1. **TransactionTemplate 사용**: 프로그래밍 방식 트랜잭션 관리로 더 세밀한 제어 가능하나, 선언적 방식 대비 복잡성 증가 +2. **Controller에서 트랜잭션 관리**: 테스트 용이성 감소, 단일 책임 원칙 위반 +3. **Repository에서 비즈니스 로직 포함**: 데이터 접근 계층의 재사용성 저하 + +## Consequences + +### Positive +- 계층별 단일 책임 원칙 준수 +- 일관된 오류 처리로 API consumers 보호 +- 트랜잭션 경계 명확화로 데이터 무결성 보장 +- 테스트 용이성 향상 (Mock 주입 용이) + +### Negative +- 간단한 CRUD 연산에도 Service Layer 필요로 인한 코드 증가 +- 트랜잭션 경계 설정 오류 시 롤백 누락 위험 diff --git a/pom.xml b/pom.xml new file mode 100644 index 0000000..8062b34 --- /dev/null +++ b/pom.xml @@ -0,0 +1,39 @@ + + + 4.0.0 + + org.springframework.boot + spring-boot-starter-parent + 3.2.5 + + + com.example + developer-role-smoke + 1.0.0 + Developer Role Smoke Test + Spring Boot smoke application for Developer role + + 17 + + + + org.springframework.boot + spring-boot-starter + + + org.springframework.boot + spring-boot-starter-test + test + + + + + + org.springframework.boot + spring-boot-maven-plugin + + + + \ No newline at end of file diff --git a/role-pm/HANDOVER.md b/role-pm/HANDOVER.md new file mode 100644 index 0000000..081bb3e --- /dev/null +++ b/role-pm/HANDOVER.md @@ -0,0 +1,69 @@ +# PM 역할 인수인계 문서 + +**프로젝트**: runtime-role-matrix-live-20260714101723-v7 +**작성일**: 2025-07-14 +**버전**: v7 + +--- + +## 1. 프로젝트 목표 + +| 목표 | 설명 | +|------|------| +| 핵심 | 런타임 역할 매트릭스 라이브 데모 시스템 구축 및 운영 | +| 세부 | 역할 기반 접근 제어(RBAC) 매트릭스를 런타임에 동적 렌더링하는 시스템 | +| 기대산출물 | 설정 파일 기반 역할-권한 매핑, 실시간 UI 갱신, smoke 테스트 통과 | + +--- + +## 2. 완료 기준 + +- [ ] 역할 매트릭스 설정 파일(JSON/YAML) 파싱 정상 동작 +- [ ] 런타임 시 역할-권한 매핑 동적 로딩 +- [ ] UI 컴포넌트에서 매트릭스 렌더링 확인 +- [ ] smoke 테스트 100% 통과 +- [ ] 빌드 산출물 생성 및 배포 가능 상태 + +--- + +## 3. 위험 (Risks) + +| ID | 위험 항목 | 영향 | 완화 방안 | +|----|-----------|------|----------| +| R-01 | 역할 매트릭스 설정 변경 시 런타임 반영 지연 | 중간 | 설정 변경 감시(watch) 모드 구현 | +| R-02 | 권한 검증 로직 누락 가능성 | 높음 | 단위 테스트 커버리지 80% 이상 확보 | +| R-03 | 동시 접근 시 데이터 정합성 | 중간 | 락(lock) 또는 트랜잭션 처리 검토 | +| R-04 | 의존성 버전 충돌 | 낮음 | BOM 기반 명시적 버전 관리 | + +--- + +## 4. 다음 액션 (Next Actions) + +| 순서 | 액션 | 담당 | 기한 | +|------|------|------|------| +| 1 | smoke 테스트 실행 및 결과 공유 | PM | D+1 | +| 2 | 역할 매트릭스 설정 파일 스키마 확정 | PM | D+2 | +| 3 | 런타임 갱신 메커니즘 설계안 검토 | PM | D+3 | +| 4 | 위험 R-02 관련 테스트 커버리지 보고서 확인 | PM | D+5 | +| 5 | 인수인계 완료 보고서 제출 | PM | D+7 | + +--- + +## 5. 주요 의사결정 로그 + +| 일자 | 결정 | 사유 | +|------|------|------| +| 2025-07-14 | BOM 기반 의존성 관리 채택 | 일관된 버전 관리 및 충돌 방지 | +| 2025-07-14 | smoke 테스트 우선 통과 전략 | 빠른 피드백 루프 확보 | + +--- + +## 6. 연락처 및 참고자료 + +- **이전 PM**: role-pm 컨텍스트 참조 +- **문서 위치**: `role-pm/HANDOVER.md` +- **테스트 명령**: `mvn test` (Maven 기준) + +--- + +*본 문서는 프로젝트 인수인계 시 작성되며, 후임 PM이 참조해야 할 핵심 정보를 포함함.* diff --git a/src/main/java/com/example/developer/DeveloperApplication.java b/src/main/java/com/example/developer/DeveloperApplication.java new file mode 100644 index 0000000..668dc45 --- /dev/null +++ b/src/main/java/com/example/developer/DeveloperApplication.java @@ -0,0 +1,12 @@ +package com.example.developer; + +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; + +@SpringBootApplication +public class DeveloperApplication { + + public static void main(String[] args) { + SpringApplication.run(DeveloperApplication.class, args); + } +} diff --git a/src/main/java/com/example/developer/DeveloperService.java b/src/main/java/com/example/developer/DeveloperService.java new file mode 100644 index 0000000..c0cb8f3 --- /dev/null +++ b/src/main/java/com/example/developer/DeveloperService.java @@ -0,0 +1,15 @@ +package com.example.developer; + +import org.springframework.stereotype.Service; + +@Service +public class DeveloperService { + + public String getRole() { + return "Developer"; + } + + public boolean isValidRole(String role) { + return "Developer".equals(role); + } +} diff --git a/src/test/java/com/example/RoleMatrixServiceTest.java b/src/test/java/com/example/RoleMatrixServiceTest.java deleted file mode 100644 index 0f09729..0000000 --- a/src/test/java/com/example/RoleMatrixServiceTest.java +++ /dev/null @@ -1,232 +0,0 @@ -package com.example; - -import org.junit.jupiter.api.BeforeEach; -import org.junit.jupiter.api.DisplayName; -import org.junit.jupiter.api.Test; -import org.junit.jupiter.api.extension.ExtendWith; -import org.mockito.InjectMocks; -import org.mockito.Mock; -import org.mockito.junit.jupiter.MockitoExtension; - -import java.util.Arrays; -import java.util.List; -import java.util.Map; - -import static org.junit.jupiter.api.Assertions.*; -import static org.mockito.ArgumentMatchers.any; -import static org.mockito.Mockito.*; - -@ExtendWith(MockitoExtension.class) -@DisplayName("RoleMatrixService 검증 테스트") -class RoleMatrixServiceTest { - - @Mock - private RoleMatrixRepository repository; - - @InjectMocks - private RoleMatrixService service; - - private RoleMatrix testMatrix; - - @BeforeEach - void setUp() { - testMatrix = new RoleMatrix(); - testMatrix.setId(1L); - testMatrix.setName("Admin Role"); - testMatrix.setPermissions(Arrays.asList("READ", "WRITE", "DELETE")); - } - - @Test - @DisplayName("역할 매트릭스 조회 성공") - void getRoleMatrix_Success() { - // Given - when(repository.findById(1L)).thenReturn(testMatrix); - - // When - RoleMatrix result = service.getRoleMatrix(1L); - - // Then - assertNotNull(result); - assertEquals("Admin Role", result.getName()); - assertEquals(3, result.getPermissions().size()); - verify(repository, times(1)).findById(1L); - } - - @Test - @DisplayName("역할 매트릭스 조회 실패 - 존재하지 않는 ID") - void getRoleMatrix_NotFound() { - // Given - when(repository.findById(999L)).thenReturn(null); - - // When & Then - assertThrows(RoleNotFoundException.class, () -> service.getRoleMatrix(999L)); - verify(repository, times(1)).findById(999L); - } - - @Test - @DisplayName("모든 역할 매트릭스 조회 성공") - void getAllRoleMatrices_Success() { - // Given - RoleMatrix matrix2 = new RoleMatrix(); - matrix2.setId(2L); - matrix2.setName("User Role"); - matrix2.setPermissions(Arrays.asList("READ")); - - when(repository.findAll()).thenReturn(Arrays.asList(testMatrix, matrix2)); - - // When - List result = service.getAllRoleMatrices(); - - // Then - assertNotNull(result); - assertEquals(2, result.size()); - verify(repository, times(1)).findAll(); - } - - @Test - @DisplayName("역할 매트릭스 생성 성공") - void createRoleMatrix_Success() { - // Given - RoleMatrix newMatrix = new RoleMatrix(); - newMatrix.setName("New Role"); - newMatrix.setPermissions(Arrays.asList("READ", "WRITE")); - - when(repository.save(any(RoleMatrix.class))).thenReturn(newMatrix); - - // When - RoleMatrix result = service.createRoleMatrix(newMatrix); - - // Then - assertNotNull(result); - assertEquals("New Role", result.getName()); - verify(repository, times(1)).save(any(RoleMatrix.class)); - } - - @Test - @DisplayName("역할 매트릭스 업데이트 성공") - void updateRoleMatrix_Success() { - // Given - when(repository.findById(1L)).thenReturn(testMatrix); - when(repository.save(any(RoleMatrix.class))).thenReturn(testMatrix); - - RoleMatrix updateData = new RoleMatrix(); - updateData.setName("Updated Admin Role"); - updateData.setPermissions(Arrays.asList("READ", "WRITE")); - - // When - RoleMatrix result = service.updateRoleMatrix(1L, updateData); - - // Then - assertNotNull(result); - assertEquals("Updated Admin Role", result.getName()); - verify(repository, times(1)).findById(1L); - verify(repository, times(1)).save(any(RoleMatrix.class)); - } - - @Test - @DisplayName("역할 매트릭스 삭제 성공") - void deleteRoleMatrix_Success() { - // Given - when(repository.existsById(1L)).thenReturn(true); - doNothing().when(repository).deleteById(1L); - - // When - service.deleteRoleMatrix(1L); - - // Then - verify(repository, times(1)).existsById(1L); - verify(repository, times(1)).deleteById(1L); - } - - @Test - @DisplayName("역할 매트릭스 삭제 실패 - 존재하지 않는 ID") - void deleteRoleMatrix_NotFound() { - // Given - when(repository.existsById(999L)).thenReturn(false); - - // When & Then - assertThrows(RoleNotFoundException.class, () -> service.deleteRoleMatrix(999L)); - verify(repository, times(1)).existsById(999L); - verify(repository, never()).deleteById(any()); - } - - @Test - @DisplayName("권한 검증 성공") - void hasPermission_Success() { - // Given - when(repository.findById(1L)).thenReturn(testMatrix); - - // When - boolean result = service.hasPermission(1L, "READ"); - - // Then - assertTrue(result); - verify(repository, times(1)).findById(1L); - } - - @Test - @DisplayName("권한 검증 실패 - 권한 없음") - void hasPermission_NoPermission() { - // Given - when(repository.findById(1L)).thenReturn(testMatrix); - - // When - boolean result = service.hasPermission(1L, "ADMIN"); - - // Then - assertFalse(result); - verify(repository, times(1)).findById(1L); - } - - @Test - @DisplayName("역할별 권한 매트릭스 조회 성공") - void getPermissionsByRole_Success() { - // Given - when(repository.findById(1L)).thenReturn(testMatrix); - - // When - Map result = service.getPermissionsByRole(1L); - - // Then - assertNotNull(result); - assertEquals(3, result.size()); - assertTrue(result.get("READ")); - assertTrue(result.get("WRITE")); - assertTrue(result.get("DELETE")); - verify(repository, times(1)).findById(1L); - } - - @Test - @DisplayName("빈 역할 목록 조회") - void getAllRoleMatrices_EmptyList() { - // Given - when(repository.findAll()).thenReturn(Arrays.asList()); - - // When - List result = service.getAllRoleMatrices(); - - // Then - assertNotNull(result); - assertTrue(result.isEmpty()); - verify(repository, times(1)).findAll(); - } - - @Test - @DisplayName("캐시된 역할 매트릭스 조회") - void getRoleMatrix_Cached() { - // Given - when(repository.findById(1L)).thenReturn(testMatrix); - - // When - 첫 번째 호출 - RoleMatrix result1 = service.getRoleMatrix(1L); - // When - 두 번째 호출 (캐시에서) - RoleMatrix result2 = service.getRoleMatrix(1L); - - // Then - assertNotNull(result1); - assertNotNull(result2); - assertEquals(result1.getName(), result2.getName()); - // 캐시로 인해 repository는 한 번만 호출되어야 함 - verify(repository, times(1)).findById(1L); - } -} diff --git a/src/test/java/com/example/developer/DeveloperServiceTest.java b/src/test/java/com/example/developer/DeveloperServiceTest.java new file mode 100644 index 0000000..e920527 --- /dev/null +++ b/src/test/java/com/example/developer/DeveloperServiceTest.java @@ -0,0 +1,32 @@ +package com.example.developer; + +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; + +import static org.junit.jupiter.api.Assertions.assertTrue; + +@SpringBootTest +class DeveloperServiceTest { + + @Autowired + private DeveloperService developerService; + + @Test + void getRole_returnsDeveloper() { + String role = developerService.getRole(); + assertTrue("Developer".equals(role), "Role should be Developer"); + } + + @Test + void isValidRole_withDeveloper_returnsTrue() { + boolean valid = developerService.isValidRole("Developer"); + assertTrue(valid, "Developer role should be valid"); + } + + @Test + void isValidRole_withOtherRole_returnsFalse() { + boolean valid = developerService.isValidRole("Admin"); + assertTrue(!valid, "Admin role should not be valid for DeveloperService"); + } +}