Files
2026-07-27 16:46:15 +08:00

36 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 车辆主档大文件与任务恢复审计
## 结果
车辆主档同步从“单次最多 500 辆、一次请求、关闭即丢失”升级为可观察、可恢复的批量任务:
- 单个 CSV 最多 5,000 辆,按每批 500 辆自动切分;前端不会突破服务端单请求边界。
- 预演与正式写入都逐批汇总结果,展示完成批次、处理车辆和百分比进度。
- 每完成一批即保存当前任务;关闭、刷新或请求中断后可从下一批继续,不重复已完成批次。
- 运行中关闭会取消当前请求并保留最后确认断点;修改来源、版本、策略或文件会重置旧结果。
- 需复核记录只渲染前 100 条,完整冲突/缺失记录可下载 CSV避免千条列表拖慢任务面板。
- 桌面保持 720 px 近全高侧栏,移动端保持 92dvh bottom sheet 和固定主操作区。
## 验证证据
- `before-desktop.png`:原桌面任务仅显示 500 辆上限,无批次或恢复状态。
- `after-desktop.png`1,001 辆真实浏览器样本完成三批预演,展示完整汇总与受控复核清单。
- `before-mobile.png`:原移动端任务配置状态。
- `after-mobile.png`:关闭并重新打开后恢复 1,001 辆、3/3 批和 100% 进度。
- `comparison-desktop.png`:同尺寸桌面前后对照。
- `vehicle-profile-sync-1001.csv`:浏览器审计使用的 1,001 辆唯一 VIN 样本。
## 自动化覆盖
- CSV 解析接受 1,001 行并拆成 500 / 500 / 1 三批。
- 三批预演与三批写入均验证调用规模和最终汇总。
- 首批写入完成、第二批失败后,从第二批继续并最终完成;首批不会重复提交。
- 关闭配置任务后重新挂载,可恢复来源、文件内容、阶段结果和批次位置。
- API 客户端向同步请求透传 `AbortSignal`
## 无障碍与已知边界
- 任务面板、步骤、摘要、进度条、错误与操作按钮均保留可访问名称或 live-region 语义;桌面和 390 × 844 移动端的固定操作区均已真实浏览器验证。
- 本轮未使用独立屏幕阅读器或全量键盘遍历工具;读屏播报顺序和不同浏览器的高对比度模式仍需专项验证。
- 当前恢复数据保存在当前浏览器会话,适合关闭/刷新续办;跨设备接管、多人并发和长期任务历史仍需要服务端任务模型。