feat: QnA 기능 구현

src/main/java/Gotcha/domain/inquiry/api/AdminInquiryApi.java

@@ -0,0 +1,61 @@
+package Gotcha.domain.inquiry.api;
+
+import Gotcha.common.jwt.auth.SecurityUserDetails;
+import Gotcha.domain.inquiry.dto.AnswerReq;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.ExampleObject;
+import io.swagger.v3.oas.annotations.parameters.RequestBody;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.PathVariable;
+
+@Tag(name = "[관리자 QnA API]", description = "관리자 QnA 처리 관련 API")
+public interface AdminInquiryApi {
+
+    @Operation(summary = "QnA 답변 생성", description = "QnA 답변 생성 API")
+    @ApiResponses({
+            @ApiResponse(responseCode = "200", description = "QnA 답변 생성 성공",
+                    content = @Content(mediaType = "application/json", examples = {
+                            @ExampleObject(value = """
+                    {
+                        "status": "OK",
+                        "message": "QnA 답변 생성에 성공했습니다."
+                    }
+                    """)
+                    })
+            ),
+            @ApiResponse(responseCode = "400", description = "필드 검증 오류",
+                    content = @Content(mediaType = "application/json", examples = {
+                            @ExampleObject(value = """
+                    {
+                        "status": "BAD_REQUEST",
+                        "message": "필드 검증 오류입니다.",
+                        "fields": {
+                            "content": "내용은 필수 입력 사항입니다."
+                        }
+                    }
+                    """)
+                    })
+            ),
+            @ApiResponse(responseCode = "403", description = "권한 없음",
+                    content = @Content(mediaType = "application/json", examples = {
+                            @ExampleObject(value = """
+                    {
+                        "status": "FORBIDDEN",
+                        "message": "권한이 없습니다."
+                    }
+                    """)
+                    })
+            )
+    })
+    ResponseEntity<?> createAnswer(@Valid @RequestBody AnswerReq answerReq, @PathVariable(value = "inquiryId")Long inquiryId,
+                                   @AuthenticationPrincipal SecurityUserDetails userDetails);
+
+
+
+}

src/main/java/Gotcha/domain/inquiry/controller/AdminInquiryController.java

@@ -0,0 +1,38 @@
+package Gotcha.domain.inquiry.controller;
+
+import Gotcha.common.api.SuccessRes;
+import Gotcha.common.jwt.auth.SecurityUserDetails;
+import Gotcha.domain.inquiry.api.AdminInquiryApi;
+import Gotcha.domain.inquiry.dto.AnswerReq;
+import Gotcha.domain.inquiry.entity.Inquiry;
+import Gotcha.domain.inquiry.service.AnswerService;
+import Gotcha.domain.inquiry.service.InquiryService;
+import Gotcha.domain.user.entity.User;
+import Gotcha.domain.user.service.UserService;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.*;
+
+@RestController
+@RequestMapping("/api/v1/admin/qnas/")
+@RequiredArgsConstructor
+public class AdminInquiryController implements AdminInquiryApi {
+
+    private final AnswerService answerService;
+
+    private final InquiryService inquiryService;
+
+    private final UserService userService;
+
+    @Override
+    @PostMapping("/{inquiryId}/answer")
+    public ResponseEntity<?> createAnswer(@Valid @RequestBody AnswerReq answerReq, @PathVariable(value = "inquiryId") Long inquiryId,
+                                          @AuthenticationPrincipal SecurityUserDetails securityUserDetails) {
+        Inquiry inquiry = inquiryService.findInquiryById(inquiryId);
+        User writer = userService.findUserByUserId(securityUserDetails.getId());
+        answerService.createAnswer(answerReq, inquiry, writer);
+        return ResponseEntity.ok(SuccessRes.from("QnA 답변 생성에 성공했습니다."));
+    }
+}

src/main/java/Gotcha/domain/inquiry/controller/InquiryController.java

@@ -0,0 +1,86 @@
+package Gotcha.domain.inquiry.controller;
+
+import Gotcha.common.api.SuccessRes;
+import Gotcha.common.jwt.auth.SecurityUserDetails;
+import Gotcha.domain.inquiry.api.InquiryApi;
+import Gotcha.domain.inquiry.dto.InquiryReq;
+import Gotcha.domain.inquiry.dto.InquiryRes;
+import Gotcha.domain.inquiry.dto.InquirySortType;
+import Gotcha.domain.inquiry.dto.InquirySummaryRes;
+import Gotcha.domain.inquiry.service.InquiryService;
+import Gotcha.domain.user.entity.User;
+import Gotcha.domain.user.service.UserService;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.Min;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.*;
+
+@RestController
+@RequestMapping("/api/v1/qnas")
+@RequiredArgsConstructor
+public class InquiryController implements InquiryApi {
+
+    private final InquiryService inquiryService;
+
+    private final UserService userService;
+
+    @Override
+    @GetMapping
+    public ResponseEntity<?> getInquiries(@RequestParam(value = "keyword", required = false) String keyword,
+                                   @RequestParam(value = "page", defaultValue = "0") @Min(0) Integer page,
+                                   @RequestParam(value = "sort", defaultValue = "DATE_DESC")InquirySortType sort,
+                                   @RequestParam(value = "isSolved", required = false) Boolean isSolved) {
+        Page<InquirySummaryRes> inquiries = inquiryService.getInquiries(keyword, page, sort, isSolved);
+
+        return ResponseEntity.status(HttpStatus.OK).body(inquiries);
+    }
+
+    @Override
+    @GetMapping("/mine")
+    public ResponseEntity<?> getMyInquiries(@RequestParam(value = "keyword", required = false) String keyword,
+                                            @RequestParam(value = "page", defaultValue = "0") @Min(0) Integer page,
+                                            @RequestParam(value = "sort", defaultValue = "DATE_DESC") InquirySortType sort,
+                                            @RequestParam(value = "isSolved", required = false) Boolean isSolved,
+                                            @AuthenticationPrincipal SecurityUserDetails userDetails) {
+        Page<InquirySummaryRes> myInquiries = inquiryService.getMyInquiries(keyword, page, sort, isSolved, userDetails.getId());
+
+        return ResponseEntity.status(HttpStatus.OK).body(myInquiries);
+    }
+
+    @Override
+    @GetMapping("/{inquiryId}")
+    public ResponseEntity<?> getInquiryById(@PathVariable(value = "inquiryId") Long inquiryId) {
+        InquiryRes inquiryRes = inquiryService.getInquiryById(inquiryId);
+        return ResponseEntity.status(HttpStatus.OK).body(inquiryRes);
+    }
+
+    @Override
+    @PostMapping
+    public ResponseEntity<?> createInquiry(@Valid @RequestBody InquiryReq inquiryReq,
+                                           @AuthenticationPrincipal SecurityUserDetails userDetails) {
+        User writer = userService.findUserByUserId(userDetails.getId());
+        inquiryService.createInquiry(inquiryReq, writer);
+        return ResponseEntity.ok(SuccessRes.from("QnA 생성에 성공했습니다."));
+    }
+
+    @Override
+    @PutMapping("/{inquiryId}")
+    public ResponseEntity<?> updateInquiry(@PathVariable(value = "inquiryId") Long inquiryId,
+                                           @Valid @RequestBody InquiryReq inquiryReq,
+                                           @AuthenticationPrincipal SecurityUserDetails userDetails) {
+        inquiryService.updateInquiry(inquiryReq, inquiryId, userDetails.getId());
+        return ResponseEntity.ok(SuccessRes.from("QnA 수정에 성공했습니다."));
+    }
+
+    @Override
+    @DeleteMapping("/{inquiryId}")
+    public ResponseEntity<?> deleteInquiry(@PathVariable(value = "inquiryId") Long inquiryId,
+                                           @AuthenticationPrincipal SecurityUserDetails userDetails) {
+        inquiryService.deleteInquiry(inquiryId, userDetails.getId());
+        return ResponseEntity.status(HttpStatus.NO_CONTENT).build();
+    }
+}

src/main/java/Gotcha/domain/inquiry/dto/AnswerReq.java

@@ -0,0 +1,19 @@
+package Gotcha.domain.inquiry.dto;
+
+import Gotcha.domain.inquiry.entity.Answer;
+import Gotcha.domain.user.entity.User;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+
+public record AnswerReq(
+        @Schema(description = "답변 내용", example = "감사합니묘! 더 발전하는 갓챠가 되겠습니묘!")
+        @NotBlank(message = "답변 내용은 필수 입력 사항입니다.")
+        String content
+) {
+        public Answer toEntity(User writer){
+                return Answer.builder().
+                        content(content)
+                        .writer(writer)
+                        .build();
+        }
+}

src/main/java/Gotcha/domain/inquiry/dto/AnswerRes.java

@@ -0,0 +1,20 @@
+package Gotcha.domain.inquiry.dto;
+
+import Gotcha.domain.inquiry.entity.Answer;
+
+import java.time.LocalDateTime;
+
+public record AnswerRes(
+        String writer,
+        String content,
+        LocalDateTime createdAt
+) {
+    public static AnswerRes fromEntity(Answer answer){
+        if (answer == null) return null;
+        return new AnswerRes(
+                answer.getWriter().getNickname(),
+                answer.getContent(),
+                answer.getCreatedAt()
+        );
+    }
+}

src/main/java/Gotcha/domain/inquiry/dto/InquiryReq.java

@@ -0,0 +1,33 @@
+package Gotcha.domain.inquiry.dto;
+
+import Gotcha.domain.inquiry.entity.Inquiry;
+import Gotcha.domain.user.entity.User;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+
+public record InquiryReq(
+        @Schema(description = "QnA 제목", example = "게임이 너무 재밌는 것 같아요!")
+        @NotBlank(message = "제목은 필수 입력 사항입니다.")
+        String title,
+
+        @Schema(description = "QnA 질문 내용", example = "이 편지는 영국에서 최초로 시작되어 일년에 한바퀴를 돌면서 받는 사람에게 행운을 주었고 지금은 당신에게로 옮겨진 이 편지는 4일 안에 당신 곁을 ...더보기")
+        @NotBlank(message = "내용은 필수 입력 사항입니다.")
+        String content,
+
+        @Schema(description = "비공개 여부", example = "false", defaultValue = "false")
+        Boolean isPrivate
+) {
+    public InquiryReq {
+        if (isPrivate == null) {
+            isPrivate = false;  // default value
+        }
+    }
+    public Inquiry toEntity(User writer){
+        return Inquiry.builder().
+                title(title).
+                content(content).
+                writer(writer).
+                isSecret(isPrivate).
+                build();
+    }
+}

src/main/java/Gotcha/domain/inquiry/dto/InquiryRes.java

@@ -0,0 +1,29 @@
+package Gotcha.domain.inquiry.dto;
+
+import Gotcha.domain.inquiry.entity.Inquiry;
+
+import java.time.LocalDateTime;
+
+public record InquiryRes(
+        Long inquiryId,
+        String title,
+        String writer,
+        String content,
+        Boolean isPrivate,
+        LocalDateTime createdAt,
+        Boolean isSolved,
+        AnswerRes answer
+) {
+    public static InquiryRes fromEntity(Inquiry inquiry){
+        return new InquiryRes(
+                inquiry.getId(),
+                inquiry.getTitle(),
+                inquiry.getWriter().getNickname(),
+                inquiry.getContent(),
+                inquiry.getIsSecret(),
+                inquiry.getCreatedAt(),
+                inquiry.getIsSolved(),
+                AnswerRes.fromEntity(inquiry.getAnswer())
+        );
+    }
+}

src/main/java/Gotcha/domain/inquiry/dto/InquirySortType.java

@@ -0,0 +1,21 @@
+package Gotcha.domain.inquiry.dto;
+
+import org.springframework.data.domain.Sort;
+
+public enum InquirySortType {
+    DATE_DESC("createdAt", Sort.Direction.DESC),
+    DATE_ASC("createdAt", Sort.Direction.ASC);
+
+    private final String type;
+    private final Sort.Direction direction;
+
+    InquirySortType(String type, Sort.Direction direction){
+        this.type = type;
+        this.direction = direction;
+    }
+
+    public Sort getSort(){
+        return Sort.by(direction, type);
+    }
+
+}

src/main/java/Gotcha/domain/inquiry/dto/InquirySummaryRes.java

@@ -0,0 +1,25 @@
+package Gotcha.domain.inquiry.dto;
+
+import Gotcha.domain.inquiry.entity.Inquiry;
+
+import java.time.LocalDateTime;
+
+public record InquirySummaryRes(
+        Long inquiryId,
+        String title,
+        String writer,
+        Boolean isPrivate,
+        LocalDateTime createdAt,
+        Boolean isSolved
+) {
+    public static InquirySummaryRes fromEntity(Inquiry inquiry){
+        return new InquirySummaryRes(
+                inquiry.getId(),
+                inquiry.getTitle(),
+                inquiry.getWriter().getNickname(),
+                inquiry.getIsSecret(),
+                inquiry.getCreatedAt(),
+                inquiry.getIsSolved()
+        );
+    }
+}

src/main/java/Gotcha/domain/inquiry/entity/Answer.java

@@ -10,10 +10,7 @@
 import jakarta.persistence.JoinColumn;
 import jakarta.persistence.ManyToOne;
 import jakarta.persistence.OneToOne;
-import lombok.AccessLevel;
-import lombok.Builder;
-import lombok.Getter;
-import lombok.NoArgsConstructor;
+import lombok.*;
 
 @Getter
 @Entity
@@ -29,11 +26,13 @@ public class Answer extends BaseTimeEntity {
     @JoinColumn(name = "user_id")
     private User writer;
 
+    @Setter
     @OneToOne(mappedBy = "answer", fetch = FetchType.LAZY)
     private Inquiry inquiry;
 
     @Builder
-    public Answer(String content){
+    public Answer(String content, User writer){
         this.content = content;
+        this.writer = writer;
     }
 }