TaskQueryService.java

역할

• 업무 조회 관련 로직 처리 (목록 조회, 상세 조회, KPI)
• 서비스에서 발생한 예외는 ApiException → 글로벌 핸들러 처리

1. 업무 목록 조회 (list)

public Page<TaskResponse> list(String scope, TaskStatus status, Long userId, int page, int size) {
    if (userId == null) throw new ApiException(ErrorCode.UNAUTHORIZED, "로그인이 필요합니다.");

    if (scope == null || scope.isBlank()) scope = "all";

    Pageable pageable = PageRequest.of(
            Math.max(page, 0),
            Math.min(Math.max(size, 1), 100),
            Sort.by(Sort.Direction.DESC, "createdAt")
    );

    UserEntity me = userRepository.findById(userId)
            .orElseThrow(() -> new ApiException(ErrorCode.UNAUTHORIZED, "사용자가 존재하지 않습니다."));
    Long myDeptId = me.getDepartment().getId();

    Page<TaskEntity> result;

    switch (scope) {
        case "all" -> result = (status == null)
                ? taskRepository.findAllVisibleForUser(userId, myDeptId, pageable)
                : taskRepository.findAllVisibleForUserByStatus(userId, myDeptId, status, pageable);

        case "public" -> result = (status == null)
                ? taskRepository.findPublicOnly(pageable)
                : taskRepository.findPublicOnlyByStatus(status, pageable);

        case "team" -> result = (status == null)
                ? taskRepository.findTeamVisibleForUser(userId, myDeptId, pageable)
                : taskRepository.findTeamVisibleForUserByStatus(userId, myDeptId, status, pageable);

        case "created" -> result = (status == null)
                ? taskRepository.findByIsDeletedFalseAndCreatedBy_Id(userId, pageable)
                : taskRepository.findByIsDeletedFalseAndCreatedBy_IdAndStatus(userId, status, pageable);

        case "assigned" -> result = (status == null)
                ? taskRepository.findByIsDeletedFalseAndAssignee_Id(userId, pageable)
                : taskRepository.findByIsDeletedFalseAndAssignee_IdAndStatus(userId, status, pageable);

        default -> throw new ApiException(ErrorCode.BAD_REQUEST, "scope 값이 올바르지 않습니다. (all|public|team|created|assigned)");
    }

    return result.map(t -> {
        long cnt = attachmentService.countActiveByTask(t.getId());
        return TaskResponse.from(t, cnt);
    });
}

설명 + 포인트

• 로그인 체크 → 없으면 401 UNAUTHORIZED
• scope 기본값 처리 → all
• 페이지네이션 → 최소 1, 최대 100, 최신순 정렬
• 사용자 부서 조회 → 팀/부서 업무 판단용
• scope + status 기반 repository 호출
• DTO 변환 → 목록에서는 첨부파일 리스트 제외, count만 포함
• 예외 처리 → 범위 오류 400 BAD_REQUEST

보안/최적화 포인트

• 조회 가능한 Task만 가져오기 → 권한/visibility 체크 포함
• EntityGraph를 통한 N+1 방지
• 첨부파일은 count만 가져와서 성능 최적화

흐름도