✨ feat : 퀴즈 생성 기능 구현

silver-eunjoo · silver-eunjoo · commit 2b9349e3a9b9 · 2025-07-13T03:53:59.000+09:00
diff --git a/backend/.gitignore b/backend/.gitignore
@@ -40,4 +40,7 @@ out/
 .env
 
 ### .idea ###
-.idea
+.idea
+
+### images/thumbnail ###
+images/thumbnail/**
diff --git a/backend/src/main/java/io/f1/backend/domain/question/app/QuestionService.java b/backend/src/main/java/io/f1/backend/domain/question/app/QuestionService.java
@@ -0,0 +1,36 @@
+package io.f1.backend.domain.question.app;
+
+import io.f1.backend.domain.question.dao.QuestionRepository;
+import io.f1.backend.domain.question.dao.TextQuestionRepository;
+import io.f1.backend.domain.question.dto.QuestionRequest;
+import io.f1.backend.domain.question.entity.Question;
+import io.f1.backend.domain.question.entity.TextQuestion;
+import io.f1.backend.domain.question.mapper.QuestionMapper;
+import io.f1.backend.domain.question.mapper.TextQuestionMapper;
+import io.f1.backend.domain.quiz.entity.Quiz;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@Service
+@RequiredArgsConstructor
+public class QuestionService {
+
+    private final QuestionRepository questionRepository;
+    private final TextQuestionRepository textQuestionRepository;
+
+    @Transactional
+    public void saveQuestion(Quiz quiz, QuestionRequest request) {
+
+        Question question = QuestionMapper.questionRequestToQuestion(quiz, request);
+        quiz.addQuestion(question);
+        questionRepository.save(question);
+
+        TextQuestion textQuestion = TextQuestionMapper.questionRequestToTextQuestion(question, request.getContent());
+        textQuestionRepository.save(textQuestion);
+        question.addTextQuestion(textQuestion);
+
+    }
+
+
+}
diff --git a/backend/src/main/java/io/f1/backend/domain/question/dao/QuestionRepository.java b/backend/src/main/java/io/f1/backend/domain/question/dao/QuestionRepository.java
@@ -0,0 +1,8 @@
+package io.f1.backend.domain.question.dao;
+
+import io.f1.backend.domain.question.entity.Question;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface QuestionRepository extends JpaRepository<Question, Long> {
+
+}
diff --git a/backend/src/main/java/io/f1/backend/domain/question/dao/TextQuestionRepository.java b/backend/src/main/java/io/f1/backend/domain/question/dao/TextQuestionRepository.java
@@ -0,0 +1,8 @@
+package io.f1.backend.domain.question.dao;
+
+import io.f1.backend.domain.question.entity.TextQuestion;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface TextQuestionRepository extends JpaRepository<TextQuestion, Long> {
+
+}
diff --git a/backend/src/main/java/io/f1/backend/domain/question/dto/QuestionRequest.java b/backend/src/main/java/io/f1/backend/domain/question/dto/QuestionRequest.java
@@ -0,0 +1,18 @@
+package io.f1.backend.domain.question.dto;
+
+import jakarta.validation.constraints.NotBlank;
+import lombok.AccessLevel;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor(access= AccessLevel.PROTECTED)
+public class QuestionRequest {
+
+    @NotBlank(message="문제를 입력해주세요.")
+    private String content;
+
+    @NotBlank(message="정답을 입력해주세요.")
+    private String answer;
+
+}
diff --git a/backend/src/main/java/io/f1/backend/domain/question/entity/Question.java b/backend/src/main/java/io/f1/backend/domain/question/entity/Question.java
@@ -13,8 +13,11 @@
 import jakarta.persistence.JoinColumn;
 import jakarta.persistence.ManyToOne;
 import jakarta.persistence.OneToOne;
+import lombok.AccessLevel;
+import lombok.NoArgsConstructor;
 
 @Entity
+@NoArgsConstructor(access= AccessLevel.PROTECTED)
 public class Question extends BaseEntity {
 
     @Id
@@ -30,4 +33,13 @@ public class Question extends BaseEntity {
 
     @OneToOne(mappedBy = "question", cascade = CascadeType.REMOVE)
     private TextQuestion textQuestion;
+	public Question(Quiz quiz, String answer) {
+		this.quiz = quiz;
+		this.answer = answer;
+	}
+
+	public void addTextQuestion(TextQuestion textQuestion) {
+		this.textQuestion = textQuestion;
+	}
+
 }
diff --git a/backend/src/main/java/io/f1/backend/domain/question/entity/TextQuestion.java b/backend/src/main/java/io/f1/backend/domain/question/entity/TextQuestion.java
@@ -7,8 +7,11 @@
 import jakarta.persistence.Id;
 import jakarta.persistence.JoinColumn;
 import jakarta.persistence.OneToOne;
+import lombok.AccessLevel;
+import lombok.NoArgsConstructor;
 
 @Entity
+@NoArgsConstructor(access= AccessLevel.PROTECTED)
 public class TextQuestion {
 
     @Id
@@ -21,4 +24,9 @@ public class TextQuestion {
 
     @Column(nullable = false)
     private String content;
+
+	public TextQuestion(Question question, String content) {
+		this.question = question;
+		this.content = content;
+	}
 }
diff --git a/backend/src/main/java/io/f1/backend/domain/question/mapper/QuestionMapper.java b/backend/src/main/java/io/f1/backend/domain/question/mapper/QuestionMapper.java
@@ -0,0 +1,13 @@
+package io.f1.backend.domain.question.mapper;
+
+import io.f1.backend.domain.question.dto.QuestionRequest;
+import io.f1.backend.domain.question.entity.Question;
+import io.f1.backend.domain.quiz.entity.Quiz;
+
+public class QuestionMapper {
+
+    public static Question questionRequestToQuestion(Quiz quiz, QuestionRequest questionRequest) {
+        return new Question(quiz, questionRequest.getAnswer());
+    }
+
+}
diff --git a/backend/src/main/java/io/f1/backend/domain/question/mapper/TextQuestionMapper.java b/backend/src/main/java/io/f1/backend/domain/question/mapper/TextQuestionMapper.java
@@ -0,0 +1,12 @@
+package io.f1.backend.domain.question.mapper;
+
+import io.f1.backend.domain.question.entity.Question;
+import io.f1.backend.domain.question.entity.TextQuestion;
+
+public class TextQuestionMapper {
+
+    public static TextQuestion questionRequestToTextQuestion(Question question, String content) {
+        return new TextQuestion(question, content);
+    }
+
+}
diff --git a/backend/src/main/java/io/f1/backend/domain/quiz/api/QuizController.java b/backend/src/main/java/io/f1/backend/domain/quiz/api/QuizController.java
@@ -0,0 +1,32 @@
+package io.f1.backend.domain.quiz.api;
+
+import io.f1.backend.domain.quiz.app.QuizService;
+import io.f1.backend.domain.quiz.dto.QuizCreateRequest;
+import io.f1.backend.domain.quiz.dto.QuizCreateResponse;
+import jakarta.validation.Valid;
+import java.io.IOException;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.MediaType;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestPart;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.multipart.MultipartFile;
+
+@RestController
+@RequestMapping("/quizzes")
+@RequiredArgsConstructor
+public class QuizController {
+
+    private final QuizService quizService;
+
+    @PostMapping(consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+    public ResponseEntity<QuizCreateResponse> saveQuiz(@RequestPart(required = false) MultipartFile file, @Valid @RequestPart QuizCreateRequest request) throws IOException {
+        QuizCreateResponse response = quizService.saveQuiz(file, request);
+
+        return ResponseEntity.status(HttpStatus.CREATED).body(response);
+    }
+
+}
diff --git a/backend/src/main/java/io/f1/backend/domain/quiz/app/QuizService.java b/backend/src/main/java/io/f1/backend/domain/quiz/app/QuizService.java
@@ -0,0 +1,90 @@
+package io.f1.backend.domain.quiz.app;
+
+import io.f1.backend.domain.question.app.QuestionService;
+import io.f1.backend.domain.question.dto.QuestionRequest;
+import io.f1.backend.domain.quiz.dao.QuizRepository;
+import io.f1.backend.domain.quiz.dto.QuizCreateRequest;
+import io.f1.backend.domain.quiz.dto.QuizCreateResponse;
+import io.f1.backend.domain.quiz.entity.Quiz;
+import io.f1.backend.domain.quiz.mapper.QuizMapper;
+import io.f1.backend.domain.user.dao.UserRepository;
+import io.f1.backend.domain.user.entity.User;
+import java.io.IOException;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.util.List;
+import java.util.Optional;
+import java.util.UUID;
+import lombok.RequiredArgsConstructor;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.web.multipart.MultipartFile;
+
+@Service
+@RequiredArgsConstructor
+public class QuizService {
+
+    @Value("${file.thumbnail-path}")
+    private String uploadPath;
+
+    @Value("${file.default-thumbnail-url}")
+    private String defaultThumbnailPath;
+
+    // TODO : 시큐리티 구현 이후 삭제해도 되는 의존성 주입
+    private final UserRepository userRepository;
+    private final QuestionService questionService;
+    private final QuizRepository quizRepository;
+
+    @Transactional
+    public QuizCreateResponse saveQuiz(MultipartFile file, QuizCreateRequest request) throws IOException {
+        String imgUrl = defaultThumbnailPath;
+
+        if(file!=null && !file.isEmpty()) {
+            validateImageFile(file);
+            imgUrl = saveThumbnail(file);
+        }
+
+        // TODO : 시큐리티 구현 이후 삭제 (data.sql로 초기 저장해둔 유저 get), 나중엔 현재 로그인한 유저의 아이디를 받아오도록 수정
+        User user = userRepository.findById(1L).orElseThrow(RuntimeException::new);
+
+        Quiz quiz = QuizMapper.quizCreateRequestToQuiz(request, imgUrl, user);
+
+        Quiz savedQuiz = quizRepository.save(quiz);
+
+        for(QuestionRequest qRequest : request.getQuestions()) {
+            questionService.saveQuestion(savedQuiz, qRequest);
+        }
+
+        return QuizMapper.quizToQuizCreateResponse(savedQuiz);
+    }
+
+    private void validateImageFile(MultipartFile file) {
+
+        if(!file.getContentType().startsWith("image")) {
+            // TODO : 이후 커스텀 예외로 변경
+            throw new IllegalArgumentException("이미지 파일을 업로드해주세요.");
+        }
+
+        List<String> allowedExt = List.of("jpg", "jpeg", "png", "webp");
+        if(!allowedExt.contains(getExtension(file.getOriginalFilename()))) {
+            throw new IllegalArgumentException("지원하지 않는 확장자입니다.");
+        }
+    }
+
+    private String saveThumbnail(MultipartFile file) throws IOException {
+        String originalFilename = file.getOriginalFilename();
+        String ext = getExtension(originalFilename);
+        String savedFilename = UUID.randomUUID().toString() + "." + ext;
+
+        Path savePath = Paths.get(uploadPath, savedFilename).toAbsolutePath();
+        file.transferTo(savePath.toFile());
+
+        return "/images/thumbnail/" + savedFilename;
+    }
+
+    private String getExtension(String filename) {
+        return filename.substring(filename.lastIndexOf(".") + 1);
+    }
+
+}
diff --git a/backend/src/main/java/io/f1/backend/domain/quiz/dao/QuizRepository.java b/backend/src/main/java/io/f1/backend/domain/quiz/dao/QuizRepository.java
@@ -0,0 +1,8 @@
+package io.f1.backend.domain.quiz.dao;
+
+import io.f1.backend.domain.quiz.entity.Quiz;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface QuizRepository extends JpaRepository<Quiz, Long> {
+
+}
diff --git a/backend/src/main/java/io/f1/backend/domain/quiz/dto/QuizCreateRequest.java b/backend/src/main/java/io/f1/backend/domain/quiz/dto/QuizCreateRequest.java
@@ -0,0 +1,26 @@
+package io.f1.backend.domain.quiz.dto;
+
+import io.f1.backend.domain.question.dto.QuestionRequest;
+import io.f1.backend.domain.quiz.entity.QuizType;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import java.util.List;
+import lombok.AccessLevel;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor(access= AccessLevel.PROTECTED)
+public class QuizCreateRequest {
+
+    @NotBlank(message="퀴즈 제목을 설정해주세요.")
+    private String title;
+    @NotNull(message="퀴즈 종류를 선택해주세요.")
+    private QuizType quizType;
+    @NotBlank(message="퀴즈 설명을 적어주세요.")
+    private String description;
+    @Size(min = 10, max=80, message = "문제는 최소 10개, 최대 80개로 정해주세요.")
+    private List<QuestionRequest> questions;
+
+}
diff --git a/backend/src/main/java/io/f1/backend/domain/quiz/dto/QuizCreateResponse.java b/backend/src/main/java/io/f1/backend/domain/quiz/dto/QuizCreateResponse.java
@@ -0,0 +1,5 @@
+package io.f1.backend.domain.quiz.dto;
+
+import io.f1.backend.domain.quiz.entity.QuizType;
+
+public record QuizCreateResponse(Long id, String title, QuizType quizType, String description, String thumbnailUrl, Long creatorId) {}
diff --git a/backend/src/main/java/io/f1/backend/domain/quiz/entity/Quiz.java b/backend/src/main/java/io/f1/backend/domain/quiz/entity/Quiz.java
@@ -18,8 +18,14 @@
 
 import java.util.ArrayList;
 import java.util.List;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
 
 @Entity
+@Getter
+@NoArgsConstructor(access= AccessLevel.PROTECTED)
 public class Quiz extends BaseEntity {
 
     @Id
@@ -45,4 +51,19 @@ public class Quiz extends BaseEntity {
     @ManyToOne
     @JoinColumn(name = "creator_id")
     private User creator;
+
+	@Builder
+	public Quiz(String title, String description, QuizType quizType, String thumbnailUrl,
+		User creator) {
+		this.title = title;
+		this.description = description;
+		this.quizType = quizType;
+		this.thumbnailUrl = thumbnailUrl;
+		this.creator = creator;
+	}
+
+	public void addQuestion(Question question) {
+		this.questions.add(question);
+	}
+
 }
diff --git a/backend/src/main/java/io/f1/backend/domain/quiz/mapper/QuizMapper.java b/backend/src/main/java/io/f1/backend/domain/quiz/mapper/QuizMapper.java
@@ -0,0 +1,28 @@
+package io.f1.backend.domain.quiz.mapper;
+
+import io.f1.backend.domain.quiz.dto.QuizCreateRequest;
+import io.f1.backend.domain.quiz.dto.QuizCreateResponse;
+import io.f1.backend.domain.quiz.entity.Quiz;
+import io.f1.backend.domain.user.entity.User;
+
+public class QuizMapper {
+
+    // TODO : 이후 파라미터에서 user 삭제하기
+    public static Quiz quizCreateRequestToQuiz(QuizCreateRequest quizCreateRequest, String imgUrl, User user) {
+
+        return Quiz.builder()
+            .title(quizCreateRequest.getTitle())
+            .description(quizCreateRequest.getDescription())
+            .quizType(quizCreateRequest.getQuizType())
+            .thumbnailUrl(imgUrl)
+            .creator(user) // TODO : 이후 creator에 들어갈 User은 현재 로그인 중인 유저를 가져오도록 변경
+            .build();
+    }
+
+    public static QuizCreateResponse quizToQuizCreateResponse(Quiz quiz) {
+        // TODO : creatorId 넣어주는 부분에서 Getter를 안 쓰고, 현재 로그인한 유저의 id를 담는 식으로 바꿔도 될 듯
+        return new QuizCreateResponse(quiz.getId(), quiz.getTitle(), quiz.getQuizType(),
+            quiz.getDescription(), quiz.getThumbnailUrl(), quiz.getCreator().getId());
+    }
+
+}
diff --git a/backend/src/main/java/io/f1/backend/domain/user/dao/UserRepository.java b/backend/src/main/java/io/f1/backend/domain/user/dao/UserRepository.java
diff --git a/backend/src/main/java/io/f1/backend/domain/user/entity/User.java b/backend/src/main/java/io/f1/backend/domain/user/entity/User.java
diff --git a/backend/src/main/java/io/f1/backend/global/config/WebConfig.java b/backend/src/main/java/io/f1/backend/global/config/WebConfig.java
diff --git a/backend/src/main/resources/application.yml b/backend/src/main/resources/application.yml
diff --git a/backend/src/main/resources/data.sql b/backend/src/main/resources/data.sql
