From ad0168d47da3f747924ff70bd24892aecc8352e7 Mon Sep 17 00:00:00 2001
From: tony.cheng <chengmingwei_1984122@126.com>
Date: Wed, 04 Mar 2026 19:59:17 +0800
Subject: [PATCH] feat: 优化外呼组件和案件数据上下文，增强功能稳定性
---
web-app/src/components/common/OutboundCallWidget.jsx | 489 +++++++++++++++++++++++++++++++++++++----------------
1 files changed, 338 insertions(+), 151 deletions(-)
diff --git a/web-app/src/components/common/OutboundCallWidget.jsx b/web-app/src/components/common/OutboundCallWidget.jsx
index cc26887..3d8c15e 100644
--- a/web-app/src/components/common/OutboundCallWidget.jsx
+++ b/web-app/src/components/common/OutboundCallWidget.jsx
@@ -1,61 +1,111 @@
import React, { useState, useEffect, useCallback, useRef } from 'react';
-import { message } from 'antd';
+import { useCaseData } from '../../contexts/CaseDataContext';
import OutboundBotAPIService from '../../services/OutboundBotAPIService';
+import { message } from 'antd';
-// 常量配置
const OUTBOUND_JOBS_KEY = 'outbound_call_jobs';
-const POLL_INTERVAL = 10000; // 10秒轮询间隔
-const MAX_POLL_DURATION = 7200000; // 2小时最大轮询时长（毫秒）
-const MAX_RETRY_COUNT = 10; // 最大重试次数
-// 活跃状态和终态定义
-const ACTIVE_STATUSES = ['Scheduling', 'Executing', 'Paused', 'Drafted'];
-const TERMINAL_STATUSES = ['Succeeded', 'Failed', 'Cancelled'];
+// 活跃状态列表（外呼进行中的状态）
+const ACTIVE_STATUSES = ['Scheduling', 'InProgress', 'Calling', 'Ringing', 'Answered', 'Executing'];
-// 状态中文映射
-const STATUS_MAP = {
- 'Scheduling': '拨号中',
- 'Executing': '通话中',
- 'Succeeded': '通话成功',
- 'Paused': '暂停',
- 'Failed': '通话失败',
- 'Cancelled': '通话已取消',
- 'Drafted': '草稿'
-};
+// Scheduling 状态 - 此状态变化不需要调用更新API
+const SCHEDULING_STATUS = 'Scheduling';
/**
* 智能外呼通话显示组件
- * 基于 localStorage 中的 jobId 轮询查询通话状态
- * 支持多任务并行显示、自动清理终态任务
+ * 显示在页面右下角的气泡组件，支持多人通话
+ * @param {Object} props
+ * @param {Function} props.onSwitchTab - Tab切换回调
+ * @param {Function} props.onRefreshData - 数据刷新回调
*/
-const OutboundCallWidget = () => {
- const [isVisible, setIsVisible] = useState(true);
- const [isMinimized, setIsMinimized] = useState(false);
+const OutboundCallWidget = ({ onSwitchTab, onRefreshData }) => {
+ const { caseData } = useCaseData();
+ const [isVisible, setIsVisible] = useState(false); // 默认不显示，有任务时自动显示
+ const [isMinimized, setIsMinimized] = useState(false); // 默认展开（非最小化）
const [calls, setCalls] = useState([]);
const isMountedRef = useRef(true);
+ const fetchCallStatusRef = useRef(null); // 用于存储最新的 fetchCallStatus 函数引用
+
+ // 轮询间隔（毫秒）
+ const POLL_INTERVAL = 10000; // 10秒
+
+ // 最大重试次数
+ const MAX_RETRY_COUNT = 10;
- /**
- * 格式化通话时长
- * @param {number} startTime - 开始时间戳（毫秒）
- * @returns {string} 格式化的时长（MM:SS）
- */
- const formatDuration = (startTime) => {
- if (!startTime) return '00:00';
- const seconds = Math.floor((Date.now() - startTime) / 1000);
+ // 获取 caseIdg
+ const caseId = caseData?.caseId || caseData?.case_id;
+
+ // 格式化通话时长
+ const formatDuration = (seconds) => {
const mins = Math.floor(seconds / 60);
const secs = seconds % 60;
return `${mins.toString().padStart(2, '0')}:${secs.toString().padStart(2, '0')}`;
};
/**
- * 从 localStorage 读取外呼任务
+ * 从 localStorage 读取外呼任务（包括成功和失败的任务）
* @returns {Array} 任务数组
*/
const loadJobsFromStorage = () => {
try {
- const stored = localStorage.getItem(OUTBOUND_JOBS_KEY);
- if (!stored) return [];
- return JSON.parse(stored);
+ // 读取成功的任务
+ const storedSuccess = localStorage.getItem(OUTBOUND_JOBS_KEY);
+ const successJobs = storedSuccess ? JSON.parse(storedSuccess) : [];
+ console.log('读取成功任务:', successJobs.length, successJobs);
+
+ // 读取失败的任务
+ const storedFailed = localStorage.getItem(`${OUTBOUND_JOBS_KEY}_failed`);
+ const failedJobs = storedFailed ? JSON.parse(storedFailed) : [];
+ console.log('读取失败任务:', failedJobs.length, failedJobs);
+
+ // 清理失败任务 - 按 errorCode 不同策略
+ const now = Date.now();
+ const cleanedFailedJobs = failedJobs.filter(job => {
+ // errorCode: 1001 - 超过 startTime 就清理
+ if (job.errorCode === 1001) {
+ const jobStartTime = typeof job.startTime === 'string' ? new Date(job.startTime).getTime() : job.startTime;
+ return now < jobStartTime; // 当前时间小于 startTime 才保留
+ }
+
+ // errorCode: 1002 - 跨天清理 (比较日期是否不同)
+ if (job.errorCode === 1002) {
+ const startDate = new Date(job.startTime);
+ const nowDate = new Date(now);
+
+ // 格式化为 YYYY-MM-DD 进行比较
+ const startDateString = startDate.getFullYear() + '-' +
+ String(startDate.getMonth() + 1).padStart(2, '0') + '-' +
+ String(startDate.getDate()).padStart(2, '0');
+
+ const nowDateString = nowDate.getFullYear() + '-' +
+ String(nowDate.getMonth() + 1).padStart(2, '0') + '-' +
+ String(nowDate.getDate()).padStart(2, '0');
+
+ // 如果日期相同，保留；如果日期不同，清理
+ return startDateString === nowDateString;
+ }
+
+ // 其他 errorCode 使用默认 24 小时策略
+ return (now - job.startTime) < 24 * 60 * 60 * 1000;
+ });
+
+ // 如果清理后数量变化，更新 localStorage
+ if (cleanedFailedJobs.length !== failedJobs.length) {
+ localStorage.setItem(`${OUTBOUND_JOBS_KEY}_failed`, JSON.stringify(cleanedFailedJobs));
+ }
+
+ // 按 personId 去重失败任务
+ const uniqueFailedJobs = [];
+ const seenPersonIds = new Set();
+ cleanedFailedJobs.forEach(job => {
+ if (!seenPersonIds.has(job.personId)) {
+ seenPersonIds.add(job.personId);
+ uniqueFailedJobs.push(job);
+ }
+ });
+
+ // 合并所有任务
+ return [...successJobs, ...uniqueFailedJobs];
} catch (err) {
console.error('读取外呼任务失败:', err);
return [];
@@ -79,6 +129,55 @@
};
/**
+ * 批量更新通话状态到后端
+ * @param {Array} jobsToUpdate - 需要更新的任务列表
+ * @returns {Promise<boolean>} 是否有成功的更新
+ */
+ const updateCallStatusToBackend = async (jobsToUpdate) => {
+ if (!jobsToUpdate || jobsToUpdate.length === 0) return false;
+
+ try {
+ // 并行调用所有任务的更新API
+ const results = await Promise.all(
+ jobsToUpdate.map(async (job) => {
+ try {
+ await OutboundBotAPIService.updateCallStatus({
+ jobId: job.jobId,
+ callStatus: job.newStatus
+ });
+ console.log(`状态更新成功: ${job.jobId} -> ${job.newStatus}`);
+ return { success: true, job };
+ } catch (err) {
+ console.error(`状态更新失败: ${job.jobId}`, err);
+ return { success: false, job };
+ }
+ })
+ );
+
+ // 检查是否有成功的更新
+ const hasSuccess = results.some(r => r.success);
+ return hasSuccess;
+ } catch (err) {
+ console.error('批量更新状态失败:', err);
+ return false;
+ }
+ };
+
+ /**
+ * 触发页面更新（刷新数据 + 切换Tab）
+ */
+ const triggerPageUpdate = useCallback(() => {
+ // 刷新案件数据
+ if (onRefreshData) {
+ onRefreshData();
+ }
+ // 切换到AI调解实时看板
+ if (onSwitchTab) {
+ onSwitchTab('mediation-board');
+ }
+ }, [onRefreshData, onSwitchTab]);
+
+ /**
* 移除终态或超时的任务
* @param {Array} jobs - 当前任务数组
* @returns {Array} 清理后的任务数组
@@ -86,64 +185,115 @@
const cleanupJobs = (jobs) => {
const now = Date.now();
return jobs.filter(job => {
- // 检查是否超时（2小时）
- if (now - job.pollStartTime > MAX_POLL_DURATION) {
- console.warn('外呼轮询超时（2小时），自动停止，jobId:', job.jobId);
- return false;
+ // 检查是否为活跃状态
+ if (ACTIVE_STATUSES.includes(job.callStatus)) {
+ // 检查是否超时（2小时）
+ const elapsed = now - (job.pollStartTime || job.startTime || now);
+ if (elapsed > 2 * 60 * 60 * 1000) {
+ console.warn('外呼轮询超时（2小时），自动停止，jobId:', job.jobId);
+ return false;
+ }
+ return true;
}
- // 保留活跃状态
- return ACTIVE_STATUSES.includes(job.callStatus);
+ return false;
});
};
/**
- * 查询通话状态（轮询核心逻辑）
+ * 查询通话状态
*/
const fetchCallStatus = useCallback(async () => {
- let jobs = loadJobsFromStorage();
+ console.log('fetchCallStatus 被调用');
- // 过滤出活跃任务
- const activeJobs = jobs.filter(job => ACTIVE_STATUSES.includes(job.callStatus));
+ // 从 localStorage 读取任务
+ const storedJobs = loadJobsFromStorage();
+ console.log('从 localStorage 读取的所有任务:', storedJobs);
- if (activeJobs.length === 0) {
- setCalls([]);
+ // 分离成功任务和失败任务
+ const successJobs = storedJobs.filter(job => {
+ const hasNoErrorCode = !job.errorCode;
+ const isActiveStatus = ACTIVE_STATUSES.includes(job.callStatus);
+ console.log(`任务 ${job.jobId}: errorCode=${job.errorCode}, callStatus=${job.callStatus}, 无错误码=${hasNoErrorCode}, 活跃状态=${isActiveStatus}`);
+ return hasNoErrorCode && isActiveStatus;
+ });
+ const failedJobs = storedJobs.filter(job => job.errorCode > 0);
+
+ console.log('成功任务数量:', successJobs.length, '失败任务数量:', failedJobs.length);
+
+ if (successJobs.length === 0) {
+ // 没有活跃任务，更新状态并返回
+ if (isMountedRef.current) {
+ setCalls([...failedJobs]);
+ if (failedJobs.length > 0) {
+ setIsVisible(true);
+ }
+ }
return;
}
- console.log('轮询查询通话状态，任务数量:', activeJobs.length);
+ // 立即显示气泡（不等待 API 返回）
+ console.log('isMountedRef.current:', isMountedRef.current);
+ if (isMountedRef.current) {
+ // 先合并当前的成功任务和失败任务，立即显示
+ const immediateJobs = [...successJobs, ...failedJobs.filter(f => !successJobs.some(s => s.personId === f.personId))];
+ console.log('准备设置 calls:', immediateJobs);
+ setCalls(immediateJobs);
+ setIsVisible(true);
+ console.log('立即显示气泡，任务数:', immediateJobs.length, 'isVisible 设置为 true');
+ } else {
+ console.log('组件未挂载，跳过显示气泡');
+ }
- // 遍历所有活跃任务，逐个查询状态（caseRef 和 jobId 都是必传参数）
+ // 收集需要更新到后端的任务（状态变化且原状态不是Scheduling）
+ const jobsNeedBackendUpdate = [];
+
+ // 并行查询所有任务的状态
const updatedJobs = await Promise.all(
- activeJobs.map(async (job) => {
+ successJobs.map(async (job) => {
try {
- // 同时传入 caseRef 和 jobId
- const response = await OutboundBotAPIService.getCallStatus({
+ const response = await OutboundBotAPIService.getCallStatus({
caseRef: job.caseId,
- jobId: job.jobId
+ phoneNumber: job.phoneNumber,
+ jobId: job.jobId
});
-
+
if (response?.data) {
const newStatus = response.data.callStatus;
- // 更新任务状态
- const updatedJob = {
- ...job,
- callStatus: newStatus,
- retryCount: 0 // 成功后重置重试计数
- };
-
- // 检测终态
- if (TERMINAL_STATUSES.includes(newStatus)) {
- console.log('检测到终态，jobId:', job.jobId, ', status:', newStatus);
- return null; // 标记为删除
+ // 如果状态发生变化，更新任务
+ if (newStatus !== job.callStatus) {
+ console.log(`任务 ${job.jobId} 状态更新: ${job.callStatus} -> ${newStatus}`);
+
+ // 检查是否需要调用后端更新API（排除Scheduling状态）
+ if (job.callStatus !== SCHEDULING_STATUS) {
+ jobsNeedBackendUpdate.push({
+ ...job,
+ newStatus
+ });
+ }
+
+ // 如果是终态，可以从轮询中移除
+ if (!ACTIVE_STATUSES.includes(newStatus)) {
+ console.log(`任务 ${job.jobId} 达到终态: ${newStatus}`);
+ return null; // 标记为删除
+ }
+
+ return {
+ ...job,
+ callStatus: newStatus,
+ pollStartTime: Date.now(), // 重置超时计时
+ retryCount: 0 // 重置重试计数
+ };
}
-
- return updatedJob;
+
+ // 状态未变化，保留原任务
+ return job;
}
+ // API 返回空数据，保留原任务
return job;
} catch (err) {
- console.warn('查询失败，重试次数:', job.retryCount + 1, '/', MAX_RETRY_COUNT, ', jobId:', job.jobId, ', 错误:', err.message);
+ console.error('获取通话状态失败:', err);
// 累加重试计数
const retryCount = job.retryCount + 1;
@@ -165,17 +315,45 @@
// 清理超时任务
const cleanedJobs = cleanupJobs(filteredJobs);
+ // 如果有需要更新到后端的任务，批量调用更新API
+ if (jobsNeedBackendUpdate.length > 0) {
+ const hasUpdateSuccess = await updateCallStatusToBackend(jobsNeedBackendUpdate);
+
+ // 如果有成功的更新，触发页面更新
+ if (hasUpdateSuccess) {
+ triggerPageUpdate();
+ }
+ }
+
// 保存到 localStorage
saveJobsToStorage(cleanedJobs);
+ // 合并成功任务和失败任务，按 personId 去重（成功任务优先）
+ const successPersonIds = new Set(cleanedJobs.map(job => job.personId));
+ // 过滤掉已有成功任务的 personId 对应的失败任务
+ const filteredFailedJobs = failedJobs.filter(job => !successPersonIds.has(job.personId));
+ const allJobs = [...cleanedJobs, ...filteredFailedJobs];
+
// 更新组件状态
if (isMountedRef.current) {
- setCalls(cleanedJobs);
+ setCalls(allJobs);
+ // 如果有任务，显示气泡（使用函数式更新避免依赖 isVisible）
+ if (allJobs.length > 0) {
+ setIsVisible(true);
+ }
}
- }, []);
+ }, [triggerPageUpdate]);
+
+ // 将最新的 fetchCallStatus 存储到 ref 中
+ useEffect(() => {
+ fetchCallStatusRef.current = fetchCallStatus;
+ }, [fetchCallStatus]);
// 定时轮询通话状态
useEffect(() => {
+ // 组件挂载时设置为 true
+ isMountedRef.current = true;
+
// 初始加载
fetchCallStatus();
@@ -189,13 +367,38 @@
};
}, [fetchCallStatus]);
- // 组件挂载时标记
+ // 监听 localStorage 变化，外呼成功后立即刷新
useEffect(() => {
- isMountedRef.current = true;
- return () => {
- isMountedRef.current = false;
+ const handleStorageChange = (e) => {
+ // 监听外呼任务存储的变化
+ if (e.key === OUTBOUND_JOBS_KEY || e.key === `${OUTBOUND_JOBS_KEY}_failed`) {
+ console.log('localStorage 变化，刷新外呼状态');
+ if (fetchCallStatusRef.current) {
+ fetchCallStatusRef.current();
+ }
+ }
};
- }, []);
+
+ // 监听 storage 事件（跨标签页同步）
+ window.addEventListener('storage', handleStorageChange);
+
+ // 同页面内的 localStorage 变化需要手动触发
+ // 创建自定义事件监听 - 使用 ref 避免依赖问题
+ const handleCustomStorageChange = () => {
+ console.log('同页面 localStorage 变化，刷新外呼状态');
+ if (fetchCallStatusRef.current) {
+ fetchCallStatusRef.current();
+ }
+ };
+ window.addEventListener('outbound-jobs-updated', handleCustomStorageChange);
+
+ console.log('事件监听器已设置: outbound-jobs-updated');
+
+ return () => {
+ window.removeEventListener('storage', handleStorageChange);
+ window.removeEventListener('outbound-jobs-updated', handleCustomStorageChange);
+ };
+ }, []); // 空依赖数组，只在组件挂载时设置一次
// 关闭气泡
const handleClose = (e) => {
@@ -210,10 +413,41 @@
setIsVisible(true);
};
+ // 过滤掉已过期的任务（用于气泡显示）
+ const now = Date.now();
+ const activeCalls = calls.filter(call => {
+ // errorCode: 1001 - 超过 startTime 视为过期
+ if (call.errorCode === 1001) {
+ const callStartTime = typeof call.startTime === 'string' ? new Date(call.startTime).getTime() : call.startTime;
+ return now < callStartTime; // 当前时间小于 startTime 才显示
+ }
+ // errorCode: 1002 - 跨天视为过期
+ if (call.errorCode === 1002) {
+ const startDate = new Date(call.startTime);
+ const nowDate = new Date(now);
+ const startDateString = startDate.getFullYear() + '-' +
+ String(startDate.getMonth() + 1).padStart(2, '0') + '-' +
+ String(startDate.getDate()).padStart(2, '0');
+ const nowDateString = nowDate.getFullYear() + '-' +
+ String(nowDate.getMonth() + 1).padStart(2, '0') + '-' +
+ String(nowDate.getDate()).padStart(2, '0');
+ return startDateString === nowDateString; // 同一天才显示
+ }
+ // 其他状态的任务正常显示
+ return true;
+ });
+
+ // 添加调试日志
+ console.log('渲染检查 - calls:', calls.length, 'activeCalls:', activeCalls.length, 'isVisible:', isVisible, 'isMinimized:', isMinimized);
+
+ // 如果没有任务，不渲染任何内容
+ if (activeCalls.length === 0) {
+ console.log('无活跃任务，不渲染气泡');
+ return null;
+ }
+
// 如果最小化，显示AI客服图标
if (isMinimized) {
-
-
return (
<div
onClick={handleExpand}
@@ -248,7 +482,7 @@
}}
/>
{/* 红点提示有通话 */}
- {calls.length > 0 && (
+ {activeCalls.length > 0 && (
<div
style={{
position: 'absolute',
@@ -266,7 +500,7 @@
fontWeight: 'bold',
}}
>
- {calls.length}
+ {activeCalls.length}
</div>
)}
</div>
@@ -287,7 +521,7 @@
maxWidth: 320,
}}
>
- {calls.map((call, index) => (
+ {activeCalls.map((call, index) => (
<div
key={call.jobId || call.phoneNumber || index}
style={{
@@ -368,7 +602,7 @@
width: 8,
height: 8,
borderRadius: '50%',
- background: '#52c41a',
+ background: call.errorCode > 0 ? '#ff4d4f' : '#52c41a',
animation: 'pulse 2s infinite',
}}
/>
@@ -379,86 +613,39 @@
{/* 通话信息 */}
<div style={{ marginBottom: 10 }}>
<div style={{ fontSize: 14, opacity: 0.9, lineHeight: 1.5 }}>
- 正在与 {call.personId || '未知联系人'} 电话沟通中...
- </div>
- <div style={{ fontSize: 12, opacity: 0.75, marginTop: 4 }}>
- 状态：{STATUS_MAP[call.callStatus] || call.callStatus}
+ {call.errorCode > 0 ? (
+ // 失败任务显示
+ <span>
+ {call.perClassName || '联系人'}
+ {call.trueName && `（${call.trueName}）`}：
+ {call.message}
+ </span>
+ ) : (
+ // 成功任务显示
+ <span>
+ 正在与{call.perClassName || '申请方'}（{call.trueName || call.personId}）电话沟通中...
+ </span>
+ )}
</div>
</div>
- {/* 通话时长 */}
- <div
- style={{
- display: 'flex',
- alignItems: 'center',
- gap: 6,
- fontSize: 13,
- opacity: 0.85,
- }}
- >
- <i className="far fa-clock" />
- <span>已持续: {formatDuration(call.startTime)}</span>
- </div>
- </div>
- ))}
-
- {/* 无通话时的占位提示 */}
- {calls.length === 0 && isVisible && (
- <div
- style={{
- background: 'linear-gradient(135deg, #1A6FB8 0%, #0d4a8a 100%)',
- borderRadius: 12,
- padding: '16px 20px',
- color: 'white',
- boxShadow: '0 4px 16px rgba(26, 111, 184, 0.3)',
- position: 'relative',
- minWidth: 280,
- }}
- >
- {/* 关闭按钮 */}
- <button
- onClick={handleClose}
- style={{
- position: 'absolute',
- top: 8,
- right: 8,
- width: 24,
- height: 24,
- borderRadius: '50%',
- border: 'none',
- background: 'rgba(255,255,255,0.2)',
- color: 'white',
- cursor: 'pointer',
- display: 'flex',
- alignItems: 'center',
- justifyContent: 'center',
- fontSize: 14,
- }}
- >
- <i className="fas fa-times" />
- </button>
-
- <div style={{ display: 'flex', alignItems: 'center', gap: 10 }}>
+ {/* 通话时长（仅对成功任务显示）*/}
+ {!call.errorCode && call.pollStartTime && (
<div
style={{
- width: 36,
- height: 36,
- borderRadius: '50%',
- background: 'rgba(255,255,255,0.2)',
display: 'flex',
alignItems: 'center',
- justifyContent: 'center',
+ gap: 6,
+ fontSize: 13,
+ opacity: 0.85,
}}
>
- <i className="fas fa-robot" style={{ fontSize: 18 }} />
+ <i className="far fa-clock" />
+ <span>已持续: {formatDuration(Math.floor((Date.now() - call.pollStartTime) / 1000))}</span>
</div>
- <div>
- <div style={{ fontSize: 16, fontWeight: 600 }}>智能外呼系统</div>
- <div style={{ fontSize: 13, opacity: 0.85 }}>暂无进行中的通话</div>
- </div>
- </div>
+ )}
</div>
- )}
+ ))}
{/* CSS 动画 */}
<style>{`
@@ -471,4 +658,4 @@
);
};
-export default OutboundCallWidget;
+export default OutboundCallWidget;
\ No newline at end of file
--
Gitblit v1.8.0