feat(ranking): 스냅샷 job 관리 기능을 추가한다

2026-06-09 11:49:50 +09:00
parent 929c056ebf
commit 2db37edb5b
5 changed files with 216 additions and 0 deletions
--- a/src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingSnapshotJobRepositoryTest.kt
+++ b/src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingSnapshotJobRepositoryTest.kt
@@ -80,4 +80,51 @@ class DefaultCreatorRankingSnapshotJobRepositoryTest @Autowired constructor(
        assertEquals(CreatorRankingSnapshotJobStatus.FAILED, failedJob?.status)
        assertEquals("aggregate failed", failedJob?.lastError)
    }
+
+    @Test
+    @DisplayName("실패한 스냅샷 job은 PENDING으로 되돌리며 실패/처리 정보를 초기화한다")
+    fun shouldMarkFailedSnapshotJobPendingForRetry() {
+        val saved = adapter.save(
+            CreatorRankingSnapshotJobRecord(
+                aggregationStartAtUtc = LocalDateTime.of(2026, 5, 31, 15, 0),
+                aggregationEndAtUtc = LocalDateTime.of(2026, 6, 7, 15, 0),
+                trigger = CreatorRankingSnapshotJobTrigger.MANUAL,
+                status = CreatorRankingSnapshotJobStatus.FAILED,
+                lastError = "aggregate failed",
+                processingStartedAt = LocalDateTime.of(2026, 6, 8, 7, 30),
+                processedAt = LocalDateTime.of(2026, 6, 8, 7, 31)
+            )
+        )
+
+        val retried = adapter.markPending(saved.id!!)
+        val allRows = repository.findAll()
+
+        assertEquals(1, allRows.size)
+        assertEquals(CreatorRankingSnapshotJobStatus.PENDING, retried?.status)
+        assertEquals(null, retried?.lastError)
+        assertEquals(null, retried?.processingStartedAt)
+        assertEquals(null, retried?.processedAt)
+    }
+
+    @Test
+    @DisplayName("실패 상태가 아닌 스냅샷 job은 재시도 대기 상태로 변경하지 않는다")
+    fun shouldNotMarkNonFailedSnapshotJobPendingForRetry() {
+        val saved = adapter.save(
+            CreatorRankingSnapshotJobRecord(
+                aggregationStartAtUtc = LocalDateTime.of(2026, 5, 31, 15, 0),
+                aggregationEndAtUtc = LocalDateTime.of(2026, 6, 7, 15, 0),
+                trigger = CreatorRankingSnapshotJobTrigger.MANUAL,
+                status = CreatorRankingSnapshotJobStatus.DONE,
+                lastError = null,
+                processingStartedAt = LocalDateTime.of(2026, 6, 8, 7, 30),
+                processedAt = LocalDateTime.of(2026, 6, 8, 7, 31)
+            )
+        )
+
+        val unchanged = adapter.markPending(saved.id!!)
+
+        assertEquals(CreatorRankingSnapshotJobStatus.DONE, unchanged?.status)
+        assertEquals(LocalDateTime.of(2026, 6, 8, 7, 30), unchanged?.processingStartedAt)
+        assertEquals(LocalDateTime.of(2026, 6, 8, 7, 31), unchanged?.processedAt)
+    }
 }
--- a/src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotJobServiceTest.kt
+++ b/src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotJobServiceTest.kt
@@ -51,6 +51,109 @@ class CreatorRankingSnapshotJobServiceTest {
        assertEquals(CreatorRankingSnapshotJobStatus.FAILED, jobPort.jobs.single().status)
        assertEquals("aggregate failed", jobPort.jobs.single().lastError)
    }
+
+    @Test
+    @DisplayName("관리자 수동 생성은 지정 UTC 기간의 MANUAL PENDING job을 만든다")
+    fun shouldCreateManualPendingJobForRequestedPeriod() {
+        val refreshService = Mockito.mock(CreatorRankingSnapshotRefreshService::class.java)
+        val jobPort = FakeCreatorRankingSnapshotJobPort()
+        val service = CreatorRankingSnapshotJobService(refreshService, jobPort)
+        val startAt = LocalDateTime.of(2026, 5, 31, 15, 0)
+        val endAt = LocalDateTime.of(2026, 6, 7, 15, 0)
+
+        val job = service.createManualJob(startAt, endAt)
+
+        assertEquals(startAt, job.aggregationStartAtUtc)
+        assertEquals(endAt, job.aggregationEndAtUtc)
+        assertEquals(CreatorRankingSnapshotJobTrigger.MANUAL, job.trigger)
+        assertEquals(CreatorRankingSnapshotJobStatus.PENDING, job.status)
+        assertEquals(null, job.lastError)
+        assertEquals(null, job.processingStartedAt)
+        assertEquals(null, job.processedAt)
+    }
+
+    @Test
+    @DisplayName("관리자 목록 조회는 기간과 상태 조건으로 snapshot job을 조회한다")
+    fun shouldFindJobsByRequestedPeriodAndStatuses() {
+        val refreshService = Mockito.mock(CreatorRankingSnapshotRefreshService::class.java)
+        val jobPort = FakeCreatorRankingSnapshotJobPort()
+        val service = CreatorRankingSnapshotJobService(refreshService, jobPort)
+        val startAt = LocalDateTime.of(2026, 5, 31, 15, 0)
+        val endAt = LocalDateTime.of(2026, 6, 7, 15, 0)
+        val failed = jobPort.save(
+            CreatorRankingSnapshotJobRecord(
+                aggregationStartAtUtc = startAt,
+                aggregationEndAtUtc = endAt,
+                trigger = CreatorRankingSnapshotJobTrigger.MANUAL,
+                status = CreatorRankingSnapshotJobStatus.FAILED,
+                lastError = "aggregate failed",
+                processingStartedAt = null,
+                processedAt = null
+            )
+        )
+        jobPort.save(
+            CreatorRankingSnapshotJobRecord(
+                aggregationStartAtUtc = startAt,
+                aggregationEndAtUtc = endAt,
+                trigger = CreatorRankingSnapshotJobTrigger.MANUAL,
+                status = CreatorRankingSnapshotJobStatus.DONE,
+                lastError = null,
+                processingStartedAt = null,
+                processedAt = null
+            )
+        )
+
+        val jobs = service.findJobs(
+            aggregationStartAtUtc = startAt,
+            aggregationEndAtUtc = endAt,
+            statuses = listOf(CreatorRankingSnapshotJobStatus.FAILED)
+        )
+
+        assertEquals(listOf(failed.id), jobs.map { it.id })
+    }
+
+    @Test
+    @DisplayName("관리자 실패 job 재시도는 FAILED job만 PENDING으로 되돌린다")
+    fun shouldRetryOnlyFailedSnapshotJob() {
+        val refreshService = Mockito.mock(CreatorRankingSnapshotRefreshService::class.java)
+        val jobPort = FakeCreatorRankingSnapshotJobPort()
+        val service = CreatorRankingSnapshotJobService(refreshService, jobPort)
+        val failed = jobPort.save(
+            CreatorRankingSnapshotJobRecord(
+                aggregationStartAtUtc = LocalDateTime.of(2026, 5, 31, 15, 0),
+                aggregationEndAtUtc = LocalDateTime.of(2026, 6, 7, 15, 0),
+                trigger = CreatorRankingSnapshotJobTrigger.MANUAL,
+                status = CreatorRankingSnapshotJobStatus.FAILED,
+                lastError = "aggregate failed",
+                processingStartedAt = LocalDateTime.of(2026, 6, 8, 7, 30),
+                processedAt = LocalDateTime.of(2026, 6, 8, 7, 31)
+            )
+        )
+        val pending = jobPort.save(
+            CreatorRankingSnapshotJobRecord(
+                aggregationStartAtUtc = LocalDateTime.of(2026, 5, 31, 15, 0),
+                aggregationEndAtUtc = LocalDateTime.of(2026, 6, 7, 15, 0),
+                trigger = CreatorRankingSnapshotJobTrigger.MANUAL,
+                status = CreatorRankingSnapshotJobStatus.PENDING,
+                lastError = "keep",
+                processingStartedAt = null,
+                processedAt = null
+            )
+        )
+
+        service.retryFailedJob(failed.id!!)
+        service.retryFailedJob(pending.id!!)
+        service.retryFailedJob(999L)
+
+        val retried = jobPort.findById(failed.id!!)!!
+        val unchanged = jobPort.findById(pending.id!!)!!
+        assertEquals(CreatorRankingSnapshotJobStatus.PENDING, retried.status)
+        assertEquals(null, retried.lastError)
+        assertEquals(null, retried.processingStartedAt)
+        assertEquals(null, retried.processedAt)
+        assertEquals(CreatorRankingSnapshotJobStatus.PENDING, unchanged.status)
+        assertEquals("keep", unchanged.lastError)
+    }
 }

 private class FakeCreatorRankingSnapshotJobPort : CreatorRankingSnapshotJobPort {
@@ -108,6 +211,17 @@ private class FakeCreatorRankingSnapshotJobPort : CreatorRankingSnapshotJobPort
        }
    }

+    override fun markPending(jobId: Long): CreatorRankingSnapshotJobRecord? {
+        return update(jobId) {
+            it.copy(
+                status = CreatorRankingSnapshotJobStatus.PENDING,
+                lastError = null,
+                processingStartedAt = null,
+                processedAt = null
+            )
+        }
+    }
+
    private fun update(
        jobId: Long,
        updater: (CreatorRankingSnapshotJobRecord) -> CreatorRankingSnapshotJobRecord