261015_03_ENH: CTI 연결 끊김 자동 복구(최대 15초 간격 재시도)

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-10-15 08:36:20 +09:00
parent 044579c27f
commit 4e51530922
2 changed files with 45 additions and 0 deletions

View File

@@ -3,6 +3,9 @@ import { nextApi } from "@/lib/http-client";
import { HttpError } from "@kri/common/http";
import {
CTI_AGENT_GROUP,
CTI_AUTO_RECONNECT_BASE_MS,
CTI_AUTO_RECONNECT_JITTER_MS,
CTI_AUTO_RECONNECT_MAX_MS,
CTI_DIALING_TIMEOUT_MS,
CTI_ERROR_ALERT_THROTTLE_MS,
CTI_ON_CALL_STATUSES,
@@ -96,6 +99,8 @@ let lastCallHistId: number | null = null;
let hangupRequested = false;
let callClosedReceived = false;
let reconnectIntervalId: ReturnType<typeof setInterval> | null = null;
let autoReconnectTimeoutId: ReturnType<typeof setTimeout> | null = null;
let autoReconnectAttempt = 0;
let dialingTimeoutId: ReturnType<typeof setTimeout> | null = null;
const lastErrorAlertAt = new Map<string, number>();
@@ -395,6 +400,32 @@ const stopReconnectLoop = () => {
console.log("[CTI][TEMP_LOG] reconnect loop stopped, agentStatus =", agentStatus); // TEMP_CTI_LOG
};
const clearAutoReconnect = () => {
if (autoReconnectTimeoutId === null) return;
clearTimeout(autoReconnectTimeoutId);
autoReconnectTimeoutId = null;
};
// 예상치 못한 소켓 끊김(onclose) 시 새로고침과 같은 connectAndLogin 경로로 다시 연결한다.
// 상태 복원과 통화 이력 복구(recoverLastCallHistId)도 함께 수행된다.
// HangUp 재연결 루프가 돌고 있으면 그 루프에 맡긴다.
const scheduleAutoReconnect = () => {
if (!currentLoginParams || reconnectIntervalId !== null || autoReconnectTimeoutId !== null) return;
const delay =
Math.min(CTI_AUTO_RECONNECT_BASE_MS * 2 ** autoReconnectAttempt, CTI_AUTO_RECONNECT_MAX_MS) +
Math.random() * CTI_AUTO_RECONNECT_JITTER_MS;
autoReconnectAttempt += 1;
console.log("[CTI][TEMP_LOG] auto reconnect scheduled, attempt =", autoReconnectAttempt, "delay =", Math.round(delay)); // TEMP_CTI_LOG
autoReconnectTimeoutId = setTimeout(() => {
autoReconnectTimeoutId = null;
const params = currentLoginParams;
if (!params || reconnectIntervalId !== null) return;
connectAndLogin(params);
}, delay);
};
const setAgentStatus = (next: string | null) => {
agentStatus = next;
if (next !== null && next !== "0") {
@@ -668,6 +699,8 @@ const logout = () => {
hangupRequested = false;
callClosedReceived = false;
stopReconnectLoop();
clearAutoReconnect();
autoReconnectAttempt = 0;
clearDialingTimeout();
setAgentStatus(null);
setLastCallHistId(null);
@@ -682,6 +715,7 @@ const openSocketAndLogin = (params: CtiLoginParams) => {
socket = ws;
ws.onopen = () => {
autoReconnectAttempt = 0;
setConnectionState("open");
sendLogin(params);
};
@@ -698,6 +732,8 @@ const openSocketAndLogin = (params: CtiLoginParams) => {
ws.onclose = (event) => {
setConnectionState("closed");
console.log("[CTI][TEMP_LOG] websocket closed, code =", event.code, "reason =", event.reason, "wasClean =", event.wasClean); // TEMP_CTI_LOG
// 의도적인 종료(teardownSocket)는 핸들러를 먼저 떼므로 여기에 오지 않는다.
scheduleAutoReconnect();
};
};
@@ -747,6 +783,8 @@ const connectAndLogin = (params: CtiLoginParams) => {
return;
}
clearAutoReconnect();
if (currentAgentLoginId && currentAgentLoginId !== params.agentLoginId) {
console.log("[CTI][TEMP_LOG] switching agent from", currentAgentLoginId, "to", params.agentLoginId); // TEMP_CTI_LOG
logout();
@@ -769,6 +807,7 @@ const connectAndLogin = (params: CtiLoginParams) => {
const suspendForPageHide = () => {
if (!currentLoginParams) return;
stopReconnectLoop();
clearAutoReconnect();
if (currentAgentLoginId && connectionState === "open" && !isCallInProgress()) {
send({ ZCommand: "Logout", AgentLoginID: currentAgentLoginId });
}