Merge pull request #268 from DocGrid/fix/266

[Fix] 24시간 처리 성공률 — 처리 이력 없을 때 100% 오표시

Author: Gimini-3

backend/src/main/java/com/opensource/docgrid/domain/sync/dto/response/SyncEventSummaryResponse.java

@@ -14,7 +14,7 @@ public record SyncEventSummaryResponse(
     long processedLast24hCount,
     long failedLast24hCount,
     long retriedLast24hCount,
-    double successRateLast24h,
+    Double successRateLast24h,
     UUID lastProcessedEventId,
     LocalDateTime lastProcessedAt
 ) {

backend/src/main/java/com/opensource/docgrid/domain/sync/service/query/SyncAdminQueryService.java

@@ -170,10 +170,10 @@ private Long oldestPendingAgeSeconds(LocalDateTime capturedAt) {
             .orElse(null);
     }
 
-    private double successRate(long processedCount, long failedCount) {
+    static Double successRate(long processedCount, long failedCount) {
         long completedCount = processedCount + failedCount;
         if (completedCount == 0) {
-            return 100.0;
+            return null;
         }
         return Math.round(processedCount * 1000.0 / completedCount) / 10.0;
     }

backend/src/test/java/com/opensource/docgrid/domain/sync/service/query/SyncAdminQueryServiceTest.java

@@ -102,6 +102,24 @@ void getSummary_aggregatesOperationalSnapshot() {
         assertThat(result.reconciliation().detectedCount()).isEqualTo(3);
     }
 
+    @Test
+    @DisplayName("처리 이력이 없으면 성공률은 null이다")
+    void successRate_returnsNull_whenNoEventsCompleted() {
+        assertThat(SyncAdminQueryService.successRate(0L, 0L)).isNull();
+    }
+
+    @Test
+    @DisplayName("성공만 있으면 성공률은 100%다")
+    void successRate_returns100_whenOnlySucceeded() {
+        assertThat(SyncAdminQueryService.successRate(1L, 0L)).isEqualTo(100.0);
+    }
+
+    @Test
+    @DisplayName("실패만 있으면 성공률은 0%다")
+    void successRate_returns0_whenOnlyFailed() {
+        assertThat(SyncAdminQueryService.successRate(0L, 1L)).isEqualTo(0.0);
+    }
+
     private SyncOutboxEvent processedEvent() {
         SyncOutboxEvent event = SyncOutboxEvent.builder()
             .eventId(UUID.randomUUID())

frontend/app/features/AdminPages.tsx

@@ -114,7 +114,7 @@ export function DashboardPage({ notify }: { notify: (message: string) => void })
         <div className="metric-card"><span>Outbox 대기</span><b>{formatMetric(syncSummary.events.pendingCount)}</b><small>최대 지연 {formatAge(syncSummary.events.oldestPendingAgeSeconds)}</small></div>
         <div className="metric-card"><span>Dispatcher 처리 중</span><b>{formatMetric(syncSummary.events.processingCount)}</b><small>Lease 소유 Event</small></div>
         <div className={`metric-card ${syncSummary.events.failedCount > 0 ? "danger-metric" : "success-metric"}`}><span>Event 최종 실패</span><b>{formatMetric(syncSummary.events.failedCount)}</b><small>최근 24시간 {formatMetric(syncSummary.events.failedLast24hCount)}</small></div>
-        <div className="metric-card success-metric"><span>24시간 처리 성공률</span><b>{syncSummary.events.successRateLast24h}%</b><small>성공 {formatMetric(syncSummary.events.processedLast24hCount)} · 재시도 {formatMetric(syncSummary.events.retriedLast24hCount)}</small></div>
+        <div className="metric-card success-metric"><span>24시간 처리 성공률</span><b>{syncSummary.events.successRateLast24h == null ? "—" : `${syncSummary.events.successRateLast24h}%`}</b><small>성공 {formatMetric(syncSummary.events.processedLast24hCount)} · 재시도 {formatMetric(syncSummary.events.retriedLast24hCount)}</small></div>
         <div className={`metric-card ${syncSummary.issues.openCount > 0 ? "danger-metric" : "success-metric"}`}><span>미해결 정합성 Issue</span><b>{formatMetric(syncSummary.issues.openCount)}</b><small>복구 중 {formatMetric(syncSummary.issues.repairingCount)}</small></div>
         <div className="metric-card success-metric"><span>24시간 자동 복구</span><b>{formatMetric(syncSummary.issues.autoResolvedLast24hCount)}</b><small>실패 {formatMetric(syncSummary.issues.failedRepairCount)}</small></div>
         <div className="metric-card"><span>마지막 Reconciliation</span><b className="metric-status">{syncSummary.reconciliation?.status ?? "미실행"}</b><small>{syncSummary.reconciliation ? `${syncSummary.reconciliation.scannedCount}개 검사 · ${syncSummary.reconciliation.detectedCount}개 탐지` : "실행 이력 없음"}</small></div>

frontend/app/lib/api-types.ts

@@ -313,7 +313,7 @@ export type SyncEventSummary = {
   processedLast24hCount: number;
   failedLast24hCount: number;
   retriedLast24hCount: number;
-  successRateLast24h: number;
+  successRateLast24h: number | null;
   lastProcessedEventId: string | null;
   lastProcessedAt: string | null;
 };