시퀀스 "완료 처리 중" stuck — 종합 리포트

1. 맥락 — 어떻게 발견했나

app.rinda.ai/sequences(=beta)에서 특정 캠페인이 "완료 처리 중" 배지에서 며칠째 풀리지 않는다는 관찰로 시작. 프론트(campaign-status.ts:70)는 status='active' AND total>0 AND active_enrollments=0일 때 이 배지를 띄우므로, 이는 백엔드가 시퀀스를 completed로 전이시키지 못한 모든 상태를 한 화면에 보여준다. beta 실데이터로 stuck 시퀀스 7건을 가드별로 분해하자 원인이 두 갈래로 나뉘었다.

2. "completed" 전환 기준 — 2단계로 분리해야 정확

핵심 혼동 지점. completed는 레벨이 둘이고, 이번 stuck은 ②가 안 되는 것이다.

① Enrollment → completed 기준 (리드 단위) — 본질은 "더 보낼 스텝이 없다"

② Sequence → completed 기준 (캠페인 단위) — stuck의 핵심

evaluateSequenceCompletion이 3가드를 모두 통과해야 markCompleted:

발단 캠페인은 가드#2로 정상 보류 중이었다(답장이 계속 옴) — 버그 아님. 손대지 않았다.

3. 근본 원인 — orphan execution

evaluateSequenceCompletion(순수 도메인)과 SequenceCompletionDeps(port)·productionDeps(adapter)는 이미 헥사고날 구조였다. 버그는 두 곳:

1. 가드#1이 enrollment 상태를 안 봤다 — execution 상태만 셌다. enrollment가 이미 terminal인데 execution만 좀비로 남으면 가드#1이 영구 TRUE → 시퀀스가 ②로 영원히 못 감.
2. completed 전이가 정리를 안 했다 — chokepoint(updateEnrollmentStatusWithSync)의 isTerminalStop에 completed가 빠져 있었고, 게다가 completed 전이는 대부분 chokepoint를 우회(enrollment-progress 직접 UPDATE).

4. Redis / BullMQ 분석 — 인프라는 멀쩡

orphan이 Redis 좀비인지 확인했고, 전부 DB-only였다. Redis는 손댈 게 없었다.

정합성이 단방향이었던 것이 원인: DB→BullMQ(cancel)는 있지만 job 소멸→DB status 동기화가 없어 DB에만 좀비가 남았다. cancelEnrollmentJobs가 pending만 조회하던 점도 deferred 누락에 기여. 단 실측상 job은 이미 사라져(EXISTS=0) Redis 정리는 불필요.

5. 코드 수정 — 헥사고날 경계 존중 (머지 완료)

도메인 함수 evaluateSequenceCompletion은 불변. ① 가드는 adapter SQL만, ② skip은 재사용 도메인 헬퍼로 추출. 5개 지점:

// 수정 1 — 완료 가드 (adapter SQL): terminal orphan 은 완료를 못 막게
   FROM sequence_step_executions sse
   INNER JOIN sequence_enrollments se ON sse.enrollment_id = se.id
   WHERE se.sequence_id = ${sequenceId}
+    AND se.status IN ('active', 'paused')
     AND sse.status IN ('pending', 'processing', 'deferred')

// 수정 4 — chokepoint: completed 도 정리 대상 (paused 만 제외)
- if (isTerminalStop) {
+ if (isTerminalStop || status === "completed") {
     await tx.update(sequenceStepExecutions)
       .set({ status: "skipped", errorMessage: skipReason })
       .where(and(eq(...enrollmentId), inArray(...["pending","deferred"])))

6. DB / Redis 수정 계획 + 실행 결과

UPDATE sequence_step_executions sse
SET status='skipped', error_message=...
FROM sequence_enrollments se
WHERE sse.enrollment_id=se.id
  AND se.status IN ('completed','stopped',
        'bounced','unsubscribed')
  AND sse.status IN ('pending','deferred');

7. 이슈 / 회귀 검증