사용자 관리 추가

src/main/java/com/kamco/cd/kamcoback/auth/AuthApiController.java

@@ -1,9 +1,11 @@
 package com.kamco.cd.kamcoback.auth;
 
 import com.kamco.cd.kamcoback.auth.dto.AuthDto;
+import com.kamco.cd.kamcoback.auth.dto.AuthDto.Basic;
 import com.kamco.cd.kamcoback.auth.service.AuthService;
 import com.kamco.cd.kamcoback.config.api.ApiResponseDto;
 import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
 import io.swagger.v3.oas.annotations.media.Content;
 import io.swagger.v3.oas.annotations.media.Schema;
 import io.swagger.v3.oas.annotations.responses.ApiResponse;
@@ -11,12 +13,15 @@ import io.swagger.v3.oas.annotations.responses.ApiResponses;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
-@Tag(name = "사용자 관리", description = "사용자 관리 API")
+@Tag(name = "관리자 관리", description = "관리자 관리 API")
 @RestController
 @RequiredArgsConstructor
 @RequestMapping("/api/auth")
@@ -24,12 +29,12 @@ public class AuthApiController {
 
   private final AuthService authService;
 
-  @Operation(summary = "사용자 등록", description = "사용자를 등록 합니다.")
+  @Operation(summary = "관리자 등록", description = "관리자 를 등록 합니다.")
   @ApiResponses(
       value = {
         @ApiResponse(
             responseCode = "201",
-            description = "사용자 등록 성공",
+            description = "관리자 등록 성공",
             content =
                 @Content(
                     mediaType = "application/json",
@@ -41,7 +46,7 @@ public class AuthApiController {
   @PostMapping("/signup")
   public ApiResponseDto<Long> signup(
       @io.swagger.v3.oas.annotations.parameters.RequestBody(
-              description = "사용자 정보",
+              description = "관리자 정보",
               required = true,
               content =
                   @Content(
@@ -52,4 +57,57 @@ public class AuthApiController {
           AuthDto.Signup signup) {
     return ApiResponseDto.createOK(authService.signup(signup));
   }
+
+  @ApiResponses(
+    value = {
+      @ApiResponse(
+        responseCode = "200",
+        description = "조회 성공",
+        content =
+        @Content(
+          mediaType = "application/json",
+          schema = @Schema(implementation = AuthDto.Basic.class))),
+      @ApiResponse(responseCode = "404", description = "코드를 찾을 수 없음", content = @Content),
+      @ApiResponse(responseCode = "500", description = "서버 오류", content = @Content)
+    })
+  @Operation(summary = "관리자 상세조회", description = "관리자 정보를 조회 합니다.")
+  @GetMapping("/detail")
+  public ApiResponseDto<AuthDto.Basic> getDetail(
+    @io.swagger.v3.oas.annotations.parameters.RequestBody(
+      description = "관리자 목록 id",
+      required = true)
+    @RequestParam
+    Long id) {
+    return ApiResponseDto.ok(authService.getFindUserById(id));
+  }
+
+  @Operation(summary = "관리자 목록", description = "관리자 목록 조회")
+  @ApiResponses(
+    value = {
+      @ApiResponse(
+        responseCode = "200",
+        description = "검색 성공",
+        content =
+        @Content(
+          mediaType = "application/json",
+          schema = @Schema(implementation = Page.class))),
+      @ApiResponse(responseCode = "400", description = "잘못된 검색 조건", content = @Content),
+      @ApiResponse(responseCode = "500", description = "서버 오류", content = @Content)
+    })
+  @GetMapping("/list")
+  public ApiResponseDto<Page<Basic>> getUserList(
+    @Parameter(description = "관리자 이름")
+    @RequestParam(required = false) String userNm,
+    @Parameter(description = "페이지 번호 (0부터 시작)", example = "0")
+    @RequestParam(defaultValue = "0") int page,
+    @Parameter(description = "페이지 크기", example = "20")
+    @RequestParam(defaultValue = "20") int size,
+    @Parameter(description = "정렬 조건 (형식: 필드명,방향)", example = "name,asc")
+    @RequestParam(required = false) String sort
+    ) {
+    AuthDto.SearchReq searchReq = new AuthDto.SearchReq(userNm, page, size, sort);
+    Page<AuthDto.Basic> userList = authService.getUserList(searchReq);
+    return ApiResponseDto.ok(userList);
+  }
+
 }