경과시간 09:08 → 18:03 점프 — 누적시간 이중 가산 원인 분석

가로축은 실제 벽시계 시간(레슨 시작 ~ 현재). 같은 9분 구간을 두 소스가 각각 측정하고 있다.

점프 직전까지 useCumulativeElapsed가 fetch한 세션 개수는 줄곧 0이었다. 세션 0개일 때는 ②(lessonStartedAt) 단독으로만 계산되어 정상값 09:08 이 나왔다.

LogRocket 상대시각(mm:ss.mmm) 기준. 강조행이 점프를 만든 지점.

검증: 09:08 = 548초, 18:03 = 1083초, 증가분 = 535초 ≈ 기존 경과시간. MAX_SINGLE_SESSION_SECONDS = 3600초라 캡과 무관.

apps/web/hooks/use-cumulative-elapsed.ts:58–90 의 합산 루프:

// 세션 목록을 돌며 누적
for (const s of sessions) {
  if (s.duration != null) {
    total += Math.min(s.duration, MAX);   // (A) 종료 세션 535초 가산
    continue;                             //     → liveCountedFromFetch 안 켜짐!
  }
  // 여기 아래는 duration==null(라이브) 일 때만 실행됨
  if (currentSessionEnteredAt == null) continue;
  if (!currentSessionId || s.sessionId === currentSessionId) {
    liveCountedFromFetch = true;          // dedup 플래그는 '라이브 세션'에서만 켜진다
  }
  total += elapsed(s.enteredAt);
}

if (currentSessionEnteredAt && !liveCountedFromFetch) {
  total += elapsed(currentSessionEnteredAt);  // (B) lessonStartedAt 548초 또 가산
}                                             // (A)+(B) = 1083초 = 18:03

왜 막히지 못했나 (두 가지 구멍)

1. dedup이 duration == null(라이브) 케이스만 처리한다. 23:52 끊김 무렵 서버 backstop(endPendingSessions)이 라이브 세션을 duration이 채워진 종료 세션으로 확정하면, fetch 결과는 (A) 경로를 타고 liveCountedFromFetch를 켜지 않는다. 그래서 (B)가 같은 구간을 다시 더한다.
2. 호출부에서 currentSessionId를 안 넘긴다. monitor-dashboard/[group]/[roomId]/page.tsx:337–343은 currentSessionEnteredAt만 전달하고 currentSessionId는 생략 → 기본값 null. 따라서 sessionId 기반 중복 방지(s.sessionId === currentSessionId)는 사실상 죽은 코드.

이 영역은 Jacob 인수인계에서 회귀 다발 지점으로 명시돼 있다.

• docs/handover/jacob/known-gaps.md:32 — "누적 시간 계산의 이중 소스 … 부분 해결, 회귀 빈도 높음. 폴백 타이머와 실시간 lessonStartedAt 기반 계산이 동시에 살아있음"
• docs/handover/jacob/card-view.md:93,136 — "누적 시간 회귀: lessonStartedAt 갱신 누락 / 폴백·실시간 값 불일치 (#527, #466, #478, #349)"
• docs/handover/jacob/landmines.md:11 — "누적 시간이 게스트와 호스트에서 다름 → lessonStartedAt 갱신/폴백 reset 누락"

기존 문서가 다룬 건 주로 "라이브 vs 폴백" 이중이고, 이번 케이스는 "종료세션(duration!=null) + 라이브" 이중이라는 변종이다 — 문서에 이 변종은 아직 없음.

1차 — 이중 가산 제거 (commit id-047)

• 진행 중 세션을 "라이브 레코드(duration==null) 존재 여부"로 판정한다. 라이브 레코드가 있으면 기존 정상 동작(durations 합 + 라이브 경과)을 그대로 유지하고 (B) 앵커 구간을 더하지 않는다.
• 라이브 레코드가 없는데 앵커만 있는 경우(= 백스톱으로 종료 확정된 버그 상황)에만 [anchor, now]를 한 번 더한다.

2차 — duration 누락 보강 (commit id-012, 코드리뷰 반영)

1차 초안은 "[anchor, now]와 겹치는 종료 세션의 duration 을 통째로 skip"했는데, 이건 anchor ≈ enteredAt 일 때만 안전하다. 앵커가 세션 시작보다 늦게 찍히면(앵커 리셋 후 늦은 재설정 등) [enteredAt, anchor] 구간이 통째로 누락된다.

그래서 종료 세션 전체를 버리지 않고 anchor 이전 부분만 더하도록 구간을 클램프한다. anchor 이후는 (B)가 커버하므로 중복도 누락도 없다. 정확 연산이라 기존의 허용오차 상수(CURRENT_SESSION_MATCH_TOLERANCE_MS)는 제거했다.

// 진행 중 세션 = 라이브 레코드 존재 여부로 판정 (기존 정상 동작 보존)
const hasLiveCurrentRecord =
  anchor != null &&
  sessions.some(s => s.duration == null &&
    (currentSessionId == null || s.sessionId === currentSessionId));

for (const s of sessions) {
  if (s.duration != null) {
    // 라이브 레코드 없음 + 앵커 존재: [anchor, now]는 (B)가 더하므로
    // 이 종료 세션은 anchor 이전 부분만 더한다 (겹침 제거 + 누락 방지)
    if (!hasLiveCurrentRecord && anchor != null) {
      const endMs = s.enteredAt + s.duration * 1000;
      total += cap(Math.floor((Math.min(endMs, anchor) - s.enteredAt) / 1000));
      continue;
    }
    total += Math.min(s.duration, MAX);   // 과거(앵커 이전 종료) 세션: 전체 가산
    continue;
  }
  if (anchor == null) continue;
  total += cap(elapsed(s.enteredAt));      // 라이브 레코드
}

if (anchor != null && !hasLiveCurrentRecord) {
  total += cap(elapsed(anchor));           // (B) [anchor, now] 를 한 번만
}

제안 2(currentSessionId 전달)는 왜 그대로 안 갔나

모니터(진행자)는 서버 sessionId를 보유하지 않는다(guestInfo엔 peerId/joinedAt만, lessonStartedAt은 로컬 앵커). 그래서 모니터 호출부는 ID를 넘길 수 없고, 위 구간 기반 로직으로 해결했다. 게스트 호출부는 이미 currentSessionId를 넘기므로 ID 정확 매칭도 함께 동작한다. 더 정밀하게 가려면 서버가 guest-session-state에 현재 sessionId를 실어 모니터에 내려주는 후속(소켓 핸들러 변경)이 정공법.

• 시스템 설계: 누적 경과시간 추적 — 세션 합산·단조 클램프 코드레벨 동작 흐름 (이 이중 가산을 막는 anchor-이전-구간 로직의 전체 흐름)
• 반대 방향(감소): 경과시간 03:49 → 02:29 감소 — 게스트 재접속 회귀