vpd-permission-poc/docs/design/424-spring-boot-vpd-backoffice/fn-savePermissionSet.md

함수 설계서: savePermissionSet (#424)

부모 설계서: ./README.md · 상태: Draft 작성: [AI] Architect · 구현: PermissionService.savePermissionSet · 테스트: PermissionServiceTest

1. 시그니처

PermissionSet savePermissionSet(PermissionSetCommand command)

2. 책임 (단일 책임, 1줄)

역할과 보호 객체에 대한 행 규칙 및 컬럼 표시 정책을 검증한 뒤 하나의 transaction으로 저장한다.

3. 입력

파라미터	타입	제약/검증	설명
command.roleId	long	존재하는 역할	권한을 받을 역할
command.objectId	long	활성 보호 객체	조회 대상 객체
command.action	String	초기 구현은 SELECT만 허용	작업 유형
command.rules	List<RuleCommand>	1개 이상, 타입별 값 검증	행 조건
command.visibleColumns	List<String>	보호 객체에 등록된 컬럼만 허용	표시 허용 컬럼

4. 출력

• 반환: 저장된 PermissionSet
• 부수효과: permission/rule/column mapping 갱신, audit insert

5. 동작 / 알고리즘

1. 역할이 존재하는지 확인한다.
2. 보호 객체가 whitelist에 있고 활성 상태인지 확인한다.
3. action이 허용 값인지 확인한다.
4. rule 목록이 비어 있으면 실패한다.
5. rule type별 rule value 형식을 검증한다.
6. 중복 rule을 제거하거나 실패 처리한다. 초기 구현은 실패 처리한다.
7. 표시 컬럼 목록이 보호 객체 컬럼 목록의 부분집합인지 확인한다.
8. transaction 안에서 기존 권한 세트를 갱신한다.
9. audit log를 저장한다.
10. 저장된 권한 세트를 다시 조회해 반환한다.

6. 에러 & 실패 모드

조건	처리	반환/예외
역할 없음	저장 중단	RoleNotFoundException
보호 객체 없음/비활성	저장 중단	ProtectedObjectNotFoundException
허용되지 않은 action	저장 중단	InvalidPermissionActionException
rule 없음	저장 중단	InvalidPermissionRuleException
rule value 형식 오류	저장 중단	InvalidPermissionRuleException
컬럼 whitelist 위반	저장 중단	InvalidColumnPolicyException
audit 저장 실패	rollback	DataAccessException

7. 엣지케이스

• ALL rule과 다른 제한 rule이 같이 들어오면 충돌로 보고 실패한다.
• SELF rule은 대상 객체에 사용자 식별 컬럼이 등록되어 있어야 허용한다.
• MY_DEPT rule은 대상 객체에 부서 컬럼이 등록되어 있어야 허용한다.
• 컬럼 목록이 빈 값이면 민감 컬럼 표시 없음으로 처리한다.

8. 복잡도 / 성능

• rule/column 검증은 입력 목록 크기에 대해 O(n)이다.
• 운영자 저장 작업 단위이므로 대량 처리 성능은 주요 병목이 아니다.

9. 의존성

• RoleMapper
• ProtectedObjectMapper
• PermissionMapper
• AuditService
• ObjectNamePolicy

10. 테스트 케이스

• 정상: SELECT 권한과 REGION rule 저장
• 정상: 민감 컬럼 제외 정책 저장
• 실패: ALL과 REGION rule 동시 입력
• 실패: 비활성 보호 객체 입력
• 실패: 등록되지 않은 컬럼 입력
• 실패: audit 저장 실패 시 permission 저장 rollback

11. 추적성

• 인수조건: #424의 "내부 사용자, 역할, 사용자-역할, 객체 권한, 행 규칙, 컬럼 표시 권한을 백오피스에서 조회하고 저장할 수 있다."
• 관련 ADR: 없음