# Proposal: 实现AI调解状态控制功能（终止/恢复）

## Change ID
`implement-mediation-state-control`

## Summary
在调解看板页面增加"终止"或"恢复"功能按钮，允许用户对正在进行的AI自动调解进行暂停和恢复操作。按钮位于人工接管按钮右侧，根据案件当前状态动态显示不同的文本和样式。

## Motivation
当前系统缺乏对AI自动调解过程的灵活控制机制。当调解遇到特殊情况（如需要人工干预、当事人临时沟通等）时，调解员需要能够暂停AI调解流程，并在适当时机恢复调解。此功能将提升系统的实用性和用户体验。

## Requirements Overview
- 在调解看板页面添加状态控制按钮
- 根据案件状态动态显示按钮文本和样式
- 实现确认对话框机制
- 调用后端API进行状态变更
- 状态变更后自动刷新页面数据

## Stakeholders
- 调解员：主要使用者，需要灵活控制调解流程
- 系统管理员：关注功能稳定性和安全性
- 产品负责人：确保功能符合业务需求

## Success Criteria
- 按钮正确显示在人工接管按钮右侧
- 状态为0或1时显示"终止"按钮（蓝色样式）
- 状态为5时显示"恢复"按钮（绿色样式）
- 其他状态下不显示该按钮
- 点击按钮后正确显示确认对话框
- API调用成功后页面数据正确刷新
- API调用失败时显示相应错误提示

## Risks & Mitigations
- **风险**：频繁的状态变更可能影响调解流程的一致性
  - **缓解**：添加操作日志记录，便于追踪状态变更历史
- **风险**：并发操作可能导致状态不一致
  - **缓解**：在后端实现状态变更的原子性控制

## Dependencies
- 已存在的`ProcessAPIService.updateMediationState` API
- 案件状态管理机制
- 现有的人工接管功能实现

## Timeline
预计开发时间：2-3个工作日
- 设计和评审：0.5天
- 前端实现：1.5天
- 测试和验证：1天

## Alternatives Considered
1. **在独立页面管理调解状态**：增加了用户操作复杂度，不符合当前一体化界面设计理念
2. **通过右键菜单实现**：隐藏了重要功能，不利于用户发现和使用
3. **自动状态检测和恢复**：缺乏人工控制灵活性，可能在不适当的时候触发状态变更

选择在现有界面中直接添加按钮的方式，既保持了界面的一致性，又提供了直观的操作方式。