Merge pull request #122 from dnd-side-project/feature/#118

Add Word List Api For Admin

src/main/java/com/dnd/spaced/domain/admin/application/AdminService.java

@@ -1,8 +1,12 @@
 package com.dnd.spaced.domain.admin.application;
 
+import com.dnd.spaced.domain.admin.application.dto.request.AdminWordConditionInfoDto;
 import com.dnd.spaced.domain.admin.application.dto.request.AdminWordRequestDto;
 import com.dnd.spaced.domain.admin.application.dto.response.ReportInfoDto;
 import com.dnd.spaced.domain.admin.application.exception.ReportNotFoundException;
+import com.dnd.spaced.domain.admin.domain.repository.AdminRepository;
+import com.dnd.spaced.domain.admin.domain.repository.AdminRepositoryMapper;
+import com.dnd.spaced.domain.admin.domain.repository.dto.request.AdminWordConditionDto;
 import com.dnd.spaced.domain.admin.presentation.dto.response.AdminWordResponse;
 import com.dnd.spaced.domain.comment.application.exception.CommentNotFoundException;
 import com.dnd.spaced.domain.comment.domain.Comment;
@@ -28,6 +32,18 @@ public class AdminService {
     private final WordRepository wordRepository;
     private final ReportRepository reportRepository;
     private final CommentRepository commentRepository;
+    private final AdminRepository adminRepository;
+
+    public List<AdminWordResponse> findAllBy(AdminWordConditionInfoDto dto) {
+        AdminWordConditionDto adminWordConditionDto = AdminRepositoryMapper.to(
+                dto.categoryName(),
+                dto.lastWordName(),
+                dto.pageable()
+        );
+        List<Word> result = adminRepository.findAllBy(adminWordConditionDto);
+
+        return AdminServiceMapper.toAdminWordResponseList(result);
+    }
 
     @Transactional
     public Long createWord(AdminWordRequestDto wordRequestDto) {

src/main/java/com/dnd/spaced/domain/admin/application/AdminServiceMapper.java

@@ -1,5 +1,6 @@
  package com.dnd.spaced.domain.admin.application;
 
+import com.dnd.spaced.domain.admin.application.dto.request.AdminWordConditionInfoDto;
 import com.dnd.spaced.domain.admin.application.dto.request.AdminWordRequestDto;
 import com.dnd.spaced.domain.admin.application.dto.response.ReportInfoDto;
 import com.dnd.spaced.domain.admin.presentation.dto.response.AdminWordResponse;
@@ -8,10 +9,26 @@
 import com.dnd.spaced.domain.word.domain.Word;
 import lombok.AccessLevel;
 import lombok.NoArgsConstructor;
+import org.springframework.data.domain.Pageable;
+import java.util.List;
 
 @NoArgsConstructor(access = AccessLevel.PRIVATE)
 public class AdminServiceMapper {
 
+     public static AdminWordConditionInfoDto to(
+             String categoryName,
+             String lastWordName,
+             Pageable pageable
+     ) {
+         return new AdminWordConditionInfoDto(categoryName, lastWordName, pageable);
+     }
+
+    public static List<AdminWordResponse> toAdminWordResponseList(List<Word> words) {
+        return words.stream()
+                .map(AdminServiceMapper::toResponseDto)
+                .toList();
+    }
+
     public static Word fromCreateRequest(AdminWordRequestDto dto) {
         return Word.builder()
                 .name(dto.name())

src/main/java/com/dnd/spaced/domain/admin/application/dto/request/AdminWordConditionInfoDto.java

@@ -0,0 +1,10 @@
+package com.dnd.spaced.domain.admin.application.dto.request;
+
+import org.springframework.data.domain.Pageable;
+
+public record AdminWordConditionInfoDto(
+        String categoryName,
+        String lastWordName,
+        Pageable pageable)
+{
+}

src/main/java/com/dnd/spaced/domain/admin/application/dto/response/AdminListWordInfoDto.java

@@ -0,0 +1,32 @@
+package com.dnd.spaced.domain.admin.application.dto.response;
+
+import com.dnd.spaced.domain.word.domain.Word;
+
+import java.time.LocalDateTime;
+
+public record AdminListWordInfoDto(
+        Long id,
+        String name,
+        String meaning,
+        String category,
+        int commentCount,
+        int viewCount,
+        String example,
+        LocalDateTime createdAt,
+        LocalDateTime updatedAt
+) {
+
+    public static AdminListWordInfoDto from(Word word) {
+        return new AdminListWordInfoDto(
+                word.getId(),
+                word.getName(),
+                word.getMeaning(),
+                word.getCategory().getName(),
+                word.getCommentCount(),
+                word.getViewCount(),
+                word.getExample().toString(),
+                word.getCreatedAt(),
+                word.getUpdatedAt()
+        );
+    }
+}

src/main/java/com/dnd/spaced/domain/admin/domain/repository/AdminRepository.java

@@ -0,0 +1,11 @@
+package com.dnd.spaced.domain.admin.domain.repository;
+
+import com.dnd.spaced.domain.admin.domain.repository.dto.request.AdminWordConditionDto;
+import com.dnd.spaced.domain.word.domain.Word;
+
+import java.util.List;
+
+public interface AdminRepository {
+    List<Word> findAllBy(AdminWordConditionDto adminWordConditionDto);
+
+}

src/main/java/com/dnd/spaced/domain/admin/domain/repository/AdminRepositoryMapper.java

@@ -0,0 +1,14 @@
+package com.dnd.spaced.domain.admin.domain.repository;
+
+import com.dnd.spaced.domain.admin.domain.repository.dto.request.AdminWordConditionDto;
+import lombok.AccessLevel;
+import lombok.NoArgsConstructor;
+import org.springframework.data.domain.Pageable;
+
+@NoArgsConstructor(access = AccessLevel.PRIVATE)
+public class AdminRepositoryMapper {
+
+    public static AdminWordConditionDto to(String categoryName, String lastWordName, Pageable pageable) {
+        return new AdminWordConditionDto(categoryName, lastWordName, pageable);
+    }
+}

src/main/java/com/dnd/spaced/domain/admin/domain/repository/QuerydslAdminRepository.java

@@ -0,0 +1,101 @@
+package com.dnd.spaced.domain.admin.domain.repository;
+
+import com.dnd.spaced.domain.admin.domain.repository.dto.request.AdminWordConditionDto;
+import com.dnd.spaced.domain.word.domain.Category;
+import com.dnd.spaced.domain.word.domain.Word;
+import com.dnd.spaced.domain.word.domain.exception.InvalidCategoryException;
+import com.dnd.spaced.domain.word.domain.repository.exception.UnsupportedWordSortConditionException;
+import com.dnd.spaced.global.repository.OrderByNull;
+import com.querydsl.core.types.OrderSpecifier;
+import com.querydsl.core.types.dsl.BooleanExpression;
+import com.querydsl.jpa.impl.JPAQueryFactory;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.domain.Sort;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+
+import static com.dnd.spaced.domain.word.domain.QWord.word;
+
+@Repository
+@RequiredArgsConstructor
+public class QuerydslAdminRepository implements AdminRepository{
+
+    private static final String SORT_CONDITION = "name";
+    private static final String IGNORE_CATEGORY = "전체";
+
+    private final JPAQueryFactory queryFactory;
+
+    @Override
+    public List<Word> findAllBy(AdminWordConditionDto adminWordConditionDto) {
+        Sort.Order order = findOrder(adminWordConditionDto.pageable());
+
+        return queryFactory.selectFrom(word)
+                .where(
+                        categoryEq(adminWordConditionDto.categoryName()),
+                        lastWordNameLt(adminWordConditionDto.lastWordName())
+                )
+                .orderBy(orderByName(order))
+                .limit(adminWordConditionDto.pageable().getPageSize())
+                .fetch();
+    }
+
+    private BooleanExpression lastWordNameLt(String lastWordName) {
+        if (lastWordName == null) {
+            return null;
+        }
+
+        return word.name.gt(lastWordName);
+    }
+
+    @SuppressWarnings("unchecked")
+    private OrderSpecifier<String> orderByName(Sort.Order order) {
+        if (order == null) {
+            return OrderByNull.DEFAULT;
+        }
+
+        validateSortCondition(order);
+
+        return calculateOrderSpecifier(order);
+    }
+
+    private void validateSortCondition(Sort.Order order) {
+        String sortCondition = order.getProperty();
+
+        if (!SORT_CONDITION.equals(sortCondition)) {
+            throw new UnsupportedWordSortConditionException();
+        }
+    }
+
+    private OrderSpecifier<String> calculateOrderSpecifier(Sort.Order order) {
+        String sortOrder = order.getDirection().toString();
+
+        if (sortOrder == null || Sort.Direction.ASC.name().equalsIgnoreCase(sortOrder)) {
+            return word.name.asc();
+        }
+
+        return word.name.desc();
+    }
+
+    private BooleanExpression categoryEq(String category) {
+        if (category == null || IGNORE_CATEGORY.equals(category)) {
+            return null;
+        }
+
+        try {
+            Category categoryEnum = Category.findBy(category);
+
+            return word.category.eq(categoryEnum);
+        } catch (InvalidCategoryException e) {
+            return null;
+        }
+    }
+
+    private Sort.Order findOrder(Pageable pageable) {
+        return pageable.getSort()
+                .get()
+                .findAny()
+                .orElse(null);
+    }
+}

src/main/java/com/dnd/spaced/domain/admin/domain/repository/dto/request/AdminWordConditionDto.java

@@ -0,0 +1,10 @@
+package com.dnd.spaced.domain.admin.domain.repository.dto.request;
+
+import org.springframework.data.domain.Pageable;
+
+public record AdminWordConditionDto(
+        String categoryName,
+        String lastWordName,
+        Pageable pageable)
+{
+}

src/main/java/com/dnd/spaced/domain/admin/presentation/AdminController.java

@@ -1,13 +1,17 @@
 package com.dnd.spaced.domain.admin.presentation;
 
 import com.dnd.spaced.domain.admin.application.AdminService;
+import com.dnd.spaced.domain.admin.application.AdminServiceMapper;
 import com.dnd.spaced.domain.admin.application.dto.request.AdminWordRequestDto;
 import com.dnd.spaced.domain.admin.application.dto.response.ReportInfoDto;
 import com.dnd.spaced.domain.admin.presentation.dto.AdminControllerMapper;
+import com.dnd.spaced.domain.admin.presentation.dto.request.AdminMultipleWordConditionRequest;
 import com.dnd.spaced.domain.admin.presentation.dto.response.AdminWordResponse;
 import com.dnd.spaced.domain.admin.presentation.dto.response.ReportListResponse;
+import com.dnd.spaced.global.resolver.word.WordSortCondition;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Pageable;
 import org.springframework.http.ResponseEntity;
 import org.springframework.security.core.Authentication;
 import org.springframework.web.bind.annotation.*;
@@ -23,6 +27,22 @@ public class AdminController implements SwaggerAdminController {
 
     private final AdminService adminService;
 
+    @GetMapping("/allwords")
+    public ResponseEntity<List<AdminWordResponse>> findAllBy(
+            AdminMultipleWordConditionRequest request,
+            @WordSortCondition Pageable pageable
+    ) {
+        List<AdminWordResponse> result = adminService.findAllBy(
+                AdminServiceMapper.to(
+                        request.category(),
+                        request.lastWordName(),
+                        pageable
+                )
+        );
+
+        return ResponseEntity.ok(result);
+    }
+
     @PostMapping("/words")
     public ResponseEntity<Void> createWord(Authentication authentication,
                                            @Valid @RequestBody AdminWordRequestDto wordRequestDto) {

src/main/java/com/dnd/spaced/domain/admin/presentation/dto/request/AdminMultipleWordConditionRequest.java

@@ -0,0 +1,17 @@
+package com.dnd.spaced.domain.admin.presentation.dto.request;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+
+public record AdminMultipleWordConditionRequest(
+
+        @Schema(
+                description = "용어 카테고리",
+                allowableValues = {"전체", "디자인", "개발", "비즈니스"},
+                requiredMode = Schema.RequiredMode.NOT_REQUIRED
+        )
+        String category,
+
+        @Schema(description = "마지막으로 조회한 용어 이름", requiredMode = Schema.RequiredMode.NOT_REQUIRED)
+        String lastWordName
+) {
+}

src/main/java/com/dnd/spaced/domain/admin/presentation/dto/response/AdminListWordInfoResponse.java

@@ -0,0 +1,61 @@
+package com.dnd.spaced.domain.admin.presentation.dto.response;
+
+import com.dnd.spaced.domain.admin.application.dto.response.AdminListWordInfoDto;
+import io.swagger.v3.oas.annotations.media.Schema;
+
+import java.util.Collections;
+import java.util.List;
+
+public record AdminListWordInfoResponse(
+
+        @Schema(description = "용어 정보")
+        List<AdminWordInfoResponse> words,
+
+        @Schema(description = "마지막으로 조회한 용어 이름", nullable = true)
+        String lastWordName
+) {
+
+    public static AdminListWordInfoResponse from(List<AdminListWordInfoDto> dtos) {
+        if (dtos == null || dtos.isEmpty()) {
+            return new AdminListWordInfoResponse(Collections.emptyList(), null);
+        }
+
+        List<AdminWordInfoResponse> words = dtos.stream()
+                .map(AdminWordInfoResponse::from)
+                .toList();
+
+        return new AdminListWordInfoResponse(words, words.get(words.size() - 1).name());
+    }
+
+    private record AdminWordInfoResponse(
+            @Schema(description = "용어 ID")
+            Long id,
+
+            @Schema(description = "용어 이름")
+            String name,
+
+            @Schema(description = "용어 뜻")
+            String meaning,
+
+            @Schema(description = "용어 카테고리", allowableValues = {"개발", "비즈니스", "디자인"})
+            String category,
+
+            @Schema(description = "댓글 개수")
+            int commentCount,
+
+            @Schema(description = "조회수")
+            int viewCount
+    ) {
+
+        public static AdminWordInfoResponse from(AdminListWordInfoDto dto) {
+            return new AdminWordInfoResponse(
+                    dto.id(),
+                    dto.name(),
+                    dto.meaning(),
+                    dto.category(),
+                    dto.commentCount(),
+                    dto.viewCount()
+            );
+        }
+    }
+}