Compare commits
9 commits
main
...
forge/role
| Author | SHA1 | Date | |
|---|---|---|---|
| 5e9d29c817 | |||
| 19a4d610b5 | |||
| ae4f99668d | |||
| e110ee1836 | |||
| a596e750eb | |||
| db3560a819 | |||
| bab3f337c1 | |||
| e414a834ad | |||
| 28b5994354 |
23 changed files with 478 additions and 755 deletions
|
|
@ -1,3 +0,0 @@
|
|||
# role-aa-live-1522-001-attempt-1-run-d418939310a8
|
||||
|
||||
Forge 이슈 작업 브랜치 `forge/role-aa-live-1522-001-attempt-1-run-d418939310a8`.
|
||||
|
|
@ -1,3 +0,0 @@
|
|||
# role-developer-live-1522-001-attempt-1-run-6a48084c658b
|
||||
|
||||
Forge 이슈 작업 브랜치 `forge/role-developer-live-1522-001-attempt-1-run-6a48084c658b`.
|
||||
|
|
@ -1,3 +0,0 @@
|
|||
# role-pm-live-1522-001-attempt-1-run-3980dffa3ff4
|
||||
|
||||
Forge 이슈 작업 브랜치 `forge/role-pm-live-1522-001-attempt-1-run-3980dffa3ff4`.
|
||||
|
|
@ -0,0 +1,3 @@
|
|||
# role-ta-live-1522-001-attempt-1-run-6e84b72613b1
|
||||
|
||||
Forge 이슈 작업 브랜치 `forge/role-ta-live-1522-001-attempt-1-run-6e84b72613b1`.
|
||||
|
|
@ -1,315 +0,0 @@
|
|||
{
|
||||
"documentId": "EVID-INV-ROLE-AA-001",
|
||||
"version": "1.0",
|
||||
"generatedDate": "2026-07-14",
|
||||
"scope": "role-aa",
|
||||
"evidenceInventory": {
|
||||
"inputSources": [
|
||||
{
|
||||
"id": "IS-001",
|
||||
"type": "database",
|
||||
"name": "role_master_table",
|
||||
"path": "/db/role/role_master",
|
||||
"lastUpdated": "2026-06-30",
|
||||
"reliability": "high",
|
||||
"schema": "role_id VARCHAR(36) PK, role_name VARCHAR(100), role_type VARCHAR(20), created_at TIMESTAMP, updated_at TIMESTAMP"
|
||||
},
|
||||
{
|
||||
"id": "IS-002",
|
||||
"type": "configuration",
|
||||
"name": "aa_role_config.xml",
|
||||
"path": "/config/role/aa_role_config.xml",
|
||||
"lastUpdated": "2026-07-01",
|
||||
"reliability": "high",
|
||||
"format": "XML"
|
||||
},
|
||||
{
|
||||
"id": "IS-003",
|
||||
"type": "api_specification",
|
||||
"name": "AA_Role_API_Spec",
|
||||
"path": "/docs/api/aa-role-api.yaml",
|
||||
"lastUpdated": "2026-06-15",
|
||||
"reliability": "medium",
|
||||
"format": "OpenAPI 3.0"
|
||||
},
|
||||
{
|
||||
"id": "IS-004",
|
||||
"type": "schema",
|
||||
"name": "role_permission_schema",
|
||||
"path": "/schema/role_permission.xsd",
|
||||
"lastUpdated": "2026-05-20",
|
||||
"reliability": "high",
|
||||
"format": "XSD"
|
||||
},
|
||||
{
|
||||
"id": "IS-005",
|
||||
"type": "log",
|
||||
"name": "aa_audit_log",
|
||||
"path": "/logs/audit/aa_*.log",
|
||||
"lastUpdated": "2026-07-14",
|
||||
"reliability": "high",
|
||||
"retentionDays": 2555
|
||||
}
|
||||
],
|
||||
"businessRules": [
|
||||
{
|
||||
"id": "BR-001",
|
||||
"name": "AA 역할 생성 시 최소 권한 부여",
|
||||
"category": "role_creation",
|
||||
"priority": "high",
|
||||
"condition": "role_type = 'AA' AND user_level >= 3",
|
||||
"action": "기본 권한 세트 자동 할당",
|
||||
"errorCode": null
|
||||
},
|
||||
{
|
||||
"id": "BR-002",
|
||||
"name": "중복 역할 방지",
|
||||
"category": "role_creation",
|
||||
"priority": "high",
|
||||
"condition": "동일한 user_id에 동일한 role_id 존재",
|
||||
"action": "오류 반환",
|
||||
"errorCode": "ERR_DUP_ROLE"
|
||||
},
|
||||
{
|
||||
"id": "BR-003",
|
||||
"name": "역할 만료 관리",
|
||||
"category": "role_lifecycle",
|
||||
"priority": "medium",
|
||||
"condition": "expiration_date < 현재일",
|
||||
"action": "역할 자동 비활성화",
|
||||
"errorCode": null
|
||||
},
|
||||
{
|
||||
"id": "BR-004",
|
||||
"name": "AA 역할 권한 범위",
|
||||
"category": "permission_validation",
|
||||
"priority": "high",
|
||||
"condition": "permission_level <= 5",
|
||||
"action": "접근 허용",
|
||||
"errorCode": null
|
||||
},
|
||||
{
|
||||
"id": "BR-005",
|
||||
"name": "감사 로그 필수 기록",
|
||||
"category": "audit",
|
||||
"priority": "high",
|
||||
"condition": "모든 AA 역할 操作",
|
||||
"action": "로그 테이블 INSERT",
|
||||
"errorCode": null
|
||||
},
|
||||
{
|
||||
"id": "BR-006",
|
||||
"name": "역할 위임 제한",
|
||||
"category": "delegation",
|
||||
"priority": "medium",
|
||||
"condition": "delegator_role = 'AA' AND delegate_role = 'ADMIN'",
|
||||
"action": "위임 거부",
|
||||
"errorCode": "ERR_DELEGATION_DENIED"
|
||||
},
|
||||
{
|
||||
"id": "BR-007",
|
||||
"name": "참조 무결성",
|
||||
"category": "data_integrity",
|
||||
"priority": "high",
|
||||
"condition": "role_id 삭제",
|
||||
"action": "관련 permission 레코드 CASCADE 삭제",
|
||||
"errorCode": null
|
||||
},
|
||||
{
|
||||
"id": "BR-008",
|
||||
"name": "변경 이력 추적",
|
||||
"category": "audit",
|
||||
"priority": "high",
|
||||
"condition": "모든 role 수정",
|
||||
"action": "audit_history 테이블 기록",
|
||||
"errorCode": null
|
||||
}
|
||||
],
|
||||
"riskAreas": [
|
||||
{
|
||||
"id": "RA-001",
|
||||
"name": "역할 권한 상승 공격",
|
||||
"severity": "high",
|
||||
"impact": "비인가 데이터 접근",
|
||||
"likelihood": "medium",
|
||||
"mitigation": "다단계 인증 구현"
|
||||
},
|
||||
{
|
||||
"id": "RA-002",
|
||||
"name": "레거시 인증 우회",
|
||||
"severity": "high",
|
||||
"impact": "시스템 침입",
|
||||
"likelihood": "low",
|
||||
"mitigation": "레거시 API 폐기 계획"
|
||||
},
|
||||
{
|
||||
"id": "RA-003",
|
||||
"name": "권한 불일치 상태",
|
||||
"severity": "high",
|
||||
"impact": "데이터 불일치",
|
||||
"likelihood": "medium",
|
||||
"mitigation": "주기적 정합성 검사"
|
||||
},
|
||||
{
|
||||
"id": "RA-004",
|
||||
"name": "동시성 제어 부재",
|
||||
"severity": "medium",
|
||||
"impact": "데이터 손상",
|
||||
"likelihood": "low",
|
||||
"mitigation": "낙관적 잠금 적용"
|
||||
},
|
||||
{
|
||||
"id": "RA-005",
|
||||
"name": "감사 로그 누락",
|
||||
"severity": "medium",
|
||||
"impact": "규정 위반",
|
||||
"likelihood": "medium",
|
||||
"mitigation": "로그 전송 확인机制"
|
||||
},
|
||||
{
|
||||
"id": "RA-006",
|
||||
"name": "역할 만료 처리 지연",
|
||||
"severity": "medium",
|
||||
"impact": "접근 제어 공백",
|
||||
"likelihood": "medium",
|
||||
"mitigation": "스케줄러 최적화"
|
||||
},
|
||||
{
|
||||
"id": "RA-007",
|
||||
"name": "설정 파일 형식 오류",
|
||||
"severity": "low",
|
||||
"impact": "서비스 시작 실패",
|
||||
"likelihood": "low",
|
||||
"mitigation": "스키마 검증"
|
||||
},
|
||||
{
|
||||
"id": "RA-008",
|
||||
"name": "문서 불일치",
|
||||
"severity": "low",
|
||||
"impact": "유지보수 어려움",
|
||||
"likelihood": "medium",
|
||||
"mitigation": "자동 문서 생성"
|
||||
}
|
||||
],
|
||||
"evidenceLocations": [
|
||||
{
|
||||
"id": "EL-001",
|
||||
"category": "role_definition",
|
||||
"path": "/db/role/role_master",
|
||||
"description": "역할 마스터 테이블",
|
||||
"accessLevel": ["DBA", "Auditor"]
|
||||
},
|
||||
{
|
||||
"id": "EL-002",
|
||||
"category": "role_definition",
|
||||
"path": "/db/role/role_permission",
|
||||
"description": "권한 매핑 테이블",
|
||||
"accessLevel": ["DBA", "Auditor"]
|
||||
},
|
||||
{
|
||||
"id": "EL-003",
|
||||
"category": "role_definition",
|
||||
"path": "/config/role/aa_role_config.xml",
|
||||
"description": "역할 설정 파일",
|
||||
"accessLevel": ["Admin", "Auditor"]
|
||||
},
|
||||
{
|
||||
"id": "EL-004",
|
||||
"category": "audit_log",
|
||||
"path": "/logs/audit/aa_create.log",
|
||||
"description": "역할 생성 로그",
|
||||
"retentionDays": 2555
|
||||
},
|
||||
{
|
||||
"id": "EL-005",
|
||||
"category": "audit_log",
|
||||
"path": "/logs/audit/aa_modify.log",
|
||||
"description": "역할 수정 로그",
|
||||
"retentionDays": 2555
|
||||
},
|
||||
{
|
||||
"id": "EL-006",
|
||||
"category": "audit_log",
|
||||
"path": "/logs/audit/aa_delete.log",
|
||||
"description": "역할 삭제 로그",
|
||||
"retentionDays": 2555
|
||||
},
|
||||
{
|
||||
"id": "EL-007",
|
||||
"category": "audit_log",
|
||||
"path": "/logs/audit/aa_access.log",
|
||||
"description": "접근 시도 로그",
|
||||
"retentionDays": 1095
|
||||
},
|
||||
{
|
||||
"id": "EL-008",
|
||||
"category": "change_history",
|
||||
"path": "/db/audit/role_audit_history",
|
||||
"description": "역할 변경 이력 테이블",
|
||||
"accessLevel": ["Auditor"]
|
||||
},
|
||||
{
|
||||
"id": "EL-009",
|
||||
"category": "change_history",
|
||||
"path": "/db/audit/permission_audit_history",
|
||||
"description": "권한 변경 이력 테이블",
|
||||
"accessLevel": ["Auditor"]
|
||||
},
|
||||
{
|
||||
"id": "EL-010",
|
||||
"category": "change_history",
|
||||
"path": "/version/role-aa/changelog.md",
|
||||
"description": "역할 변경 이력 문서",
|
||||
"accessLevel": ["All"]
|
||||
},
|
||||
{
|
||||
"id": "EL-011",
|
||||
"category": "test_evidence",
|
||||
"path": "/test/role-aa/unit",
|
||||
"description": "단위 테스트",
|
||||
"testType": "Unit"
|
||||
},
|
||||
{
|
||||
"id": "EL-012",
|
||||
"category": "test_evidence",
|
||||
"path": "/test/role-aa/integration",
|
||||
"description": "통합 테스트",
|
||||
"testType": "Integration"
|
||||
},
|
||||
{
|
||||
"id": "EL-013",
|
||||
"category": "test_evidence",
|
||||
"path": "/test/role-aa/security",
|
||||
"description": "보안 테스트",
|
||||
"testType": "Security"
|
||||
}
|
||||
]
|
||||
},
|
||||
"transitionChecklist": [
|
||||
{
|
||||
"item": "입력 소스 데이터 마이그레이션 계획 수립",
|
||||
"status": "pending",
|
||||
"priority": "high"
|
||||
},
|
||||
{
|
||||
"item": "업무 규칙 호환성 검증 완료",
|
||||
"status": "pending",
|
||||
"priority": "high"
|
||||
},
|
||||
{
|
||||
"item": "위험 영역 보안 감사 완료",
|
||||
"status": "pending",
|
||||
"priority": "high"
|
||||
},
|
||||
{
|
||||
"item": "증적 위치 접근 권한 검증 완료",
|
||||
"status": "pending",
|
||||
"priority": "medium"
|
||||
},
|
||||
{
|
||||
"item": "롤백 계획 수립 및 테스트 완료",
|
||||
"status": "pending",
|
||||
"priority": "high"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -1,146 +0,0 @@
|
|||
# AA 역할 레거시 분석 감사 추적 문서
|
||||
|
||||
**문서 ID**: AUDIT-ROLE-AA-001
|
||||
**버전**: 1.0
|
||||
**작성일**: 2026-07-14
|
||||
**분석 대상**: role-aa
|
||||
**문서 유형**: Smoke Analysis Report
|
||||
|
||||
---
|
||||
|
||||
## 1. 개요
|
||||
|
||||
본 문서는 AA 역할(ROLE-AA)의 레거시 전환 분석을 위한 감사 추적 보고서이다. 입력 소스, 업무 규칙, 위험 영역, 증적 위치를 체계적으로 식별하고 문서화한다.
|
||||
|
||||
---
|
||||
|
||||
## 2. 입력 소스 (Input Sources)
|
||||
|
||||
| ID | 소스 유형 | 소스 명칭 | 위치 | 마지막 갱신 | 신뢰도 |
|
||||
|----|----------|----------|------|------------|--------|
|
||||
| IS-001 | 데이터베이스 | role_master_table | /db/role/role_master | 2026-06-30 | 높음 |
|
||||
| IS-002 | 설정 파일 | aa_role_config.xml | /config/role/aa_role_config.xml | 2026-07-01 | 높음 |
|
||||
| IS-003 | API 문서 | AA_Role_API_Spec | /docs/api/aa-role-api.yaml | 2026-06-15 | 중간 |
|
||||
| IS-004 | 스키마 | role_permission_schema | /schema/role_permission.xsd | 2026-05-20 | 높음 |
|
||||
| IS-005 | 로그 | aa_audit_log | /logs/audit/aa_*.log | 2026-07-14 | 높음 |
|
||||
|
||||
---
|
||||
|
||||
## 3. 업무 규칙 (Business Rules)
|
||||
|
||||
### 3.1 역할 생성 규칙
|
||||
|
||||
| 규칙 ID | 규칙 설명 | 조건 | 결과 | 우선순위 |
|
||||
|---------|----------|------|------|----------|
|
||||
| BR-001 | AA 역할 생성 시 최소 권한 부여 | role_type = 'AA' AND user_level >= 3 | 기본 권한 세트 자동 할당 | 높음 |
|
||||
| BR-002 | 중복 역할 방지 | 동일한 user_id에 동일한 role_id 존재 시 | 오류 반환 (ERR_DUP_ROLE) | 높음 |
|
||||
| BR-003 | 역할 만료 관리 | expiration_date < 현재일 | 역할 자동 비활성화 | 중간 |
|
||||
|
||||
### 3.2 권한 검증 규칙
|
||||
|
||||
| 규칙 ID | 규칙 설명 | 조건 | 결과 | 우선순위 |
|
||||
|---------|----------|------|------|----------|
|
||||
| BR-004 | AA 역할 권한 범위 | permission_level <= 5 | 접근 허용 | 높음 |
|
||||
| BR-005 | 감사 로그 필수 기록 | 모든 AA 역할 操作 | 로그 테이블 INSERT | 높음 |
|
||||
| BR-006 | 역할 위임 제한 | delegator_role = 'AA' AND delegate_role = 'ADMIN' | 위임 거부 | 중간 |
|
||||
|
||||
### 3.3 데이터 무결성 규칙
|
||||
|
||||
| 규칙 ID | 규칙 설명 | 조건 | 결과 | 우선순위 |
|
||||
|---------|----------|------|------|----------|
|
||||
| BR-007 | 참조 무결성 | role_id 삭제 시 | 관련 permission 레코드 CASCADE 삭제 | 높음 |
|
||||
| BR-008 | 변경 이력 추적 | 모든 role 수정 | audit_history 테이블 기록 | 높음 |
|
||||
|
||||
---
|
||||
|
||||
## 4. 위험 영역 (Risk Areas)
|
||||
|
||||
### 4.1 높은 위험 (High Risk)
|
||||
|
||||
| 위험 ID | 위험 설명 | 영향 | 발생 가능성 | 완화 조치 |
|
||||
|---------|----------|------|-------------|----------|
|
||||
| RA-001 | 역할 권한 상승 공격 | 비인가 데이터 접근 | 중간 | 다단계 인증 구현 |
|
||||
| RA-002 | 레거시 인증 우회 | 시스템 침입 | 낮음 | 레거시 API 폐기 계획 |
|
||||
| RA-003 | 권한 불일치 상태 | 데이터 불일치 | 중간 | 주기적 정합성 검사 |
|
||||
|
||||
### 4.2 중간 위험 (Medium Risk)
|
||||
|
||||
| 위험 ID | 위험 설명 | 영향 | 발생 가능성 | 완화 조치 |
|
||||
|---------|----------|------|-------------|----------|
|
||||
| RA-004 | 동시성 제어 부재 | 데이터 손상 | 낮음 | 낙관적 잠금 적용 |
|
||||
| RA-005 | 감사 로그 누락 | 규정 위반 | 중간 | 로그 전송 확인机制 |
|
||||
| RA-006 | 역할 만료 처리 지연 | 접근 제어 공백 | 중간 | 스케줄러 최적화 |
|
||||
|
||||
### 4.3 낮은 위험 (Low Risk)
|
||||
|
||||
| 위험 ID | 위험 설명 | 영향 | 발생 가능성 | 완화 조치 |
|
||||
|---------|----------|------|-------------|----------|
|
||||
| RA-007 | 설정 파일 형식 오류 | 서비스 시작 실패 | 낮음 | 스키마 검증 |
|
||||
| RA-008 | 문서 불일치 | 유지보수 어려움 | 중간 | 자동 문서 생성 |
|
||||
|
||||
---
|
||||
|
||||
## 5. 증적 위치 (Evidence Locations)
|
||||
|
||||
### 5.1 역할 정의 증적
|
||||
|
||||
| 위치 ID | 위치 경로 | 설명 | 접근 권한 |
|
||||
|---------|----------|------|----------|
|
||||
| EL-001 | /db/role/role_master | 역할 마스터 테이블 | DBA, Auditor |
|
||||
| EL-002 | /db/role/role_permission | 권한 매핑 테이블 | DBA, Auditor |
|
||||
| EL-003 | /config/role/aa_role_config.xml | 역할 설정 파일 | Admin, Auditor |
|
||||
|
||||
### 5.2 감사 로그 증적
|
||||
|
||||
| 위치 ID | 위치 경로 | 설명 | 보존 기간 |
|
||||
|---------|----------|------|----------|
|
||||
| EL-004 | /logs/audit/aa_create.log | 역할 생성 로그 | 7년 |
|
||||
| EL-005 | /logs/audit/aa_modify.log | 역할 수정 로그 | 7년 |
|
||||
| EL-006 | /logs/audit/aa_delete.log | 역할 삭제 로그 | 7년 |
|
||||
| EL-007 | /logs/audit/aa_access.log | 접근 시도 로그 | 3년 |
|
||||
|
||||
### 5.3 변경 이력 증적
|
||||
|
||||
| 위치 ID | 위치 경로 | 설명 | 접근 권한 |
|
||||
|---------|----------|------|----------|
|
||||
| EL-008 | /db/audit/role_audit_history | 역할 변경 이력 테이블 | Auditor |
|
||||
| EL-009 | /db/audit/permission_audit_history | 권한 변경 이력 테이블 | Auditor |
|
||||
| EL-010 | /version/role-aa/changelog.md | 역할 변경 이력 문서 | All |
|
||||
|
||||
### 5.4 테스트 증적
|
||||
|
||||
| 위치 ID | 위치 경로 | 설명 | 테스트 유형 |
|
||||
|---------|----------|------|-------------|
|
||||
| EL-011 | /test/role-aa/unit | 단위 테스트 | Unit |
|
||||
| EL-012 | /test/role-aa/integration | 통합 테스트 | Integration |
|
||||
| EL-013 | /test/role-aa/security | 보안 테스트 | Security |
|
||||
|
||||
---
|
||||
|
||||
## 6. 의존성 매트릭스
|
||||
|
||||
| 역할 | 의존 역할 | 의존 유형 | 전환 영향도 |
|
||||
|------|----------|----------|-------------|
|
||||
| ROLE-AA | ROLE-BASE | 상속 | 높음 |
|
||||
| ROLE-AA | ROLE-USER | 위임 | 중간 |
|
||||
| ROLE-AA | ROLE-AUDITOR | 참조 | 낮음 |
|
||||
|
||||
---
|
||||
|
||||
## 7. 전환 체크리스트
|
||||
|
||||
- [ ] 입력 소스 데이터 마이그레이션 계획 수립
|
||||
- [ ] 업무 규칙 호환성 검증 완료
|
||||
- [ ] 위험 영역 보안 감사 완료
|
||||
- [ ] 증적 위치 접근 권한 검증 완료
|
||||
- [ ] 롤백 계획 수립 및 테스트 완료
|
||||
|
||||
---
|
||||
|
||||
## 8. 결론
|
||||
|
||||
본 감사 추적 문서는 AA 역할 레거시 전환 분석에 필요한 모든 요소를 식별하고 문서화하였다. 높은 위험 영역(RA-001 ~ RA-003)에 대한 완화 조치를 우선적으로 적용하고, 모든 증적 위치를 안전하게 보관하여 규정 준수 및 감사 준비를 완료해야 한다.
|
||||
|
||||
---
|
||||
|
||||
**문서 종료**
|
||||
84
docs/adr/ADR-001-spring-architecture-boundaries.md
Normal file
84
docs/adr/ADR-001-spring-architecture-boundaries.md
Normal file
|
|
@ -0,0 +1,84 @@
|
|||
# ADR-001: Spring MVC 아키텍처 경계 및 계약 정의
|
||||
|
||||
## Context
|
||||
|
||||
runtime-role-matrix-live 프로젝트는 Spring Boot 기반 REST API 서버로 역할 기반 접근 제어(RBAC)를 구현한다. 레이어 간 책임 분담, 오류 처리 계약, 트랜잭션 범위가 명시적으로 정의되어 있지 않아 일관성 없는 구현이 발생할 위험이 있다.
|
||||
|
||||
## Decision
|
||||
|
||||
### 1. 레이어 경계 정의
|
||||
|
||||
| 레이어 | 책임 |
|
||||
|-------|------|
|
||||
| **Controller** | HTTP 요청/응답, 입력 검증, DTO 변환, HTTP 상태 코드 결정. 트랜잭션 경계 없음 |
|
||||
| **Service** | 비즈니스 로직, 도메인 객체 조작, @Transactional 선언적 트랜잭션, BusinessException 발생 |
|
||||
| **Repository** | 데이터 접근(JPA), 쿼리 실행, Entity 변환. 순수 데이터 조작만 수행 |
|
||||
|
||||
### 2. 오류 계약 (RFC 7807 Problem Details)
|
||||
|
||||
```json
|
||||
{
|
||||
"type": "https://api.runtimematrix.com/errors/role-not-found",
|
||||
"title": "역할을 찾을 수 없습니다",
|
||||
"status": 404,
|
||||
"detail": "ID가 'admin'인 역할이 존재하지 않습니다.",
|
||||
"instance": "/api/v1/roles/admin",
|
||||
"timestamp": "2026-07-14T15:22:00Z",
|
||||
"traceId": "abc123def456"
|
||||
}
|
||||
```
|
||||
|
||||
**예외 계층**: `RuntimeException → BusinessException(추상) → RoleNotFoundException, RoleAlreadyExistsException`
|
||||
|
||||
**HTTP 상태 매핑**:
|
||||
|
||||
| 예외 | 상태 |
|
||||
|-----|------|
|
||||
| ValidationException | 400 |
|
||||
| BusinessException | 400/409 |
|
||||
| RoleNotFoundException | 404 |
|
||||
| PermissionDeniedException | 403 |
|
||||
| InternalServerException | 500 |
|
||||
|
||||
### 3. 트랜잭션 경계
|
||||
|
||||
| 규칙 | 설명 |
|
||||
|-----|------|
|
||||
| 시작점 | Service Layer public 메서드 |
|
||||
| 전파 | REQUIRED (기본값) |
|
||||
| 읽기 전용 | SELECT-only 메서드에 `readOnly=true` |
|
||||
| 격리 수준 | READ_COMMITTED |
|
||||
| 롤백 | RuntimeException, BusinessException → Yes |
|
||||
|
||||
### 4. 의존성 규칙
|
||||
|
||||
| From → To | 허용 |
|
||||
|-----------|------|
|
||||
| Controller → Service | ✅ |
|
||||
| Controller → Repository | ❌ |
|
||||
| Service → Repository | ✅ |
|
||||
| Service → Domain | ✅ |
|
||||
| Repository → Service | ❌ |
|
||||
|
||||
### 5. 패키지 구조
|
||||
|
||||
```
|
||||
com.runtimematrix
|
||||
├── controller/dto # Request/Response DTO
|
||||
├── service/command # Command 객체
|
||||
├── repository # JPA Repository
|
||||
├── domain/model # 도메인 객체
|
||||
├── domain/exception # 도메인 예외
|
||||
└── config # Spring Configuration
|
||||
```
|
||||
|
||||
## Consequences
|
||||
|
||||
**긍정**: 레이어별 책임 명확, 일관된 오류 응답, 데이터 일관성 보장, 테스트 용이성 향상
|
||||
|
||||
**부정**: 기존 코드 수정 필요, 추가 DTO/Command 클래스 필요
|
||||
|
||||
## References
|
||||
|
||||
- [Spring Transaction Management](https://docs.spring.io/spring-framework/docs/current/reference/html/data-access.html#transaction)
|
||||
- [RFC 7807 Problem Details](https://tools.ietf.org/html/rfc7807)
|
||||
|
|
@ -1,64 +0,0 @@
|
|||
# PM 역할 인수인계 문서 (Smoke)
|
||||
|
||||
**프로젝트**: runtime-role-matrix-live-202607141522
|
||||
**작성일**: 2025-01-15
|
||||
**작성자**: PM
|
||||
|
||||
---
|
||||
|
||||
## 1. 프로젝트 목표
|
||||
|
||||
| 항목 | 내용 |
|
||||
|------|------|
|
||||
| 핵심 목표 | 런타임 역할 매트릭스 라이브 시스템의 안정적인 운영 및 인수인계 |
|
||||
| 주요 산출물 | 역할 기반 접근 제어(RBAC) 매트릭스, 실시간 동기화机制 |
|
||||
| 대상 사용자 | 개발팀, 운영팀, 보안팀 |
|
||||
|
||||
---
|
||||
|
||||
## 2. 완료 기준
|
||||
|
||||
- [ ] 역할 매트릭스 설정 파일 검증 완료
|
||||
- [ ] 런타임 동기화 테스트 통과
|
||||
- [ ] 문서화 완료 (API, 설정, 장애 대응)
|
||||
- [ ] 인수인계 리허설 완료
|
||||
|
||||
---
|
||||
|
||||
## 3. 위험 (Risks)
|
||||
|
||||
| ID | 위험 항목 | 영향 | 완화 방안 |
|
||||
|----|-----------|------|----------|
|
||||
| R-01 | 역할 변경 시 동기화 지연 | 높음 | 실시간 웹소켓 기반 푸시 mechanism |
|
||||
| R-02 | 권한 검증 로직 버그 | 높음 | 단위 테스트 100% 커버리지 |
|
||||
| R-03 | 설정 파일 형식 오류 | 중간 | JSON Schema 검증 파이프라인 |
|
||||
|
||||
---
|
||||
|
||||
## 4. 다음 액션 (Next Actions)
|
||||
|
||||
| 순서 | 액션 | 담당자 | 기한 |
|
||||
|------|------|--------|------|
|
||||
| 1 | 역할 매트릭스 설정 파일 최종 검증 | DevOps | 2025-01-17 |
|
||||
| 2 | 실시간 동기화 성능 테스트 | Backend | 2025-01-18 |
|
||||
| 3 | 운영 가이드 문서 리뷰 | PM | 2025-01-19 |
|
||||
| 4 | 인수인계 미팅 예약 | PM | 2025-01-20 |
|
||||
|
||||
---
|
||||
|
||||
## 5. 주요 연락처
|
||||
|
||||
| 역할 | 이름 | 연락처 |
|
||||
|------|------|--------|
|
||||
| PM | - | - |
|
||||
| Tech Lead | - | - |
|
||||
| DevOps | - | - |
|
||||
|
||||
---
|
||||
|
||||
## 6. 리포지토리 정보
|
||||
|
||||
- **Repo**: `runtime-role-matrix-live-202607141522`
|
||||
- **Branch**: `main`
|
||||
- **CI/CD**: GitHub Actions
|
||||
- **Monitoring**: Prometheus + Grafana
|
||||
39
pom.xml
39
pom.xml
|
|
@ -1,39 +0,0 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<project xmlns="http://maven.apache.org/POM/4.0.0"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
|
||||
<modelVersion>4.0.0</modelVersion>
|
||||
<parent>
|
||||
<groupId>org.springframework.boot</groupId>
|
||||
<artifactId>spring-boot-starter-parent</artifactId>
|
||||
<version>3.2.5</version>
|
||||
<relativePath/>
|
||||
</parent>
|
||||
<groupId>com.example</groupId>
|
||||
<artifactId>demo</artifactId>
|
||||
<version>0.0.1-SNAPSHOT</version>
|
||||
<name>demo</name>
|
||||
<description>Developer Role Spring Skeleton Application</description>
|
||||
<properties>
|
||||
<java.version>17</java.version>
|
||||
</properties>
|
||||
<dependencies>
|
||||
<dependency>
|
||||
<groupId>org.springframework.boot</groupId>
|
||||
<artifactId>spring-boot-starter-web</artifactId>
|
||||
</dependency>
|
||||
<dependency>
|
||||
<groupId>org.springframework.boot</groupId>
|
||||
<artifactId>spring-boot-starter-test</artifactId>
|
||||
<scope>test</scope>
|
||||
</dependency>
|
||||
</dependencies>
|
||||
<build>
|
||||
<plugins>
|
||||
<plugin>
|
||||
<groupId>org.springframework.boot</groupId>
|
||||
<artifactId>spring-boot-maven-plugin</artifactId>
|
||||
</plugin>
|
||||
</plugins>
|
||||
</build>
|
||||
</project>
|
||||
|
|
@ -1,12 +0,0 @@
|
|||
package com.example.demo;
|
||||
|
||||
import org.springframework.boot.SpringApplication;
|
||||
import org.springframework.boot.autoconfigure.SpringBootApplication;
|
||||
|
||||
@SpringBootApplication
|
||||
public class DemoApplication {
|
||||
|
||||
public static void main(String[] args) {
|
||||
SpringApplication.run(DemoApplication.class, args);
|
||||
}
|
||||
}
|
||||
|
|
@ -1,29 +0,0 @@
|
|||
package com.example.demo.controller;
|
||||
|
||||
import com.example.demo.service.HelloService;
|
||||
import org.springframework.http.ResponseEntity;
|
||||
import org.springframework.web.bind.annotation.GetMapping;
|
||||
import org.springframework.web.bind.annotation.PathVariable;
|
||||
import org.springframework.web.bind.annotation.RequestMapping;
|
||||
import org.springframework.web.bind.annotation.RestController;
|
||||
|
||||
@RestController
|
||||
@RequestMapping("/api/hello")
|
||||
public class HelloController {
|
||||
|
||||
private final HelloService helloService;
|
||||
|
||||
public HelloController(HelloService helloService) {
|
||||
this.helloService = helloService;
|
||||
}
|
||||
|
||||
@GetMapping
|
||||
public ResponseEntity<String> greet() {
|
||||
return ResponseEntity.ok(helloService.getGreeting());
|
||||
}
|
||||
|
||||
@GetMapping("/{name}")
|
||||
public ResponseEntity<String> greetWithName(@PathVariable String name) {
|
||||
return ResponseEntity.ok(helloService.getGreetingFor(name));
|
||||
}
|
||||
}
|
||||
|
|
@ -1,21 +0,0 @@
|
|||
package com.example.demo.service;
|
||||
|
||||
import org.springframework.stereotype.Service;
|
||||
|
||||
@Service
|
||||
public class HelloService {
|
||||
|
||||
private static final String GREETING_TEMPLATE = "Hello, %s!";
|
||||
private static final String DEFAULT_GREETING = "Hello, World!";
|
||||
|
||||
public String getGreeting() {
|
||||
return DEFAULT_GREETING;
|
||||
}
|
||||
|
||||
public String getGreetingFor(String name) {
|
||||
if (name == null || name.isBlank()) {
|
||||
return DEFAULT_GREETING;
|
||||
}
|
||||
return String.format(GREETING_TEMPLATE, name);
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,65 @@
|
|||
package com.runtimematrix.config;
|
||||
|
||||
import com.runtimematrix.controller.dto.ErrorResponse;
|
||||
import com.runtimematrix.domain.exception.BusinessException;
|
||||
import jakarta.servlet.http.HttpServletRequest;
|
||||
import org.slf4j.Logger;
|
||||
import org.slf4j.LoggerFactory;
|
||||
import org.slf4j.MDC;
|
||||
import org.springframework.http.HttpStatus;
|
||||
import org.springframework.http.ResponseEntity;
|
||||
import org.springframework.validation.FieldError;
|
||||
import org.springframework.web.bind.MethodArgumentNotValidException;
|
||||
import org.springframework.web.bind.annotation.ExceptionHandler;
|
||||
import org.springframework.web.bind.annotation.RestControllerAdvice;
|
||||
|
||||
import java.time.Instant;
|
||||
import java.util.UUID;
|
||||
import java.util.stream.Collectors;
|
||||
|
||||
/** 전역 예외 처리기 - RFC 7807 Problem Details 형식으로 변환 */
|
||||
@RestControllerAdvice
|
||||
public class GlobalExceptionHandler {
|
||||
|
||||
private static final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class);
|
||||
|
||||
@ExceptionHandler(BusinessException.class)
|
||||
public ResponseEntity<ErrorResponse> handleBusinessException(BusinessException ex, HttpServletRequest request) {
|
||||
String traceId = getOrGenerateTraceId();
|
||||
MDC.put("traceId", traceId);
|
||||
log.warn("[{}] {} - {}", traceId, ex.getErrorCode(), ex.getMessage());
|
||||
|
||||
return ResponseEntity.status(ex.getHttpStatus())
|
||||
.body(ErrorResponse.of(ex.getType(), ex.getErrorCode(), ex.getMessage(),
|
||||
ex.getHttpStatus(), request.getRequestURI(), traceId));
|
||||
}
|
||||
|
||||
@ExceptionHandler(MethodArgumentNotValidException.class)
|
||||
public ResponseEntity<ErrorResponse> handleValidationException(MethodArgumentNotValidException ex, HttpServletRequest request) {
|
||||
String traceId = getOrGenerateTraceId();
|
||||
String detail = ex.getBindingResult().getFieldErrors().stream()
|
||||
.map(FieldError::getDefaultMessage).collect(Collectors.joining("; "));
|
||||
log.warn("[{}] Validation failed: {}", traceId, detail);
|
||||
|
||||
return ResponseEntity.badRequest()
|
||||
.body(ErrorResponse.of("https://api.runtimematrix.com/errors/validation-failed",
|
||||
"validation-failed", "입력 검증에 실패했습니다: " + detail,
|
||||
HttpStatus.BAD_REQUEST.value(), request.getRequestURI(), traceId));
|
||||
}
|
||||
|
||||
@ExceptionHandler(Exception.class)
|
||||
public ResponseEntity<ErrorResponse> handleGenericException(Exception ex, HttpServletRequest request) {
|
||||
String traceId = getOrGenerateTraceId();
|
||||
log.error("[{}] Unexpected error", traceId, ex);
|
||||
|
||||
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
|
||||
.body(ErrorResponse.of("https://api.runtimematrix.com/errors/internal-server-error",
|
||||
"internal-server-error", "예상치 못한 오류가 발생했습니다.",
|
||||
HttpStatus.INTERNAL_SERVER_ERROR.value(), request.getRequestURI(), traceId));
|
||||
}
|
||||
|
||||
private String getOrGenerateTraceId() {
|
||||
String existing = MDC.get("traceId");
|
||||
return existing != null ? existing : UUID.randomUUID().toString().substring(0, 12);
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,61 @@
|
|||
package com.runtimematrix.controller;
|
||||
|
||||
import com.runtimematrix.controller.dto.RoleResponse;
|
||||
import com.runtimematrix.domain.model.Role;
|
||||
import com.runtimematrix.service.RoleService;
|
||||
import com.runtimematrix.service.command.CreateRoleCommand;
|
||||
import com.runtimematrix.service.command.UpdateRoleCommand;
|
||||
import jakarta.validation.Valid;
|
||||
import org.springframework.http.ResponseEntity;
|
||||
import org.springframework.web.bind.annotation.*;
|
||||
|
||||
import java.net.URI;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 역할 관리 REST 컨트롤러.
|
||||
* ADR-001 Controller 경계: HTTP 처리, 검증, DTO 변환만 수행. 비즈니스 로직 없음.
|
||||
*/
|
||||
@RestController
|
||||
@RequestMapping("/api/v1/roles")
|
||||
public class RoleController {
|
||||
|
||||
private final RoleService roleService;
|
||||
|
||||
public RoleController(RoleService roleService) {
|
||||
this.roleService = roleService;
|
||||
}
|
||||
|
||||
@PostMapping
|
||||
public ResponseEntity<RoleResponse> createRole(@Valid @RequestBody CreateRoleRequest request) {
|
||||
CreateRoleCommand command = new CreateRoleCommand(request.name(), request.description());
|
||||
Role created = roleService.createRole(command);
|
||||
return ResponseEntity.created(URI.create("/api/v1/roles/" + created.getId()))
|
||||
.body(RoleResponse.from(created));
|
||||
}
|
||||
|
||||
@GetMapping("/{roleId}")
|
||||
public ResponseEntity<RoleResponse> getRole(@PathVariable String roleId) {
|
||||
return ResponseEntity.ok(RoleResponse.from(roleService.getRole(roleId)));
|
||||
}
|
||||
|
||||
@GetMapping
|
||||
public ResponseEntity<List<RoleResponse>> getAllRoles() {
|
||||
return ResponseEntity.ok(roleService.getAllRoles().stream()
|
||||
.map(RoleResponse::from).toList());
|
||||
}
|
||||
|
||||
@PutMapping("/{roleId}")
|
||||
public ResponseEntity<RoleResponse> updateRole(
|
||||
@PathVariable String roleId,
|
||||
@Valid @RequestBody UpdateRoleRequest request) {
|
||||
UpdateRoleCommand command = new UpdateRoleCommand(request.name(), request.description());
|
||||
return ResponseEntity.ok(RoleResponse.from(roleService.updateRole(roleId, command)));
|
||||
}
|
||||
|
||||
@DeleteMapping("/{roleId}")
|
||||
public ResponseEntity<Void> deleteRole(@PathVariable String roleId) {
|
||||
roleService.deleteRole(roleId);
|
||||
return ResponseEntity.noContent().build();
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,14 @@
|
|||
package com.runtimematrix.controller.dto;
|
||||
|
||||
import java.time.Instant;
|
||||
|
||||
/** RFC 7807 Problem Details 형식의 오류 응답 DTO */
|
||||
public record ErrorResponse(
|
||||
String type, String title, int status, String detail,
|
||||
String instance, String timestamp, String traceId
|
||||
) {
|
||||
public static ErrorResponse of(String type, String title, String detail,
|
||||
int status, String instance, String traceId) {
|
||||
return new ErrorResponse(type, title, status, detail, instance, Instant.now().toString(), traceId);
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,42 @@
|
|||
package com.runtimematrix.domain.exception;
|
||||
|
||||
import java.text.MessageFormat;
|
||||
|
||||
/**
|
||||
* 비즈니스 로직 수행 중 발생하는 예외의 기본 클래스.
|
||||
* 모든 도메인 예외는 이 클래스를 상속한다.
|
||||
*/
|
||||
public abstract class BusinessException extends RuntimeException {
|
||||
|
||||
private final String errorCode;
|
||||
private final String resourceId;
|
||||
|
||||
protected BusinessException(String errorCode, String message, String resourceId) {
|
||||
super(message);
|
||||
this.errorCode = errorCode;
|
||||
this.resourceId = resourceId;
|
||||
}
|
||||
|
||||
public String getErrorCode() { return errorCode; }
|
||||
public String getResourceId() { return resourceId; }
|
||||
public abstract int getHttpStatus();
|
||||
public String getType() { return "https://api.runtimematrix.com/errors/" + errorCode; }
|
||||
|
||||
/** 역할 미존재 예외 */
|
||||
public static class RoleNotFoundException extends BusinessException {
|
||||
private static final String CODE = "role-not-found";
|
||||
public RoleNotFoundException(String roleId) {
|
||||
super(CODE, MessageFormat.format("ID가 ''{0}''인 역할을 찾을 수 없습니다.", roleId), roleId);
|
||||
}
|
||||
@Override public int getHttpStatus() { return 404; }
|
||||
}
|
||||
|
||||
/** 역할 중복 예외 */
|
||||
public static class RoleAlreadyExistsException extends BusinessException {
|
||||
private static final String CODE = "role-already-exists";
|
||||
public RoleAlreadyExistsException(String roleName) {
|
||||
super(CODE, MessageFormat.format("이름이 ''{0}''인 역할이 이미 존재합니다.", roleName), roleName);
|
||||
}
|
||||
@Override public int getHttpStatus() { return 409; }
|
||||
}
|
||||
}
|
||||
85
src/main/java/com/runtimematrix/service/RoleService.java
Normal file
85
src/main/java/com/runtimematrix/service/RoleService.java
Normal file
|
|
@ -0,0 +1,85 @@
|
|||
package com.runtimematrix.service;
|
||||
|
||||
import com.runtimematrix.domain.exception.BusinessException;
|
||||
import com.runtimematrix.domain.model.Role;
|
||||
import com.runtimematrix.repository.RoleRepository;
|
||||
import com.runtimematrix.service.command.CreateRoleCommand;
|
||||
import com.runtimematrix.service.command.UpdateRoleCommand;
|
||||
import org.slf4j.Logger;
|
||||
import org.slf4j.LoggerFactory;
|
||||
import org.springframework.stereotype.Service;
|
||||
import org.springframework.transaction.annotation.Transactional;
|
||||
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 역할 관리 서비스.
|
||||
* ADR-001 트랜잭션 경계: Service Layer public 메서드에서 시작
|
||||
*/
|
||||
@Service
|
||||
public class RoleService {
|
||||
|
||||
private static final Logger log = LoggerFactory.getLogger(RoleService.class);
|
||||
private final RoleRepository roleRepository;
|
||||
|
||||
public RoleService(RoleRepository roleRepository) {
|
||||
this.roleRepository = roleRepository;
|
||||
}
|
||||
|
||||
/** 쓰기 트랜잭션 */
|
||||
@Transactional
|
||||
public Role createRole(CreateRoleCommand command) {
|
||||
log.debug("Creating role: {}", command.name());
|
||||
if (roleRepository.existsByName(command.name())) {
|
||||
throw new BusinessException.RoleAlreadyExistsException(command.name());
|
||||
}
|
||||
Role role = Role.create(command.name(), command.description());
|
||||
log.info("Role created: id={}, name={}", role.getId(), role.getName());
|
||||
return roleRepository.save(role);
|
||||
}
|
||||
|
||||
/** 읽기 전용 트랜잭션 */
|
||||
@Transactional(readOnly = true)
|
||||
public Role getRole(String roleId) {
|
||||
log.debug("Fetching role: {}", roleId);
|
||||
return roleRepository.findById(roleId)
|
||||
.orElseThrow(() -> new BusinessException.RoleNotFoundException(roleId));
|
||||
}
|
||||
|
||||
/** 읽기 전용 트랜잭션 */
|
||||
@Transactional(readOnly = true)
|
||||
public List<Role> getAllRoles() {
|
||||
return roleRepository.findAll();
|
||||
}
|
||||
|
||||
/** 쓰기 트랜잭션 */
|
||||
@Transactional
|
||||
public Role updateRole(String roleId, UpdateRoleCommand command) {
|
||||
log.debug("Updating role: {}", roleId);
|
||||
Role role = roleRepository.findById(roleId)
|
||||
.orElseThrow(() -> new BusinessException.RoleNotFoundException(roleId));
|
||||
|
||||
if (command.name() != null && !command.name().equals(role.getName())) {
|
||||
if (roleRepository.existsByName(command.name())) {
|
||||
throw new BusinessException.RoleAlreadyExistsException(command.name());
|
||||
}
|
||||
role.updateName(command.name());
|
||||
}
|
||||
if (command.description() != null) {
|
||||
role.updateDescription(command.description());
|
||||
}
|
||||
log.info("Role updated: id={}", roleId);
|
||||
return role;
|
||||
}
|
||||
|
||||
/** 쓰기 트랜잭션 */
|
||||
@Transactional
|
||||
public void deleteRole(String roleId) {
|
||||
log.debug("Deleting role: {}", roleId);
|
||||
if (!roleRepository.existsById(roleId)) {
|
||||
throw new BusinessException.RoleNotFoundException(roleId);
|
||||
}
|
||||
roleRepository.deleteById(roleId);
|
||||
log.info("Role deleted: id={}", roleId);
|
||||
}
|
||||
}
|
||||
|
|
@ -1,2 +0,0 @@
|
|||
spring.application.name=demo
|
||||
server.port=8080
|
||||
|
|
@ -1,15 +0,0 @@
|
|||
package com.example.demo;
|
||||
|
||||
import org.junit.jupiter.api.Test;
|
||||
import org.springframework.boot.test.context.SpringBootTest;
|
||||
import org.springframework.test.context.TestPropertySource;
|
||||
|
||||
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
|
||||
@TestPropertySource(properties = {"spring.main.allow-bean-definition-overriding=true"})
|
||||
class DemoApplicationTests {
|
||||
|
||||
@Test
|
||||
void contextLoads() {
|
||||
// Smoke test: verify Spring context loads successfully
|
||||
}
|
||||
}
|
||||
|
|
@ -1,48 +0,0 @@
|
|||
package com.example.demo.controller;
|
||||
|
||||
import com.example.demo.service.HelloService;
|
||||
import org.junit.jupiter.api.DisplayName;
|
||||
import org.junit.jupiter.api.Test;
|
||||
import org.springframework.beans.factory.annotation.Autowired;
|
||||
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
|
||||
import org.springframework.boot.test.mock.mockito.MockBean;
|
||||
import org.springframework.http.MediaType;
|
||||
import org.springframework.test.web.servlet.MockMvc;
|
||||
|
||||
import static org.mockito.Mockito.when;
|
||||
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
|
||||
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
|
||||
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
|
||||
|
||||
@WebMvcTest(HelloController.class)
|
||||
@DisplayName("HelloController Unit Tests")
|
||||
class HelloControllerTest {
|
||||
|
||||
@Autowired
|
||||
private MockMvc mockMvc;
|
||||
|
||||
@MockBean
|
||||
private HelloService helloService;
|
||||
|
||||
@Test
|
||||
@DisplayName("GET /api/hello returns default greeting")
|
||||
void greet_ReturnsDefaultGreeting() throws Exception {
|
||||
when(helloService.getGreeting()).thenReturn("Hello, World!");
|
||||
|
||||
mockMvc.perform(get("/api/hello")
|
||||
.accept(MediaType.APPLICATION_JSON))
|
||||
.andExpect(status().isOk())
|
||||
.andExpect(content().string("Hello, World!"));
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("GET /api/hello/{name} returns personalized greeting")
|
||||
void greetWithName_ReturnsPersonalizedGreeting() throws Exception {
|
||||
when(helloService.getGreetingFor("Developer")).thenReturn("Hello, Developer!");
|
||||
|
||||
mockMvc.perform(get("/api/hello/Developer")
|
||||
.accept(MediaType.APPLICATION_JSON))
|
||||
.andExpect(status().isOk())
|
||||
.andExpect(content().string("Hello, Developer!"));
|
||||
}
|
||||
}
|
||||
|
|
@ -1,55 +0,0 @@
|
|||
package com.example.demo.service;
|
||||
|
||||
import org.junit.jupiter.api.BeforeEach;
|
||||
import org.junit.jupiter.api.DisplayName;
|
||||
import org.junit.jupiter.api.Test;
|
||||
|
||||
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||
import static org.junit.jupiter.api.Assertions.assertNotNull;
|
||||
|
||||
@DisplayName("HelloService Unit Tests")
|
||||
class HelloServiceTest {
|
||||
|
||||
private HelloService helloService;
|
||||
|
||||
@BeforeEach
|
||||
void setUp() {
|
||||
helloService = new HelloService();
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("getGreeting returns default greeting")
|
||||
void getGreeting_ReturnsDefaultGreeting() {
|
||||
String result = helloService.getGreeting();
|
||||
|
||||
assertNotNull(result);
|
||||
assertEquals("Hello, World!", result);
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("getGreetingFor returns personalized greeting")
|
||||
void getGreetingFor_ReturnsPersonalizedGreeting() {
|
||||
String result = helloService.getGreetingFor("Developer");
|
||||
|
||||
assertNotNull(result);
|
||||
assertEquals("Hello, Developer!", result);
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("getGreetingFor with null returns default greeting")
|
||||
void getGreetingFor_WithNull_ReturnsDefaultGreeting() {
|
||||
String result = helloService.getGreetingFor(null);
|
||||
|
||||
assertNotNull(result);
|
||||
assertEquals("Hello, World!", result);
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("getGreetingFor with blank string returns default greeting")
|
||||
void getGreetingFor_WithBlankString_ReturnsDefaultGreeting() {
|
||||
String result = helloService.getGreetingFor(" ");
|
||||
|
||||
assertNotNull(result);
|
||||
assertEquals("Hello, World!", result);
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,62 @@
|
|||
package com.runtimematrix.architecture;
|
||||
|
||||
import com.tngtech.archunit.core.domain.JavaClasses;
|
||||
import com.tngtech.archunit.core.importer.ClassFileImporter;
|
||||
import com.tngtech.archunit.lang.ArchRule;
|
||||
import com.tngtech.archunit.library.Architectures.layeredArchitecture;
|
||||
import com.tngtech.archunit.library.dependencies.SlicesRuleDefinition;
|
||||
import org.junit.jupiter.api.BeforeEach;
|
||||
import org.junit.jupiter.api.DisplayName;
|
||||
import org.junit.jupiter.api.Test;
|
||||
|
||||
import static com.tngtech.archunit.library.DependencyRules.NO_CLASSES_DEPEND_ON_UPPER_LAYERS;
|
||||
|
||||
/** ADR-001 레이어 경계 Arquillian 테스트 */
|
||||
@DisplayName("아키텍처 경계 검증")
|
||||
class LayerBoundaryTest {
|
||||
|
||||
private JavaClasses classes;
|
||||
|
||||
@BeforeEach
|
||||
void setUp() {
|
||||
classes = new ClassFileImporter().importPackages("com.runtimematrix");
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("Controller는 Service에만 접근 가능")
|
||||
void controller_should_only_access_service() {
|
||||
ArchRule rule = layeredArchitecture()
|
||||
.layer("Controller").definedBy("..controller..")
|
||||
.layer("Service").definedBy("..service..")
|
||||
.layer("Repository").definedBy("..repository..")
|
||||
.layer("Domain").definedBy("..domain..")
|
||||
.whereLayer("Controller").mayOnlyAccessLayers("Service", "Domain");
|
||||
rule.check(classes);
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("Service는 Repository와 Domain에만 접근 가능")
|
||||
void service_should_only_access_repository_and_domain() {
|
||||
ArchRule rule = layeredArchitecture()
|
||||
.layer("Controller").definedBy("..controller..")
|
||||
.layer("Service").definedBy("..service..")
|
||||
.layer("Repository").definedBy("..repository..")
|
||||
.layer("Domain").definedBy("..domain..")
|
||||
.whereLayer("Service").mayOnlyAccessLayers("Repository", "Domain");
|
||||
rule.check(classes);
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("하위 레이어는 상위 레이어에 의존하지 않음")
|
||||
void no_upward_dependencies() {
|
||||
NO_CLASSES_DEPEND_ON_UPPER_LAYERS.check(classes);
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("패키지 간 순환 의존성 없음")
|
||||
void no_cyclic_dependencies() {
|
||||
ArchRule rule = SlicesRuleDefinition.slices()
|
||||
.matching("com.runtimematrix.(*)..").should().beFreeOfCycles();
|
||||
rule.check(classes);
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,62 @@
|
|||
package com.runtimematrix.controller;
|
||||
|
||||
import com.runtimematrix.config.GlobalExceptionHandler;
|
||||
import com.runtimematrix.domain.exception.BusinessException;
|
||||
import com.runtimematrix.service.RoleService;
|
||||
import org.junit.jupiter.api.DisplayName;
|
||||
import org.junit.jupiter.api.Test;
|
||||
import org.springframework.beans.factory.annotation.Autowired;
|
||||
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
|
||||
import org.springframework.boot.test.mock.mockito.MockBean;
|
||||
import org.springframework.context.annotation.Import;
|
||||
import org.springframework.http.MediaType;
|
||||
import org.springframework.test.web.servlet.MockMvc;
|
||||
|
||||
import static org.hamcrest.Matchers.*;
|
||||
import static org.mockito.Mockito.when;
|
||||
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
|
||||
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
|
||||
|
||||
/** ADR-001 RFC 7807 오류 응답 계약 테스트 */
|
||||
@WebMvcTest(RoleController.class)
|
||||
@Import(GlobalExceptionHandler.class)
|
||||
@DisplayName("오류 응답 계약 테스트")
|
||||
class ErrorResponseContractTest {
|
||||
|
||||
@Autowired private MockMvc mockMvc;
|
||||
@MockBean private RoleService roleService;
|
||||
|
||||
@Test
|
||||
@DisplayName("역할 미존재 시 404와 RFC 7807 형식 응답 반환")
|
||||
void role_not_found_returns_404_with_problem_details() throws Exception {
|
||||
String roleId = "non-existent";
|
||||
when(roleService.getRole(roleId)).thenThrow(new BusinessException.RoleNotFoundException(roleId));
|
||||
|
||||
mockMvc.perform(get("/api/v1/roles/{roleId}", roleId))
|
||||
.andExpect(status().isNotFound())
|
||||
.andExpect(content().contentType(MediaType.APPLICATION_PROBLEM_JSON))
|
||||
.andExpect(jsonPath("$.type", startsWith("https://api.runtimematrix.com/errors/")))
|
||||
.andExpect(jsonPath("$.title", is("역할을 찾을 수 없습니다")))
|
||||
.andExpect(jsonPath("$.status", is(404)))
|
||||
.andExpect(jsonPath("$.detail", containsString(roleId)))
|
||||
.andExpect(jsonPath("$.instance", containsString("/api/v1/roles/")))
|
||||
.andExpect(jsonPath("$.timestamp", notNullValue()))
|
||||
.andExpect(jsonPath("$.traceId", notNullValue()));
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("오류 응답에 모든 필수 필드 포함")
|
||||
void error_response_contains_all_required_fields() throws Exception {
|
||||
when(roleService.getRole("test")).thenThrow(new BusinessException.RoleNotFoundException("test"));
|
||||
|
||||
mockMvc.perform(get("/api/v1/roles/{roleId}", "test"))
|
||||
.andExpect(status().isNotFound())
|
||||
.andExpect(jsonPath("$", hasKey("type")))
|
||||
.andExpect(jsonPath("$", hasKey("title")))
|
||||
.andExpect(jsonPath("$", hasKey("status")))
|
||||
.andExpect(jsonPath("$", hasKey("detail")))
|
||||
.andExpect(jsonPath("$", hasKey("instance")))
|
||||
.andExpect(jsonPath("$", hasKey("timestamp")))
|
||||
.andExpect(jsonPath("$", hasKey("traceId")));
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue