feat: 개발질문 게시판의 해시태그 기능 구현 완료

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

@@ -4,6 +4,7 @@
 import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
+import org.apache.coyote.BadRequestException;
 import org.springframework.security.access.prepost.PreAuthorize;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;

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

@@ -9,7 +9,7 @@
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
-import page.clab.api.domain.community.board.application.dto.response.BoardCategoryResponseDto;
+import page.clab.api.domain.community.board.application.dto.response.BoardOverviewResponseDto;
 import page.clab.api.domain.community.board.application.port.in.RetrieveBoardsByCategoryUseCase;
 import page.clab.api.domain.community.board.domain.BoardCategory;
 import page.clab.api.global.common.dto.ApiResponse;
@@ -33,15 +33,15 @@ public class BoardsByCategoryRetrievalController {
             "DTO의 필드명을 기준으로 정렬 가능하며, 정렬 방향은 오름차순(asc)과 내림차순(desc)이 가능함")
     @PreAuthorize("hasRole('GUEST')")
     @GetMapping("/category")
-    public ApiResponse<PagedResponseDto<BoardCategoryResponseDto>> retrieveBoardsByCategory(
+    public ApiResponse<PagedResponseDto<BoardOverviewResponseDto>> retrieveBoardsByCategory(
             @RequestParam(name = "category") BoardCategory category,
             @RequestParam(name = "page", defaultValue = "0") int page,
             @RequestParam(name = "size", defaultValue = "20") int size,
             @RequestParam(name = "sortBy", defaultValue = "createdAt") List<String> sortBy,
             @RequestParam(name = "sortDirection", defaultValue = "desc") List<String> sortDirection
     ) throws SortingArgumentException, InvalidColumnException {
-        Pageable pageable = pageableUtils.createPageable(page, size, sortBy, sortDirection, BoardCategoryResponseDto.class);
-        PagedResponseDto<BoardCategoryResponseDto> boards = retrieveBoardsByCategoryUseCase.retrieveBoardsByCategory(category, pageable);
+        Pageable pageable = pageableUtils.createPageable(page, size, sortBy, sortDirection, BoardOverviewResponseDto.class);
+        PagedResponseDto<BoardOverviewResponseDto> boards = retrieveBoardsByCategoryUseCase.retrieveBoardsByCategory(category, pageable);
         return ApiResponse.success(boards);
     }
 }

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

@@ -0,0 +1,46 @@
+package page.clab.api.domain.community.board.adapter.in.web;
+
+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.data.domain.Pageable;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+import page.clab.api.domain.community.board.application.dto.response.BoardOverviewResponseDto;
+import page.clab.api.domain.community.board.application.port.in.RetrieveBoardsByHashtagUseCase;
+import page.clab.api.global.common.dto.ApiResponse;
+import page.clab.api.global.common.dto.PagedResponseDto;
+import page.clab.api.global.exception.InvalidColumnException;
+import page.clab.api.global.exception.SortingArgumentException;
+import page.clab.api.global.util.PageableUtils;
+
+@RestController
+@RequestMapping("/api/v1/boards")
+@RequiredArgsConstructor
+@Tag(name = "Community - Board", description = "커뮤니티 게시판")
+public class BoardsByHashtagRetrievalController {
+
+    private final RetrieveBoardsByHashtagUseCase retrieveBoardsByHashtagUseCase;
+    private final PageableUtils pageableUtils;
+
+    @Operation(summary = "[G] 커뮤니티 게시글 해시태그로 조회", description = "ROLE_GUEST 이상의 권한이 필요함<br>" +
+            "DTO의 필드명을 기준으로 정렬 가능하며, 정렬 방향은 오름차순(asc)과 내림차순(desc)이 가능함<br>" +
+            "현재는 카테고리가 개발질문인 게시글만 해시태그가 적용되어 있어서 해당 API의 응답으로 개발질문 게시판만 반환됨")
+    @PreAuthorize("hasRole('GUEST')")
+    @GetMapping("/hashtag")
+    public ApiResponse<PagedResponseDto<BoardOverviewResponseDto>> retrieveBoardsByCategory(
+            @RequestParam(name = "hashtags") List<String> hashtags,
+            @RequestParam(name = "page", defaultValue = "0") int page,
+            @RequestParam(name = "size", defaultValue = "20") int size,
+            @RequestParam(name = "sortBy", defaultValue = "createdAt") List<String> sortBy,
+            @RequestParam(name = "sortDirection", defaultValue = "desc") List<String> sortDirection
+    ) throws SortingArgumentException, InvalidColumnException {
+        Pageable pageable = pageableUtils.createPageable(page, size, sortBy, sortDirection, BoardOverviewResponseDto.class);
+        PagedResponseDto<BoardOverviewResponseDto> boards = retrieveBoardsByHashtagUseCase.retrieveBoardsByHashtag(hashtags, pageable);
+        return ApiResponse.success(boards);
+    }
+}

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

@@ -0,0 +1,42 @@
+package page.clab.api.domain.community.board.adapter.out.persistence;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+import org.hibernate.annotations.SQLDelete;
+import org.hibernate.annotations.SQLRestriction;
+import page.clab.api.global.common.domain.BaseEntity;
+
+@Entity
+@Getter
+@Setter
+@Builder
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@AllArgsConstructor(access = AccessLevel.PRIVATE)
+@SQLDelete(sql = "UPDATE board_hashtag SET is_deleted = true WHERE id = ?")
+@SQLRestriction("is_deleted = false")
+@Table(name = "board_hashtag")
+public class BoardHashtagJpaEntity extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(name = "board_id", nullable = false)
+    private Long boardId;
+
+    @Column(name = "hashtag_id", nullable = false)
+    private Long hashtagId;
+
+    @Column(name = "is_deleted", nullable = false)
+    private Boolean isDeleted;
+}

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

@@ -0,0 +1,12 @@
+package page.clab.api.domain.community.board.adapter.out.persistence;
+
+import org.mapstruct.Mapper;
+import page.clab.api.domain.community.board.domain.BoardHashtag;
+
+@Mapper(componentModel = "spring")
+public interface BoardHashtagMapper {
+
+    BoardHashtagJpaEntity toEntity(BoardHashtag boardHashTag);
+
+    BoardHashtag toDomain(BoardHashtagJpaEntity entity);
+}

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

@@ -0,0 +1,44 @@
+package page.clab.api.domain.community.board.adapter.out.persistence;
+
+import java.util.List;
+import java.util.stream.Collectors;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.stereotype.Component;
+import page.clab.api.domain.community.board.application.port.out.RegisterBoardHashtagPort;
+import page.clab.api.domain.community.board.application.port.out.RetrieveBoardHashtagPort;
+import page.clab.api.domain.community.board.domain.BoardHashtag;
+
+@Component
+@RequiredArgsConstructor
+public class BoardHashtagPersistenceAdapter implements
+        RegisterBoardHashtagPort, RetrieveBoardHashtagPort {
+
+    private final BoardHashtagRepository boardHashtagRepository;
+    private final BoardHashtagMapper mapper;
+    @Override
+    public BoardHashtag save(BoardHashtag boardHashtag) {
+        BoardHashtagJpaEntity entity = mapper.toEntity(boardHashtag);
+        BoardHashtagJpaEntity savedEntity = boardHashtagRepository.save(entity);
+        return mapper.toDomain(savedEntity);
+    }
+
+    @Override
+    public List<BoardHashtag> getAllByBoardId(Long boardId) {
+        return boardHashtagRepository.findAllByBoardId(boardId).stream()
+                .map(mapper::toDomain)
+                .collect(Collectors.toList());
+    }
+
+    @Override
+    public List<BoardHashtag> getAllIncludingDeletedByBoardId(Long boardId) {
+        return boardHashtagRepository.findAllIncludingDeletedByBoardId(boardId).stream()
+                .map(mapper::toDomain)
+                .collect(Collectors.toList());
+    }
+
+    public List<Long> getBoardIdsByHashTagId(List<Long> hashtagIds, Pageable pageable) {
+        return boardHashtagRepository.getBoardIdsByHashTagId(hashtagIds, pageable);
+    }
+}

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

@@ -0,0 +1,16 @@
+package page.clab.api.domain.community.board.adapter.out.persistence;
+
+import java.util.List;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.querydsl.QuerydslPredicateExecutor;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface BoardHashtagRepository extends JpaRepository<BoardHashtagJpaEntity, Long>, BoardHashtagRepositoryCustom, QuerydslPredicateExecutor<BoardHashtagJpaEntity> {
+
+    List<BoardHashtagJpaEntity> findAllByBoardId(Long boardId);
+
+    @Query(value = "SELECT b.* FROM board_hashtag b WHERE b.board_id = :boardId", nativeQuery = true)
+    List<BoardHashtagJpaEntity> findAllIncludingDeletedByBoardId(Long boardId);
+}

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

@@ -0,0 +1,9 @@
+package page.clab.api.domain.community.board.adapter.out.persistence;
+
+import java.util.List;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+
+public interface BoardHashtagRepositoryCustom {
+    List<Long> getBoardIdsByHashTagId(List<Long> hashtagIds, Pageable pageable);
+}

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

@@ -0,0 +1,29 @@
+package page.clab.api.domain.community.board.adapter.out.persistence;
+
+import com.querydsl.jpa.JPQLQuery;
+import com.querydsl.jpa.impl.JPAQueryFactory;
+import java.util.List;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Pageable;
+import org.springframework.stereotype.Repository;
+
+@Repository
+@RequiredArgsConstructor
+public class BoardHashtagRepositoryImpl implements BoardHashtagRepositoryCustom {
+
+    private final JPAQueryFactory queryFactory;
+
+    @Override
+    public List<Long> getBoardIdsByHashTagId(List<Long> hashtagIds, Pageable pageable) {
+        QBoardHashtagJpaEntity boardHashtag = QBoardHashtagJpaEntity.boardHashtagJpaEntity;
+
+        JPQLQuery<Long> query = queryFactory.selectDistinct(boardHashtag.boardId)
+                .from(boardHashtag)
+                .where(boardHashtag.hashtagId.in(hashtagIds)
+                        .and(boardHashtag.isDeleted.eq(false)))
+                .groupBy(boardHashtag.boardId)
+                .having(boardHashtag.hashtagId.count().eq((long) hashtagIds.size()));
+
+        return query.fetch();
+    }
+}

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

@@ -3,9 +3,10 @@
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Component;
 import page.clab.api.domain.community.board.application.dto.request.BoardRequestDto;
-import page.clab.api.domain.community.board.application.dto.response.BoardCategoryResponseDto;
+import page.clab.api.domain.community.board.application.dto.response.BoardOverviewResponseDto;
 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.BoardListResponseDto;
 import page.clab.api.domain.community.board.application.dto.response.BoardMyResponseDto;
 import page.clab.api.domain.community.board.application.dto.response.WriterInfo;
@@ -39,7 +40,7 @@ public Board fromDto(BoardRequestDto requestDto, String memberId, List<UploadedF
                 .build();
     }
 
-    public BoardDetailsResponseDto toDto(Board board, MemberDetailedInfoDto memberInfo, boolean isOwner, List<BoardEmojiCountResponseDto> emojiInfos) {
+    public BoardDetailsResponseDto toDto(Board board, MemberDetailedInfoDto memberInfo, boolean isOwner, List<BoardEmojiCountResponseDto> emojiInfos, List<BoardHashtagResponseDto> boardHashtagInfos) {
         WriterInfo writerInfo = createDetail(board, memberInfo);
         return BoardDetailsResponseDto.builder()
                 .id(board.getId())
@@ -54,17 +55,19 @@ public BoardDetailsResponseDto toDto(Board board, MemberDetailedInfoDto memberIn
                 .imageUrl(board.getImageUrl())
                 .isOwner(isOwner)
                 .emojiInfos(emojiInfos)
+                .boardHashtagInfos(boardHashtagInfos)
                 .createdAt(board.getCreatedAt())
                 .build();
     }
 
-    public BoardMyResponseDto toDto(Board board, MemberBasicInfoDto memberInfo) {
+    public BoardMyResponseDto toDto(Board board, MemberBasicInfoDto memberInfo, List<BoardHashtagResponseDto> boardHashtagInfos) {
         return BoardMyResponseDto.builder()
                 .id(board.getId())
                 .category(board.getCategory().getKey())
                 .writerName(board.isWantAnonymous() ? board.getNickname() : memberInfo.getMemberName())
                 .title(board.getTitle())
                 .imageUrl(board.getImageUrl())
+                .boardHashtagInfos(boardHashtagInfos)
                 .createdAt(board.getCreatedAt())
                 .build();
     }
@@ -78,21 +81,22 @@ public BoardCommentInfoDto toDto(Board board) {
                 .build();
     }
 
-    public BoardCategoryResponseDto toCategoryDto(Board board, MemberDetailedInfoDto memberInfo, Long commentCount) {
+    public BoardOverviewResponseDto toCategoryDto(Board board, MemberDetailedInfoDto memberInfo, Long commentCount, List<BoardHashtagResponseDto> boardHashtagInfos) {
         WriterInfo writerInfo = create(board, memberInfo);
-        return BoardCategoryResponseDto.builder()
+        return BoardOverviewResponseDto.builder()
                 .id(board.getId())
                 .category(board.getCategory().getKey())
                 .writerId(writerInfo.getId())
                 .writerName(writerInfo.getName())
                 .title(board.getTitle())
                 .commentCount(commentCount)
                 .imageUrl(board.getImageUrl())
+                .boardHashtagInfos(boardHashtagInfos)
                 .createdAt(board.getCreatedAt())
                 .build();
     }
 
-    public BoardListResponseDto toListDto(Board board, MemberDetailedInfoDto memberInfo, Long commentCount) {
+    public BoardListResponseDto toListDto(Board board, MemberDetailedInfoDto memberInfo, Long commentCount, List<BoardHashtagResponseDto> boardHashtagInfos) {
         WriterInfo writerInfo = create(board, memberInfo);
         return BoardListResponseDto.builder()
                 .id(board.getId())
@@ -103,6 +107,7 @@ public BoardListResponseDto toListDto(Board board, MemberDetailedInfoDto memberI
                 .content(board.getContent())
                 .commentCount(commentCount)
                 .imageUrl(board.getImageUrl())
+                .boardHashtagInfos(boardHashtagInfos)
                 .createdAt(board.getCreatedAt())
                 .build();
     }

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

@@ -0,0 +1,37 @@
+package page.clab.api.domain.community.board.application.dto.mapper;
+
+import java.util.List;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+import page.clab.api.domain.community.board.application.dto.request.BoardHashtagRequestDto;
+import page.clab.api.domain.community.board.application.dto.response.BoardHashtagResponseDto;
+import page.clab.api.domain.community.board.domain.BoardHashtag;
+
+@Component
+@RequiredArgsConstructor
+public class BoardHashtagDtoMapper {
+
+    public BoardHashtag fromDto(Long boardId, Long hashtagId){
+        return BoardHashtag.builder()
+                .boardId(boardId)
+                .hashtagId(hashtagId)
+                .isDeleted(false)
+                .build();
+    }
+
+    public BoardHashtagRequestDto toDto(Long boardId, List<Long> hashtagIdList) {
+        return BoardHashtagRequestDto.builder()
+                .boardId(boardId)
+                .hashtagIdList(hashtagIdList)
+                .build();
+    }
+
+    public BoardHashtagResponseDto toDto(BoardHashtag boardHashtag, String name) {
+        return BoardHashtagResponseDto.builder()
+                .id(boardHashtag.getId())
+                .boardId(boardHashtag.getBoardId())
+                .name(name)
+                .hashtagId(boardHashtag.getHashtagId())
+                .build();
+    }
+}

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

@@ -0,0 +1,15 @@
+package page.clab.api.domain.community.board.application.dto.request;
+
+import java.util.List;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.Setter;
+
+@Getter
+@Setter
+@Builder
+public class BoardHashtagRequestDto {
+
+    private Long boardId;
+    private List<Long> hashtagIdList;
+}

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

@@ -33,4 +33,7 @@ public class BoardRequestDto {
     @NotNull(message = "{notNull.board.wantAnonymous}")
     @Schema(description = "익명 사용 여부", example = "false", required = true)
     private boolean wantAnonymous;
+
+    @Schema(description = "해시태그 id 리스트", example = "[1, 2]")
+    private List<Long> hashtagIdList;
 }

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

@@ -2,6 +2,7 @@
 
 import io.swagger.v3.oas.annotations.media.Schema;
 import jakarta.validation.constraints.NotNull;
+import java.util.List;
 import lombok.Getter;
 import lombok.Setter;
 import page.clab.api.domain.community.board.domain.BoardCategory;
@@ -25,4 +26,7 @@ public class BoardUpdateRequestDto {
     @NotNull(message = "{notNull.board.wantAnonymous}")
     @Schema(description = "익명 사용 여부", example = "false")
     private boolean wantAnonymous;
+
+    @Schema(description = "해시태그 id 리스트", example = "[1, 2]")
+    private List<Long> hashtagIdList;
 }