feat: 数据加载稳定性重构 - 将证据材料和调解协议API集中到CaseDataContext统一管理

tony.cheng

2026-03-12 85d9447504b83d4b4b0550d4b5199e284e14a06f

 web-app/src/contexts/CaseDataContext.jsx

@@ -6,6 +6,9 @@
import React, { createContext, useContext, useState, useEffect, useRef } from 'react';
import { message } from 'antd';
import ProcessAPIService from '../services/ProcessAPIService';
import OutboundBotAPIService from '../services/OutboundBotAPIService';
import EvidenceAPIService from '../services/EvidenceAPIService';
import MediationAgreementAPIService from '../services/MediationAgreementAPIService';
import { getMergedParams } from '../utils/urlParams';
import { mockTimelineData } from '../mocks/timeline';
import { getFallbackStartTime, parseTimeString } from '../utils/timeFormatter';
@@ -15,6 +18,7 @@

// localStorage键名
const STORAGE_KEY = 'case_data_timeline';
const OUTBOUND_JOBS_KEY = 'outbound_call_jobs';

/**
 * CaseDataProvider组件
@@ -28,21 +32,21 @@
  const [taskStartTime, setTaskStartTime] = useState(null);  // 任务开始时间
  const [isTaskTimeFallback, setIsTaskTimeFallback] = useState(false);  // 是否降级模式
  const [hasLoaded, setHasLoaded] = useState(false);  // 防止重复加载

  /**
   * 从localStorage读取数据
   */
  const loadFromStorage = () => {
    try {
      const stored = localStorage.getItem(STORAGE_KEY);
      if (stored) {
        return JSON.parse(stored);
      }
    } catch (err) {
      console.error('Failed to load data from localStorage:', err);
    }
    return null;
  };
  
  // 证据材料数据
  const [evidenceData, setEvidenceData] = useState({
    applicantMaterials: [],
    respondentMaterials: [],
    loading: false,
    error: null
  });
  
  // 调解协议数据
  const [agreementData, setAgreementData] = useState({
    content: '',
    loading: false,
    error: null
  });

  /**
   * 保存数据到localStorage
@@ -52,6 +56,190 @@
      localStorage.setItem(STORAGE_KEY, JSON.stringify(data));
    } catch (err) {
      console.error('Failed to save data to localStorage:', err);
    }
  };

  /**
   * 检查是否有活跃的外呼任务
   * @returns {boolean} 是否有活跃任务
   */
  const hasActiveOutboundJobs = () => {
    try {
      const stored = localStorage.getItem(OUTBOUND_JOBS_KEY);
      if (!stored) return false;
      
      const jobs = JSON.parse(stored);
      const activeStatuses = [
        'Scheduling',
        'Executing',
        'Paused',
        'Drafted',
        'InProgress',
        'Calling',
        'Ringing',
        'Answered'
      ];
      
      // 过滤出活跃状态的任务
      const activeJobs = jobs.filter(job => activeStatuses.includes(job.callStatus));
      return activeJobs.length > 0;
    } catch (err) {
      console.error('检查活跃外呼任务失败:', err);
      return false;
    }
  };

  /**
   * 触发智能外呼
   * @param {Object} timeline - 案件时间线数据
   */
  const triggerOutboundCall = async (timeline) => {
    try {
      const { mediation } = timeline;
      if (!mediation) {
        console.warn('缺少必要参数:timeline.mediation，跳过外呼触发:', timeline);
        return;
      }
      const { state } = mediation;
      if (state >= 2) { // 2：调解成功,3:调解失败，4:人工接管
        console.warn('调解状态已结束,mediation.state:', state);
        return;
      }
      // 检查是否已有活跃任务，如有则跳过
      if (hasActiveOutboundJobs()) {
        console.log('检测到活跃外呼任务，跳过发起新外呼');
        return;
      }

      const mediationId = timeline.id;
      const caseId = timeline.case_id;

      if (!mediationId || !caseId) {
        console.warn('缺少必要参数，跳过外呼触发:', { mediationId, caseId });
        return;
      }

      console.log('发起智能外呼，mediationId:', mediationId, ', caseId:', caseId);

      // 调用外呼API
      const response = await OutboundBotAPIService.makeCallV2({
        mediationId: String(mediationId),
        caseId: String(caseId),
        callAuto: 0,
        callPersonId: ''
      });

      // 处理响应
      console.log('triggerOutboundCall API 响应:', response);
      console.log('response.data:', response?.data);
      console.log('response.data 是数组:', Array.isArray(response?.data));
      
      if (response?.data && Array.isArray(response.data)) {
        const successJobs = [];
        const failedJobs = [];

        // 分类成功和失败的记录
        response.data.forEach(item => {
          if (item.errorCode === 0 && item.jobId) {
            successJobs.push({
              jobId: item.jobId,
              callStatus: item.callStatus || 'Scheduling',
              personId: item.personId,
              mediationId: item.mediationId,
              caseId: String(caseId), // 添加 caseId 字段用于轮询
              perClassName: item.perClassName || '', // 添加人员类型名称
              trueName: item.trueName || '', // 添加真实姓名
              startTime: item.createTime || item.createdTime || item.start_time,
              pollStartTime: Date.now(),
              retryCount: 0
            });
          } else if (item.errorCode > 0) {
            failedJobs.push({
              personId: item.personId,
              message: item.message || '未知错误',
              perClassName: item.perClassName || '', // 添加人员类型名称
              trueName: item.trueName || '', // 添加真实姓名
              errorCode: item.errorCode, // 添加错误码
              startTime: new Date(item.startTime || item.start_time).getTime() // 转换为时间戳
            });
          }
        });

        // 存储成功的任务到 localStorage
        if (successJobs.length > 0) {
          // 读取现有的成功任务，合并而不是覆盖
          const existingJobs = JSON.parse(localStorage.getItem(OUTBOUND_JOBS_KEY) || '[]');
          // 按 jobId 去重，新任务优先
          const existingJobIds = new Set(successJobs.map(job => job.jobId));
          const filteredExistingJobs = existingJobs.filter(job => !existingJobIds.has(job.jobId));
          const mergedJobs = [...successJobs, ...filteredExistingJobs];
          
          localStorage.setItem(OUTBOUND_JOBS_KEY, JSON.stringify(mergedJobs));
          console.log('存储外呼任务成功，新增:', successJobs.length, '总数:', mergedJobs.length);
          console.log('存储的任务:', JSON.stringify(mergedJobs, null, 2));
          
          // 外呼成功后，清除对应的失败记录
          const storedFailedJobs = JSON.parse(localStorage.getItem(`${OUTBOUND_JOBS_KEY}_failed`) || '[]');
          if (storedFailedJobs.length > 0) {
            // 获取成功任务的 personId 列表
            const successPersonIds = successJobs.map(job => job.personId);
            // 过滤掉已成功的 personId 对应的失败记录
            const remainingFailedJobs = storedFailedJobs.filter(job => !successPersonIds.includes(job.personId));
            localStorage.setItem(`${OUTBOUND_JOBS_KEY}_failed`, JSON.stringify(remainingFailedJobs));
            console.log('外呼成功后清除失败记录，清除数量:', storedFailedJobs.length - remainingFailedJobs.length);
          }
          
          // 延迟触发自定义事件，确保监听器已经设置好
          setTimeout(() => {
            console.log('触发 outbound-jobs-updated 事件');
            window.dispatchEvent(new CustomEvent('outbound-jobs-updated'));
          }, 300);
        }

        // 存储失败的任务到 localStorage（用于气泡显示）
        if (failedJobs.length > 0) {
          console.log('准备存储失败任务:', failedJobs);
          // 读取现有的失败任务
          const storedFailedJobs = JSON.parse(localStorage.getItem(`${OUTBOUND_JOBS_KEY}_failed`) || '[]');
          
          // 去重：按 personId 去重，保留最新的错误信息
          const uniqueFailedJobs = [...storedFailedJobs];
          failedJobs.forEach(newJob => {
            const existingIndex = uniqueFailedJobs.findIndex(job => job.personId === newJob.personId);
            if (existingIndex >= 0) {
              // 更新已存在的失败任务
              uniqueFailedJobs[existingIndex] = newJob;
            } else {
              // 添加新的失败任务
              uniqueFailedJobs.push(newJob);
            }
          });
          
          // 清理超过24小时的失败任务
          const now = Date.now();
          const cleanedFailedJobs = uniqueFailedJobs.filter(job => {
            return (now - job.startTime) < 24 * 60 * 60 * 1000; // 24小时
          });
          
          localStorage.setItem(`${OUTBOUND_JOBS_KEY}_failed`, JSON.stringify(cleanedFailedJobs));
          console.log('存储外呼失败任务，数量:', cleanedFailedJobs.length);
          
          // 触发自定义事件通知 OutboundCallWidget 组件刷新
          window.dispatchEvent(new CustomEvent('outbound-jobs-updated'));
        }

        // 提示失败的任务
        if (failedJobs.length > 0) {
          const failedMsg = failedJobs
            .map(job => `${job.personId}（${job.message}）`)
            .join('、');
          message.warning(`部分联系人外呼失败：${failedMsg}`);
          console.warn('部分外呼失败:', failedJobs);
        }
      }
    } catch (err) {
      console.error('智能外呼发起失败:', err);
      message.error('智能外呼发起失败，请检查网络后重试');
    }
  };

@@ -95,6 +283,87 @@
      console.log('Using fallback start time:', new Date(fallbackTime).toLocaleString());
    }
  };

  /**
   * 加载证据材料数据
   * @param {Object} params - 参数对象
   * @param {string} params.caseId - 案件ID
   * @param {string} params.caseType - 案件类型
   * @param {string} params.platformCode - 平台编码
   */
  const loadEvidenceData = async (params) => {
    setEvidenceData(prev => ({ ...prev, loading: true, error: null }));
    
    try {
      const response = await EvidenceAPIService.getEvidenceList({
        case_id: params.caseId,
        case_type: params.caseType || params.caseTypeFirst,
        platform_code: params.platformCode
      });
      
      console.log('Evidence API response:', response);
      
      const responseData = response.data || [];
      
      // 分离申请人和被申请人材料
      const applicantData = responseData.find(item => item.per_type === '15_020008-1');
      const respondentData = responseData.find(item => item.per_type === '15_020008-2');
      
      const applicantList = applicantData?.file_list?.slice(0, applicantData.file_count) || [];
      const respondentList = respondentData?.file_list?.slice(0, respondentData.file_count) || [];
      
      setEvidenceData({
        applicantMaterials: applicantList,
        respondentMaterials: respondentList,
        loading: false,
        error: null
      });
      
      console.log('Evidence data loaded:', { applicantList, respondentList });
    } catch (err) {
      console.error('加载证据材料失败:', err);
      setEvidenceData(prev => ({
        ...prev,
        loading: false,
        error: err.message || '加载证据材料失败'
      }));
    }
  };

  /**
   * 加载调解协议数据
   * @param {string} caseId - 案件ID
   */
  const loadAgreementData = async (caseId) => {
    setAgreementData(prev => ({ ...prev, loading: true, error: null }));
    
    try {
      const response = await MediationAgreementAPIService.generateAgreement(caseId);
      
      if (response?.data?.agreeContent) {
        setAgreementData({
          content: response.data.agreeContent,
          loading: false,
          error: null
        });
        console.log('Agreement data loaded');
      } else {
        setAgreementData({
          content: '',
          loading: false,
          error: '协议内容为空'
        });
      }
    } catch (err) {
      console.error('加载调解协议失败:', err);
      setAgreementData({
        content: '',
        loading: false,
        error: err.message || '加载调解协议失败'
      });
    }
  };

  /**
   * 加载案件数据
   */
@@ -114,20 +383,38 @@
      
      console.log('Loading case data with params:', params);

      if (!params.caseId) {
        setError('caseId缺失');
        setLoading(false);
        return;
      }

      try {
        await OutboundBotAPIService.syncStatusByCase({ caseId: params.caseId });
      } catch (syncError) {
        console.error('同步外呼状态失败:', syncError);
      }
      try {
        await OutboundBotAPIService.backfillConversationByCase({ caseId: params.caseId });
      } catch (backfillError) {
        console.error('回补通话记录失败:', backfillError);
      }

      // 调用API获取数据
      const response = await ProcessAPIService.getCaseProcessInfo(
        params.caseId,
        {
          caseTypeFirst: params.caseTypeFirst,
          platform_code: params.platform_code
          platform_code: params.platform_code,
          authorization: params.auth_token
        }
      );

      // 提取timeline数据
      const timelineData = response.timeline || response.data?.timeline || response;
      
      // 提取nodes数据（确保为数组）
      const nodesData = response.nodes || response.data?.nodes || [];
      // 提取nodes数据（确保为数组），兼容 nodeList 和 nodes 两种字段名
      const nodesData = response.data?.nodeList || response.data?.nodes || response.nodes || [];
      
      console.log('API Response:', response);
      console.log('Extracted nodesData:', nodesData);
@@ -137,8 +424,32 @@
      setProcessNodes(Array.isArray(nodesData) ? nodesData : []);  // 确保为数组
      setHasLoaded(true);  // 标记已加载
      
      // 并行加载证据材料和调解协议数据（在终态检查之前，确保数据完整性）
      await Promise.all([
        loadEvidenceData({
          caseId: params.caseId,
          caseType: params.caseType || params.caseTypeFirst,
          caseTypeFirst: params.caseTypeFirst,
          platformCode: params.platform_code
        }),
        loadAgreementData(params.caseId)
      ]);
      
      // 检查终态状态（调解成功/失败/人工接管），终态不执行外呼和存储
      const mediationState = timelineData.mediation?.state;
      const isTerminalState = [2, 3, 4].includes(mediationState);
      
      if (isTerminalState) {
        console.log('案件已处于终态状态:', mediationState, '，跳过外呼和存储');
        return;
      }
      
      // 保存到localStorage
      saveToStorage(timelineData);
      
      // 触发智能外呼
      await triggerOutboundCall(timelineData);
      

      // 加载任务时间数据
      await loadTaskTime(timelineData);
@@ -152,18 +463,8 @@
      message.error('加载案件数据失败，请稍后重试');
      
      // 使用Mock数据（缓存数据不包含nodes，所以统一使用Mock）
      console.log('===== 使用Mock数据 =====');
      const mockData = mockTimelineData.data.timeline;
      const mockNodes = mockTimelineData.data.nodes || [];
      console.log('mockData:', mockData);
      console.log('mockNodes:', mockNodes);
      setCaseData(mockData);
      setProcessNodes(mockNodes);
      saveToStorage(mockData);
      setHasLoaded(true);
      
      // Mock数据也加载任务时间
      await loadTaskTime(mockData);
    } finally {
      setLoading(false);
    }
@@ -208,7 +509,13 @@
    refreshData,
    loadCaseData,
    taskStartTime,      // 任务开始时间
    isTaskTimeFallback  // 是否降级模式
    isTaskTimeFallback, // 是否降级模式
    // 证据材料数据
    evidenceData,
    loadEvidenceData,
    // 调解协议数据
    agreementData,
    loadAgreementData
  };

  return (