feat: 연애 모의고사를 작성한다

src/docs/asciidoc/index.adoc

@@ -9,3 +9,5 @@
 * link:member.adoc[회원 정보 API]
 * link:mission.adoc[미션 API]
 * link:membermissions.adoc[회원 미션 API]
+* link:survey.adoc[연애고사 API]
+* link:membersurveys.adoc[회원 연애고사 API]

src/docs/asciidoc/membersurveys.adoc

@@ -0,0 +1,38 @@
+:toc: left
+:source-highlighter: highlightjs
+:sectlinks:
+:toclevels: 2
+:sectlinks:
+:sectnums:
+
+== MemberSurveys
+
+=== 연애고사 응시 (POST /api/members/me/surveys)
+
+==== 요청
+include::{snippets}/member-surveys-controller-web-mvc-test/회원_연애고사_응시/request-headers.adoc[]
+include::{snippets}/member-surveys-controller-web-mvc-test/회원_연애고사_응시/request-fields.adoc[]
+include::{snippets}/member-surveys-controller-web-mvc-test/회원_연애고사_응시/http-request.adoc[]
+
+==== 응답
+include::{snippets}/member-surveys-controller-web-mvc-test/회원_연애고사_응시/http-response.adoc[]
+
+=== 연애고사 조회 (GET /api/members/me/surveys/{surveyId})
+
+==== 요청
+include::{snippets}/member-surveys-controller-web-mvc-test/회원_연애고사_조회/request-headers.adoc[]
+include::{snippets}/member-surveys-controller-web-mvc-test/회원_연애고사_조회/http-request.adoc[]
+
+==== 응답
+include::{snippets}/member-surveys-controller-web-mvc-test/회원_연애고사_조회/response-fields.adoc[]
+include::{snippets}/member-surveys-controller-web-mvc-test/회원_연애고사_조회/http-response.adoc[]
+
+=== 연애고사 매칭 조회 (GET /api/members/me/surveys/match)
+
+==== 요청
+include::{snippets}/member-surveys-controller-web-mvc-test/회원_연애고사_매칭_조회/request-headers.adoc[]
+include::{snippets}/member-surveys-controller-web-mvc-test/회원_연애고사_매칭_조회/http-request.adoc[]
+
+==== 응답
+include::{snippets}/member-surveys-controller-web-mvc-test/회원_연애고사_매칭_조회/response-fields.adoc[]
+include::{snippets}/member-surveys-controller-web-mvc-test/회원_연애고사_매칭_조회/http-response.adoc[]

src/docs/asciidoc/survey.adoc

@@ -0,0 +1,18 @@
+:toc: left
+:source-highlighter: highlightjs
+:sectlinks:
+:toclevels: 2
+:sectlinks:
+:sectnums:
+
+== Survey
+
+=== 설문 생성 (POST /api/surveys)
+
+==== 요청
+include::{snippets}/survey-controller-web-mvc-test/연애_모의고사_과목_생성/request-fields.adoc[]
+include::{snippets}/survey-controller-web-mvc-test/연애_모의고사_과목_생성/http-request.adoc[]
+
+==== 응답
+include::{snippets}/survey-controller-web-mvc-test/연애_모의고사_과목_생성/response-headers.adoc[]
+include::{snippets}/survey-controller-web-mvc-test/연애_모의고사_과목_생성/http-response.adoc[]

src/main/java/com/atwoz/member/config/AuthConfig.java

@@ -5,14 +5,14 @@
 import com.atwoz.member.ui.auth.interceptor.PathMatcherInterceptor;
 import com.atwoz.member.ui.auth.interceptor.TokenRegenerateInterceptor;
 import com.atwoz.member.ui.auth.support.resolver.AuthArgumentResolver;
-import java.util.List;
 import lombok.RequiredArgsConstructor;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.web.method.support.HandlerMethodArgumentResolver;
 import org.springframework.web.servlet.HandlerInterceptor;
 import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
 import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
 
+import java.util.List;
 import static com.atwoz.member.ui.auth.interceptor.HttpMethod.DELETE;
 import static com.atwoz.member.ui.auth.interceptor.HttpMethod.GET;
 import static com.atwoz.member.ui.auth.interceptor.HttpMethod.OPTIONS;
@@ -39,7 +39,9 @@ private HandlerInterceptor parseMemberIdFromTokenInterceptor() {
         return new PathMatcherInterceptor(parseMemberIdFromTokenInterceptor)
                 .excludePathPattern("/**", OPTIONS)
                 .addPathPatterns("/api/info/**", GET, POST, PATCH)
-                .addPathPatterns("/api/members/me/missions/**", GET, POST, PATCH);
+                .addPathPatterns("/api/surveys/**", GET, POST)
+                .addPathPatterns("/api/members/me/missions/**", GET, POST, PATCH)
+                .addPathPatterns("/api/members/me/surveys/**", GET, POST);
     }
 
     /**
@@ -49,6 +51,7 @@ private HandlerInterceptor loginValidCheckerInterceptor() {
         return new PathMatcherInterceptor(loginValidCheckerInterceptor)
                 .excludePathPattern("/**", OPTIONS)
                 .excludePathPattern("/api/missions/**", GET, POST, PATCH, DELETE)
+                .excludePathPattern("/api/surveys/**", GET, POST)
                 .addPathPatterns("/api/members/**", GET, POST, PATCH, DELETE);
     }
 

src/main/java/com/atwoz/survey/application/membersurvey/MemberSurveysQueryService.java

@@ -0,0 +1,27 @@
+package com.atwoz.survey.application.membersurvey;
+
+import com.atwoz.survey.domain.membersurvey.MemberSurveysRepository;
+import com.atwoz.survey.exception.membersurvey.exceptions.MemberSurveysNotFoundException;
+import com.atwoz.survey.infrastructure.membersurvey.dto.MemberSurveyResponse;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+@RequiredArgsConstructor
+@Transactional(readOnly = true)
+@Service
+public class MemberSurveysQueryService {
+
+    private final MemberSurveysRepository memberSurveysRepository;
+
+    public MemberSurveyResponse findMemberSurvey(final Long memberId, final Long surveyId) {
+        return memberSurveysRepository.findMemberSurvey(memberId, surveyId)
+                .orElseThrow(MemberSurveysNotFoundException::new);
+    }
+
+    public List<Long> findMatchMembers(final Long memberId) {
+        return memberSurveysRepository.findMatchMembers(memberId);
+    }
+}

src/main/java/com/atwoz/survey/application/membersurvey/MemberSurveysService.java

@@ -0,0 +1,83 @@
+package com.atwoz.survey.application.membersurvey;
+
+import com.atwoz.survey.application.membersurvey.dto.SurveySubmitRequest;
+import com.atwoz.survey.domain.membersurvey.MemberSurveys;
+import com.atwoz.survey.domain.membersurvey.MemberSurveysRepository;
+import com.atwoz.survey.domain.membersurvey.dto.SurveySubmitCreateDto;
+import com.atwoz.survey.domain.survey.Survey;
+import com.atwoz.survey.domain.survey.SurveyRepository;
+import com.atwoz.survey.domain.survey.dto.SurveyComparisonRequest;
+import com.atwoz.survey.exception.membersurvey.exceptions.RequiredSurveyNotSubmittedException;
+import com.atwoz.survey.exception.membersurvey.exceptions.SurveySubmitDuplicateException;
+import com.atwoz.survey.exception.survey.exceptions.SurveyNotFoundException;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
+
+@RequiredArgsConstructor
+@Transactional
+@Service
+public class MemberSurveysService {
+
+    private final MemberSurveysRepository memberSurveysRepository;
+    private final SurveyRepository surveyRepository;
+
+    public void submitSurvey(final Long memberId, final List<SurveySubmitRequest> requests) {
+        validateIsAllSubmittedRequiredSurveys(requests);
+
+        MemberSurveys memberSurveys = memberSurveysRepository.findByMemberId(memberId)
+                .orElseGet(() -> createNewMemberSurveysWithMemberId(memberId));
+        validateEachSurveyRequestIsValid(requests);
+        memberSurveys.submitSurveys(convertSurveySubmits(requests));
+    }
+
+    private void validateIsAllSubmittedRequiredSurveys(final List<SurveySubmitRequest> requests) {
+        List<Long> requiredSurveyIds = surveyRepository.findAllRequiredSurveyIds();
+        Set<Long> submittedSurveyIds = extractSubmittedSurveyIds(requests);
+
+        if (!submittedSurveyIds.containsAll(requiredSurveyIds)) {
+            throw new RequiredSurveyNotSubmittedException();
+        }
+    }
+
+    private Set<Long> extractSubmittedSurveyIds(final List<SurveySubmitRequest> requests) {
+        List<Long> submittedSurveyIds = requests.stream()
+                .map(SurveySubmitRequest::surveyId)
+                .toList();
+        HashSet<Long> surveyIds = new HashSet<>(submittedSurveyIds);
+
+        validateSurveyIdNotDuplicated(surveyIds, submittedSurveyIds);
+
+        return surveyIds;
+    }
+
+    private void validateSurveyIdNotDuplicated(final HashSet<Long> surveyIds, final List<Long> submittedSurveyIds) {
+        if (surveyIds.size() != submittedSurveyIds.size()) {
+            throw new SurveySubmitDuplicateException();
+        }
+    }
+
+    private MemberSurveys createNewMemberSurveysWithMemberId(final Long memberId) {
+        MemberSurveys memberSurveys = MemberSurveys.createWithMemberId(memberId);
+        return memberSurveysRepository.save(memberSurveys);
+    }
+
+    private void validateEachSurveyRequestIsValid(final List<SurveySubmitRequest> requests) {
+        requests.forEach(request -> {
+                    Survey survey = surveyRepository.findById(request.surveyId())
+                            .orElseThrow(SurveyNotFoundException::new);
+                    SurveyComparisonRequest comparisonRequest = SurveyComparisonRequest.from(request);
+                    survey.validateIsValidSubmitSurveyRequest(comparisonRequest);
+                });
+    }
+
+    private List<SurveySubmitCreateDto> convertSurveySubmits(final List<SurveySubmitRequest> requests) {
+        return requests.stream()
+                .map(SurveySubmitCreateDto::from)
+                .toList();
+    }
+}

src/main/java/com/atwoz/survey/application/membersurvey/dto/SurveyQuestionSubmitRequest.java

@@ -0,0 +1,11 @@
+package com.atwoz.survey.application.membersurvey.dto;
+
+import jakarta.validation.constraints.NotNull;
+
+public record SurveyQuestionSubmitRequest(
+        @NotNull(message = "응시할 연애고사 질문 id가 작성되어야 합니다.")
+        Long questionId,
+        @NotNull(message = "응시할 연애고사 답변 번호가 작성되어야 합니다.")
+        Integer answerNumber
+) {
+}

src/main/java/com/atwoz/survey/application/membersurvey/dto/SurveySubmitRequest.java

@@ -0,0 +1,13 @@
+package com.atwoz.survey.application.membersurvey.dto;
+
+import jakarta.validation.constraints.NotNull;
+
+import java.util.List;
+
+public record SurveySubmitRequest(
+        @NotNull(message = "응시할 연애고사 과목 id가 작성되어야 합니다.")
+        Long surveyId,
+        @NotNull(message = "응시할 연애고사 질문이 작성되어야 합니다.")
+        List<SurveyQuestionSubmitRequest> questions
+) {
+}

src/main/java/com/atwoz/survey/application/survey/SurveyService.java

@@ -0,0 +1,31 @@
+package com.atwoz.survey.application.survey;
+
+import com.atwoz.survey.application.survey.dto.SurveyCreateRequest;
+import com.atwoz.survey.domain.survey.Survey;
+import com.atwoz.survey.domain.survey.SurveyRepository;
+import com.atwoz.survey.domain.survey.dto.SurveyCreateDto;
+import com.atwoz.survey.exception.survey.exceptions.SurveyNameAlreadyExistException;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@RequiredArgsConstructor
+@Transactional
+@Service
+public class SurveyService {
+
+    private final SurveyRepository surveyRepository;
+
+    public Survey addSurvey(final SurveyCreateRequest request) {
+        validateIsAlreadyUsedName(request.name());
+        SurveyCreateDto surveyRequest = SurveyCreateDto.from(request);
+
+        return surveyRepository.save(Survey.from(surveyRequest));
+    }
+
+    private void validateIsAlreadyUsedName(final String name) {
+        if (surveyRepository.isExistedByName(name)) {
+            throw new SurveyNameAlreadyExistException();
+        }
+    }
+}

src/main/java/com/atwoz/survey/application/survey/dto/SurveyAnswerCreateRequest.java

@@ -0,0 +1,17 @@
+package com.atwoz.survey.application.survey.dto;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+
+public record SurveyAnswerCreateRequest(
+        @NotNull(message = "답변 번호가 작성되어야 합니다. (ex: 1)")
+        Integer number,
+
+        @NotBlank(message = "답변 내용이 작성되어야 합니다. (ex: 무계획 여행)")
+        String answer
+) {
+
+    public static SurveyAnswerCreateRequest of(final Integer number, final String answer) {
+        return new SurveyAnswerCreateRequest(number, answer);
+    }
+}

src/main/java/com/atwoz/survey/application/survey/dto/SurveyCreateRequest.java

@@ -0,0 +1,19 @@
+package com.atwoz.survey.application.survey.dto;
+
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+
+import java.util.List;
+
+public record SurveyCreateRequest(
+        @NotBlank(message = "연애고사 과목 이름이 있어야 합니다.")
+        String name,
+
+        @NotNull(message = "연애고사 과목 필수 여부가 있어야 합니다.")
+        Boolean required,
+
+        @Valid
+        List<SurveyQuestionCreateRequest> questions
+) {
+}

src/main/java/com/atwoz/survey/application/survey/dto/SurveyQuestionCreateRequest.java

@@ -0,0 +1,15 @@
+package com.atwoz.survey.application.survey.dto;
+
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotBlank;
+
+import java.util.List;
+
+public record SurveyQuestionCreateRequest(
+        @NotBlank(message = "질문 내용이 작성되어야 합니다. (ex: 다음 중 좋아하는 여행 스타일은?)")
+        String description,
+
+        @Valid
+        List<SurveyAnswerCreateRequest> answers
+) {
+}

src/main/java/com/atwoz/survey/domain/membersurvey/MemberSurvey.java

@@ -0,0 +1,45 @@
+package com.atwoz.survey.domain.membersurvey;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@EqualsAndHashCode(exclude = "id")
+@AllArgsConstructor(access = AccessLevel.PRIVATE)
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@Builder
+@Entity
+public class MemberSurvey {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(nullable = false)
+    private Long surveyId;
+
+    @Column(nullable = false)
+    private Long questionId;
+
+    @Column(nullable = false)
+    private Integer answerNumber;
+
+    private MemberSurvey(final Long surveyId, final Long questionId, final Integer answerNumber) {
+        this.surveyId = surveyId;
+        this.questionId = questionId;
+        this.answerNumber = answerNumber;
+    }
+
+    public static MemberSurvey of(final Long surveyId, final Long questionId, final Integer answerNumber) {
+        return new MemberSurvey(surveyId, questionId, answerNumber);
+    }
+}