⚠️ 本文档已过时，仅留档备查，请勿删除。该历史任务已落地；当前状态见 `../任务清单.md`。

# [P1] 银行导入 API 加固与回归测试

## 背景

解析内核能识别现有六个样本，但 `/api/parse` 仍是最小原型：只返回第一个批次、手写 multipart、诊断边界不完整，也没有接口级测试。

## 范围

- API 返回所有成功工作表批次，而不是固定使用 `batches[0]`。
- 未知模板诊断始终包含原始文件名、工作表名、扫描行数和候选表头；空表和单单元格行也有明确结果。
- 解析失败不得创建成功导入记录，临时文件名不得泄露。
- 使用成熟 multipart 处理方式，严格限制扩展名、大小、文件数量和资源消耗。
- 覆盖重复文件、损坏文件、无工作表、多工作表、歧义模板和余额异常。
- 每新增银行模板必须有脱敏 fixture 和回归测试。

## 验收标准

- [ ] 多工作表文件的每个批次都可确认、异常或忽略，不丢失成功工作表。
- [ ] 空工作簿、单单元格候选和未知表头错误都返回四项诊断证据。
- [ ] API 错误只显示原始上传文件名，不显示服务器临时路径。
- [ ] 损坏文件和超限请求返回稳定错误码，不产生已确认交易。
- [ ] 前端失败流程不增加导入成功行。
- [ ] `/api/parse` 有接口回归测试，包含现有工商银行样本。

## 测试

- 单元测试：候选摘要、空表、多表、歧义、余额异常。
- API 测试：原始文件名、multipart、大小限制、失败不建成功批次、全部批次返回。

## 依赖

Issue 002、004。