✨ feat: 전체 유저 목록 조회 기능

Author: jiwon1217

backend/src/main/java/io/f1/backend/domain/admin/api/AdminController.java

@@ -0,0 +1,30 @@
+package io.f1.backend.domain.admin.api;
+
+import io.f1.backend.domain.admin.app.AdminService;
+import io.f1.backend.domain.admin.dto.UserPageResponse;
+import io.f1.backend.global.validation.LimitPageSize;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.domain.Sort.Direction;
+import org.springframework.data.web.PageableDefault;
+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
+@RequestMapping("/admin")
+@RequiredArgsConstructor
+public class AdminController {
+
+    private final AdminService adminService;
+
+    @GetMapping("/users")
+    @LimitPageSize
+    public ResponseEntity<UserPageResponse> getUsers(
+        @PageableDefault(sort = "lastLogin", direction = Direction.DESC) Pageable pageable
+    ) {
+        UserPageResponse response = adminService.getAllUsers(pageable);
+        return ResponseEntity.ok().body(response);
+    }
+}

backend/src/main/java/io/f1/backend/domain/admin/app/AdminService.java

@@ -0,0 +1,25 @@
+package io.f1.backend.domain.admin.app;
+
+import static io.f1.backend.domain.admin.mapper.AdminMapper.toUserListPageResponse;
+
+import io.f1.backend.domain.admin.dto.UserPageResponse;
+import io.f1.backend.domain.admin.dto.UserResponse;
+import io.f1.backend.domain.user.dao.UserRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@Service
+@RequiredArgsConstructor
+public class AdminService {
+
+    private final UserRepository userRepository;
+
+    @Transactional(readOnly = true)
+    public UserPageResponse getAllUsers(Pageable pageable) {
+        Page<UserResponse> users = userRepository.findAllUsersWithPaging(pageable);
+        return toUserListPageResponse(users);
+    }
+}

backend/src/main/java/io/f1/backend/domain/admin/dto/UserPageResponse.java

@@ -0,0 +1,7 @@
+package io.f1.backend.domain.admin.dto;
+
+import java.util.List;
+
+public record UserPageResponse(int totalPages, int currentPage, int totalElements, List<UserResponse> users) {
+
+}

backend/src/main/java/io/f1/backend/domain/admin/dto/UserResponse.java

@@ -0,0 +1,8 @@
+package io.f1.backend.domain.admin.dto;
+
+import java.time.LocalDateTime;
+
+public record UserResponse(Long id, String nickname, LocalDateTime lastLogin,
+                           LocalDateTime createdAt) {
+
+}

backend/src/main/java/io/f1/backend/domain/admin/mapper/AdminMapper.java

@@ -0,0 +1,22 @@
+package io.f1.backend.domain.admin.mapper;
+
+import io.f1.backend.domain.admin.dto.UserPageResponse;
+import io.f1.backend.domain.admin.dto.UserResponse;
+import org.springframework.data.domain.Page;
+
+public class AdminMapper {
+
+    private AdminMapper() {
+    }
+
+    public static UserPageResponse toUserListPageResponse(Page<UserResponse> userPage) {
+        int curPage = userPage.getNumber() + 1;
+
+        return new UserPageResponse(
+            userPage.getTotalPages(),
+            curPage,
+            userPage.getNumberOfElements(),
+            userPage.getContent()
+        );
+    }
+}

backend/src/main/java/io/f1/backend/domain/user/dao/UserRepository.java

@@ -1,16 +1,25 @@
 package io.f1.backend.domain.user.dao;
 
+import io.f1.backend.domain.admin.dto.UserResponse;
 import io.f1.backend.domain.user.entity.User;
-
+import java.util.Optional;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
 import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
 import org.springframework.stereotype.Repository;
 
-import java.util.Optional;
-
 @Repository
 public interface UserRepository extends JpaRepository<User, Long> {
 
     Optional<User> findByProviderAndProviderId(String provider, String providerId);
 
     Boolean existsUserByNickname(String nickname);
+
+    @Query(
+        "SELECT new io.f1.backend.domain.admin.dto.UserResponse(u.id, u.nickname, u.lastLogin, u.createdAt)" +
+            "FROM User u " +
+            "ORDER BY u.lastLogin DESC"
+    )
+    Page<UserResponse> findAllUsersWithPaging(Pageable pageable);
 }

backend/src/test/java/io/f1/backend/domain/admin/app/AdminServiceTests.java

@@ -0,0 +1,51 @@
+package io.f1.backend.domain.admin.app;
+
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+
+import com.github.database.rider.core.api.dataset.DataSet;
+import io.f1.backend.global.template.BrowserTestTemplate;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.security.test.context.support.WithMockUser;
+import org.springframework.test.web.servlet.ResultActions;
+
+@WithMockUser(roles = "ADMIN")
+public class AdminServiceTests extends BrowserTestTemplate {
+
+    @Test
+    @DataSet("datasets/admin/sorted-user.yml")
+    @DisplayName("가입한 유저가 3명이면 첫 페이지에서 3개의 결과를 반환한다")
+    void totalUser() throws Exception {
+        // when
+        ResultActions result = mockMvc.perform(get("/admin/users"));
+
+        // then
+        result.andExpectAll(
+            status().isOk(),
+            jsonPath("$.totalPages").value(1),
+            jsonPath("$.currentPage").value(1),
+            jsonPath("$.totalElements").value(3),
+            jsonPath("$.users.length()").value(3));
+    }
+
+    @Test
+    @DataSet("datasets/admin/sorted-user.yml")
+    @DisplayName("유저 목록이 최근 로그인 순(내림차순)으로 정렬되어 반환된다")
+    void getUsersSortedByLastLogin() throws Exception {
+        // when
+        ResultActions result = mockMvc.perform(get("/admin/users"));
+        // then
+        result.andExpectAll(
+            status().isOk(),
+            jsonPath("$.totalElements").value(3),
+            // 가장 최근 로그인한 USER3이 첫 번째
+            jsonPath("$.users[0].nickname").value("USER3"),
+            // 중간 로그인한 USER2가 두 번째
+            jsonPath("$.users[1].nickname").value("USER2"),
+            // 가장 오래된 로그인한 USER1이 세 번째
+            jsonPath("$.users[2].nickname").value("USER1")
+        );
+    }
+}

backend/src/test/resources/datasets/admin/sorted-user.yml

@@ -0,0 +1,22 @@
+
+user_test:
+  - id: 1
+    nickname: "USER1"
+    provider: "kakao"
+    provider_id: "kakao1"
+    last_login: 2025-07-16 09:00:00  # 가장 오래된 로그인
+    created_at: 2025-07-01 10:00:00
+
+  - id: 2
+    nickname: "USER2"
+    provider: "kakao"
+    provider_id: "kakao2"
+    last_login: 2025-07-17 12:00:00  # 중간 로그인
+    created_at: 2025-07-02 10:00:00
+
+  - id: 3
+    nickname: "USER3"
+    provider: "kakao"
+    provider_id: "kakao3"
+    last_login: 2025-07-18 15:00:00  # 가장 최근 로그인
+    created_at: 2025-07-03 10:00:00