7장 · 권한(RBAC) & 예외 처리

User  ──(tb_user_role)──  Role  ──(tb_menu_role)──  Menu
사용자        연결           역할        연결          메뉴

· tb_user_role : 사용자에게 어떤 역할(ROLE_ADMIN 등)이 있는지
· tb_menu_role : 역할이 각 메뉴에서 무엇을 할 수 있는지
                 (읽기/생성/수정/삭제/내보내기 5개 플래그)

// core/model/entity/User.java
public Set<String> getRoleCodes() {            // 역할 코드 목록 (ROLE_ADMIN 등)
    return this.userRoles.stream()
            .map(ur -> ur.getId().getRoleCode())
            .collect(Collectors.toSet());
}

public boolean isReadonly() {                  // ROLE_READONLY 보유 여부
    return hasRole("ROLE_READONLY");
}

@Override
public Collection<? extends GrantedAuthority> getAuthorities() {
    return getRoleCodes().stream()             // 역할 코드를 시큐리티 권한으로
            .map(r -> (GrantedAuthority) () -> r)
            .toList();
}

// core/model/entity/MenuRole.java (발췌)
@Column(name = "can_read")   private Boolean canRead   = false;
@Column(name = "can_create") private Boolean canCreate = false;
@Column(name = "can_update") private Boolean canUpdate = false;
@Column(name = "can_delete") private Boolean canDelete = false;
@Column(name = "can_export") private Boolean canExport = false;

// web/endpoint/MenuEndpoint.java (요지)
boolean isAdmin = userRoles.contains("ROLE_ADMIN");

for (Menu menu : allMenus) {
    if (isAdmin)
        permissionMap.put(menu.getCode(), MenuPermission.fullAccess()); // 전부 허용
    else
        permissionMap.put(menu.getCode(), MenuPermission.noAccess());   // 전부 차단으로 초기화
}

if (!isAdmin && !userRoles.isEmpty()) {
    // 내가 가진 역할들의 메뉴-권한을 한 번에 조회
    List<MenuRole> menuRoles = menuRoleRepo.findAllByRoleCodes(new ArrayList<>(userRoles));
    for (MenuRole mr : menuRoles) {
        var current = permissionMap.getOrDefault(menuCode, MenuPermission.noAccess());
        var rolePerm = new MenuPermission(mr.getCanRead(), mr.getCanCreate(),
                                          mr.getCanUpdate(), mr.getCanDelete(), mr.getCanExport());
        permissionMap.put(menuCode, current.merge(rolePerm)); // ← OR 병합
    }
}

// web/endpoint/RoleEndpoint.java (발췌)
@PostMapping("")
@PreAuthorize("hasRole('ADMIN')")     // 관리자만 역할 생성
public Role create(@Valid @RequestBody RoleCreateRequest request) { ... }

@DeleteMapping("/{code}")
@PreAuthorize("hasRole('ADMIN')")
@Transactional
public void delete(@PathVariable String code) {
    Role role = roleRepo.findById(code).orElseThrow(...);
    if (role.getIsSystem())            // 시스템 필수 역할은 보호
        throw new BizRuleException("시스템 필수 역할은 삭제할 수 없습니다.");
    ...
}

// 다른 메서드들 — 올바름
@PreAuthorize("hasRole('ADMIN')")        // 검사 대상: ROLE_ADMIN

// updatePermissions 한 곳만 — 잘못됨
@PreAuthorize("hasRole('ROLE_ADMIN')")   // 검사 대상: ROLE_ROLE_ADMIN (버그)

// web/endpoint/GlobalExceptionHandler.java
@ControllerAdvice           // 모든 컨트롤러의 예외를 가로채는 전역 처리기
@Slf4j
public class GlobalExceptionHandler {

    @ExceptionHandler(BizRuleException.class)
    public ResponseEntity<ActionResult> handleBizRuleException(BizRuleException ex) {
        return ResponseEntity.status(HttpStatus.BAD_REQUEST)
                             .body(ActionResult.fail(ex.getMessage()));
    }
}

// MethodArgumentNotValidException 등 → validationErrors 맵
{
  "status": 400,
  "error": "Bad Request",
  "message": "입력이 올바르지 않습니다",
  "validationErrors": {
    "userid": "필수 입력입니다",
    "email": "이메일 형식이 아닙니다"
  }
}

// BizRuleException, NotFoundException, IllegalArgumentException 등
{
  "ok": false,
  "message": "시스템 필수 역할은 삭제할 수 없습니다.",
  "type": "warn",
  "data": null,
  "errors": null
}

// web/dto/ActionResult.java (요지)
public class ActionResult {
    private boolean ok = false;          // 성공 여부
    private String  message = "";        // 실패 사유 또는 성공 문구
    private String  type;                // success / info / warn
    private Object  data;                // 성공 시 전달할 데이터
    private List<ObjectError> errors;     // 검증 오류 목록(선택)

    public static ActionResult ok(Object data) { ... }   // 성공 + 데이터
    public static ActionResult fail(String message) { ... } // 실패 + 사유
}

// DataIntegrityViolationException 처리 시 제약명으로 메시지 분기 (getConstraintViolationMessage → 500)
if (name.contains("unique"))   return "중복된 데이터가 존재합니다.";
else if (name.contains("fk"))  return "사용 또는 참조 중이므로 삭제할 수 없습니다.";
else if (name.contains("not_null")) return "필수 값이 누락되었습니다.";