# 首页证据材料汇总API对接提案

## 概述
为云小调系统首页增加证据材料汇总展示功能，实现与后端API的数据对接，展示申请人和被申请人的材料信息及审核状态。

## 背景
当前首页缺少证据材料的可视化展示，用户无法直观了解案件材料的提交和审核情况。需要通过API对接实现材料数据的实时展示。

## 目标
- 实现首页证据材料汇总的数据加载和展示
- 提供清晰的Tab切换界面区分申请人和被申请人材料
- 展示材料审核状态和基本信息
- 提供良好的用户体验（loading状态、错误处理）

## 范围
### 包含
- 首页证据材料模块的API数据对接
- 申请人/被申请人Tab切换功能
- 材料列表展示（名称、状态、说明、时间）
- 审核状态计算逻辑
- Loading状态和错误处理

### 不包含
- 材料上传功能
- 材料详情查看功能
- 审核操作功能

## 设计决策
### 1. 数据获取策略
- 优先从URL参数获取case_id、case_type、platform_code
- URL参数为空时从localStorage的case_data_timeline中获取
- 使用EvidenceAPIService.getEvidenceList进行数据获取

### 2. Tab状态计算
- Tab标题显示格式："申请人材料(状态)" / "被申请人材料(状态)"
- 状态判定逻辑：
  - 任一audit_state为0或-2 → "待审核"
  - 所有audit_state为1 → "已审核"
  - audit_state=-2 → "驳回"

### 3. 材料列表展示
- 按file_count字段实际数值展示材料数量
- 展示字段：name、audit_state、result、update_time/create_time
- 时间格式化为：YYYY-MM-DD HH:mm

### 4. 用户体验
- 数据加载时显示Loading状态
- API调用失败时显示错误信息
- 无数据时显示友好的空状态提示

## 验收标准
1. 首页能正确显示证据材料汇总模块
2. Tab切换功能正常，状态计算准确
3. 材料列表按要求格式展示
4. Loading状态和错误处理功能完善
5. 在不同数据状态下（有数据/无数据/错误）表现正常

## 风险与缓解
### 风险1：API响应慢影响用户体验
**缓解措施**：实现Loading状态，设置合理的超时时间

### 风险2：数据结构变化导致展示异常
**缓解措施**：增加数据校验，提供降级展示方案

### 风险3：URL参数缺失导致数据获取失败
**缓解措施**：提供localStorage备选方案，增加参数缺失提示