[DDING-91] 지원하기 API 구현

src/main/java/ddingdong/ddingdongBE/common/config/SecurityConfig.java

@@ -1,6 +1,7 @@
 package ddingdong.ddingdongBE.common.config;
 
 import static org.springframework.http.HttpMethod.GET;
+import static org.springframework.http.HttpMethod.POST;
 
 import ddingdong.ddingdongBE.auth.service.JwtAuthService;
 import ddingdong.ddingdongBE.common.filter.JwtAuthenticationFilter;
@@ -46,7 +47,13 @@ public SecurityFilterChain filterChain(HttpSecurity http, JwtAuthService authSer
                                 API_PREFIX + "/banners/**",
                                 API_PREFIX + "/documents/**",
                                 API_PREFIX + "/questions/**",
-                                API_PREFIX + "/feeds/**")
+                                API_PREFIX + "/feeds/**",
+                                API_PREFIX + "/forms/**"
+                                )
+                        .permitAll()
+                        .requestMatchers(POST,
+                                API_PREFIX + "/forms/{formId}/applications"
+                                )
                         .permitAll()
                         .requestMatchers(API_PREFIX + "/internal/**")
                         .permitAll()

src/main/java/ddingdong/ddingdongBE/domain/form/service/FormFieldService.java

@@ -3,11 +3,14 @@
 import ddingdong.ddingdongBE.domain.form.entity.Form;
 import ddingdong.ddingdongBE.domain.form.entity.FormField;
 import java.util.List;
+import java.util.Optional;
 
 public interface FormFieldService {
 
     void createAll(List<FormField> formFields);
 
+    FormField getById(Long id);
+
     List<FormField> findAllByForm(Form form);
 
     void deleteAll(List<FormField> originFormFields);

src/main/java/ddingdong/ddingdongBE/domain/form/service/GeneralFormFieldService.java

@@ -4,6 +4,8 @@
 import ddingdong.ddingdongBE.domain.form.entity.FormField;
 import ddingdong.ddingdongBE.domain.form.repository.FormFieldRepository;
 import java.util.List;
+import java.util.Optional;
+
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
@@ -21,6 +23,12 @@ public void createAll(List<FormField> formFields) {
         formFieldRepository.saveAll(formFields);
     }
 
+
+    @Override
+    public FormField getById(Long id) {
+        return formFieldRepository.findById(id)
+                .orElseThrow(() -> new IllegalArgumentException("해당 field를 id로 찾을 수 없습니다: " + id));
+
     @Override
     public List<FormField> findAllByForm(Form form) {
         return formFieldRepository.findAllByForm(form);

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/api/UserFormApi.java

@@ -0,0 +1,24 @@
+package ddingdong.ddingdongBE.domain.formapplicaion.api;
+
+import ddingdong.ddingdongBE.domain.formapplicaion.controller.dto.request.CreateFormApplicationRequest;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import org.springframework.http.HttpStatus;
+import org.springframework.web.bind.annotation.*;
+
+@Tag(name = "Form - User", description = "User Form API")
+@RequestMapping("/server")
+public interface UserFormApi {
+
+    @Operation(summary = "지원하기 API")
+    @ApiResponse(responseCode = "201", description = "지원하기 성공")
+    @ResponseStatus(HttpStatus.CREATED)
+    @PostMapping("/forms/{formId}/applications")
+    void createFormResponse(
+            @PathVariable Long formId,
+            @Valid @RequestBody CreateFormApplicationRequest request
+    );
+
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/controller/UserFormController.java

@@ -0,0 +1,19 @@
+package ddingdong.ddingdongBE.domain.formapplicaion.controller;
+
+import ddingdong.ddingdongBE.domain.formapplicaion.api.UserFormApi;
+import ddingdong.ddingdongBE.domain.formapplicaion.controller.dto.request.CreateFormApplicationRequest;
+import ddingdong.ddingdongBE.domain.formapplicaion.service.FacadeUserFormService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequiredArgsConstructor
+public class UserFormController implements UserFormApi {
+
+    private final FacadeUserFormService facadeUserFormService;
+
+    @Override
+    public void createFormResponse(Long formId, CreateFormApplicationRequest createFormApplicationRequest) {
+        facadeUserFormService.createFormApplication(formId, createFormApplicationRequest.toCommand());
+    }
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/controller/dto/request/CreateFormApplicationRequest.java

@@ -0,0 +1,60 @@
+package ddingdong.ddingdongBE.domain.formapplicaion.controller.dto.request;
+
+import ddingdong.ddingdongBE.domain.formapplicaion.entity.FormApplicationStatus;
+import ddingdong.ddingdongBE.domain.formapplicaion.service.dto.CreateFormApplicationCommand;
+import ddingdong.ddingdongBE.domain.formapplicaion.service.dto.CreateFormApplicationCommand.CreateFormAnswerCommand;
+import io.swagger.v3.oas.annotations.media.ArraySchema;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+
+import java.util.List;
+
+public record CreateFormApplicationRequest(
+
+        @NotNull(message = "지원자 이름은 필수 입력 사항입니다.")
+        @Schema(description = "지원자 이름", example = "김띵동")
+        String name,
+
+        @NotNull(message = "지원자 학번은 필수 입력 사항입니다.")
+        @Schema(description = "학번", example = "60200000")
+        String studentNumber,
+
+        @NotNull(message = "지원자 학과는 필수 입력 사항입니다.")
+        @Schema(description = "학과", example = "융합소프트웨어학부 응용소프트웨어전공")
+        String department,
+
+        @ArraySchema(schema = @Schema(implementation = CreateFormAnswerRequest.class))
+        List<CreateFormAnswerRequest> formAnswers
+) {
+    record CreateFormAnswerRequest(
+            @NotNull(message = "질문 id는 null이 될 수 없습니다.")
+            @Schema(description = "질문 id", example = "1")
+            Long fieldId,
+
+            @Schema(description = "답변 값")
+            List<String> value
+    ) {
+        public CreateFormAnswerCommand toCommand() {
+            return CreateFormAnswerCommand.builder()
+                    .fieldId(fieldId)
+                    .value(value)
+                    .build();
+        }
+    }
+
+    public CreateFormApplicationCommand toCommand() {
+        List<CreateFormAnswerCommand> createFormAnswerCommands = formAnswers.stream()
+                .map(CreateFormAnswerRequest::toCommand)
+                .toList();
+        return CreateFormApplicationCommand.builder()
+                .name(name)
+                .studentNumber(studentNumber)
+                .department(department)
+                .status(FormApplicationStatus.SUBMITTED)
+                .formAnswerCommands(createFormAnswerCommands)
+                .build();
+    }
+
+}
+
+

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/entity/FormAnswer.java

@@ -0,0 +1,40 @@
+package ddingdong.ddingdongBE.domain.formapplicaion.entity;
+
+import ddingdong.ddingdongBE.common.BaseEntity;
+import ddingdong.ddingdongBE.common.converter.StringListConverter;
+import ddingdong.ddingdongBE.domain.form.entity.FieldType;
+import ddingdong.ddingdongBE.domain.form.entity.FormField;
+import jakarta.persistence.*;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import java.util.List;
+
+@Entity
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@Getter
+public class FormAnswer extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(nullable = false)
+    @Convert(converter = StringListConverter.class)
+    private List<String> value;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    private FormApplication formApplication;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    private FormField formField;
+
+    @Builder
+    private FormAnswer(List<String> value, FormApplication formApplication, FormField formField) {
+        this.value = value;
+        this.formApplication = formApplication;
+        this.formField = formField;
+    }
+
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/entity/FormApplication.java

@@ -0,0 +1,44 @@
+package ddingdong.ddingdongBE.domain.formapplicaion.entity;
+
+import ddingdong.ddingdongBE.common.BaseEntity;
+import ddingdong.ddingdongBE.domain.form.entity.Form;
+import jakarta.persistence.*;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Entity
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@Getter
+public class FormApplication extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(nullable = false)
+    private String name;
+
+    @Column(nullable = false)
+    private String studentNumber;
+
+    @Column(nullable = false)
+    private String department;
+
+    @Enumerated(EnumType.STRING)
+    @Column(nullable = false, name = "status")
+    private FormApplicationStatus status;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    private Form form;
+
+    @Builder
+    private FormApplication(String name, String studentNumber, String department, FormApplicationStatus status, Form form) {
+        this.name = name;
+        this.studentNumber = studentNumber;
+        this.department = department;
+        this.status = status;
+        this.form = form;
+    }
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/entity/FormApplicationStatus.java

@@ -0,0 +1,8 @@
+package ddingdong.ddingdongBE.domain.formapplicaion.entity;
+
+public enum FormApplicationStatus {
+    SUBMITTED,
+    FIRST_PASS,
+    FINAL_PASS,
+    FAILURE
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/repository/FormAnswerRepository.java

@@ -0,0 +1,7 @@
+package ddingdong.ddingdongBE.domain.formapplicaion.repository;
+
+import ddingdong.ddingdongBE.domain.formapplicaion.entity.FormAnswer;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface FormAnswerRepository extends JpaRepository<FormAnswer, Long> {
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/repository/FormApplicationRepository.java

@@ -0,0 +1,7 @@
+package ddingdong.ddingdongBE.domain.formapplicaion.repository;
+
+import ddingdong.ddingdongBE.domain.formapplicaion.entity.FormApplication;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface FormApplicationRepository extends JpaRepository<FormApplication, Long> {
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/service/FacadeUserFormService.java

@@ -0,0 +1,9 @@
+package ddingdong.ddingdongBE.domain.formapplicaion.service;
+
+import ddingdong.ddingdongBE.domain.formapplicaion.service.dto.CreateFormApplicationCommand;
+
+public interface FacadeUserFormService {
+
+    void createFormApplication(Long formId, CreateFormApplicationCommand createFormApplicationCommand);
+
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/service/FacadeUserFormServiceImpl.java

@@ -0,0 +1,46 @@
+package ddingdong.ddingdongBE.domain.formapplicaion.service;
+
+import ddingdong.ddingdongBE.domain.form.entity.Form;
+import ddingdong.ddingdongBE.domain.formapplicaion.entity.FormAnswer;
+import ddingdong.ddingdongBE.domain.form.entity.FormField;
+import ddingdong.ddingdongBE.domain.formapplicaion.entity.FormApplication;
+import ddingdong.ddingdongBE.domain.form.service.FormFieldService;
+import ddingdong.ddingdongBE.domain.form.service.FormService;
+import ddingdong.ddingdongBE.domain.formapplicaion.service.dto.CreateFormApplicationCommand;
+import ddingdong.ddingdongBE.domain.formapplicaion.service.dto.CreateFormApplicationCommand.CreateFormAnswerCommand;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+@Service
+@RequiredArgsConstructor
+@Transactional(readOnly = true)
+public class FacadeUserFormServiceImpl implements FacadeUserFormService {
+
+    private final FormApplicationService formApplicationService;
+    private final FormAnswerService formAnswerService;
+    private final FormService formService;
+    private final FormFieldService formFieldService;
+
+    @Transactional
+    @Override
+    public void createFormApplication(Long formId, CreateFormApplicationCommand createFormApplicationCommand) {
+        Form form = formService.getById(formId);
+        FormApplication formApplication = createFormApplicationCommand.toEntity(form);
+        FormApplication savedFormApplication = formApplicationService.create(formApplication);
+
+        List<FormAnswer> formAnswers = toFormAnswers(savedFormApplication, createFormApplicationCommand.formAnswerCommands());
+        formAnswerService.createAll(formAnswers);
+    }
+
+    private List<FormAnswer> toFormAnswers(FormApplication savedFormApplication, List<CreateFormAnswerCommand> createFormAnswerCommands) {
+        return createFormAnswerCommands.stream()
+                .map(formAnswerCommand -> {
+                    FormField formField = formFieldService.getById(formAnswerCommand.fieldId());
+                    return formAnswerCommand.toEntity(savedFormApplication, formField);
+                })
+                .toList();
+    }
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/service/FormAnswerService.java

@@ -0,0 +1,10 @@
+package ddingdong.ddingdongBE.domain.formapplicaion.service;
+
+import ddingdong.ddingdongBE.domain.formapplicaion.entity.FormAnswer;
+import java.util.List;
+
+public interface FormAnswerService {
+
+    void createAll(List<FormAnswer> formAnswers);
+
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/service/FormApplicationService.java

@@ -0,0 +1,9 @@
+package ddingdong.ddingdongBE.domain.formapplicaion.service;
+
+import ddingdong.ddingdongBE.domain.formapplicaion.entity.FormApplication;
+
+public interface FormApplicationService {
+
+    FormApplication create(FormApplication formApplication);
+
+}

src/main/java/ddingdong/ddingdongBE/domain/formapplicaion/service/GeneralFormAnswerService.java

@@ -0,0 +1,24 @@
+package ddingdong.ddingdongBE.domain.formapplicaion.service;
+
+import ddingdong.ddingdongBE.domain.formapplicaion.entity.FormAnswer;
+import ddingdong.ddingdongBE.domain.formapplicaion.repository.FormAnswerRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+@Service
+@RequiredArgsConstructor
+@Transactional(readOnly = true)
+public class GeneralFormAnswerService implements FormAnswerService {
+
+    private final FormAnswerRepository formAnswerRepository;
+
+    @Transactional
+    @Override
+    public void createAll(List<FormAnswer> formAnswers) {
+        formAnswerRepository.saveAll(formAnswers);
+    }
+
+}