gc-guide-api/src/main/java/com/gcsc/guide/controller/IssueController.java

package com.gcsc.guide.controller;

import com.gcsc.guide.dto.*;
import com.gcsc.guide.service.IssueService;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.media.Content;
import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.v3.oas.annotations.responses.ApiResponse;
import io.swagger.v3.oas.annotations.responses.ApiResponses;
import io.swagger.v3.oas.annotations.security.SecurityRequirement;
import io.swagger.v3.oas.annotations.tags.Tag;
import jakarta.validation.Valid;
import lombok.RequiredArgsConstructor;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.domain.Sort;
import org.springframework.data.web.PageableDefault;
import org.springframework.http.ResponseEntity;
import org.springframework.security.core.Authentication;
import org.springframework.web.bind.annotation.*;

import java.net.URI;
import java.util.Map;

@RestController
@RequestMapping("/api/issues")
@RequiredArgsConstructor
@Tag(name = "06. 이슈 관리", description = "이슈 등록/조회/수정 및 코멘트 관리")
@SecurityRequirement(name = "Bearer JWT")
public class IssueController {

    private final IssueService issueService;

    @Operation(summary = "이슈 목록 조회",
        description = "이슈 목록을 페이징으로 조회합니다. status 파라미터로 상태별 필터링이 가능합니다.")
    @ApiResponses({
        @ApiResponse(responseCode = "200", description = "조회 성공"),
        @ApiResponse(responseCode = "401", description = "인증 실패", content = @Content)
    })
    @GetMapping
    public ResponseEntity<Page<IssueResponse>> getIssues(
            @Parameter(description = "이슈 상태 필터 (OPEN, IN_PROGRESS, CLOSED)", example = "OPEN")
            @RequestParam(required = false) String status,
            @Parameter(description = "페이징 파라미터 (page, size, sort)")
            @PageableDefault(size = 20, sort = "createdAt", direction = Sort.Direction.DESC) Pageable pageable) {
        return ResponseEntity.ok(issueService.getIssues(status, pageable));
    }

    @Operation(summary = "이슈 생성",
        description = "새로운 이슈를 생성합니다. 프로젝트명, 위치, Gitea 이슈 링크 등을 선택적으로 포함할 수 있습니다.")
    @ApiResponses({
        @ApiResponse(responseCode = "201", description = "이슈 생성 성공",
            content = @Content(schema = @Schema(implementation = IssueResponse.class))),
        @ApiResponse(responseCode = "401", description = "인증 실패", content = @Content)
    })
    @PostMapping
    public ResponseEntity<IssueResponse> createIssue(
            Authentication authentication,
            @Valid @RequestBody CreateIssueRequest request) {
        Long authorId = (Long) authentication.getPrincipal();
        IssueResponse issue = issueService.createIssue(authorId, request);
        return ResponseEntity.created(URI.create("/api/issues/" + issue.id())).body(issue);
    }

    @Operation(summary = "이슈 상세 조회",
        description = "이슈의 상세 정보와 코멘트 목록을 함께 반환합니다.")
    @ApiResponses({
        @ApiResponse(responseCode = "200", description = "조회 성공"),
        @ApiResponse(responseCode = "401", description = "인증 실패", content = @Content),
        @ApiResponse(responseCode = "404", description = "이슈를 찾을 수 없음", content = @Content)
    })
    @GetMapping("/{id}")
    public ResponseEntity<Map<String, Object>> getIssue(
            @Parameter(description = "이슈 ID", required = true) @PathVariable Long id) {
        return ResponseEntity.ok(issueService.getIssueDetail(id));
    }

    @Operation(summary = "이슈 수정",
        description = "이슈의 제목, 내용, 상태, 우선순위, 담당자 등을 수정합니다.")
    @ApiResponses({
        @ApiResponse(responseCode = "200", description = "수정 성공",
            content = @Content(schema = @Schema(implementation = IssueResponse.class))),
        @ApiResponse(responseCode = "401", description = "인증 실패", content = @Content),
        @ApiResponse(responseCode = "404", description = "이슈를 찾을 수 없음", content = @Content)
    })
    @PutMapping("/{id}")
    public ResponseEntity<IssueResponse> updateIssue(
            @Parameter(description = "이슈 ID", required = true) @PathVariable Long id,
            @RequestBody UpdateIssueRequest request) {
        return ResponseEntity.ok(issueService.updateIssue(id, request));
    }

    @Operation(summary = "코멘트 추가",
        description = "이슈에 새로운 코멘트를 추가합니다.")
    @ApiResponses({
        @ApiResponse(responseCode = "201", description = "코멘트 추가 성공",
            content = @Content(schema = @Schema(implementation = IssueCommentResponse.class))),
        @ApiResponse(responseCode = "401", description = "인증 실패", content = @Content),
        @ApiResponse(responseCode = "404", description = "이슈를 찾을 수 없음", content = @Content)
    })
    @PostMapping("/{id}/comments")
    public ResponseEntity<IssueCommentResponse> addComment(
            @Parameter(description = "이슈 ID", required = true) @PathVariable Long id,
            Authentication authentication,
            @Valid @RequestBody CreateCommentRequest request) {
        Long authorId = (Long) authentication.getPrincipal();
        IssueCommentResponse comment = issueService.addComment(id, authorId, request.body());
        return ResponseEntity.created(URI.create("/api/issues/" + id + "/comments/" + comment.id()))
            .body(comment);
    }
}