lingniu-vehicle-ingest/vehicle-data-platform/docs/design/vehicle-profile-sync-scale-recovery-20260723/README.md

车辆主档大文件与任务恢复审计

结果

车辆主档同步从“单次最多 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 移动端的固定操作区均已真实浏览器验证。
• 本轮未使用独立屏幕阅读器或全量键盘遍历工具；读屏播报顺序和不同浏览器的高对比度模式仍需专项验证。
• 当前恢复数据保存在当前浏览器会话，适合关闭/刷新续办；跨设备接管、多人并发和长期任务历史仍需要服务端任务模型。