Q&A 기능 추가

backend/ddang/src/docs/asciidoc/docs.adoc

@@ -104,12 +104,12 @@ include::{snippets}/user-controller-test/사용자_정보를_조회한다/respon
 
 ==== 요청
 
-include::{snippets}/user-controller-test/사용자_정보를_수정한다/http-request.adoc[]
+include::{snippets}/user-controller-test/사용자_정보를_모두_수정한다/http-request.adoc[]
 
 ==== 응답
 
-include::{snippets}/user-controller-test/사용자_정보를_수정한다/http-response.adoc[]
-include::{snippets}/user-controller-test/사용자_정보를_수정한다/response-fields.adoc[]
+include::{snippets}/user-controller-test/사용자_정보를_모두_수정한다/http-response.adoc[]
+include::{snippets}/user-controller-test/사용자_정보를_모두_수정한다/response-fields.adoc[]
 
 == 카테고리 API
 
@@ -251,6 +251,67 @@ include::{snippets}/auction-controller-test/지정한_아이디에_해당하는_
 
 include::{snippets}/auction-controller-test/지정한_아이디에_해당하는_경매를_삭제한다/http-response.adoc[]
 
+== Q&A API
+
+=== 질문 등록
+
+==== 요청
+
+include::{snippets}/qna-controller-test/질문을_등록한다/http-request.adoc[]
+include::{snippets}/qna-controller-test/질문을_등록한다/request-headers.adoc[]
+include::{snippets}/qna-controller-test/질문을_등록한다/request-fields.adoc[]
+
+==== 응답
+
+include::{snippets}/qna-controller-test/질문을_등록한다/http-response.adoc[]
+
+=== 질문 삭제
+
+==== 요청
+
+include::{snippets}/qna-controller-test/질문을_삭제한다/http-request.adoc[]
+include::{snippets}/qna-controller-test/질문을_삭제한다/request-headers.adoc[]
+include::{snippets}/qna-controller-test/질문을_삭제한다/path-parameters.adoc[]
+
+==== 응답
+
+include::{snippets}/qna-controller-test/질문을_삭제한다/http-response.adoc[]
+
+=== 답변 등록
+
+==== 요청
+
+include::{snippets}/qna-controller-test/답변을_등록한다/http-request.adoc[]
+include::{snippets}/qna-controller-test/답변을_등록한다/request-headers.adoc[]
+include::{snippets}/qna-controller-test/답변을_등록한다/request-fields.adoc[]
+
+==== 응답
+
+include::{snippets}/qna-controller-test/답변을_등록한다/http-response.adoc[]
+
+=== 답변 삭제
+
+==== 요청
+
+include::{snippets}/qna-controller-test/답변을_삭제한다/http-request.adoc[]
+include::{snippets}/qna-controller-test/답변을_삭제한다/request-headers.adoc[]
+include::{snippets}/qna-controller-test/답변을_삭제한다/path-parameters.adoc[]
+
+==== 응답
+
+include::{snippets}/qna-controller-test/답변을_삭제한다/http-response.adoc[]
+
+=== Q&A 조회
+
+==== 요청
+
+include::{snippets}/auction-qna-controller-test/경매_아이디를_통해_질문과_답변을_모두_조회한다/http-request.adoc[]
+
+==== 응답
+
+include::{snippets}/auction-qna-controller-test/경매_아이디를_통해_질문과_답변을_모두_조회한다/http-response.adoc[]
+include::{snippets}/auction-qna-controller-test/경매_아이디를_통해_질문과_답변을_모두_조회한다/response-fields.adoc[]
+
 == 입찰 API
 
 === 입찰 등록
@@ -391,6 +452,52 @@ include::{snippets}/report-controller-test/전체_채팅방_신고_목록을_조
 include::{snippets}/report-controller-test/전체_채팅방_신고_목록을_조회한다/http-response.adoc[]
 include::{snippets}/report-controller-test/전체_채팅방_신고_목록을_조회한다/response-fields.adoc[]
 
+=== 질문 신고 등록
+
+==== 요청
+
+include::{snippets}/report-controller-test/질문_신고를_등록한다/http-request.adoc[]
+include::{snippets}/report-controller-test/질문_신고를_등록한다/request-headers.adoc[]
+include::{snippets}/report-controller-test/질문_신고를_등록한다/request-fields.adoc[]
+
+==== 응답
+
+include::{snippets}/report-controller-test/질문_신고를_등록한다/http-response.adoc[]
+
+=== 채팅방 신고 조회
+
+==== 요청
+
+include::{snippets}/report-controller-test/전체_질문_신고_목록을_조회한다/http-request.adoc[]
+
+==== 응답
+
+include::{snippets}/report-controller-test/전체_질문_신고_목록을_조회한다/http-response.adoc[]
+include::{snippets}/report-controller-test/전체_질문_신고_목록을_조회한다/response-fields.adoc[]
+
+=== 답변 신고 등록
+
+==== 요청
+
+include::{snippets}/report-controller-test/답변_신고를_등록한다/http-request.adoc[]
+include::{snippets}/report-controller-test/답변_신고를_등록한다/request-headers.adoc[]
+include::{snippets}/report-controller-test/답변_신고를_등록한다/request-fields.adoc[]
+
+==== 응답
+
+include::{snippets}/report-controller-test/답변_신고를_등록한다/http-response.adoc[]
+
+=== 채팅방 신고 조회
+
+==== 요청
+
+include::{snippets}/report-controller-test/전체_답변_신고_목록을_조회한다/http-request.adoc[]
+
+==== 응답
+
+include::{snippets}/report-controller-test/전체_답변_신고_목록을_조회한다/http-response.adoc[]
+include::{snippets}/report-controller-test/전체_답변_신고_목록을_조회한다/response-fields.adoc[]
+
 == 디바이스 토큰 API
 
 === 디바이스 토큰 갱신

backend/ddang/src/main/java/com/ddang/ddang/auction/infrastructure/persistence/JpaAuctionRepository.java

@@ -3,5 +3,9 @@
 import com.ddang.ddang.auction.domain.Auction;
 import org.springframework.data.jpa.repository.JpaRepository;
 
+import java.util.Optional;
+
 public interface JpaAuctionRepository extends JpaRepository<Auction, Long>, QuerydslAuctionRepository, QuerydslAuctionAndImageRepository {
+
+    Optional<Auction> findByIdAndDeletedIsFalse(final Long id);
 }

backend/ddang/src/main/java/com/ddang/ddang/auction/presentation/AuctionQnaController.java

@@ -0,0 +1,27 @@
+package com.ddang.ddang.auction.presentation;
+
+import com.ddang.ddang.auction.presentation.dto.response.ReadQnasResponse;
+import com.ddang.ddang.qna.application.QuestionService;
+import com.ddang.ddang.qna.application.dto.ReadQnasDto;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/auctions")
+@RequiredArgsConstructor
+public class AuctionQnaController {
+
+    private final QuestionService questionService;
+
+    @GetMapping("/{auctionId}/questions")
+    public ResponseEntity<ReadQnasResponse> readAllByAuctionId(@PathVariable final Long auctionId) {
+        final ReadQnasDto readQnasDto = questionService.readAllByAuctionId(auctionId);
+        final ReadQnasResponse response = ReadQnasResponse.from(readQnasDto);
+
+        return ResponseEntity.ok(response);
+    }
+}

backend/ddang/src/main/java/com/ddang/ddang/auction/presentation/dto/response/ReadAnswerResponse.java

@@ -0,0 +1,27 @@
+package com.ddang.ddang.auction.presentation.dto.response;
+
+import com.ddang.ddang.qna.application.dto.ReadAnswerDto;
+import com.fasterxml.jackson.annotation.JsonFormat;
+
+import java.time.LocalDateTime;
+
+public record ReadAnswerResponse(
+        Long id,
+
+        ReadUserInAuctionQuestionResponse writer,
+
+        @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd'T'HH:mm:ss", timezone = "Asia/Seoul")
+        LocalDateTime createdTime,
+
+        String content
+) {
+
+    public static ReadAnswerResponse from(final ReadAnswerDto readAnswerDto) {
+        return new ReadAnswerResponse(
+                readAnswerDto.id(),
+                ReadUserInAuctionQuestionResponse.from(readAnswerDto.writerDto()),
+                readAnswerDto.createdTime(),
+                readAnswerDto.content()
+        );
+    }
+}

backend/ddang/src/main/java/com/ddang/ddang/auction/presentation/dto/response/ReadQnaResponse.java

@@ -0,0 +1,25 @@
+package com.ddang.ddang.auction.presentation.dto.response;
+
+import com.ddang.ddang.qna.application.dto.ReadAnswerDto;
+import com.ddang.ddang.qna.application.dto.ReadQnaDto;
+
+public record ReadQnaResponse(
+        ReadQuestionResponse question,
+        ReadAnswerResponse answer
+) {
+
+    public static ReadQnaResponse from(final ReadQnaDto readQnaDto) {
+        final ReadQuestionResponse question = ReadQuestionResponse.from(readQnaDto.readQuestionDto());
+        final ReadAnswerResponse answer = processReadAnswerResponse(readQnaDto.readAnswerDto());
+
+        return new ReadQnaResponse(question, answer);
+    }
+
+    private static ReadAnswerResponse processReadAnswerResponse(final ReadAnswerDto readAnswerDto) {
+        if (readAnswerDto == null) {
+            return null;
+        }
+
+        return ReadAnswerResponse.from(readAnswerDto);
+    }
+}

backend/ddang/src/main/java/com/ddang/ddang/auction/presentation/dto/response/ReadQnasResponse.java

@@ -0,0 +1,18 @@
+package com.ddang.ddang.auction.presentation.dto.response;
+
+import com.ddang.ddang.qna.application.dto.ReadQnaDto;
+import com.ddang.ddang.qna.application.dto.ReadQnasDto;
+
+import java.util.List;
+
+public record ReadQnasResponse(List<ReadQnaResponse> qnas) {
+
+    public static ReadQnasResponse from(final ReadQnasDto readQnasDto) {
+        final List<ReadQnaDto> dtos = readQnasDto.readQnaDtos();
+        final List<ReadQnaResponse> readQnaResponses = dtos.stream()
+                                                           .map(ReadQnaResponse::from)
+                                                           .toList();
+
+        return new ReadQnasResponse(readQnaResponses);
+    }
+}

backend/ddang/src/main/java/com/ddang/ddang/auction/presentation/dto/response/ReadQuestionResponse.java

@@ -0,0 +1,27 @@
+package com.ddang.ddang.auction.presentation.dto.response;
+
+import com.ddang.ddang.qna.application.dto.ReadQuestionDto;
+import com.fasterxml.jackson.annotation.JsonFormat;
+
+import java.time.LocalDateTime;
+
+public record ReadQuestionResponse(
+        Long id,
+
+        ReadUserInAuctionQuestionResponse writer,
+
+        @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd'T'HH:mm:ss", timezone = "Asia/Seoul")
+        LocalDateTime createdTime,
+
+        String content
+) {
+
+    public static ReadQuestionResponse from(final ReadQuestionDto readQuestionDto) {
+        return new ReadQuestionResponse(
+                readQuestionDto.id(),
+                ReadUserInAuctionQuestionResponse.from(readQuestionDto.readUserInQnaDto()),
+                readQuestionDto.createdTime(),
+                readQuestionDto.content()
+        );
+    }
+}

backend/ddang/src/main/java/com/ddang/ddang/auction/presentation/dto/response/ReadUserInAuctionQuestionResponse.java

@@ -0,0 +1,18 @@
+package com.ddang.ddang.auction.presentation.dto.response;
+
+import com.ddang.ddang.image.presentation.util.ImageRelativeUrl;
+import com.ddang.ddang.image.presentation.util.ImageUrlCalculator;
+import com.ddang.ddang.qna.application.dto.ReadUserInQnaDto;
+
+public record ReadUserInAuctionQuestionResponse(Long id, String name, String image) {
+
+    public static ReadUserInAuctionQuestionResponse from(
+            final ReadUserInQnaDto writerDto
+    ) {
+        return new ReadUserInAuctionQuestionResponse(
+                writerDto.id(),
+                writerDto.name(),
+                ImageUrlCalculator.calculateBy(ImageRelativeUrl.USER, writerDto.profileImageId())
+        );
+    }
+}

backend/ddang/src/main/java/com/ddang/ddang/exception/GlobalExceptionHandler.java

@@ -23,10 +23,17 @@
 import com.ddang.ddang.image.infrastructure.local.exception.StoreImageFailureException;
 import com.ddang.ddang.image.infrastructure.local.exception.UnsupportedImageFileExtensionException;
 import com.ddang.ddang.notification.application.exception.NotificationFailedException;
+import com.ddang.ddang.qna.application.exception.AlreadyAnsweredException;
+import com.ddang.ddang.qna.application.exception.AnswerNotFoundException;
+import com.ddang.ddang.qna.application.exception.InvalidAnswererException;
+import com.ddang.ddang.qna.application.exception.InvalidAuctionToAskQuestionException;
+import com.ddang.ddang.qna.application.exception.InvalidQuestionerException;
+import com.ddang.ddang.qna.application.exception.QuestionNotFoundException;
 import com.ddang.ddang.region.application.exception.RegionNotFoundException;
 import com.ddang.ddang.report.application.exception.AlreadyReportAuctionException;
 import com.ddang.ddang.report.application.exception.AlreadyReportChatRoomException;
 import com.ddang.ddang.report.application.exception.InvalidChatRoomReportException;
+import com.ddang.ddang.report.application.exception.InvalidQuestionReportException;
 import com.ddang.ddang.report.application.exception.InvalidReportAuctionException;
 import com.ddang.ddang.report.application.exception.InvalidReporterToAuctionException;
 import com.ddang.ddang.review.application.exception.AlreadyReviewException;
@@ -346,6 +353,62 @@ public ResponseEntity<ExceptionResponse> handleReviewNotFoundException(
                              .body(new ExceptionResponse(ex.getMessage()));
     }
 
+    @ExceptionHandler(InvalidAuctionToAskQuestionException.class)
+    public ResponseEntity<ExceptionResponse> handleInvalidAuctionToAskQuestionException(final InvalidAuctionToAskQuestionException ex) {
+        logger.warn(String.format(LOG_MESSAGE_FORMAT, ex.getClass().getSimpleName(), ex.getMessage()));
+
+        return ResponseEntity.status(HttpStatus.BAD_REQUEST)
+                             .body(new ExceptionResponse(ex.getMessage()));
+    }
+
+    @ExceptionHandler(InvalidQuestionerException.class)
+    public ResponseEntity<ExceptionResponse> handleInvalidQuestionerException(final InvalidQuestionerException ex) {
+        logger.warn(String.format(LOG_MESSAGE_FORMAT, ex.getClass().getSimpleName(), ex.getMessage()));
+
+        return ResponseEntity.status(HttpStatus.BAD_REQUEST)
+                             .body(new ExceptionResponse(ex.getMessage()));
+    }
+
+    @ExceptionHandler(QuestionNotFoundException.class)
+    public ResponseEntity<ExceptionResponse> handleQuestionNotFoundException(final QuestionNotFoundException ex) {
+        logger.warn(String.format(LOG_MESSAGE_FORMAT, ex.getClass().getSimpleName(), ex.getMessage()));
+
+        return ResponseEntity.status(HttpStatus.NOT_FOUND)
+                             .body(new ExceptionResponse(ex.getMessage()));
+    }
+
+    @ExceptionHandler(AnswerNotFoundException.class)
+    public ResponseEntity<ExceptionResponse> handleAnswerNotFoundException(final AnswerNotFoundException ex) {
+        logger.warn(String.format(LOG_MESSAGE_FORMAT, ex.getClass().getSimpleName(), ex.getMessage()));
+
+        return ResponseEntity.status(HttpStatus.NOT_FOUND)
+                             .body(new ExceptionResponse(ex.getMessage()));
+    }
+
+    @ExceptionHandler(InvalidAnswererException.class)
+    public ResponseEntity<ExceptionResponse> handleInvalidAnswererException(final InvalidAnswererException ex) {
+        logger.warn(String.format(LOG_MESSAGE_FORMAT, ex.getClass().getSimpleName(), ex.getMessage()));
+
+        return ResponseEntity.status(HttpStatus.BAD_REQUEST)
+                             .body(new ExceptionResponse(ex.getMessage()));
+    }
+
+    @ExceptionHandler(InvalidQuestionReportException.class)
+    public ResponseEntity<ExceptionResponse> handleInvalidQuestionReportException(final InvalidQuestionReportException ex) {
+        logger.warn(String.format(LOG_MESSAGE_FORMAT, ex.getClass().getSimpleName(), ex.getMessage()));
+
+        return ResponseEntity.status(HttpStatus.BAD_REQUEST)
+                             .body(new ExceptionResponse(ex.getMessage()));
+    }
+
+    @ExceptionHandler(AlreadyAnsweredException.class)
+    public ResponseEntity<ExceptionResponse> handleAlreadyAnsweredException(final AlreadyAnsweredException ex) {
+        logger.warn(String.format(LOG_MESSAGE_FORMAT, ex.getClass().getSimpleName(), ex.getMessage()));
+
+        return ResponseEntity.status(HttpStatus.BAD_REQUEST)
+                             .body(new ExceptionResponse(ex.getMessage()));
+    }
+
     @Override
     protected ResponseEntity<Object> handleMethodArgumentNotValid(
             final MethodArgumentNotValidException ex,