Feature/#23 문항, 새끼문항 도메인 생성, 수정, 삭제 API 구현

build.gradle

@@ -56,6 +56,11 @@ dependencies {
     // validator
     implementation 'commons-validator:commons-validator:1.7'
 
+    // Map Struct
+    implementation 'org.mapstruct:mapstruct:1.6.3'
+    annotationProcessor 'org.mapstruct:mapstruct-processor:1.6.3'
+    annotationProcessor 'org.projectlombok:lombok-mapstruct-binding:0.2.0'
+
 }
 
 tasks.named('test') {

src/main/generated/com/moplus/moplus_server/domain/problem/service/mapper/ChildProblemMapperImpl.java

@@ -0,0 +1,58 @@
+package com.moplus.moplus_server.domain.problem.service.mapper;
+
+import com.moplus.moplus_server.domain.problem.domain.childProblem.ChildProblem;
+import com.moplus.moplus_server.domain.problem.dto.request.ChildProblemPostRequest;
+import com.moplus.moplus_server.domain.problem.dto.request.ChildProblemUpdateRequest;
+import java.util.LinkedHashSet;
+import java.util.Set;
+import javax.annotation.processing.Generated;
+import org.springframework.stereotype.Component;
+
+@Generated(
+    value = "org.mapstruct.ap.MappingProcessor",
+    date = "2025-01-30T21:11:35+0900",
+    comments = "version: 1.6.3, compiler: javac, environment: Java 17.0.10 (JetBrains s.r.o.)"
+)
+@Component
+public class ChildProblemMapperImpl implements ChildProblemMapper {
+
+    @Override
+    public ChildProblem from(ChildProblemPostRequest request) {
+        if ( request == null ) {
+            return null;
+        }
+
+        ChildProblem.ChildProblemBuilder childProblem = ChildProblem.builder();
+
+        childProblem.imageUrl( request.imageUrl() );
+        childProblem.problemType( request.problemType() );
+        childProblem.answer( request.answer() );
+        Set<Long> set = request.conceptTagIds();
+        if ( set != null ) {
+            childProblem.conceptTagIds( new LinkedHashSet<Long>( set ) );
+        }
+        childProblem.sequence( request.sequence() );
+
+        return childProblem.build();
+    }
+
+    @Override
+    public ChildProblem from(ChildProblemUpdateRequest request) {
+        if ( request == null ) {
+            return null;
+        }
+
+        ChildProblem.ChildProblemBuilder childProblem = ChildProblem.builder();
+
+        childProblem.imageUrl( request.imageUrl() );
+        childProblem.problemType( request.problemType() );
+        childProblem.answer( request.answer() );
+        Set<Long> set = request.conceptTagIds();
+        if ( set != null ) {
+            childProblem.conceptTagIds( new LinkedHashSet<Long>( set ) );
+        }
+        childProblem.sequence( request.sequence() );
+
+        return childProblem.build();
+    }
+}

src/main/generated/com/moplus/moplus_server/domain/problem/service/mapper/ProblemMapperImpl.java

@@ -0,0 +1,75 @@
+package com.moplus.moplus_server.domain.problem.service.mapper;
+
+import com.moplus.moplus_server.domain.problem.domain.practiceTest.PracticeTestTag;
+import com.moplus.moplus_server.domain.problem.domain.problem.Problem;
+import com.moplus.moplus_server.domain.problem.domain.problem.ProblemId;
+import com.moplus.moplus_server.domain.problem.dto.request.ProblemPostRequest;
+import com.moplus.moplus_server.domain.problem.dto.request.ProblemUpdateRequest;
+import java.util.LinkedHashSet;
+import java.util.Set;
+import javax.annotation.processing.Generated;
+import org.springframework.stereotype.Component;
+
+@Generated(
+    value = "org.mapstruct.ap.MappingProcessor",
+    date = "2025-01-30T21:11:35+0900",
+    comments = "version: 1.6.3, compiler: javac, environment: Java 17.0.10 (JetBrains s.r.o.)"
+)
+@Component
+public class ProblemMapperImpl implements ProblemMapper {
+
+    @Override
+    public Problem from(ProblemPostRequest request, ProblemId problemId, PracticeTestTag practiceTestTag) {
+        if ( request == null && problemId == null && practiceTestTag == null ) {
+            return null;
+        }
+
+        Problem.ProblemBuilder problem = Problem.builder();
+
+        if ( request != null ) {
+            problem.number( request.number() );
+            problem.answer( request.answer() );
+            problem.comment( request.comment() );
+            problem.mainProblemImageUrl( request.mainProblemImageUrl() );
+            problem.mainAnalysisImageUrl( request.mainAnalysisImageUrl() );
+            problem.readingTipImageUrl( request.readingTipImageUrl() );
+            problem.seniorTipImageUrl( request.seniorTipImageUrl() );
+            problem.prescriptionImageUrl( request.prescriptionImageUrl() );
+            Set<Long> set = request.conceptTagIds();
+            if ( set != null ) {
+                problem.conceptTagIds( new LinkedHashSet<Long>( set ) );
+            }
+        }
+        problem.id( problemId );
+        problem.practiceTestTag( practiceTestTag );
+
+        return problem.build();
+    }
+
+    @Override
+    public Problem from(ProblemUpdateRequest request, ProblemId problemId, PracticeTestTag practiceTestTag) {
+        if ( request == null && problemId == null && practiceTestTag == null ) {
+            return null;
+        }
+
+        Problem.ProblemBuilder problem = Problem.builder();
+
+        if ( request != null ) {
+            problem.answer( String.valueOf( request.answer() ) );
+            problem.comment( request.comment() );
+            problem.mainProblemImageUrl( request.mainProblemImageUrl() );
+            problem.mainAnalysisImageUrl( request.mainAnalysisImageUrl() );
+            problem.readingTipImageUrl( request.readingTipImageUrl() );
+            problem.seniorTipImageUrl( request.seniorTipImageUrl() );
+            problem.prescriptionImageUrl( request.prescriptionImageUrl() );
+            Set<Long> set = request.conceptTagIds();
+            if ( set != null ) {
+                problem.conceptTagIds( new LinkedHashSet<Long>( set ) );
+            }
+        }
+        problem.id( problemId );
+        problem.practiceTestTag( practiceTestTag );
+
+        return problem.build();
+    }
+}

src/main/java/com/moplus/moplus_server/domain/concept/controller/ConceptTagController.java

@@ -0,0 +1,29 @@
+package com.moplus.moplus_server.domain.concept.controller;
+
+import com.moplus.moplus_server.domain.concept.dto.response.ConceptTagResponse;
+import com.moplus.moplus_server.domain.concept.repository.ConceptTagRepository;
+import io.swagger.v3.oas.annotations.Operation;
+import java.util.List;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/api/v1/conceptTags")
+@RequiredArgsConstructor
+public class ConceptTagController {
+
+    ConceptTagRepository conceptTagRepository;
+
+    @GetMapping("")
+    @Operation(summary = "모든 개념 태그 리스트 조회")
+    public ResponseEntity<List<ConceptTagResponse>> getConceptTags(
+    ) {
+        List<ConceptTagResponse> responses = conceptTagRepository.findAll().stream()
+                .map(ConceptTagResponse::of)
+                .toList();
+        return ResponseEntity.ok(responses);
+    }
+}

src/main/java/com/moplus/moplus_server/domain/concept/dto/response/ConceptTagResponse.java

@@ -0,0 +1,15 @@
+package com.moplus.moplus_server.domain.concept.dto.response;
+
+import com.moplus.moplus_server.domain.concept.domain.ConceptTag;
+
+public record ConceptTagResponse(
+        Long id,
+        String name
+) {
+    public static ConceptTagResponse of(ConceptTag entity) {
+        return new ConceptTagResponse(
+                entity.getId(),
+                entity.getName()
+        );
+    }
+}

src/main/java/com/moplus/moplus_server/domain/concept/repository/ConceptTagRepository.java

@@ -1,7 +1,21 @@
 package com.moplus.moplus_server.domain.concept.repository;
 
 import com.moplus.moplus_server.domain.concept.domain.ConceptTag;
+import com.moplus.moplus_server.global.error.exception.ErrorCode;
+import com.moplus.moplus_server.global.error.exception.NotFoundException;
+import java.util.List;
+import java.util.Set;
 import org.springframework.data.jpa.repository.JpaRepository;
 
 public interface ConceptTagRepository extends JpaRepository<ConceptTag, Long> {
+
+    default void existsByIdElseThrow(Set<Long> ids) {
+        List<Long> foundIds = findAllById(ids).stream()
+                .map(ConceptTag::getId) // 엔티티의 ID 추출
+                .toList();
+
+        if (ids.size() != foundIds.size()) {
+            throw new NotFoundException(ErrorCode.CONCEPT_TAG_NOT_FOUND_IN_LIST);
+        }
+    }
 }

src/main/java/com/moplus/moplus_server/domain/problem/controller/PracticeTestTagController.java

@@ -0,0 +1,28 @@
+package com.moplus.moplus_server.domain.problem.controller;
+
+import com.moplus.moplus_server.domain.problem.dto.response.PracticeTestTagResponse;
+import com.moplus.moplus_server.domain.problem.repository.PracticeTestTagRepository;
+import io.swagger.v3.oas.annotations.Operation;
+import java.util.List;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/api/v1/practiceTestTags")
+@RequiredArgsConstructor
+public class PracticeTestTagController {
+
+    private final PracticeTestTagRepository practiceTestTagRepository;
+
+    @GetMapping("")
+    @Operation(summary = "모의고사 목록 조회")
+    public ResponseEntity<List<PracticeTestTagResponse>> getPracticeTestTags() {
+        List<PracticeTestTagResponse> responses = practiceTestTagRepository.findAll().stream()
+                .map(PracticeTestTagResponse::of)
+                .toList();
+        return ResponseEntity.ok(responses);
+    }
+}

src/main/java/com/moplus/moplus_server/domain/problem/controller/ProblemController.java

@@ -0,0 +1,64 @@
+package com.moplus.moplus_server.domain.problem.controller;
+
+import com.moplus.moplus_server.domain.problem.dto.request.ProblemPostRequest;
+import com.moplus.moplus_server.domain.problem.dto.request.ProblemUpdateRequest;
+import com.moplus.moplus_server.domain.problem.dto.response.ProblemGetResponse;
+import com.moplus.moplus_server.domain.problem.service.ProblemDeleteService;
+import com.moplus.moplus_server.domain.problem.service.ProblemGetService;
+import com.moplus.moplus_server.domain.problem.service.ProblemSaveService;
+import com.moplus.moplus_server.domain.problem.service.ProblemUpdateService;
+import io.swagger.v3.oas.annotations.Operation;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/api/v1/problems")
+@RequiredArgsConstructor
+public class ProblemController {
+
+    private final ProblemSaveService problemSaveService;
+    private final ProblemUpdateService problemUpdateService;
+    private final ProblemGetService problemGetService;
+    private final ProblemDeleteService problemDeleteService;
+
+    @GetMapping("/{id}")
+    @Operation(summary = "문항 조회", description = "문항를 조회합니다.")
+    public ResponseEntity<ProblemGetResponse> getProblem(
+            @PathVariable("id") String id
+    ) {
+        return ResponseEntity.ok(problemGetService.getProblem(id));
+    }
+
+    @PostMapping("")
+    @Operation(summary = "문항 생성", description = "문제를 생성합니다. 새끼 문항은 list 순서대로 sequence를 저장합니다.")
+    public ResponseEntity<String> createProblem(
+            @RequestBody ProblemPostRequest request
+    ) {
+        return ResponseEntity.ok(problemSaveService.createProblem(request).toString());
+    }
+
+    @PostMapping("/{id}")
+    @Operation(summary = "문항 업데이트", description = "문제를 업데이트합니다. 문항 번호, 모의고사는 수정할 수 없습니다. 새로 추가되는 새끼문항 id는 빈 값입니다.")
+    public ResponseEntity<ProblemGetResponse> updateProblem(
+            @PathVariable("id") String id,
+            @RequestBody ProblemUpdateRequest request
+    ) {
+        return ResponseEntity.ok(problemUpdateService.updateProblem(id, request));
+    }
+
+    @DeleteMapping("/{id}")
+    @Operation(summary = "문항 삭제")
+    public ResponseEntity<ProblemGetResponse> updateProblem(
+            @PathVariable("id") String id
+    ) {
+        problemDeleteService.deleteProblem(id);
+        return ResponseEntity.ok().body(null);
+    }
+}

src/main/java/com/moplus/moplus_server/domain/problem/domain/Answer.java

@@ -0,0 +1,45 @@
+package com.moplus.moplus_server.domain.problem.domain;
+
+import com.moplus.moplus_server.domain.problem.domain.problem.ProblemType;
+import com.moplus.moplus_server.global.error.exception.ErrorCode;
+import com.moplus.moplus_server.global.error.exception.InvalidValueException;
+import jakarta.persistence.Column;
+import jakarta.persistence.Embeddable;
+import lombok.AccessLevel;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@Embeddable
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class Answer {
+
+    @Column(name = "answer")
+    private String value;
+
+    public Answer(String value, ProblemType problemType) {
+        validateByType(value, problemType);
+        this.value = value;
+    }
+
+    private void validateByType(String answer, ProblemType problemType) {
+        if (answer.isBlank()) {
+            throw new InvalidValueException(ErrorCode.BLANK_INPUT_VALUE);
+        }
+        if (problemType == ProblemType.MULTIPLE_CHOICE) {
+            if (!answer.matches("^[1-5]*$")) {
+                throw new InvalidValueException(ErrorCode.INVALID_MULTIPLE_CHOICE_ANSWER);
+            }
+        }
+        if (problemType == ProblemType.SHORT_NUMBER_ANSWER) {
+            try {
+                int numericAnswer = Integer.parseInt(answer);
+                if (numericAnswer < 0 || numericAnswer > 999) {
+                    throw new InvalidValueException(ErrorCode.INVALID_SHORT_NUMBER_ANSWER);
+                }
+            } catch (NumberFormatException e) {
+                throw new InvalidValueException(ErrorCode.INVALID_SHORT_NUMBER_ANSWER);
+            }
+        }
+    }
+}