역할

• 업무 목록 조회 시 범위를 지정하는 Enum
• Controller에서 scope 파라미터로 사용
• Service 계층에서 조건 분기 가능 (ALL, CREATED, ASSIGNED)

활용 예시 (Controller)

@GetMapping
public ResponseEntity<PageResponse<TaskResponse>> list(
    @RequestParam(name = "scope", required = false, defaultValue = "ALL") TaskScope scope,
    @AuthenticationPrincipal UserDetails principal
) {
    Long userId = Long.parseLong(principal.getUsername());
    Page<TaskResponse> result = taskQueryService.list(scope, userId);
    return ResponseEntity.ok(PageResponse.from(result));
}

• 클라이언트가 scope=CREATED → 자신이 생성한 업무만 조회
• scope=ASSIGNED → 자신이 담당자로 배정된 업무만 조회
• scope=ALL → 전체 업무 조회

<aside> 💡

포인트

• TaskScope는 조회 필터 역할
• Controller에서 바로 매핑 가능 (Spring @RequestParam Enum 변환 지원)
• Service에서 switch(scope)로 조건 분기 → DB 쿼리 최적화 가능 </aside>