test: 지원서 작성 api 문서 작성 (#3)

src/docs/asciidoc/api/application/application.adoc

@@ -0,0 +1,6 @@
+=== 지원서 작성
+
+==== HTTP Request
+
+include::{snippets}/application-create-doc/http-request.adoc[]
+include::{snippets}/application-create-doc/request-fields.adoc[]

src/docs/asciidoc/index.adoc

@@ -1,5 +1,5 @@
 ifndef::snippets[]
-:snippets: ../../build/generated-snippets
+:snippets: ../build/generated-snippets
 endif::[]
 = yonsei-golf REST API 문서
 :doctype: book
@@ -13,3 +13,6 @@ endif::[]
 [[Common-API]]
 = 공통 API
 include::common.adoc[]
+
+[[ Application-API ]]
+include::api/application/application.adoc[]

src/main/java/yonseigolf/server/apply/dto/request/ApplicationRequest.java

@@ -0,0 +1,34 @@
+package yonseigolf.server.apply.dto.request;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+
+@Getter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class ApplicationRequest {
+
+    private String name;
+    private String photo;
+    private long age;
+    private long studentId;
+    private String major;
+    private String phoneNumber;
+    private long golfDuration;
+    private long roundCount;
+    private boolean lessonStatus;
+    private boolean clubStatus;
+    private String selfIntroduction;
+    private String applyReason;
+    private String skillEvaluation;
+    private String golfMemory;
+    // 다른 동아리 활동 질문
+    private String otherClub;
+    private String swingVideo;
+    private LocalDateTime submitTime;
+}

src/test/java/yonseigolf/server/apply/controller/ApplicationControllerTest.java

@@ -0,0 +1,90 @@
+package yonseigolf.server.apply.controller;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.junit.jupiter.MockitoExtension;
+import org.springframework.restdocs.payload.JsonFieldType;
+import yonseigolf.server.apply.dto.request.ApplicationRequest;
+import yonseigolf.server.docs.utils.RestDocsSupport;
+
+import java.time.LocalDateTime;
+
+import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.document;
+import static org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders.post;
+import static org.springframework.restdocs.payload.PayloadDocumentation.fieldWithPath;
+import static org.springframework.restdocs.payload.PayloadDocumentation.requestFields;
+import static org.springframework.test.web.servlet.result.MockMvcResultHandlers.*;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+import static yonseigolf.server.docs.utils.ApiDocumentUtils.getDocumentRequest;
+import static yonseigolf.server.docs.utils.ApiDocumentUtils.getDocumentResponse;
+
+
+@ExtendWith(MockitoExtension.class)
+
+public class ApplicationControllerTest extends RestDocsSupport {
+
+    @Override
+    protected Object initController() {
+
+        return new ApplicationController();
+    }
+
+    @Test
+    @DisplayName("지원자는 지원서를 작성할 수 있다.")
+    void test() throws Exception {
+        // given
+        ApplicationRequest request = ApplicationRequest.builder()
+                .name("홍길동")
+                .photo("사진")
+                .age(20L)
+                .studentId(1L)
+                .major("체육교육")
+                .phoneNumber("010-1234-5678")
+                .golfDuration(1L)
+                .roundCount(1L)
+                .lessonStatus(true)
+                .clubStatus(true)
+                .selfIntroduction("자기소개")
+                .applyReason("지원동기")
+                .skillEvaluation("실력평가")
+                .golfMemory("골프추억")
+                .otherClub("다른동아리활동")
+                .swingVideo("스윙영상")
+                .submitTime(LocalDateTime.now())
+                .build();
+
+        // when
+
+
+        // then
+        mockMvc.perform(post("/application")
+                        .content(objectMapper.writeValueAsString(request))
+                        .contentType("application/json")
+                )
+                .andExpect(status().isOk())
+                .andDo(print())
+                .andDo(document("application-create-doc",
+                        getDocumentRequest(),
+                        getDocumentResponse(),
+                        requestFields(
+                                fieldWithPath("name").type(JsonFieldType.STRING).description("이름"),
+                                fieldWithPath("photo").type(JsonFieldType.STRING).description("사진"),
+                                fieldWithPath("age").type(JsonFieldType.NUMBER).description("나이"),
+                                fieldWithPath("studentId").type(JsonFieldType.NUMBER).description("학번"),
+                                fieldWithPath("major").type(JsonFieldType.STRING).description("전공"),
+                                fieldWithPath("phoneNumber").type(JsonFieldType.STRING).description("전화번호"),
+                                fieldWithPath("golfDuration").type(JsonFieldType.NUMBER).description("골프경력"),
+                                fieldWithPath("roundCount").type(JsonFieldType.NUMBER).description("라운드횟수"),
+                                fieldWithPath("lessonStatus").type(JsonFieldType.BOOLEAN).description("레슨여부"),
+                                fieldWithPath("clubStatus").type(JsonFieldType.BOOLEAN).description("클럽보유여부"),
+                                fieldWithPath("selfIntroduction").type(JsonFieldType.STRING).description("자기소개"),
+                                fieldWithPath("applyReason").type(JsonFieldType.STRING).description("지원동기"),
+                                fieldWithPath("skillEvaluation").type(JsonFieldType.STRING).description("골프 자시 실력 평가"),
+                                fieldWithPath("golfMemory").type(JsonFieldType.STRING).description("골프추억"),
+                                fieldWithPath("otherClub").type(JsonFieldType.STRING).description("다른동아리활동 기술"),
+                                fieldWithPath("swingVideo").type(JsonFieldType.STRING).description("스윙영상"),
+                                fieldWithPath("submitTime").type(JsonFieldType.ARRAY).description("제출시간"))
+                ));
+    }
+}