docs: 내 프로필 api 문서 작성

backend/src/docs/asciidoc/index.adoc

@@ -43,4 +43,8 @@ include::highlight-answers.adoc[]
 
 == 인증
 
-include::auth.adoc[]
+include::auth.adoc[]
+
+== 사용자
+
+include::member.adoc[]

backend/src/docs/asciidoc/member.adoc

@@ -0,0 +1,3 @@
+==== 내 프로필 정보
+
+operation::my-profile[snippets="curl-request,request-cookies,http-response,response-fields"]

backend/src/main/java/reviewme/member/controller/MemberController.java

@@ -0,0 +1,21 @@
+package reviewme.member.controller;
+
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RestController;
+import reviewme.member.service.MemberService;
+import reviewme.member.service.dto.ProfileResponse;
+
+@RestController
+@RequiredArgsConstructor
+public class MemberController {
+
+    private final MemberService memberService;
+
+    @GetMapping("/v2/members/profile/mine")
+    public ResponseEntity<ProfileResponse> getProfile() {
+        ProfileResponse response = memberService.getProfile();
+        return ResponseEntity.ok(response);
+    }
+}

backend/src/main/java/reviewme/member/service/MemberService.java

@@ -0,0 +1,12 @@
+package reviewme.member.service;
+
+import org.springframework.stereotype.Service;
+import reviewme.member.service.dto.ProfileResponse;
+
+@Service
+public class MemberService {
+
+    public ProfileResponse getProfile() {
+        return null;
+    }
+}

backend/src/main/java/reviewme/member/service/dto/ProfileResponse.java

@@ -0,0 +1,7 @@
+package reviewme.member.service.dto;
+
+public record ProfileResponse(
+        String nickname,
+        String profileImageUrl
+) {
+}

backend/src/test/java/reviewme/api/ApiTest.java

@@ -30,6 +30,8 @@
 import reviewme.auth.service.AuthService;
 import reviewme.highlight.controller.HighlightController;
 import reviewme.highlight.service.HighlightService;
+import reviewme.member.controller.MemberController;
+import reviewme.member.service.MemberService;
 import reviewme.review.controller.ReviewController;
 import reviewme.review.service.ReviewDetailLookupService;
 import reviewme.review.service.ReviewGatheredLookupService;
@@ -51,6 +53,7 @@
         TemplateController.class,
         SectionController.class,
         HighlightController.class,
+        MemberController.class,
         AuthController.class
 })
 @ExtendWith(RestDocumentationExtension.class)
@@ -88,6 +91,9 @@ public abstract class ApiTest {
     @MockBean
     protected HighlightService highlightService;
 
+    @MockBean
+    protected MemberService memberService;
+
     @MockBean
     protected AuthService authService;
 

backend/src/test/java/reviewme/api/MemberApiTest.java

@@ -0,0 +1,45 @@
+package reviewme.api;
+
+import static org.springframework.restdocs.cookies.CookieDocumentation.cookieWithName;
+import static org.springframework.restdocs.cookies.CookieDocumentation.requestCookies;
+import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.document;
+import static org.springframework.restdocs.payload.PayloadDocumentation.fieldWithPath;
+import static org.springframework.restdocs.payload.PayloadDocumentation.responseFields;
+
+import org.junit.jupiter.api.Test;
+import org.mockito.BDDMockito;
+import org.springframework.restdocs.cookies.CookieDescriptor;
+import org.springframework.restdocs.mockmvc.RestDocumentationResultHandler;
+import org.springframework.restdocs.payload.FieldDescriptor;
+import reviewme.member.service.dto.ProfileResponse;
+
+public class MemberApiTest extends ApiTest {
+
+    @Test
+    void 내_프로필을_불러온다() {
+        BDDMockito.given(memberService.getProfile())
+                .willReturn(new ProfileResponse("donghoony", "https://aru.image"));
+
+        CookieDescriptor[] cookieDescriptors = {
+                cookieWithName("JSESSIONID").description("세션 ID")
+        };
+
+        FieldDescriptor[] responseFieldDescriptors = {
+                fieldWithPath("nickname").description("닉네임"),
+                fieldWithPath("profileImageUrl").description("프로필 이미지 URL")
+        };
+
+        RestDocumentationResultHandler handler = document(
+                "my-profile",
+                requestCookies(cookieDescriptors),
+                responseFields(responseFieldDescriptors)
+        );
+
+        givenWithSpec().log().all()
+                .cookie("JSESSIONID", "SESSION12345678")
+                .when().get("/v2/members/profile/mine")
+                .then().log().all()
+                .apply(handler)
+                .statusCode(200);
+    }
+}