Merge pull request #15 from Dalguring/feature/auth

feat :  auth/me api 뼈대 및 문서화

Author: jaehyeong21

src/main/java/com/rentify/rentify_api/user/controller/AuthApi.java

@@ -0,0 +1,34 @@
+package com.rentify.rentify_api.user.controller;
+
+import com.rentify.rentify_api.user.dto.AuthMeResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.http.ResponseEntity;
+
+@Tag(name = "Auth", description = "인증 API")
+public interface AuthApi {
+
+    @Operation(summary = "내 정보 조회", description = "JWT로 현재 로그인 사용자 확인")
+    @ApiResponses({
+            @ApiResponse(responseCode = "200", description = "인증 성공"),
+            @ApiResponse(responseCode = "401", description = "Access Token 만료",
+                    content = @Content(schema = @Schema(example = """
+            {
+              "code": "TOKEN_EXPIRED",
+              "message": "Access token expired"
+            }
+            """))),
+            @ApiResponse(responseCode = "401", description = "유효하지 않은 토큰",
+                    content = @Content(schema = @Schema(example = """
+            {
+              "code": "INVALID_TOKEN",
+              "message": "Invalid token"
+            }
+            """)))
+    })
+    ResponseEntity<AuthMeResponse> me();
+}

src/main/java/com/rentify/rentify_api/user/controller/AuthController.java

@@ -0,0 +1,24 @@
+package com.rentify.rentify_api.user.controller;
+
+
+import com.rentify.rentify_api.user.dto.AuthMeResponse;
+import com.rentify.rentify_api.user.service.AuthService;
+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
+@RequiredArgsConstructor
+@RequestMapping("/auth")
+public class AuthController implements AuthApi {
+
+    private final AuthService authService;
+
+    @Override
+    @GetMapping("/me")
+    public ResponseEntity<AuthMeResponse> me() {
+        return ResponseEntity.ok(authService.getMe());
+    }
+}

src/main/java/com/rentify/rentify_api/user/dto/AuthMeResponse.java

@@ -0,0 +1,22 @@
+package com.rentify.rentify_api.user.dto;
+
+import com.rentify.rentify_api.user.entity.User;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public class AuthMeResponse {
+
+    private Long userId;
+    private String email;
+    private String name;
+
+    public static AuthMeResponse from(User user) {
+        return new AuthMeResponse(
+                user.getId(),
+                user.getEmail(),
+                user.getName()
+        );
+    }
+}

src/main/java/com/rentify/rentify_api/user/exception/UnauthenticatedException.java

@@ -0,0 +1,8 @@
+package com.rentify.rentify_api.user.exception;
+
+public class UnauthenticatedException extends RuntimeException {
+
+    public UnauthenticatedException() {
+        super("인증되지 않은 사용자입ㄴ디ㅏ.");
+    }
+}

src/main/java/com/rentify/rentify_api/user/service/AuthService.java

@@ -0,0 +1,40 @@
+package com.rentify.rentify_api.user.service;
+
+import com.rentify.rentify_api.user.dto.AuthMeResponse;
+import com.rentify.rentify_api.user.entity.User;
+import com.rentify.rentify_api.user.exception.UnauthenticatedException;
+import com.rentify.rentify_api.user.exception.UserNotFoundException;
+import com.rentify.rentify_api.user.repository.UserRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.security.core.Authentication;
+import org.springframework.security.core.context.SecurityContextHolder;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@Service
+@RequiredArgsConstructor
+@Transactional(readOnly = true)
+public class AuthService {
+
+    private final UserRepository userRepository;
+
+    public AuthMeResponse getMe() {
+        Long userId = getCurrentUserId();
+
+        User user = userRepository.findById(userId)
+                .orElseThrow(UserNotFoundException::new);
+
+        return AuthMeResponse.from(user);
+    }
+
+    private Long getCurrentUserId() {
+        Authentication authentication =
+                SecurityContextHolder.getContext().getAuthentication();
+
+        if (authentication == null || !authentication.isAuthenticated()) {
+            throw new UnauthenticatedException();
+        }
+
+        return (Long) authentication.getPrincipal();
+    }
+}