lingniu-vehicle-ingest/vehicle-data-platform/docs/design/history-preferences-pagination-20260723

历史导出保留期、字段视图同步与任务分页审计

审计日期：2026-07-23
验证视口：1440 × 900、390 × 844
范围：历史导出任务中心、导出保留期、字段视图账号同步及其 API 持久化。

1. 关注 → 已修复：任务中心只显示前 20 条，搜索和状态统计也只覆盖这 20 条。 基线中服务端还有 36 条任务，但页面徽标、统计和列表都停在 20；任务继续增长后无法定位后续记录。

   

2. 健康：改为服务端搜索、状态筛选和分页。 任务中心显示当前账号可访问的 36 条总量、全局状态摘要、当前页范围和 10/20 条分页；页码、搜索、状态和每页数量均写入 URL。运行时收到旧缓存或不完整分页响应时会安全降级为空态，不再使工作区崩溃。

   

3. 健康：翻页后工作位置可恢复。 第二页 URL 包含 exportPage=2，列表、页码和“第 11–20 个”范围同步更新；批量选择语义明确限定为当前页。

   

4. 健康：字段视图和导出保留期跟随账号。 命名字段视图不再只依赖当前浏览器的 localStorage，服务端按账号持久化最多 8 个视图；保留期支持 1、3、7、14、30 天，并作为后续导出的账号默认值。任务自身固化实际保留天数，重建时保持原策略。

   

5. 健康：移动端保持单一滚动面和固定操作。 bottom sheet 提升到 min(90dvh, 780px)，筛选、任务列表和固定分页/完成操作在 390 × 844 下无横向溢出；用户不需要滚回底部才能翻页或退出。

   

验证

• API：go test ./... 全部通过。
• Web：76 个测试文件、471 个测试全部通过；历史页 37 个回归测试，API client 33 个契约测试。
• 构建：TypeScript、Vite 生产构建和发布产物校验全部通过。
• 浏览器：验证 36 条任务、第二页 URL、账号字段视图、14 → 30 天保留期保存并刷新恢复，以及桌面/移动端真实布局。

无障碍与已知限制

• 搜索、状态、保留期、分页、关闭与恢复按钮均具有可识别角色和名称；dialog、list、search、progressbar 与 live 文案可由可访问树读取。
• 本轮通过 DOM 可访问树和键盘语义测试核验，但没有使用真实屏幕阅读器，也未完成自动化色彩对比扫描；这两项继续作为平台级回归检查。
• 控制台仍有 Semi UI 内部 findDOMNode StrictMode 弃用提示和既有 Sass @import 弃用提示；不影响本轮功能与构建。
• 沿用现有中台设计系统和真实基线截图，因此本轮不需要 ImageGen 生成新的视觉资产。