TaskController.java

역할

• 클라이언트 요청 처리 (업무 조회, 생성, 상세 조회)
• 서비스 계층 (TaskCommandService, TaskQueryService) 호출
• 인증 정보는 Spring Security의 @AuthenticationPrincipal로 가져옴
• 예외 처리(인증 실패, 데이터 없음 등)는 서비스에서 ApiException 등으로 처리하고, 글로벌 핸들러에서 JSON 응답으로 통일

1. 업무 목록 조회 (GET /api/tasks)

@GetMapping
public ResponseEntity<PageResponse<TaskResponse>> list(
    @RequestParam(name = "scope", required = false, defaultValue = "all") String scope,
    @RequestParam(name = "status", required = false) TaskStatus status,
    @RequestParam(name = "page", required = false, defaultValue = "0") int page,
    @RequestParam(name = "size", required = false, defaultValue = "9") int size,
    @AuthenticationPrincipal UserDetails principal
) {
    Long userId = Long.parseLong(principal.getUsername()); 
    Page<TaskResponse> result = taskQueryService.list(scope, status, userId, page, size);
    return ResponseEntity.ok(PageResponse.from(result));
}

설명:

• scope: 조회 범위 (all, my, dept)
• status: 업무 상태 필터 (TODO, IN_PROGRESS, DONE 등)
• page / size: 페이징 처리
• 로그인 사용자 정보(principal)에서 userId 가져와 서비스 호출
• 반환은 PageResponse<TaskResponse> 형태 → 클라이언트에서 페이징 UI 사용 가능

2. 업무 생성 (POST /api/tasks/create)

@PostMapping("/create")
public ResponseEntity<TaskResponse> create(
        @Valid @RequestBody TaskCreateRequest req,
        @AuthenticationPrincipal UserDetails principal
) {
    if (principal == null) return ResponseEntity.status(401).build(); 

    Long userId = Long.parseLong(principal.getUsername());
    return ResponseEntity.ok(taskCommandService.create(req, userId));
}

설명:

• 요청 DTO TaskCreateRequest로 업무 정보 전달