[BE] feat: 학교 북마크 기능 추가 (#787)

backend/src/main/java/com/festago/bookmark/application/SchoolBookmarkAppendValidator.java

@@ -0,0 +1,34 @@
+package com.festago.bookmark.application;
+
+import com.festago.bookmark.domain.BookmarkType;
+import com.festago.bookmark.repository.BookmarkRepository;
+import com.festago.common.exception.ErrorCode;
+import com.festago.common.exception.NotFoundException;
+import com.festago.school.repository.SchoolRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+
+@Component
+@RequiredArgsConstructor
+public class SchoolBookmarkAppendValidator {
+
+    private static final int BOOKMARK_MAXIMUM_COUNT = 12;
+    private final BookmarkRepository bookmarkRepository;
+    private final SchoolRepository schoolRepository;
+
+    //TODO: 커스텀 예외 적용
+    public void validate(Long schoolId, Long memberId) {
+        if (!schoolRepository.existsById(schoolId)) {
+            throw new NotFoundException(ErrorCode.SCHOOL_NOT_FOUND);
+        }
+
+        if (bookmarkRepository.existsByBookmarkTypeAndMemberIdAndResourceId(BookmarkType.SCHOOL, memberId, schoolId)) {
+            throw new IllegalArgumentException("이미 저장된 북마크입니다.");
+        }
+
+        long bookmarkCount = bookmarkRepository.countByMemberIdAndBookmarkType(memberId, BookmarkType.SCHOOL);
+        if (bookmarkCount >= BOOKMARK_MAXIMUM_COUNT) {
+            throw new IllegalArgumentException("북마크는 저장 갯수를 초과하였습니다.");
+        }
+    }
+}

backend/src/main/java/com/festago/bookmark/application/SchoolBookmarkCommandService.java

@@ -0,0 +1,27 @@
+package com.festago.bookmark.application;
+
+import com.festago.bookmark.domain.Bookmark;
+import com.festago.bookmark.domain.BookmarkType;
+import com.festago.bookmark.repository.BookmarkRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@Service
+@Transactional
+@RequiredArgsConstructor
+public class SchoolBookmarkCommandService {
+
+    private final BookmarkRepository bookmarkRepository;
+    private final SchoolBookmarkAppendValidator schoolBookmarkAppendValidator;
+
+    public Long save(Long schoolId, Long memberId) {
+        schoolBookmarkAppendValidator.validate(schoolId, memberId);
+        return bookmarkRepository.save(new Bookmark(BookmarkType.SCHOOL, schoolId, memberId))
+            .getId();
+    }
+
+    public void delete(Long schoolId, Long memberId) {
+        bookmarkRepository.deleteByBookmarkTypeAndMemberIdAndResourceId(BookmarkType.SCHOOL, memberId, schoolId);
+    }
+}

backend/src/main/java/com/festago/bookmark/application/SchoolBookmarkV1QueryService.java

@@ -0,0 +1,21 @@
+package com.festago.bookmark.application;
+
+import com.festago.bookmark.dto.v1.SchoolBookmarkV1Response;
+import com.festago.bookmark.repository.SchoolBookmarkV1QuerydslRepository;
+import java.util.List;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@Service
+@RequiredArgsConstructor
+@Transactional(readOnly = true)
+public class SchoolBookmarkV1QueryService {
+
+    private final SchoolBookmarkV1QuerydslRepository schoolBookmarkV1QuerydslRepository;
+
+    public List<SchoolBookmarkV1Response> findAllByMemberId(Long memberId) {
+        return schoolBookmarkV1QuerydslRepository.findAllByMemberId(memberId);
+    }
+}
+

backend/src/main/java/com/festago/bookmark/dto/v1/SchoolBookmarkV1Response.java

@@ -0,0 +1,15 @@
+package com.festago.bookmark.dto.v1;
+
+import com.festago.school.dto.v1.SchoolSearchV1Response;
+import com.querydsl.core.annotations.QueryProjection;
+import java.time.LocalDateTime;
+
+public record SchoolBookmarkV1Response(
+    SchoolSearchV1Response school,
+    LocalDateTime bookmarkCreatedAt
+) {
+
+    @QueryProjection
+    public SchoolBookmarkV1Response {
+    }
+}

backend/src/main/java/com/festago/bookmark/presentation/SchoolBookmarkV1Controller.java

@@ -0,0 +1,28 @@
+package com.festago.bookmark.presentation;
+
+import com.festago.auth.annotation.Member;
+import com.festago.bookmark.application.SchoolBookmarkV1QueryService;
+import com.festago.bookmark.dto.v1.SchoolBookmarkV1Response;
+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.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/v1/bookmarks/schools")
+@Tag(name = "학교 북마크 API V1")
+public class SchoolBookmarkV1Controller {
+
+    private final SchoolBookmarkV1QueryService schoolBookmarkV1QueryService;
+
+    @GetMapping
+    @Operation(description = "특정한 회원의 학교 북마크 목록을 반환한다", summary = "회원 학교 북마크 목록 조회")
+    public ResponseEntity<List<SchoolBookmarkV1Response>> findAllByMemberId(@Member Long memberId) {
+        return ResponseEntity.ok(schoolBookmarkV1QueryService.findAllByMemberId(memberId));
+    }
+}

backend/src/main/java/com/festago/bookmark/repository/SchoolBookmarkV1QuerydslRepository.java

@@ -0,0 +1,31 @@
+package com.festago.bookmark.repository;
+
+import static com.festago.bookmark.domain.QBookmark.bookmark;
+import static com.festago.school.domain.QSchool.school;
+
+import com.festago.bookmark.domain.Bookmark;
+import com.festago.bookmark.domain.BookmarkType;
+import com.festago.bookmark.dto.v1.QSchoolBookmarkV1Response;
+import com.festago.bookmark.dto.v1.SchoolBookmarkV1Response;
+import com.festago.common.querydsl.QueryDslRepositorySupport;
+import com.festago.school.dto.v1.QSchoolSearchV1Response;
+import java.util.List;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public class SchoolBookmarkV1QuerydslRepository extends QueryDslRepositorySupport {
+
+    protected SchoolBookmarkV1QuerydslRepository() {
+        super(Bookmark.class);
+    }
+
+    public List<SchoolBookmarkV1Response> findAllByMemberId(Long memberId) {
+        return select(new QSchoolBookmarkV1Response(
+            new QSchoolSearchV1Response(school.id, school.name, school.logoUrl), bookmark.createdAt))
+            .from(bookmark)
+            .innerJoin(school).on(school.id.eq(bookmark.resourceId)
+                .and(bookmark.memberId.eq(memberId))
+                .and(bookmark.bookmarkType.eq(BookmarkType.SCHOOL)))
+            .fetch();
+    }
+}

backend/src/main/java/com/festago/school/dto/v1/SchoolSearchV1Response.java

@@ -0,0 +1,14 @@
+package com.festago.school.dto.v1;
+
+import com.querydsl.core.annotations.QueryProjection;
+
+public record SchoolSearchV1Response(
+    Long id,
+    String name,
+    String logoUrl
+) {
+
+    @QueryProjection
+    public SchoolSearchV1Response {
+    }
+}

backend/src/main/java/com/festago/school/repository/SchoolRepository.java

@@ -6,9 +6,21 @@
 import com.festago.school.domain.SchoolRegion;
 import java.util.List;
 import java.util.Optional;
-import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.repository.Repository;
 
-public interface SchoolRepository extends JpaRepository<School, Long> {
+public interface SchoolRepository extends Repository<School, Long> {
+
+    School save(School school);
+
+    List<School> findAll();
+
+    Optional<School> findById(Long schoolId);
+
+    void deleteById(Long id);
+
+    void flush();
+
+    boolean existsById(Long id);
 
     default School getOrThrow(Long schoolId) {
         return findById(schoolId)

backend/src/test/java/com/festago/bookmark/application/SchoolBookmarkAppendValidatorTest.java

@@ -0,0 +1,70 @@
+package com.festago.bookmark.application;
+
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
+
+import com.festago.bookmark.domain.Bookmark;
+import com.festago.bookmark.domain.BookmarkType;
+import com.festago.bookmark.repository.BookmarkRepository;
+import com.festago.bookmark.repository.MemoryBookmarkRepository;
+import com.festago.common.exception.ErrorCode;
+import com.festago.common.exception.NotFoundException;
+import com.festago.school.repository.MemorySchoolRepository;
+import com.festago.school.repository.SchoolRepository;
+import com.festago.support.SchoolFixture;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayNameGeneration;
+import org.junit.jupiter.api.DisplayNameGenerator.ReplaceUnderscores;
+import org.junit.jupiter.api.Test;
+
+@DisplayNameGeneration(ReplaceUnderscores.class)
+@SuppressWarnings("NonAsciiCharacters")
+class SchoolBookmarkAppendValidatorTest {
+
+    BookmarkRepository bookmarkRepository;
+    SchoolRepository schoolRepository;
+    SchoolBookmarkAppendValidator schoolBookmarkAppendValidator;
+
+    @BeforeEach
+    void setUp() {
+        bookmarkRepository = new MemoryBookmarkRepository();
+        schoolRepository = new MemorySchoolRepository();
+        schoolBookmarkAppendValidator = new SchoolBookmarkAppendValidator(bookmarkRepository, schoolRepository);
+    }
+
+    @Test
+    void 해당하는_학교가_없으면_예외() {
+        // when && then
+        assertThatThrownBy(() -> schoolBookmarkAppendValidator.validate(-1L, 1L))
+            .isInstanceOf(NotFoundException.class)
+            .hasMessage(ErrorCode.SCHOOL_NOT_FOUND.getMessage());
+    }
+
+    @Test
+    void 학교_북마크_갯수가_이미_12개_이상이면_예외() {
+        // given
+        Long memberId = 1L;
+        for (long i = 0; i < 12; i++) {
+            Long schoolId = schoolRepository.save(SchoolFixture.school().build()).getId();
+            bookmarkRepository.save(new Bookmark(BookmarkType.SCHOOL, schoolId, memberId));
+        }
+
+        Long schoolId = schoolRepository.save(SchoolFixture.school().build()).getId();
+
+        // when && then
+        assertThatThrownBy(() -> schoolBookmarkAppendValidator.validate(schoolId, memberId))
+            .isInstanceOf(IllegalArgumentException.class)
+            .hasMessage("북마크는 저장 갯수를 초과하였습니다.");
+    }
+
+    @Test
+    void 이미_해당하는_북마크가_저장됐다면_예외() {
+        // given
+        Long schoolId = schoolRepository.save(SchoolFixture.school().build()).getId();
+        bookmarkRepository.save(new Bookmark(BookmarkType.SCHOOL, schoolId, 1L));
+
+        // when && then
+        assertThatThrownBy(() -> schoolBookmarkAppendValidator.validate(schoolId, 1L))
+            .isInstanceOf(IllegalArgumentException.class)
+            .hasMessage("이미 저장된 북마크입니다.");
+    }
+}

backend/src/test/java/com/festago/bookmark/application/SchoolBookmarkCommandIntegrationServiceTest.java

@@ -0,0 +1,69 @@
+package com.festago.bookmark.application;
+
+import static com.festago.bookmark.domain.BookmarkType.SCHOOL;
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.mockito.Mockito.only;
+import static org.mockito.Mockito.verify;
+
+import com.festago.bookmark.domain.Bookmark;
+import com.festago.bookmark.repository.BookmarkRepository;
+import com.festago.member.repository.MemberRepository;
+import com.festago.school.repository.SchoolRepository;
+import com.festago.support.ApplicationIntegrationTest;
+import com.festago.support.MemberFixture;
+import com.festago.support.SchoolFixture;
+import org.junit.jupiter.api.DisplayNameGeneration;
+import org.junit.jupiter.api.DisplayNameGenerator.ReplaceUnderscores;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.mock.mockito.MockBean;
+
+@DisplayNameGeneration(ReplaceUnderscores.class)
+@SuppressWarnings("NonAsciiCharacters")
+class SchoolBookmarkCommandIntegrationServiceTest extends ApplicationIntegrationTest {
+
+    @Autowired
+    SchoolRepository schoolRepository;
+
+    @Autowired
+    BookmarkRepository bookmarkRepository;
+
+    @Autowired
+    MemberRepository memberRepository;
+
+    @Autowired
+    SchoolBookmarkCommandService schoolBookmarkCommandService;
+
+    @MockBean
+    SchoolBookmarkAppendValidator schoolBookmarkAppendValidator;
+
+    @Test
+    void 북마크_저장_성공() {
+        // given
+        Long memberId = memberRepository.save(MemberFixture.member().build()).getId();
+        Long schoolId = schoolRepository.save(SchoolFixture.school().build()).getId();
+
+        // when
+        Long actual = schoolBookmarkCommandService.save(schoolId, memberId);
+
+        // then
+        assertThat(actual).isPositive();
+        verify(schoolBookmarkAppendValidator, only()).validate(schoolId, memberId);
+    }
+
+    @Test
+    void 북마크를_삭제한다() {
+        // given
+        Long memberId = memberRepository.save(MemberFixture.member().build()).getId();
+        Long schoolId = schoolRepository.save(SchoolFixture.school().build()).getId();
+        bookmarkRepository.save(new Bookmark(SCHOOL, schoolId, memberId));
+
+        // when
+        schoolBookmarkCommandService.delete(schoolId, memberId);
+
+        // then
+        var actual = bookmarkRepository.existsByBookmarkTypeAndMemberIdAndResourceId(SCHOOL, memberId,
+            schoolId);
+        assertThat(actual).isFalse();
+    }
+}