## ADDED Requirements

### Requirement: 智能外呼自动触发

系统在首页加载案件数据完成后，SHALL 自动发起 AI 智能外呼，无需用户手动操作。外呼请求应基于案件数据（mediationId、caseId）构建，并确保幂等性（页面刷新时不重复触发）。

#### Scenario: 首次进入首页自动触发外呼

- **GIVEN** 用户首次进入首页，localStorage 中无活跃外呼任务
- **WHEN** `CaseDataContext.loadCaseData()` 完成并返回 `timelineData`
- **THEN** 系统自动调用 `OutboundBotAPIService.makeCallV2({ mediationId, caseId, callAuto: 0, callPersonId: null })`
- **AND** 成功响应后，从 `response.data` 中提取所有 `errorCode === 0` 的记录
- **AND** 将每条记录的 `jobId`、`callStatus`、`personId`、`mediationId` 存储到 localStorage（键名：`outbound_call_jobs`）
- **AND** 右下角智能外呼气泡组件自动弹出，展示"正在与XX电话沟通中..."

#### Scenario: 页面刷新时检测活跃任务

- **GIVEN** localStorage 中存在活跃状态的外呼任务（`callStatus` 为 `Scheduling`、`Executing`、`Paused` 或 `Drafted`）
- **WHEN** 用户刷新页面，`CaseDataContext.loadCaseData()` 执行
- **THEN** 系统检测到活跃任务，跳过发起新外呼
- **AND** 继续轮询查询现有任务的通话状态
- **AND** 右下角气泡组件根据 localStorage 中的 jobId 恢复显示

#### Scenario: 外呼发起失败处理

- **GIVEN** 用户进入首页，数据加载完成
- **WHEN** 调用 `makeCallV2` 失败（如网络错误、API 返回 500）
- **THEN** 系统展示 Ant Design 错误提示：`message.error('发起外呼失败，请稍后重试')`
- **AND** 在浏览器控制台输出详细错误日志：`console.error('makeCallV2 failed:', err)`
- **AND** 不阻塞页面其他功能，用户可正常使用首页

#### Scenario: API 返回部分成功记录

- **GIVEN** `makeCallV2` 响应包含多条记录，其中部分 `errorCode === 0`（成功），部分 `errorCode !== 0`（失败）
- **WHEN** 系统解析响应数据
- **THEN** 仅提取并存储 `errorCode === 0` 的记录到 localStorage
- **AND** 对于失败记录（如"外呼次数已达上限"），在控制台输出警告日志
- **AND** 右下角气泡仅展示成功发起的外呼任务

---

### Requirement: 外呼状态实时监控

系统 SHALL 对活跃外呼任务进行定时轮询，查询通话状态并实时更新右下角气泡组件显示。轮询策略应平衡实时性与服务器压力，采用 10 秒间隔、最大 2 小时轮询时长、失败重试 10 次的机制。

#### Scenario: 定时轮询查询通话状态

- **GIVEN** localStorage 中存在活跃状态的 jobId（`callStatus` 为 `Scheduling`、`Executing`、`Paused` 或 `Drafted`）
- **WHEN** `OutboundCallWidget` 组件挂载后启动轮询定时器（间隔 10 秒）
- **THEN** 遍历所有活跃 jobId，调用 `OutboundBotAPIService.getCallStatus({ jobId })`
- **AND** 解析每个响应的 `callStatus`，更新组件内部 `calls` 状态数组
- **AND** 气泡组件实时显示通话人姓名、通话状态（中文）、通话时长（格式：MM:SS）

#### Scenario: 检测终态状态并停止轮询

- **GIVEN** 轮询过程中某个 jobId 的 `callStatus` 变为 `Succeeded`（成功）
- **WHEN** 系统检测到终态状态
- **THEN** 立即从 localStorage 的 `outbound_call_jobs` 中移除该 jobId
- **AND** 更新 `calls` 状态数组，移除对应记录
- **AND** 如果所有 jobId 均为终态，右下角气泡自动隐藏（`isVisible=false`）
- **AND** 停止该 jobId 的后续轮询

#### Scenario: 轮询超时自动停止

- **GIVEN** 某个 jobId 的轮询已持续 2 小时（从 `pollStartTime` 开始计时）
- **WHEN** 系统检测到轮询时长超过 7200 秒
- **THEN** 自动停止该 jobId 的轮询，从 localStorage 中移除
- **AND** 在控制台输出警告日志：`console.warn('轮询超时，jobId: xxx')`
- **AND** 不展示错误提示，避免打扰用户

#### Scenario: 单次查询失败重试机制

- **GIVEN** 调用 `getCallStatus` 失败（如网络抖动、API 返回 500）
- **WHEN** 系统检测到单次查询失败
- **THEN** 累加该 jobId 的 `retryCount` 计数器
- **AND** 保留该 jobId 在 localStorage 中，下次轮询继续重试
- **AND** 在控制台输出日志：`console.warn('查询失败，重试次数: X/10, jobId: xxx')`

#### Scenario: 连续失败 10 次后移除任务

- **GIVEN** 某个 jobId 的 `retryCount` 已达到 10
- **WHEN** 第 10 次查询失败
- **THEN** 展示 Ant Design 错误提示：`message.error('获取通话状态失败，请检查网络连接')`
- **AND** 从 localStorage 中移除该 jobId
- **AND** 在控制台输出错误日志：`console.error('重试次数超限，jobId: xxx')`
- **AND** 更新气泡组件，移除该任务显示

---

### Requirement: 多任务并行支持

系统 SHALL 支持同时展示多个外呼任务的状态（如申请人、被申请人同时外呼），气泡组件采用纵向堆叠布局，每个任务独立显示通话人和状态信息。

#### Scenario: 同时展示多个外呼任务

- **GIVEN** `makeCallV2` 响应返回 2 条成功记录（2 个 jobId）
- **WHEN** 系统存储到 localStorage 并启动轮询
- **THEN** 右下角气泡组件纵向堆叠展示 2 个气泡
- **AND** 每个气泡独立显示：通话人姓名、通话状态、通话时长
- **AND** 第一个气泡位于下方，第二个气泡位于上方（堆叠顺序）

#### Scenario: 单个任务结束后部分气泡消失

- **GIVEN** 存在 2 个活跃外呼任务
- **WHEN** 其中 1 个任务状态变为 `Succeeded`（成功）
- **THEN** 对应气泡立即消失
- **AND** 另一个任务的气泡继续显示并轮询
- **AND** localStorage 中仅保留 1 个活跃 jobId

#### Scenario: 所有任务结束后气泡完全隐藏

- **GIVEN** 所有外呼任务均已结束（`callStatus` 为 `Succeeded`、`Failed` 或 `Cancelled`）
- **WHEN** 系统检测到 localStorage 中无活跃 jobId
- **THEN** 右下角气泡完全隐藏（包括最小化的 AI 客服图标）
- **AND** 停止轮询定时器

---

### Requirement: 组件生命周期管理

系统 SHALL 在组件卸载或用户离开页面时正确清理定时器和资源，避免内存泄漏和控制台报错。

#### Scenario: 组件卸载时清理定时器

- **GIVEN** `OutboundCallWidget` 组件已挂载并启动轮询定时器
- **WHEN** 用户导航到其他页面，组件卸载
- **THEN** 在 `useEffect` 的清理函数中调用 `clearInterval(intervalId)`
- **AND** 停止所有正在进行的轮询
- **AND** 不抛出任何错误或警告到控制台

#### Scenario: 路由切换时保留 localStorage 状态

- **GIVEN** 用户在首页查看外呼气泡，然后切换到其他页面
- **WHEN** `OutboundCallWidget` 组件卸载
- **THEN** localStorage 中的 `outbound_call_jobs` 数据保持不变
- **AND** 用户返回首页时，组件重新挂载并从 localStorage 恢复状态
- **AND** 继续轮询之前的活跃任务

#### Scenario: 避免组件卸载后的异步回调执行

- **GIVEN** 组件发起了 `getCallStatus` 异步请求
- **WHEN** 请求尚未返回时，组件被卸载
- **THEN** 使用 `useRef` 记录 `isMounted` 状态
- **AND** 异步回调中检查 `isMounted`，如果组件已卸载则不执行状态更新
- **AND** 不抛出"Can't perform a React state update on an unmounted component"警告

---

### Requirement: 通话状态中文映射

系统 SHALL 将 API 返回的英文通话状态映射为中文，便于用户理解当前外呼进度。

#### Scenario: 状态中文映射规则

- **GIVEN** API 返回的 `callStatus` 为英文值
- **WHEN** 气泡组件渲染通话状态
- **THEN** 按照以下规则显示中文：
  - `Scheduling` → "拨号中"
  - `Executing` → "通话中"
  - `Paused` → "已暂停"
  - `Drafted` → "草稿"
  - `Succeeded` → "已完成"
  - `Failed` → "失败"
  - `Cancelled` → "已取消"
- **AND** 未知状态显示原始值

#### Scenario: 通话时长计算

- **GIVEN** API 响应包含 `startTime` 字段（时间戳或 ISO 格式字符串）
- **WHEN** 气泡组件显示通话时长
- **THEN** 计算当前时间与 `startTime` 的差值（秒）
- **AND** 格式化为"MM:SS"格式（如"02:35"表示 2 分 35 秒）
- **AND** 每次轮询更新时重新计算并刷新显示

---

### Requirement: 错误提示与日志记录

系统 SHALL 在关键操作失败时提供友好的错误提示，并在浏览器控制台输出详细日志，便于开发调试。

#### Scenario: makeCallV2 失败提示

- **GIVEN** 调用 `makeCallV2` 失败（如网络错误、API 返回 500）
- **WHEN** 捕获到异常
- **THEN** 展示 Ant Design 错误提示：`message.error('发起外呼失败，请稍后重试')`
- **AND** 在控制台输出错误日志：`console.error('makeCallV2 failed:', err)`

#### Scenario: getCallStatus 重试超限提示

- **GIVEN** 某个 jobId 的查询连续失败 10 次
- **WHEN** 第 10 次失败后
- **THEN** 展示 Ant Design 错误提示：`message.error('获取通话状态失败，请检查网络连接')`
- **AND** 在控制台输出错误日志：`console.error('重试次数超限，jobId: xxx')`

#### Scenario: 关键步骤日志记录

- **GIVEN** 系统执行外呼触发、轮询、状态更新等关键步骤
- **WHEN** 每个步骤完成
- **THEN** 在控制台输出相应日志：
  - `console.log('发起外呼，mediationId: X, caseId: Y')`
  - `console.log('存储 jobId: X, callStatus: Y')`
  - `console.log('轮询查询 jobId: X')`
  - `console.log('检测到终态，移除 jobId: X')`