[BOM-1031] feat: 연속 읽기 랭킹 조회 api

backend/bom-bom-server/src/main/java/me/bombom/api/v1/badge/dto/response/BadgesResponse.java

@@ -1,6 +1,7 @@
 package me.bombom.api.v1.badge.dto.response;
 
 import me.bombom.api.v1.reading.dto.MonthlyReadingRankFlat;
+import me.bombom.api.v1.reading.dto.ContinueReadingRankFlat;
 
 public record BadgesResponse(
         RankingBadgeResponse ranking,
@@ -15,4 +16,13 @@ public static BadgesResponse from(MonthlyReadingRankFlat flat) {
         }
         return new BadgesResponse(ranking, challenge);
     }
+
+    public static BadgesResponse from(ContinueReadingRankFlat flat) {
+        RankingBadgeResponse ranking = RankingBadgeResponse.from(flat);
+        ChallengeBadgeResponse challenge = ChallengeBadgeResponse.from(flat);
+        if (ranking == null && challenge == null) {
+            return null;
+        }
+        return new BadgesResponse(ranking, challenge);
+    }
 }

backend/bom-bom-server/src/main/java/me/bombom/api/v1/badge/dto/response/ChallengeBadgeResponse.java

@@ -4,6 +4,7 @@
 import jakarta.validation.constraints.NotNull;
 import me.bombom.api.v1.badge.domain.BadgeGrade;
 import me.bombom.api.v1.reading.dto.MonthlyReadingRankFlat;
+import me.bombom.api.v1.reading.dto.ContinueReadingRankFlat;
 
 public record ChallengeBadgeResponse(
 
@@ -27,4 +28,15 @@ public static ChallengeBadgeResponse from(MonthlyReadingRankFlat flat) {
         }
         return null;
     }
+
+    public static ChallengeBadgeResponse from(ContinueReadingRankFlat flat) {
+        if (flat.hasChallengeBadge()) {
+            return new ChallengeBadgeResponse(
+                    BadgeGrade.valueOf(flat.challengeBadgeGrade()),
+                    flat.challengeBadgeName(),
+                    flat.challengeBadgeGeneration()
+            );
+        }
+        return null;
+    }
 }

backend/bom-bom-server/src/main/java/me/bombom/api/v1/badge/dto/response/RankingBadgeResponse.java

@@ -4,6 +4,7 @@
 import jakarta.validation.constraints.NotNull;
 import me.bombom.api.v1.badge.domain.BadgeGrade;
 import me.bombom.api.v1.reading.dto.MonthlyReadingRankFlat;
+import me.bombom.api.v1.reading.dto.ContinueReadingRankFlat;
 
 public record RankingBadgeResponse(
 
@@ -27,4 +28,15 @@ public static RankingBadgeResponse from(MonthlyReadingRankFlat flat) {
         }
         return null;
     }
+
+    public static RankingBadgeResponse from(ContinueReadingRankFlat flat) {
+        if (flat.hasRankingBadge()) {
+            return new RankingBadgeResponse(
+                    BadgeGrade.valueOf(flat.rankingBadgeGrade()),
+                    flat.rankingBadgeYear(),
+                    flat.rankingBadgeMonth()
+            );
+        }
+        return null;
+    }
 }

backend/bom-bom-server/src/main/java/me/bombom/api/v1/common/ContinueReadingRankingScheduleProperties.java

@@ -0,0 +1,30 @@
+package me.bombom.api.v1.common;
+
+import jakarta.validation.constraints.NotBlank;
+import java.time.ZoneId;
+import lombok.Getter;
+import lombok.Setter;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.scheduling.support.CronExpression;
+import org.springframework.validation.annotation.Validated;
+
+@Getter
+@Setter
+@Validated
+@ConfigurationProperties("ranking.reading.continue")
+public class ContinueReadingRankingScheduleProperties {
+
+    @NotBlank
+    private String cron;
+
+    @NotBlank
+    private String zone;
+
+    public ZoneId zoneId() {
+        return ZoneId.of(zone);
+    }
+
+    public CronExpression cronExpression() {
+        return CronExpression.parse(cron);
+    }
+}

backend/bom-bom-server/src/main/java/me/bombom/api/v1/common/config/RankingScheduleConfig.java

@@ -1,10 +1,14 @@
 package me.bombom.api.v1.common.config;
 
+import me.bombom.api.v1.common.ContinueReadingRankingScheduleProperties;
 import me.bombom.api.v1.common.MonthlyRankingScheduleProperties;
 import org.springframework.boot.context.properties.EnableConfigurationProperties;
 import org.springframework.context.annotation.Configuration;
 
 @Configuration
-@EnableConfigurationProperties(MonthlyRankingScheduleProperties.class)
+@EnableConfigurationProperties({
+        MonthlyRankingScheduleProperties.class,
+        ContinueReadingRankingScheduleProperties.class
+})
 public class RankingScheduleConfig {
 }

backend/bom-bom-server/src/main/java/me/bombom/api/v1/reading/controller/ReadingController.java

@@ -9,6 +9,8 @@
 import me.bombom.api.v1.reading.dto.response.MemberMonthlyReadingRankResponse;
 import me.bombom.api.v1.reading.dto.response.MonthlyReadingRankingResponse;
 import me.bombom.api.v1.reading.dto.response.ReadingInformationResponse;
+import me.bombom.api.v1.reading.dto.response.ContinueReadingRankingResponse;
+import me.bombom.api.v1.reading.dto.response.MemberContinueReadingRankResponse;
 import me.bombom.api.v1.reading.dto.response.WeeklyGoalCountResponse;
 import me.bombom.api.v1.reading.service.ReadingService;
 import org.springframework.validation.annotation.Validated;
@@ -46,12 +48,26 @@ public MonthlyReadingRankingResponse getMonthlyReadingRank(@RequestParam @Positi
         return readingService.getMonthlyReadingRank(limit);
     }
 
+    @Override
+    @GetMapping("/streak/rank")
+    public ContinueReadingRankingResponse getContinueReadingRank(
+            @RequestParam @Positive(message = "limit는 1 이상의 값이어야 합니다.") int limit
+    ) {
+        return readingService.getContinueReadingRank(limit);
+    }
+
     @Override
     @GetMapping("/month/rank/me")
     public MemberMonthlyReadingRankResponse getMemberMonthlyRank(@LoginMember Member member) {
         return readingService.getMemberMonthlyReadingRank(member);
     }
 
+    @Override
+    @GetMapping("/streak/rank/me")
+    public MemberContinueReadingRankResponse getMemberContinueReadingRank(@LoginMember Member member) {
+        return readingService.getMemberContinueReadingRank(member);
+    }
+
     @Override
     @GetMapping("/month")
     public MemberMonthlyReadingCountResponse getMemberMonthlyReadingCount(@LoginMember Member member) {

backend/bom-bom-server/src/main/java/me/bombom/api/v1/reading/controller/ReadingControllerApi.java

@@ -13,6 +13,8 @@
 import me.bombom.api.v1.reading.dto.response.MemberMonthlyReadingRankResponse;
 import me.bombom.api.v1.reading.dto.response.MonthlyReadingRankingResponse;
 import me.bombom.api.v1.reading.dto.response.ReadingInformationResponse;
+import me.bombom.api.v1.reading.dto.response.ContinueReadingRankingResponse;
+import me.bombom.api.v1.reading.dto.response.MemberContinueReadingRankResponse;
 import me.bombom.api.v1.reading.dto.response.WeeklyGoalCountResponse;
 import org.springframework.web.bind.annotation.RequestParam;
 
@@ -50,13 +52,36 @@ WeeklyGoalCountResponse updateWeeklyGoalCount(
     MonthlyReadingRankingResponse getMonthlyReadingRank(
             @Parameter(description = "최대 조회 개수 (예: ?limit=10)") @RequestParam @Positive(message = "limit는 1 이상의 값이어야 합니다.") int limit);
 
+    @Operation(
+            summary = "스트릭 랭킹 조회",
+            description = "연속 읽기 일수(continue_reading_realtime.day_count) 기준 내림차순 순위를 조회합니다. day_count가 0인 회원도 목록에 포함됩니다."
+    )
+    @ApiResponses({
+            @ApiResponse(responseCode = "200", description = "스트릭 랭킹 조회 성공"),
+            @ApiResponse(responseCode = "400", description = "잘못된 요청 값 (limit는 1 이상의 값이어야 함)", content = @Content),
+    })
+    ContinueReadingRankingResponse getContinueReadingRank(
+            @Parameter(description = "최대 조회 개수 (예: ?limit=10)") @RequestParam @Positive(message = "limit는 1 이상의 값이어야 합니다.") int limit
+    );
+
     @Operation(summary = "나의 월간 순위 조회", description = "저장된 rank 기반으로 나의 순위와 총 랭킹 참여자 수를 반환합니다.")
     @ApiResponses({
             @ApiResponse(responseCode = "200", description = "나의 월간 순위 조회 성공"),
             @ApiResponse(responseCode = "401", description = "인증 실패 (로그인 필요)", content = @Content),
     })
     MemberMonthlyReadingRankResponse getMemberMonthlyRank(@Parameter(hidden = true) Member member);
 
+    @Operation(
+            summary = "나의 스트릭 순위 조회",
+            description = "실시간 연속 읽기 일수 기준 나의 순위를 반환합니다. day_count가 0이면 월간 순위와 같이 최하위 구간의 공동 순위로 포함됩니다. continue_reading_snapshot 행이 없으면 404입니다."
+    )
+    @ApiResponses({
+            @ApiResponse(responseCode = "200", description = "나의 스트릭 순위 조회 성공"),
+            @ApiResponse(responseCode = "401", description = "인증 실패 (로그인 필요)", content = @Content),
+            @ApiResponse(responseCode = "404", description = "연속 읽기 랭킹 스냅샷 정보 없음", content = @Content),
+    })
+    MemberContinueReadingRankResponse getMemberContinueReadingRank(@Parameter(hidden = true) Member member);
+
     @Operation(summary = "나의 월간 읽기 개수 조회", description = "현재 로그인한 사용자의 이번 달 아티클 읽기 개수를 조회합니다.")
     @ApiResponses({
         @ApiResponse(responseCode = "200", description = "월간 읽기 개수 조회 성공"),

backend/bom-bom-server/src/main/java/me/bombom/api/v1/reading/domain/ContinueReading.java → backend/bom-bom-server/src/main/java/me/bombom/api/v1/reading/domain/ContinueReadingRealtime.java

@@ -15,7 +15,7 @@
 @Entity
 @Getter
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
-public class ContinueReading extends BaseEntity {
+public class ContinueReadingRealtime extends BaseEntity {
 
     private static final int INITIAL_DAY_COUNT = 0;
     private static final int RESET_DAY_COUNT = 0;
@@ -32,7 +32,7 @@ public class ContinueReading extends BaseEntity {
     private int dayCount;
 
     @Builder
-    public ContinueReading(
+    public ContinueReadingRealtime(
             Long id,
             @NonNull Long memberId,
             int dayCount
@@ -42,8 +42,8 @@ public ContinueReading(
         this.dayCount = dayCount;
     }
 
-    public static ContinueReading create(Long memberId) {
-        return ContinueReading.builder()
+    public static ContinueReadingRealtime create(Long memberId) {
+        return ContinueReadingRealtime.builder()
                 .memberId(memberId)
                 .dayCount(INITIAL_DAY_COUNT)
                 .build();

backend/bom-bom-server/src/main/java/me/bombom/api/v1/reading/domain/ContinueReadingSnapshot.java

@@ -0,0 +1,53 @@
+package me.bombom.api.v1.reading.domain;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.NonNull;
+import me.bombom.api.v1.common.BaseEntity;
+
+@Entity
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class ContinueReadingSnapshot extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(nullable = false, unique = true)
+    private Long memberId;
+
+    @Column(nullable = false, columnDefinition = "SMALLINT")
+    private int dayCount;
+
+    @Column(nullable = false)
+    private long rankOrder;
+
+    @Builder
+    public ContinueReadingSnapshot(
+            Long id,
+            @NonNull Long memberId,
+            int dayCount,
+            long rankOrder
+    ) {
+        this.id = id;
+        this.memberId = memberId;
+        this.dayCount = dayCount;
+        this.rankOrder = rankOrder;
+    }
+
+    public static ContinueReadingSnapshot create(Long memberId, int dayCount, long rankOrder) {
+        return ContinueReadingSnapshot.builder()
+                .memberId(memberId)
+                .dayCount(dayCount)
+                .rankOrder(rankOrder)
+                .build();
+    }
+}

backend/bom-bom-server/src/main/java/me/bombom/api/v1/reading/domain/MonthlyReadingSnapshotMeta.java → backend/bom-bom-server/src/main/java/me/bombom/api/v1/reading/domain/ReadingSnapshotMeta.java

@@ -2,6 +2,8 @@
 
 import jakarta.persistence.Column;
 import jakarta.persistence.Entity;
+import jakarta.persistence.EnumType;
+import jakarta.persistence.Enumerated;
 import jakarta.persistence.Id;
 import jakarta.validation.constraints.NotNull;
 import java.time.LocalDateTime;
@@ -13,21 +15,22 @@
 @Entity
 @Getter
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
-public class MonthlyReadingSnapshotMeta {
+public class ReadingSnapshotMeta {
 
     @Id
-    @Column(nullable = false)
-    private Long id;
+    @Enumerated(EnumType.STRING)
+    @Column(nullable = false, length = 30)
+    private ReadingSnapshotType snapshotType;
 
-    @Column(nullable= false)
+    @Column(nullable = false)
     private LocalDateTime snapshotAt;
 
     @Builder
-    public MonthlyReadingSnapshotMeta(
-            @NotNull Long id,
+    public ReadingSnapshotMeta(
+            @NotNull ReadingSnapshotType snapshotType,
             @NotNull LocalDateTime snapshotAt
     ) {
-        this.id = id;
+        this.snapshotType = snapshotType;
         this.snapshotAt = snapshotAt;
     }
 }

backend/bom-bom-server/src/main/java/me/bombom/api/v1/reading/domain/ReadingSnapshotType.java

@@ -0,0 +1,7 @@
+package me.bombom.api.v1.reading.domain;
+
+public enum ReadingSnapshotType {
+
+    MONTHLY,
+    CONTINUE
+}

backend/bom-bom-server/src/main/java/me/bombom/api/v1/reading/dto/ContinueReadingRankFlat.java

@@ -0,0 +1,23 @@
+package me.bombom.api.v1.reading.dto;
+
+public record ContinueReadingRankFlat(
+
+        String nickname,
+        long rank,
+        int dayCount,
+        String rankingBadgeGrade,
+        Integer rankingBadgeYear,
+        Integer rankingBadgeMonth,
+        String challengeBadgeGrade,
+        String challengeBadgeName,
+        Integer challengeBadgeGeneration
+) {
+
+    public boolean hasRankingBadge() {
+        return rankingBadgeGrade != null && rankingBadgeYear != null && rankingBadgeMonth != null;
+    }
+
+    public boolean hasChallengeBadge() {
+        return challengeBadgeGrade != null && challengeBadgeName != null && challengeBadgeGeneration != null;
+    }
+}

backend/bom-bom-server/src/main/java/me/bombom/api/v1/reading/dto/MonthlyReadingRankFlat.java

@@ -1,6 +1,7 @@
 package me.bombom.api.v1.reading.dto;
 
 public record MonthlyReadingRankFlat(
+
                 String nickname,
                 long rank,
                 int monthlyReadCount,

backend/bom-bom-server/src/main/java/me/bombom/api/v1/reading/dto/RankerInfo.java

@@ -1,6 +1,7 @@
 package me.bombom.api.v1.reading.dto;
 
 public record RankerInfo(
+
         Long memberId,
         long rankOrder
 ) {