Feature/283 봉사 시간 랭킹 기능 구현

src/main/java/com/somemore/domains/volunteerrecord/dto/response/VolunteerMonthlyRankingResponseDto.java

@@ -0,0 +1,10 @@
+package com.somemore.domains.volunteerrecord.dto.response;
+
+import java.util.UUID;
+
+public record VolunteerMonthlyRankingResponseDto(
+        UUID volunteerId,
+        int totalHours,
+        long ranking
+) {
+}

src/main/java/com/somemore/domains/volunteerrecord/dto/response/VolunteerRankingResponseDto.java

@@ -0,0 +1,28 @@
+package com.somemore.domains.volunteerrecord.dto.response;
+
+import com.fasterxml.jackson.databind.PropertyNamingStrategies;
+import com.fasterxml.jackson.databind.annotation.JsonNaming;
+import com.somemore.domains.center.dto.response.PreferItemResponseDto;
+import lombok.Builder;
+
+import java.util.List;
+
+@JsonNaming(PropertyNamingStrategies.SnakeCaseStrategy.class)
+@Builder
+public record VolunteerRankingResponseDto(
+        List<VolunteerTotalRankingResponseDto> volunteerTotalRankingResponse,
+        List<VolunteerMonthlyRankingResponseDto> volunteerMonthlyResponse,
+        List<VolunteerWeeklyRankingResponseDto> volunteerWeeklyRankingResponse
+) {
+    public static VolunteerRankingResponseDto of(
+            List<VolunteerTotalRankingResponseDto> totalRanking,
+            List<VolunteerMonthlyRankingResponseDto> monthlyRanking,
+            List<VolunteerWeeklyRankingResponseDto> weeklyRanking){
+
+        return VolunteerRankingResponseDto.builder()
+                .volunteerTotalRankingResponse(totalRanking)
+                .volunteerMonthlyResponse(monthlyRanking)
+                .volunteerWeeklyRankingResponse(weeklyRanking)
+                .build();
+    }
+}

src/main/java/com/somemore/domains/volunteerrecord/dto/response/VolunteerTotalRankingResponseDto.java

@@ -0,0 +1,11 @@
+package com.somemore.domains.volunteerrecord.dto.response;
+
+import java.util.UUID;
+
+public record VolunteerTotalRankingResponseDto(
+        UUID volunteerId,
+        int totalHours,
+        long ranking
+) {
+
+}

src/main/java/com/somemore/domains/volunteerrecord/dto/response/VolunteerWeeklyRankingResponseDto.java

@@ -0,0 +1,10 @@
+package com.somemore.domains.volunteerrecord.dto.response;
+
+import java.util.UUID;
+
+public record VolunteerWeeklyRankingResponseDto(
+        UUID volunteerId,
+        int totalHours,
+        long ranking
+) {
+}

src/main/java/com/somemore/domains/volunteerrecord/repository/mapper/VolunteerRankingMapper.java

@@ -0,0 +1,38 @@
+package com.somemore.domains.volunteerrecord.repository.mapper;
+
+import com.somemore.domains.volunteerrecord.dto.response.VolunteerMonthlyRankingResponseDto;
+import com.somemore.domains.volunteerrecord.dto.response.VolunteerTotalRankingResponseDto;
+import com.somemore.domains.volunteerrecord.dto.response.VolunteerWeeklyRankingResponseDto;
+
+import java.util.UUID;
+
+public class VolunteerRankingMapper {
+
+    private VolunteerRankingMapper() {
+        throw new UnsupportedOperationException("유틸리티 클래스는 인스턴스화할 수 없습니다.");
+    }
+
+    public static VolunteerTotalRankingResponseDto toTotalRankingResponse(Object[] result) {
+        return new VolunteerTotalRankingResponseDto(
+                (UUID) result[0],
+                ((Number) result[1]).intValue(),
+                ((Number) result[2]).longValue()
+        );
+    }
+
+    public static VolunteerWeeklyRankingResponseDto toWeeklyRankingResponse(Object[] result) {
+        return new VolunteerWeeklyRankingResponseDto(
+                (UUID) result[0],
+                ((Number) result[1]).intValue(),
+                ((Number) result[2]).longValue()
+        );
+    }
+
+    public static VolunteerMonthlyRankingResponseDto toMonthlyRankingResponse(Object[] result) {
+        return new VolunteerMonthlyRankingResponseDto(
+                (UUID) result[0],
+                ((Number) result[1]).intValue(),
+                ((Number) result[2]).longValue()
+        );
+    }
+}

src/main/java/com/somemore/domains/volunteerrecord/service/CalculateRankingService.java

@@ -0,0 +1,48 @@
+package com.somemore.domains.volunteerrecord.service;
+
+import com.somemore.domains.volunteerrecord.dto.response.VolunteerMonthlyRankingResponseDto;
+import com.somemore.domains.volunteerrecord.dto.response.VolunteerRankingResponseDto;
+import com.somemore.domains.volunteerrecord.dto.response.VolunteerTotalRankingResponseDto;
+import com.somemore.domains.volunteerrecord.dto.response.VolunteerWeeklyRankingResponseDto;
+import com.somemore.domains.volunteerrecord.repository.VolunteerRecordRepository;
+import com.somemore.domains.volunteerrecord.repository.mapper.VolunteerRankingMapper;
+import com.somemore.domains.volunteerrecord.usecase.CalculateRankingUseCase;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+@RequiredArgsConstructor
+@Service
+@Transactional(readOnly = true)
+public class CalculateRankingService implements CalculateRankingUseCase {
+
+    private final VolunteerRecordRepository volunteerRecordRepository;
+
+    @Override
+    public VolunteerRankingResponseDto calculateRanking() {
+
+        List<Object[]> volunteerTotalRanking = volunteerRecordRepository.findTotalTopRankingWithTies();
+        List<Object[]> volunteerMonthlyRanking = volunteerRecordRepository.findMonthlyTopRankingWithTies();
+        List<Object[]> volunteerWeeklyRanking = volunteerRecordRepository.findWeeklyTopRankingWithTies();
+
+        List<VolunteerTotalRankingResponseDto> totalRankingDtos = volunteerTotalRanking.stream()
+                .map(VolunteerRankingMapper::toTotalRankingResponse)
+                .toList();
+
+        List<VolunteerMonthlyRankingResponseDto> monthlyRankingDtos = volunteerMonthlyRanking.stream()
+                .map(VolunteerRankingMapper::toMonthlyRankingResponse)
+                .toList();
+
+        List<VolunteerWeeklyRankingResponseDto> weeklyRankingDtos = volunteerWeeklyRanking.stream()
+                .map(VolunteerRankingMapper::toWeeklyRankingResponse)
+                .toList();
+
+        return VolunteerRankingResponseDto.of(
+                totalRankingDtos,
+                monthlyRankingDtos,
+                weeklyRankingDtos
+        );
+    }
+}

src/main/java/com/somemore/domains/volunteerrecord/usecase/CalculateRankingUseCase.java

@@ -0,0 +1,7 @@
+package com.somemore.domains.volunteerrecord.usecase;
+
+import com.somemore.domains.volunteerrecord.dto.response.VolunteerRankingResponseDto;
+
+public interface CalculateRankingUseCase {
+    VolunteerRankingResponseDto calculateRanking();
+}

src/test/java/com/somemore/domains/volunteerrecord/service/CalculateRankingServiceTest.java

@@ -0,0 +1,119 @@
+package com.somemore.domains.volunteerrecord.service;
+
+import com.somemore.domains.volunteerrecord.domain.VolunteerRecord;
+import com.somemore.domains.volunteerrecord.dto.response.VolunteerRankingResponseDto;
+import com.somemore.domains.volunteerrecord.repository.VolunteerRecordRepository;
+import com.somemore.support.IntegrationTestSupport;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.time.LocalDate;
+import java.util.UUID;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+@Transactional
+class CalculateRankingServiceTest extends IntegrationTestSupport {
+
+    @Autowired
+    private CalculateRankingService calculateRankingService;
+
+    @Autowired
+    private VolunteerRecordRepository volunteerRecordRepository;
+
+    @DisplayName("전체 기간 봉사 시간 합계로 4위까지의 랭킹을 반환할 수 있다. 동점자를 같이 반환한다.")
+    @Test
+    void calculateTotalVolunteerRanking() {
+
+        // given
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "봉사1", LocalDate.of(2025, 1, 10), 100));
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "봉사2", LocalDate.of(2025, 1, 11), 100));
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "봉사3", LocalDate.of(2025, 1, 12), 90));
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "봉사4", LocalDate.of(2025, 1, 13), 60));
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "봉사5", LocalDate.of(2025, 1, 14), 50));
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "봉사6", LocalDate.of(2025, 1, 15), 30));
+
+        // when
+        VolunteerRankingResponseDto ranking = calculateRankingService.calculateRanking();
+
+        // then
+        assertThat(ranking.volunteerTotalRankingResponse()).hasSize(5);
+
+        assertThat(ranking.volunteerTotalRankingResponse().get(0).totalHours()).isEqualTo(100L);
+        assertThat(ranking.volunteerTotalRankingResponse().get(0).ranking()).isEqualTo(1);
+
+        assertThat(ranking.volunteerTotalRankingResponse().get(1).totalHours()).isEqualTo(100L);
+        assertThat(ranking.volunteerTotalRankingResponse().get(1).ranking()).isEqualTo(1);
+
+        assertThat(ranking.volunteerTotalRankingResponse().get(3).totalHours()).isEqualTo(60L);
+        assertThat(ranking.volunteerTotalRankingResponse().get(3).ranking()).isEqualTo(3);
+    }
+
+    @DisplayName("주간 봉사 시간으로 4위까지의 랭킹을 반환할 수 있다. 동점자를 같이 반환한다.")
+    @Test
+    void calculateWeeklyVolunteerRanking() {
+
+        // given
+        LocalDate currentDate = LocalDate.now();
+
+        // 이번 주 데이터
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "이번주봉사1", currentDate, 100));
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "이번주봉사2", currentDate, 100));
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "이번주봉사3", currentDate, 90));
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "이번주봉사4", currentDate, 60));
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "이번주봉사5", currentDate, 50));
+
+        // 지난 주 데이터
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "지난주봉사", currentDate.minusWeeks(1), 200));
+
+        // when
+        VolunteerRankingResponseDto ranking = calculateRankingService.calculateRanking();
+
+        // then
+        assertThat(ranking.volunteerWeeklyRankingResponse()).hasSize(5);
+
+        assertThat(ranking.volunteerWeeklyRankingResponse().get(0).totalHours()).isEqualTo(100L);
+        assertThat(ranking.volunteerWeeklyRankingResponse().get(0).ranking()).isEqualTo(1);
+
+        assertThat(ranking.volunteerWeeklyRankingResponse().get(1).totalHours()).isEqualTo(100L);
+        assertThat(ranking.volunteerWeeklyRankingResponse().get(1).ranking()).isEqualTo(1);
+
+        assertThat(ranking.volunteerWeeklyRankingResponse().get(3).totalHours()).isEqualTo(60L);
+        assertThat(ranking.volunteerWeeklyRankingResponse().get(3).ranking()).isEqualTo(3);
+    }
+
+    @DisplayName("월간 봉사 시간으로 4위까지의 랭킹을 반환할 수 있다. 동점자를 같이 반환한다.")
+    @Test
+    void calculateMonthlyVolunteerRanking() {
+
+        // given
+        LocalDate currentDate = LocalDate.now();
+
+        // 이번 달 데이터
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "이번달봉사1", currentDate, 100));
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "이번달봉사2", currentDate, 100));
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "이번달봉사3", currentDate, 90));
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "이번달봉사4", currentDate, 60));
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "이번달봉사5", currentDate, 50));
+
+        // 지난 달 데이터
+        volunteerRecordRepository.save(VolunteerRecord.create(UUID.randomUUID(), "지난달봉사", currentDate.minusMonths(1), 200));
+
+        // when
+        VolunteerRankingResponseDto ranking = calculateRankingService.calculateRanking();
+
+        // then
+        assertThat(ranking.volunteerMonthlyResponse()).hasSize(5);
+
+        assertThat(ranking.volunteerMonthlyResponse().get(0).totalHours()).isEqualTo(100L);
+        assertThat(ranking.volunteerMonthlyResponse().get(0).ranking()).isEqualTo(1);
+
+        assertThat(ranking.volunteerMonthlyResponse().get(1).totalHours()).isEqualTo(100L);
+        assertThat(ranking.volunteerMonthlyResponse().get(1).ranking()).isEqualTo(1);
+
+        assertThat(ranking.volunteerMonthlyResponse().get(3).totalHours()).isEqualTo(60L);
+        assertThat(ranking.volunteerMonthlyResponse().get(3).ranking()).isEqualTo(3);
+    }
+}