refactor: 해시태그에 카테고리 적용 완료 (#647)

src/main/java/page/clab/api/domain/community/board/adapter/in/web/HotBoardsRetrievalController.java

@@ -2,6 +2,7 @@
 
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
+import java.util.List;
 import lombok.RequiredArgsConstructor;
 import org.springframework.security.access.prepost.PreAuthorize;
 import org.springframework.web.bind.annotation.GetMapping;
@@ -12,8 +13,6 @@
 import page.clab.api.domain.community.board.application.port.in.RetrieveHotBoardsUseCase;
 import page.clab.api.global.common.dto.ApiResponse;
 
-import java.util.List;
-
 @RestController
 @RequestMapping("/api/v1/boards")
 @RequiredArgsConstructor

src/main/java/page/clab/api/domain/community/board/adapter/out/persistence/BoardPersistenceAdapter.java

@@ -1,5 +1,8 @@
 package page.clab.api.domain.community.board.adapter.out.persistence;
 
+import java.time.LocalDateTime;
+import java.util.List;
+import java.util.stream.Collectors;
 import lombok.RequiredArgsConstructor;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
@@ -10,10 +13,6 @@
 import page.clab.api.domain.community.board.domain.BoardCategory;
 import page.clab.api.global.exception.NotFoundException;
 
-import java.time.LocalDateTime;
-import java.util.List;
-import java.util.stream.Collectors;
-
 @Component
 @RequiredArgsConstructor
 public class BoardPersistenceAdapter implements

src/main/java/page/clab/api/domain/community/board/adapter/out/persistence/RedisHotBoardPersistenceAdapter.java

@@ -1,16 +1,15 @@
 package page.clab.api.domain.community.board.adapter.out.persistence;
 
+import java.util.List;
+import java.util.Objects;
+import java.util.Set;
 import lombok.RequiredArgsConstructor;
 import org.springframework.data.redis.core.RedisTemplate;
 import org.springframework.stereotype.Component;
 import page.clab.api.domain.community.board.application.port.out.RegisterHotBoardPort;
 import page.clab.api.domain.community.board.application.port.out.RemoveHotBoardPort;
 import page.clab.api.domain.community.board.application.port.out.RetrieveHotBoardPort;
 
-import java.util.List;
-import java.util.Objects;
-import java.util.Set;
-
 @Component
 @RequiredArgsConstructor
 public class RedisHotBoardPersistenceAdapter implements

src/main/java/page/clab/api/domain/community/board/application/dto/mapper/BoardDtoMapper.java

@@ -7,7 +7,6 @@
 import page.clab.api.domain.community.board.application.dto.response.BoardDetailsResponseDto;
 import page.clab.api.domain.community.board.application.dto.response.BoardEmojiCountResponseDto;
 import page.clab.api.domain.community.board.application.dto.response.BoardHashtagResponseDto;
-import page.clab.api.domain.community.board.application.dto.response.BoardEmojiToggleResponseDto;
 import page.clab.api.domain.community.board.application.dto.response.BoardListResponseDto;
 import page.clab.api.domain.community.board.application.dto.response.BoardMyResponseDto;
 import page.clab.api.domain.community.board.application.dto.response.BoardOverviewResponseDto;

src/main/java/page/clab/api/domain/community/board/application/dto/mapper/BoardHashtagDtoMapper.java

@@ -19,10 +19,10 @@ public BoardHashtag fromDto(Long boardId, Long hashtagId) {
             .build();
     }
 
-    public BoardHashtagRequestDto toDto(Long boardId, List<Long> hashtagIdList) {
+    public BoardHashtagRequestDto toDto(Long boardId, List<String> hashtagNames) {
         return BoardHashtagRequestDto.builder()
             .boardId(boardId)
-            .hashtagIds(hashtagIdList)
+            .hashtagNames(hashtagNames)
             .build();
     }
 

src/main/java/page/clab/api/domain/community/board/application/dto/request/BoardHashtagRequestDto.java

@@ -11,5 +11,5 @@
 public class BoardHashtagRequestDto {
 
     private Long boardId;
-    private List<Long> hashtagIds;
+    private List<String> hashtagNames;
 }

src/main/java/page/clab/api/domain/community/board/application/dto/request/BoardRequestDto.java

@@ -33,6 +33,6 @@ public class BoardRequestDto {
     @Schema(description = "익명 사용 여부", example = "false", required = true)
     private boolean wantAnonymous;
 
-    @Schema(description = "해시태그 id 리스트", example = "[1, 2]")
-    private List<Long> hashtagIdList;
+    @Schema(description = "해시태그 이름 리스트", example = "[\"Java\", \"C++\"]")
+    private List<String> hashtagNames;
 }

src/main/java/page/clab/api/domain/community/board/application/dto/request/BoardUpdateRequestDto.java

@@ -27,6 +27,6 @@ public class BoardUpdateRequestDto {
     @Schema(description = "익명 사용 여부", example = "false")
     private boolean wantAnonymous;
 
-    @Schema(description = "해시태그 id 리스트", example = "[1, 2]")
-    private List<Long> hashtagIdList;
+    @Schema(description = "해시태그 이름 리스트", example = "[\"Java\", \"Devops\"]")
+    private List<String> hashtagNames;
 }

src/main/java/page/clab/api/domain/community/board/application/port/in/RetrieveHotBoardsUseCase.java

@@ -1,8 +1,7 @@
 package page.clab.api.domain.community.board.application.port.in;
 
-import page.clab.api.domain.community.board.application.dto.response.BoardListResponseDto;
-
 import java.util.List;
+import page.clab.api.domain.community.board.application.dto.response.BoardListResponseDto;
 
 public interface RetrieveHotBoardsUseCase {
     List<BoardListResponseDto> retrieveHotBoards(String strategyName);

src/main/java/page/clab/api/domain/community/board/application/port/out/RetrieveBoardPort.java

@@ -1,13 +1,12 @@
 package page.clab.api.domain.community.board.application.port.out;
 
+import java.time.LocalDateTime;
+import java.util.List;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
 import page.clab.api.domain.community.board.domain.Board;
 import page.clab.api.domain.community.board.domain.BoardCategory;
 
-import java.time.LocalDateTime;
-import java.util.List;
-
 public interface RetrieveBoardPort {
 
     Board getById(Long boardId);

src/main/java/page/clab/api/domain/community/board/application/service/BoardHashtagRegisterService.java

@@ -25,9 +25,9 @@ public class BoardHashtagRegisterService implements RegisterBoardHashtagUseCase
     @Override
     public Long registerBoardHashtag(BoardHashtagRequestDto requestDto) {
         Long boardId = requestDto.getBoardId();
-        for (Long hashtagId : requestDto.getHashtagIds()) {
-            Hashtag hashtag = externalRetrieveHashtagUseCase.getById(hashtagId);
-            BoardHashtag boardHashtag = mapper.fromDto(boardId, hashtagId);
+        for (String hashtagName : requestDto.getHashtagNames()) {
+            Hashtag hashtag = externalRetrieveHashtagUseCase.getByName(hashtagName);
+            BoardHashtag boardHashtag = mapper.fromDto(boardId, hashtag.getId());
             registerBoardHashtagPort.save(boardHashtag);
             hashtag.incrementBoardUsage();
             externalRegisterHashtagUseCase.save(hashtag);

src/main/java/page/clab/api/domain/community/board/application/service/BoardRegisterService.java

@@ -53,7 +53,7 @@ public String registerBoard(BoardRequestDto requestDto) throws PermissionDeniedE
         List<UploadedFile> uploadedFiles = uploadedFileService.getUploadedFilesByUrls(requestDto.getFileUrlList());
         Board board = boardDtoMapper.fromDto(requestDto, currentMemberInfo.getMemberId(), uploadedFiles);
         board.validateAccessPermissionForCreation(currentMemberInfo);
-        board.validateBoardHashtagRegistration(requestDto.getHashtagIdList());
+        board.validateBoardHashtagRegistration(requestDto.getHashtagNames());
 
         if (board.shouldNotifyForNewBoard(currentMemberInfo)) {
             externalSendNotificationUseCase.sendNotificationToMember(currentMemberInfo.getMemberId(),
@@ -65,9 +65,9 @@ public String registerBoard(BoardRequestDto requestDto) throws PermissionDeniedE
 
         Board savedBoard = registerBoardPort.save(board);
 
-        if (requestDto.getHashtagIdList() != null) {
+        if (requestDto.getHashtagNames() != null && !requestDto.getHashtagNames().isEmpty()) {
             registerBoardHashtagUseCase.registerBoardHashtag(
-                boardHashtagDtoMapper.toDto(savedBoard.getId(), requestDto.getHashtagIdList()));
+                boardHashtagDtoMapper.toDto(savedBoard.getId(), requestDto.getHashtagNames()));
         }
         return savedBoard.getCategory().getKey();
     }

src/main/java/page/clab/api/domain/community/board/application/service/BoardUpdateService.java

@@ -47,7 +47,11 @@ public String updateBoard(Long boardId, BoardUpdateRequestDto requestDto) throws
 
         board.update(requestDto);
 
-        List<Long> hastagIdList = requestDto.getHashtagIdList();
+        List<String> hashtagNames = requestDto.getHashtagNames();
+
+        List<Long> hastagIdList = hashtagNames.stream()
+            .map(externalRetrieveHashtagUseCase::getIdByName)
+            .toList();
         handleBoardHashtagUpdate(boardId, board, hastagIdList);
 
         eventPublisher.publishEvent(new BoardUpdatedEvent(this, board.getId()));
@@ -70,6 +74,9 @@ private void deleteAllHashtagsForBoard(Long boardId) {
         currentBoardHashtags.forEach(boardHashtag -> {
             if (!boardHashtag.getIsDeleted()) {
                 boardHashtag.toggleIsDeletedStatus();
+                Hashtag hashtag = externalRetrieveHashtagUseCase.getById(boardHashtag.getHashtagId());
+                hashtag.decreaseBoardUsage();
+                externalRegisterHashtagUseCase.save(hashtag);
                 registerBoardHashtagPort.save(boardHashtag);
             }
         });
@@ -151,7 +158,8 @@ private void addOrUpdateHashtag(Long boardId, Long hashtagId, List<BoardHashtag>
                 },
                 () -> {
                     registerBoardHashtagUseCase.registerBoardHashtag(
-                        boardHashtagDtoMapper.toDto(boardId, List.of(hashtagId))
+                        boardHashtagDtoMapper.toDto(boardId,
+                            List.of(externalRetrieveHashtagUseCase.getNameById(hashtagId)))
                     );
                 }
             );

src/main/java/page/clab/api/domain/community/board/application/service/DefaultHotBoardSelectionStrategy.java

@@ -1,5 +1,11 @@
 package page.clab.api.domain.community.board.application.service;
 
+import java.time.DayOfWeek;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.Comparator;
+import java.util.List;
+import java.util.stream.Collectors;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
@@ -8,13 +14,6 @@
 import page.clab.api.domain.community.board.domain.Board;
 import page.clab.api.external.community.comment.application.port.ExternalRetrieveCommentUseCase;
 
-import java.time.DayOfWeek;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-import java.util.Comparator;
-import java.util.List;
-import java.util.stream.Collectors;
-
 @Service(HotBoardSelectionStrategies.DEFAULT)
 @RequiredArgsConstructor
 public class DefaultHotBoardSelectionStrategy implements HotBoardSelectionStrategy {

src/main/java/page/clab/api/domain/community/board/application/service/HotBoardRegisterService.java

@@ -1,5 +1,7 @@
 package page.clab.api.domain.community.board.application.service;
 
+import java.util.List;
+import java.util.Map;
 import lombok.RequiredArgsConstructor;
 import org.springframework.scheduling.annotation.Scheduled;
 import org.springframework.stereotype.Service;
@@ -8,9 +10,6 @@
 import page.clab.api.domain.community.board.application.port.out.RemoveHotBoardPort;
 import page.clab.api.domain.community.board.domain.Board;
 
-import java.util.List;
-import java.util.Map;
-
 @Service
 @RequiredArgsConstructor
 public class HotBoardRegisterService {

src/main/java/page/clab/api/domain/community/board/application/service/HotBoardRetrievalService.java

@@ -2,6 +2,8 @@
 
 import com.drew.lang.annotations.NotNull;
 import jakarta.transaction.Transactional;
+import java.util.List;
+import java.util.Map;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 import page.clab.api.domain.community.board.application.dto.mapper.BoardDtoMapper;
@@ -15,9 +17,6 @@
 import page.clab.api.external.community.comment.application.port.ExternalRetrieveCommentUseCase;
 import page.clab.api.external.memberManagement.member.application.port.ExternalRetrieveMemberUseCase;
 
-import java.util.List;
-import java.util.Map;
-
 @Service
 @RequiredArgsConstructor
 public class HotBoardRetrievalService implements RetrieveHotBoardsUseCase {

src/main/java/page/clab/api/domain/community/board/application/service/HotBoardSelectionStrategy.java

@@ -1,8 +1,7 @@
 package page.clab.api.domain.community.board.application.service;
 
-import page.clab.api.domain.community.board.domain.Board;
-
 import java.util.List;
+import page.clab.api.domain.community.board.domain.Board;
 
 public interface HotBoardSelectionStrategy {
     List<Board> getHotBoards();

src/main/java/page/clab/api/domain/community/board/domain/Board.java

@@ -75,8 +75,8 @@ public void validateAccessPermissionForCreation(MemberDetailedInfoDto currentMem
         }
     }
 
-    public void validateBoardHashtagRegistration(List<Long> hashtagIds) {
-        if (!isDevelopmentQna() && (hashtagIds != null && !hashtagIds.isEmpty())) {
+    public void validateBoardHashtagRegistration(List<String> hashtagNames) {
+        if (!isDevelopmentQna() && (hashtagNames != null && !hashtagNames.isEmpty())) {
             throw new InvalidBoardCategoryHashtagException("개발질문 게시판에만 해시태그를 등록할 수 있습니다.");
         }
     }

src/main/java/page/clab/api/domain/community/hashtag/adapter/in/web/HashtagRegisterController.java

@@ -27,7 +27,7 @@ public class HashtagRegisterController {
     @PreAuthorize("hasRole('ADMIN')")
     @PostMapping("")
     public ApiResponse<List<HashtagResponseDto>> registerHashtag(
-        @Valid @RequestBody HashtagRequestDto requestDto
+        @Valid @RequestBody List<HashtagRequestDto> requestDto
     ) {
         List<HashtagResponseDto> hashTags = registerHashtagUseCase.registerHashtag(requestDto);
         return ApiResponse.success(hashTags);

src/main/java/page/clab/api/domain/community/hashtag/adapter/out/persistence/HashtagJpaEntity.java

@@ -2,6 +2,8 @@
 
 import jakarta.persistence.Column;
 import jakarta.persistence.Entity;
+import jakarta.persistence.EnumType;
+import jakarta.persistence.Enumerated;
 import jakarta.persistence.GeneratedValue;
 import jakarta.persistence.GenerationType;
 import jakarta.persistence.Id;
@@ -14,6 +16,7 @@
 import lombok.Setter;
 import org.hibernate.annotations.SQLDelete;
 import org.hibernate.annotations.SQLRestriction;
+import page.clab.api.domain.community.hashtag.domain.HashtagCategory;
 import page.clab.api.global.common.domain.BaseEntity;
 
 @Entity
@@ -34,6 +37,10 @@ public class HashtagJpaEntity extends BaseEntity {
     @Column(name = "name", unique = true, nullable = false)
     private String name;
 
+    @Column(name = "hashtag_category", nullable = false)
+    @Enumerated(EnumType.STRING)
+    private HashtagCategory hashtagCategory;
+
     @Column(name = "board_usage", nullable = false)
     private Long boardUsage;
 

src/main/java/page/clab/api/domain/community/hashtag/application/dto/mapper/HashtagDtoMapper.java

@@ -4,14 +4,16 @@
 import org.springframework.stereotype.Component;
 import page.clab.api.domain.community.hashtag.application.dto.response.HashtagResponseDto;
 import page.clab.api.domain.community.hashtag.domain.Hashtag;
+import page.clab.api.domain.community.hashtag.domain.HashtagCategory;
 
 @Component
 @RequiredArgsConstructor
 public class HashtagDtoMapper {
 
-    public Hashtag of(String name) {
+    public Hashtag of(String name, HashtagCategory hashtagCategory) {
         return Hashtag.builder()
             .name(name)
+            .hashtagCategory(hashtagCategory)
             .boardUsage(0L)
             .isDeleted(false)
             .build();
@@ -21,6 +23,7 @@ public HashtagResponseDto toDto(Hashtag hashtag) {
         return HashtagResponseDto.builder()
             .id(hashtag.getId())
             .name(hashtag.getName())
+            .hashtagCategory(hashtag.getHashtagCategory().getKey())
             .boardUsageCount(hashtag.getBoardUsage())
             .build();
     }

src/main/java/page/clab/api/domain/community/hashtag/application/dto/request/HashtagRequestDto.java

@@ -1,13 +1,17 @@
 package page.clab.api.domain.community.hashtag.application.dto.request;
 
-import java.util.ArrayList;
-import java.util.List;
+import jakarta.validation.constraints.NotNull;
 import lombok.Getter;
 import lombok.Setter;
+import page.clab.api.domain.community.hashtag.domain.HashtagCategory;
 
 @Getter
 @Setter
 public class HashtagRequestDto {
 
-    List<String> hashtagNames = new ArrayList<>();
+    @NotNull
+    private String name;
+
+    @NotNull
+    private HashtagCategory hashtagCategory;
 }

src/main/java/page/clab/api/domain/community/hashtag/application/dto/response/HashtagResponseDto.java

@@ -9,5 +9,6 @@ public class HashtagResponseDto {
 
     private Long id;
     private String name;
+    private String hashtagCategory;
     private Long boardUsageCount;
 }

src/main/java/page/clab/api/domain/community/hashtag/application/port/in/RegisterHashtagUseCase.java

@@ -6,5 +6,5 @@
 
 public interface RegisterHashtagUseCase {
 
-    List<HashtagResponseDto> registerHashtag(HashtagRequestDto requestDto);
+    List<HashtagResponseDto> registerHashtag(List<HashtagRequestDto> requestDto);
 }