Merge pull request #191 from SSASINSA/feature/149_admin_user_managment

seungsang2000 · web-flow · commit 69aee671a050 · 2025-12-09T10:57:27.000+09:00
feat: 관리자 계정 관리 로직 추가 (#149)
diff --git a/src/main/java/com/ssasinsa/wearagain/domain/auth/repository/AdminUserRepository.java b/src/main/java/com/ssasinsa/wearagain/domain/auth/repository/AdminUserRepository.java
@@ -3,8 +3,9 @@
 import com.ssasinsa.wearagain.domain.auth.entity.AdminUser;
 import java.util.Optional;
 import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.JpaSpecificationExecutor;
 
-public interface AdminUserRepository extends JpaRepository<AdminUser, Long> {
+public interface AdminUserRepository extends JpaRepository<AdminUser, Long>, JpaSpecificationExecutor<AdminUser> {
 
     Optional<AdminUser> findByEmail(String email);
 
diff --git a/src/main/java/com/ssasinsa/wearagain/domain/event/docs/EventExamples.java b/src/main/java/com/ssasinsa/wearagain/domain/event/docs/EventExamples.java
@@ -407,6 +407,7 @@ private EventExamples() {
                   "displayOrder": 1
                 }
               ],
+              "optionDepth": 3,
               "options": [
                 {
                   "optionId": 2001,
diff --git a/src/main/java/com/ssasinsa/wearagain/domain/event/dto/response/EventDetailResponse.java b/src/main/java/com/ssasinsa/wearagain/domain/event/dto/response/EventDetailResponse.java
@@ -36,6 +36,9 @@ public record EventDetailResponse(
         @Schema(description = "이미지 목록")
         List<EventDetailImageResponse> images,
 
+        @Schema(description = "옵션 최대 깊이", example = "2")
+        int optionDepth,
+
         @Schema(description = "옵션 트리")
         List<EventDetailOptionResponse> options
 ) {
diff --git a/src/main/java/com/ssasinsa/wearagain/domain/event/service/EventUserServiceImpl.java b/src/main/java/com/ssasinsa/wearagain/domain/event/service/EventUserServiceImpl.java
@@ -465,6 +465,7 @@ private EventDetailResponse mapToDetail(
             List<EventOption> rootOptions,
             Map<Long, Long> counts
     ) {
+        int optionDepth = calculateOptionDepth(rootOptions);
         List<EventDetailImageResponse> images = event.getImages()
                 .stream()
                 .sorted(IMAGE_ORDER)
@@ -495,6 +496,7 @@ private EventDetailResponse mapToDetail(
                 event.getEndDate(),
                 event.getStatus().name(),
                 images,
+                optionDepth,
                 options
         );
     }
@@ -522,6 +524,24 @@ private EventDetailOptionResponse mapOption(EventOption option, Map<Long, Long>
         );
     }
 
+    private int calculateOptionDepth(List<EventOption> rootOptions) {
+        if (rootOptions == null || rootOptions.isEmpty()) {
+            return 0;
+        }
+        int maxDepth = 0;
+        Deque<OptionLevel> stack = new ArrayDeque<>();
+        rootOptions.forEach(option -> stack.push(new OptionLevel(option, 1)));
+        while (!stack.isEmpty()) {
+            OptionLevel current = stack.pop();
+            maxDepth = Math.max(maxDepth, current.depth());
+            List<EventOption> children = toDistinctOptions(current.option().getChildOptions());
+            for (EventOption child : children) {
+                stack.push(new OptionLevel(child, current.depth() + 1));
+            }
+        }
+        return maxDepth;
+    }
+
     private Integer safeToInteger(long value) {
         if (value > Integer.MAX_VALUE) {
             return Integer.MAX_VALUE;
@@ -609,4 +629,7 @@ private Map<Long, String> loadThumbnails(List<Event> events) {
         return thumbnails;
     }
 
+    private record OptionLevel(EventOption option, int depth) {
+    }
+
 }
diff --git a/src/main/java/com/ssasinsa/wearagain/domain/user/controller/UserAdminController.java b/src/main/java/com/ssasinsa/wearagain/domain/user/controller/UserAdminController.java
@@ -7,13 +7,20 @@
 import com.ssasinsa.wearagain.domain.user.dto.admin.AdminParticipantStatsResponse;
 import com.ssasinsa.wearagain.domain.user.dto.admin.AdminParticipantSuspensionRequest;
 import com.ssasinsa.wearagain.domain.user.dto.admin.AdminParticipantUpdateRequest;
+import com.ssasinsa.wearagain.domain.user.dto.admin.AdminManagedUserListResponse;
+import com.ssasinsa.wearagain.domain.user.service.AdminManagedUserService;
 import com.ssasinsa.wearagain.domain.user.service.UserAdminService;
+import com.ssasinsa.wearagain.domain.auth.entity.AdminStatus;
+import com.ssasinsa.wearagain.domain.auth.infrastructure.security.AdminAuthenticatedUser;
+import com.ssasinsa.wearagain.domain.user.dto.admin.AdminManagedUserKeywordScope;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 import org.springframework.data.domain.PageRequest;
 import org.springframework.data.domain.Pageable;
 import org.springframework.http.ResponseEntity;
 import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.DeleteMapping;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PathVariable;
 import org.springframework.web.bind.annotation.PutMapping;
@@ -24,16 +31,17 @@
 import io.swagger.v3.oas.annotations.tags.Tag;
 
 @RestController
-@RequestMapping("/api/v1/admin/participants")
+@RequestMapping("/api/v1/admin")
 @PreAuthorize("hasAnyRole('ADMIN','SUPER_ADMIN')")
 @RequiredArgsConstructor
 @Tag(name = AdminParticipantApiDocs.TAG_NAME, description = AdminParticipantApiDocs.TAG_DESCRIPTION)
 public class UserAdminController {
 
     private final UserAdminService userAdminService;
+    private final AdminManagedUserService adminManagedUserService;
 
     @AdminParticipantApiDocs.GetParticipants
-    @GetMapping
+    @GetMapping("/participants")
     public ResponseEntity<AdminParticipantListResponse> getParticipants(
             @RequestParam(value = "suspended", required = false) Boolean suspended,
             @RequestParam(value = "sortBy", defaultValue = "CREATED_DESC") String sortBy,
@@ -54,7 +62,7 @@ public ResponseEntity<AdminParticipantListResponse> getParticipants(
     }
 
     @AdminParticipantApiDocs.GetParticipantDetail
-    @GetMapping("/{participantId}")
+    @GetMapping("/participants/{participantId}")
     public ResponseEntity<AdminParticipantDetailResponse> getParticipantDetail(
             @PathVariable Long participantId
     ) {
@@ -63,14 +71,14 @@ public ResponseEntity<AdminParticipantDetailResponse> getParticipantDetail(
     }
 
     @AdminParticipantApiDocs.GetParticipantStats
-    @GetMapping("/stats")
+    @GetMapping("/participants/stats")
     public ResponseEntity<AdminParticipantStatsResponse> getParticipantStats() {
         AdminParticipantStatsResponse response = userAdminService.getParticipantStats();
         return ResponseEntity.ok(response);
     }
 
     @AdminParticipantApiDocs.UpdateParticipantBalance
-    @PutMapping("/{participantId}")
+    @PutMapping("/participants/{participantId}")
     public ResponseEntity<AdminParticipantDetailResponse> updateParticipant(
             @PathVariable Long participantId,
             @Valid @RequestBody AdminParticipantUpdateRequest request
@@ -79,7 +87,7 @@ public ResponseEntity<AdminParticipantDetailResponse> updateParticipant(
         return ResponseEntity.ok(response);
     }
 
-    @PutMapping("/{participantId}/suspension")
+    @PutMapping("/participants/{participantId}/suspension")
     @AdminParticipantApiDocs.UpdateSuspension
     public ResponseEntity<AdminParticipantDetailResponse> updateSuspension(
             @PathVariable Long participantId,
@@ -88,4 +96,35 @@ public ResponseEntity<AdminParticipantDetailResponse> updateSuspension(
         AdminParticipantDetailResponse response = userAdminService.updateSuspension(participantId, request);
         return ResponseEntity.ok(response);
     }
+
+    @AdminParticipantApiDocs.GetAdminUsers
+    @GetMapping("/admin-users")
+    public ResponseEntity<AdminManagedUserListResponse> getAdminUsers(
+            @RequestParam(value = "status", required = false) AdminStatus status,
+            @RequestParam(value = "sortBy", defaultValue = "CREATED_DESC") String sortBy,
+            @RequestParam(value = "keyword", required = false) String keyword,
+            @RequestParam(value = "keywordScope", required = false) String keywordScope,
+            @RequestParam(value = "page", defaultValue = "0") int page,
+            @RequestParam(value = "size", defaultValue = "20") int size
+    ) {
+        AdminManagedUserListResponse response = adminManagedUserService.getAdminUsers(
+                status,
+                keyword,
+                AdminManagedUserKeywordScope.from(keywordScope),
+                page,
+                size,
+                sortBy
+        );
+        return ResponseEntity.ok(response);
+    }
+
+    @AdminParticipantApiDocs.DeleteAdminUser
+    @DeleteMapping("/admin-users/{adminUserId}")
+    public ResponseEntity<Void> deleteAdminUser(
+            @PathVariable Long adminUserId,
+            @AuthenticationPrincipal AdminAuthenticatedUser principal
+    ) {
+        adminManagedUserService.softDeleteAdminUser(adminUserId, principal.adminId());
+        return ResponseEntity.noContent().build();
+    }
 }
diff --git a/src/main/java/com/ssasinsa/wearagain/domain/user/docs/AdminParticipantApiDocs.java b/src/main/java/com/ssasinsa/wearagain/domain/user/docs/AdminParticipantApiDocs.java
@@ -88,4 +88,31 @@ private AdminParticipantApiDocs() {
     )
     public @interface UpdateSuspension {
     }
+
+    @SecurityRequirement(name = "adminJWT")
+    @Target(ElementType.METHOD)
+    @Retention(RetentionPolicy.RUNTIME)
+    @ApiDoc(
+            summary = "관리자 계정 목록 조회",
+            description = """
+                    ADMIN 또는 SUPER_ADMIN 권한으로 관리자 계정 목록을 조회합니다.
+                    status(상태), keyword/keywordScope(EMAIL|NAME|ALL), sortBy(CREATED_DESC, CREATED_ASC, NAME_ASC, NAME_DESC),
+                    page/size 파라미터를 지원합니다.
+                    """,
+            responseSchema = com.ssasinsa.wearagain.domain.user.dto.admin.AdminManagedUserListResponse.class,
+            responseExample = AdminParticipantExamples.ADMIN_USER_LIST_RESPONSE
+    )
+    public @interface GetAdminUsers {
+    }
+
+    @SecurityRequirement(name = "adminJWT")
+    @Target(ElementType.METHOD)
+    @Retention(RetentionPolicy.RUNTIME)
+    @ApiDoc(
+            summary = "관리자 계정 비활성화",
+            description = "다른 관리자 계정을 소프트 삭제(INACTIVE) 처리합니다. SUPER_ADMIN 계정이나 자기 자신은 삭제할 수 없습니다.",
+            responseSchema = Void.class
+    )
+    public @interface DeleteAdminUser {
+    }
 }
diff --git a/src/main/java/com/ssasinsa/wearagain/domain/user/docs/AdminParticipantExamples.java b/src/main/java/com/ssasinsa/wearagain/domain/user/docs/AdminParticipantExamples.java
@@ -167,4 +167,36 @@ public class AdminParticipantExamples {
               ]
             }
             """;
+
+    public static final String ADMIN_USER_LIST_RESPONSE = """
+            {
+              "content": [
+                {
+                  "adminUserId": 1,
+                  "email": "super@wearagain.kr",
+                  "name": "최고 관리자",
+                  "role": "SUPER_ADMIN",
+                  "status": "ACTIVE",
+                  "lastLoginAt": "2025-12-07T05:20:00Z",
+                  "createdAt": "2025-11-01T02:00:00Z",
+                  "updatedAt": "2025-12-05T09:00:00Z"
+                },
+                {
+                  "adminUserId": 5,
+                  "email": "event.admin@wearagain.kr",
+                  "name": "행사 관리자",
+                  "role": "ADMIN",
+                  "status": "ACTIVE",
+                  "lastLoginAt": "2025-11-25T10:00:00Z",
+                  "createdAt": "2025-11-15T08:30:00Z",
+                  "updatedAt": "2025-11-20T10:10:00Z"
+                }
+              ],
+              "page": 0,
+              "size": 20,
+              "totalElements": 6,
+              "totalPages": 1,
+              "hasNext": false
+            }
+            """;
 }
diff --git a/src/main/java/com/ssasinsa/wearagain/domain/user/dto/admin/AdminManagedUserKeywordScope.java b/src/main/java/com/ssasinsa/wearagain/domain/user/dto/admin/AdminManagedUserKeywordScope.java
@@ -0,0 +1,18 @@
+package com.ssasinsa.wearagain.domain.user.dto.admin;
+
+public enum AdminManagedUserKeywordScope {
+    ALL,
+    EMAIL,
+    NAME;
+
+    public static AdminManagedUserKeywordScope from(String value) {
+        if (value == null || value.isBlank()) {
+            return ALL;
+        }
+        try {
+            return AdminManagedUserKeywordScope.valueOf(value.trim().toUpperCase());
+        } catch (IllegalArgumentException exception) {
+            return ALL;
+        }
+    }
+}
diff --git a/src/main/java/com/ssasinsa/wearagain/domain/user/dto/admin/AdminManagedUserListResponse.java b/src/main/java/com/ssasinsa/wearagain/domain/user/dto/admin/AdminManagedUserListResponse.java
@@ -0,0 +1,33 @@
+package com.ssasinsa.wearagain.domain.user.dto.admin;
+
+import java.util.List;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+
+@Schema(description = "관리자 계정 목록 응답")
+public record AdminManagedUserListResponse(
+        @Schema(description = "관리자 계정 목록")
+        List<AdminManagedUserResponse> content,
+        @Schema(description = "현재 페이지 번호", example = "0")
+        int page,
+        @Schema(description = "페이지 크기", example = "20")
+        int size,
+        @Schema(description = "전체 요소 수", example = "6")
+        long totalElements,
+        @Schema(description = "전체 페이지 수", example = "1")
+        int totalPages,
+        @Schema(description = "다음 페이지 존재 여부", example = "false")
+        boolean hasNext
+) {
+
+    public static AdminManagedUserListResponse of(
+            List<AdminManagedUserResponse> content,
+            int page,
+            int size,
+            long totalElements,
+            int totalPages,
+            boolean hasNext
+    ) {
+        return new AdminManagedUserListResponse(content, page, size, totalElements, totalPages, hasNext);
+    }
+}
diff --git a/src/main/java/com/ssasinsa/wearagain/domain/user/dto/admin/AdminManagedUserResponse.java b/src/main/java/com/ssasinsa/wearagain/domain/user/dto/admin/AdminManagedUserResponse.java
@@ -0,0 +1,32 @@
+package com.ssasinsa.wearagain.domain.user.dto.admin;
+
+import com.ssasinsa.wearagain.domain.auth.entity.AdminRole;
+import com.ssasinsa.wearagain.domain.auth.entity.AdminStatus;
+import com.ssasinsa.wearagain.domain.auth.entity.AdminUser;
+import java.time.OffsetDateTime;
+import java.time.ZoneOffset;
+
+public record AdminManagedUserResponse(
+        Long adminUserId,
+        String email,
+        String name,
+        AdminRole role,
+        AdminStatus status,
+        OffsetDateTime lastLoginAt,
+        OffsetDateTime createdAt,
+        OffsetDateTime updatedAt
+) {
+
+    public static AdminManagedUserResponse from(AdminUser adminUser) {
+        return new AdminManagedUserResponse(
+                adminUser.getId(),
+                adminUser.getEmail(),
+                adminUser.getName(),
+                adminUser.getRole(),
+                adminUser.getStatus(),
+                adminUser.getLastLoginAt() == null ? null : adminUser.getLastLoginAt().atOffset(ZoneOffset.UTC),
+                adminUser.getCreatedAt() == null ? null : adminUser.getCreatedAt().atOffset(ZoneOffset.UTC),
+                adminUser.getUpdatedAt() == null ? null : adminUser.getUpdatedAt().atOffset(ZoneOffset.UTC)
+        );
+    }
+}
diff --git a/src/main/java/com/ssasinsa/wearagain/domain/user/exception/AdminManagementErrorCode.java b/src/main/java/com/ssasinsa/wearagain/domain/user/exception/AdminManagementErrorCode.java
@@ -0,0 +1,35 @@
+package com.ssasinsa.wearagain.domain.user.exception;
+
+import com.ssasinsa.wearagain.global.exception.ErrorCode;
+import org.springframework.http.HttpStatus;
+
+public enum AdminManagementErrorCode implements ErrorCode {
+    ADMIN_USER_NOT_FOUND("UA2001", "관리자 계정을 찾을 수 없습니다.", HttpStatus.NOT_FOUND.value()),
+    DELETE_FORBIDDEN("UA2002", "해당 관리자 계정을 삭제할 수 없습니다.", HttpStatus.FORBIDDEN.value()),
+    INVALID_REQUEST("UA2003", "잘못된 요청입니다.", HttpStatus.BAD_REQUEST.value());
+
+    private final String code;
+    private final String message;
+    private final int status;
+
+    AdminManagementErrorCode(String code, String message, int status) {
+        this.code = code;
+        this.message = message;
+        this.status = status;
+    }
+
+    @Override
+    public String getCode() {
+        return code;
+    }
+
+    @Override
+    public String getMessage() {
+        return message;
+    }
+
+    @Override
+    public int getStatus() {
+        return status;
+    }
+}
diff --git a/src/main/java/com/ssasinsa/wearagain/domain/user/exception/AdminManagementException.java b/src/main/java/com/ssasinsa/wearagain/domain/user/exception/AdminManagementException.java
@@ -0,0 +1,10 @@
+package com.ssasinsa.wearagain.domain.user.exception;
+
+import com.ssasinsa.wearagain.global.exception.CustomException;
+
+public class AdminManagementException extends CustomException {
+
+    public AdminManagementException(AdminManagementErrorCode errorCode) {
+        super(errorCode);
+    }
+}
diff --git a/src/main/java/com/ssasinsa/wearagain/domain/user/repository/AdminManagedUserSpecifications.java b/src/main/java/com/ssasinsa/wearagain/domain/user/repository/AdminManagedUserSpecifications.java
diff --git a/src/main/java/com/ssasinsa/wearagain/domain/user/service/AdminManagedUserService.java b/src/main/java/com/ssasinsa/wearagain/domain/user/service/AdminManagedUserService.java
diff --git a/src/main/java/com/ssasinsa/wearagain/domain/user/service/AdminManagedUserServiceImpl.java b/src/main/java/com/ssasinsa/wearagain/domain/user/service/AdminManagedUserServiceImpl.java
diff --git a/src/test/java/com/ssasinsa/wearagain/domain/event/service/EventUserServiceImplTest.java b/src/test/java/com/ssasinsa/wearagain/domain/event/service/EventUserServiceImplTest.java

Original file line number	Diff line number	Diff line change
`@@ -407,6 +407,7 @@ private EventExamples() {`
`407`	`407`	`"displayOrder": 1`
`408`	`408`	`}`
`409`	`409`	`],`
	`410`	`+ "optionDepth": 3,`
`410`	`411`	`"options": [`
`411`	`412`	`{`
`412`	`413`	`"optionId": 2001,`