feat: 총동연 월별 1위 동아리 목록 조회 API 구현 (#385)

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: KoSeonJe

src/main/java/ddingdong/ddingdongBE/domain/feed/api/AdminFeedApi.java

@@ -0,0 +1,33 @@
+package ddingdong.ddingdongBE.domain.feed.api;
+
+import ddingdong.ddingdongBE.domain.feed.controller.dto.response.AdminFeedRankingWinnerResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.media.ArraySchema;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.security.SecurityRequirement;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import java.util.List;
+import org.springframework.http.HttpStatus;
+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.ResponseStatus;
+
+@Tag(name = "Feed - Admin", description = "Feed Admin API")
+@RequestMapping("/server/admin/feeds")
+public interface AdminFeedApi {
+
+    @Operation(summary = "총동연 월별 1위 동아리 목록 조회 API")
+    @ApiResponse(responseCode = "200", description = "월별 1위 동아리 목록 조회 성공",
+            content = @Content(array = @ArraySchema(schema = @Schema(implementation = AdminFeedRankingWinnerResponse.class))))
+    @ResponseStatus(HttpStatus.OK)
+    @SecurityRequirement(name = "AccessToken")
+    @GetMapping("/ranking/last")
+    List<AdminFeedRankingWinnerResponse> getMonthlyWinners(
+            @RequestParam("year") @Min(value = 2000, message = "year는 2000 이상이어야 합니다.") @Max(value = 2100, message = "year는 2100 이하여야 합니다.") int year
+    );
+}

src/main/java/ddingdong/ddingdongBE/domain/feed/controller/AdminFeedController.java

@@ -0,0 +1,24 @@
+package ddingdong.ddingdongBE.domain.feed.controller;
+
+import ddingdong.ddingdongBE.domain.feed.api.AdminFeedApi;
+import ddingdong.ddingdongBE.domain.feed.controller.dto.response.AdminFeedRankingWinnerResponse;
+import ddingdong.ddingdongBE.domain.feed.service.FeedRankingService;
+import java.util.List;
+import lombok.RequiredArgsConstructor;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequiredArgsConstructor
+@Validated
+public class AdminFeedController implements AdminFeedApi {
+
+    private final FeedRankingService feedRankingService;
+
+    @Override
+    public List<AdminFeedRankingWinnerResponse> getMonthlyWinners(int year) {
+        return feedRankingService.getMonthlyWinners(year).stream()
+                .map(AdminFeedRankingWinnerResponse::from)
+                .toList();
+    }
+}

src/main/java/ddingdong/ddingdongBE/domain/feed/controller/dto/response/AdminFeedRankingWinnerResponse.java

@@ -0,0 +1,30 @@
+package ddingdong.ddingdongBE.domain.feed.controller.dto.response;
+
+import ddingdong.ddingdongBE.domain.feed.service.dto.query.FeedRankingWinnerQuery;
+import lombok.Builder;
+
+@Builder
+public record AdminFeedRankingWinnerResponse(
+        String clubName,
+        long feedCount,
+        long viewCount,
+        long likeCount,
+        long commentCount,
+        long score,
+        int targetYear,
+        int targetMonth
+) {
+
+    public static AdminFeedRankingWinnerResponse from(FeedRankingWinnerQuery query) {
+        return AdminFeedRankingWinnerResponse.builder()
+                .clubName(query.clubName())
+                .feedCount(query.feedCount())
+                .viewCount(query.viewCount())
+                .likeCount(query.likeCount())
+                .commentCount(query.commentCount())
+                .score(query.score())
+                .targetYear(query.targetYear())
+                .targetMonth(query.targetMonth())
+                .build();
+    }
+}

src/main/java/ddingdong/ddingdongBE/domain/feed/repository/FeedMonthlyRankingRepository.java

@@ -1,9 +1,12 @@
 package ddingdong.ddingdongBE.domain.feed.repository;
 
 import ddingdong.ddingdongBE.domain.feed.entity.FeedMonthlyRanking;
+import java.util.List;
 import org.springframework.data.jpa.repository.JpaRepository;
 
 public interface FeedMonthlyRankingRepository extends JpaRepository<FeedMonthlyRanking, Long> {
 
     boolean existsByTargetYearAndTargetMonth(int targetYear, int targetMonth);
+
+    List<FeedMonthlyRanking> findByTargetYearAndRankingOrderByTargetMonthAsc(int targetYear, int ranking);
 }

src/main/java/ddingdong/ddingdongBE/domain/feed/service/FeedRankingService.java

@@ -0,0 +1,9 @@
+package ddingdong.ddingdongBE.domain.feed.service;
+
+import ddingdong.ddingdongBE.domain.feed.service.dto.query.FeedRankingWinnerQuery;
+import java.util.List;
+
+public interface FeedRankingService {
+
+    List<FeedRankingWinnerQuery> getMonthlyWinners(int year);
+}

src/main/java/ddingdong/ddingdongBE/domain/feed/service/GeneralFeedRankingService.java

@@ -0,0 +1,29 @@
+package ddingdong.ddingdongBE.domain.feed.service;
+
+import ddingdong.ddingdongBE.domain.feed.entity.FeedMonthlyRanking;
+import ddingdong.ddingdongBE.domain.feed.repository.FeedMonthlyRankingRepository;
+import ddingdong.ddingdongBE.domain.feed.service.dto.query.FeedRankingWinnerQuery;
+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 GeneralFeedRankingService implements FeedRankingService {
+
+    private static final int WINNER_RANKING = 1;
+
+    private final FeedMonthlyRankingRepository feedMonthlyRankingRepository;
+
+    @Override
+    public List<FeedRankingWinnerQuery> getMonthlyWinners(int year) {
+        List<FeedMonthlyRanking> rankings =
+                feedMonthlyRankingRepository.findByTargetYearAndRankingOrderByTargetMonthAsc(year, WINNER_RANKING);
+
+        return rankings.stream()
+                .map(FeedRankingWinnerQuery::from)
+                .toList();
+    }
+}

src/main/java/ddingdong/ddingdongBE/domain/feed/service/dto/query/FeedRankingWinnerQuery.java

@@ -0,0 +1,30 @@
+package ddingdong.ddingdongBE.domain.feed.service.dto.query;
+
+import ddingdong.ddingdongBE.domain.feed.entity.FeedMonthlyRanking;
+import lombok.Builder;
+
+@Builder
+public record FeedRankingWinnerQuery(
+        String clubName,
+        long feedCount,
+        long viewCount,
+        long likeCount,
+        long commentCount,
+        long score,
+        int targetYear,
+        int targetMonth
+) {
+
+    public static FeedRankingWinnerQuery from(FeedMonthlyRanking entity) {
+        return FeedRankingWinnerQuery.builder()
+                .clubName(entity.getClubName())
+                .feedCount(entity.getFeedCount())
+                .viewCount(entity.getViewCount())
+                .likeCount(entity.getLikeCount())
+                .commentCount(entity.getCommentCount())
+                .score(entity.getScore())
+                .targetYear(entity.getTargetYear())
+                .targetMonth(entity.getTargetMonth())
+                .build();
+    }
+}

src/test/java/ddingdong/ddingdongBE/common/fixture/FeedMonthlyRankingFixture.java

@@ -0,0 +1,33 @@
+package ddingdong.ddingdongBE.common.fixture;
+
+import ddingdong.ddingdongBE.domain.feed.entity.FeedMonthlyRanking;
+
+public class FeedMonthlyRankingFixture {
+
+    public static FeedMonthlyRanking create(Long clubId, String clubName,
+            long feedCount, long viewCount, long likeCount, long commentCount,
+            int targetYear, int targetMonth, int ranking) {
+        FeedMonthlyRanking entity = FeedMonthlyRanking.builder()
+                .clubId(clubId)
+                .clubName(clubName)
+                .feedCount(feedCount)
+                .viewCount(viewCount)
+                .likeCount(likeCount)
+                .commentCount(commentCount)
+                .targetYear(targetYear)
+                .targetMonth(targetMonth)
+                .build();
+        entity.assignRanking(ranking);
+        return entity;
+    }
+
+    public static FeedMonthlyRanking createWinner(Long clubId, String clubName,
+            int targetYear, int targetMonth) {
+        return create(clubId, clubName, 10, 100, 50, 20, targetYear, targetMonth, 1);
+    }
+
+    public static FeedMonthlyRanking createWithRanking(Long clubId, String clubName,
+            int targetYear, int targetMonth, int ranking) {
+        return create(clubId, clubName, 5, 50, 25, 10, targetYear, targetMonth, ranking);
+    }
+}

src/test/java/ddingdong/ddingdongBE/domain/feed/controller/AdminFeedControllerE2ETest.java

@@ -0,0 +1,96 @@
+package ddingdong.ddingdongBE.domain.feed.controller;
+
+import static io.restassured.RestAssured.given;
+import static org.assertj.core.api.Assertions.assertThat;
+
+import ddingdong.ddingdongBE.auth.controller.dto.request.SignInRequest;
+import ddingdong.ddingdongBE.auth.controller.dto.response.SignInResponse;
+import ddingdong.ddingdongBE.common.fixture.FeedMonthlyRankingFixture;
+import ddingdong.ddingdongBE.common.fixture.UserFixture;
+import ddingdong.ddingdongBE.common.support.NonTxTestContainerSupport;
+import ddingdong.ddingdongBE.domain.feed.controller.dto.response.AdminFeedRankingWinnerResponse;
+import ddingdong.ddingdongBE.domain.feed.repository.FeedMonthlyRankingRepository;
+import ddingdong.ddingdongBE.domain.user.entity.User;
+import ddingdong.ddingdongBE.domain.user.repository.UserRepository;
+import io.restassured.RestAssured;
+import io.restassured.http.ContentType;
+import java.util.List;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.boot.test.web.server.LocalServerPort;
+import org.springframework.security.crypto.password.PasswordEncoder;
+import org.springframework.transaction.annotation.Propagation;
+import org.springframework.transaction.annotation.Transactional;
+
+@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
+class AdminFeedControllerE2ETest extends NonTxTestContainerSupport {
+
+    @LocalServerPort
+    private int port;
+
+    @Autowired
+    private UserRepository userRepository;
+
+    @Autowired
+    private FeedMonthlyRankingRepository feedMonthlyRankingRepository;
+
+    @Autowired
+    private PasswordEncoder passwordEncoder;
+
+    private String adminToken;
+
+    @BeforeEach
+    @Transactional(propagation = Propagation.REQUIRES_NEW)
+    void setUp() {
+        RestAssured.port = port;
+
+        User admin = userRepository.save(
+                UserFixture.createAdminUser(passwordEncoder.encode("1234")));
+
+        feedMonthlyRankingRepository.saveAll(List.of(
+                FeedMonthlyRankingFixture.createWinner(1L, "1월 우승 동아리", 2025, 1),
+                FeedMonthlyRankingFixture.createWinner(2L, "2월 우승 동아리", 2025, 2),
+                FeedMonthlyRankingFixture.createWinner(3L, "3월 우승 동아리", 2025, 3)
+        ));
+
+        adminToken = getAuthToken(admin.getAuthId(), "1234");
+    }
+
+    @DisplayName("총동연 월별 1위 동아리 목록 조회 API - 성공")
+    @Test
+    void getMonthlyWinners_success() {
+        List<AdminFeedRankingWinnerResponse> response = given()
+                .contentType(ContentType.JSON)
+                .header("Authorization", "Bearer " + adminToken)
+                .queryParam("year", 2025)
+                .when()
+                .get("/server/admin/feeds/ranking/last")
+                .then()
+                .statusCode(200)
+                .extract()
+                .jsonPath()
+                .getList(".", AdminFeedRankingWinnerResponse.class);
+
+        assertThat(response).hasSize(3);
+        assertThat(response.get(0).clubName()).isEqualTo("1월 우승 동아리");
+        assertThat(response.get(0).targetMonth()).isEqualTo(1);
+        assertThat(response.get(2).clubName()).isEqualTo("3월 우승 동아리");
+        assertThat(response.get(2).targetMonth()).isEqualTo(3);
+    }
+
+    private String getAuthToken(String authId, String password) {
+        SignInResponse signInResponse = given()
+                .contentType(ContentType.JSON)
+                .body(new SignInRequest(authId, password))
+                .when()
+                .post("/server/auth/sign-in")
+                .then()
+                .statusCode(200)
+                .extract()
+                .as(SignInResponse.class);
+        return signInResponse.getToken();
+    }
+}

src/test/java/ddingdong/ddingdongBE/domain/feed/controller/dto/response/AdminFeedRankingWinnerResponseTest.java

@@ -0,0 +1,41 @@
+package ddingdong.ddingdongBE.domain.feed.controller.dto.response;
+
+import static org.assertj.core.api.SoftAssertions.assertSoftly;
+
+import ddingdong.ddingdongBE.domain.feed.service.dto.query.FeedRankingWinnerQuery;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+class AdminFeedRankingWinnerResponseTest {
+
+    @DisplayName("from - FeedRankingWinnerQuery의 모든 필드를 올바르게 매핑한다")
+    @Test
+    void from_mapsAllFields() {
+        // given
+        FeedRankingWinnerQuery query = FeedRankingWinnerQuery.builder()
+                .clubName("테스트 동아리")
+                .feedCount(10)
+                .viewCount(100)
+                .likeCount(50)
+                .commentCount(20)
+                .score(450)
+                .targetYear(2025)
+                .targetMonth(3)
+                .build();
+
+        // when
+        AdminFeedRankingWinnerResponse response = AdminFeedRankingWinnerResponse.from(query);
+
+        // then
+        assertSoftly(softly -> {
+            softly.assertThat(response.clubName()).isEqualTo("테스트 동아리");
+            softly.assertThat(response.feedCount()).isEqualTo(10);
+            softly.assertThat(response.viewCount()).isEqualTo(100);
+            softly.assertThat(response.likeCount()).isEqualTo(50);
+            softly.assertThat(response.commentCount()).isEqualTo(20);
+            softly.assertThat(response.score()).isEqualTo(450);
+            softly.assertThat(response.targetYear()).isEqualTo(2025);
+            softly.assertThat(response.targetMonth()).isEqualTo(3);
+        });
+    }
+}