首页证据材料汇总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备选方案，增加参数缺失提示