Files
lingniu-vehicle-ingest/vehicle-data-platform/docs/design/history-export-entry-audit-20260723

历史导出任务入口审计

审计日期2026-07-23

结论

  • 原桌面入口隐藏在历史明细的“更多”菜单内,用户需要先理解查询结果工具层级才能找到后台任务。
  • 原移动端只有存在当前查询结果时才显示“工具”,空状态无法进入已有导出任务;跨会话查看后台结果被当前查询状态错误阻断。
  • 新桌面入口常驻于“遥测证据检索”顶栏,与“收起/修改条件”并列;低频菜单只保留密度和刷新。
  • 新移动入口与“查询范围”并列,显示“导出任务 / 后台记录”,无车辆、无查询结果时也可直接进入。
  • 任务中心继续复用原 SideSheet、URL、分页、筛选、归档和下载逻辑不引入第二套任务状态。

证据

  1. 01-before-desktop-hidden-task-entry.png优化前桌面必须展开“更多”才能发现导出任务1440 × 900。
  2. 02-before-mobile-no-task-entry.png优化前移动空状态完全没有导出任务入口390 × 844。
  3. 03-after-mobile-direct-task-entry.png优化后移动查询与后台任务并列常驻390 × 844。
  4. 04-after-mobile-task-center.png:移动端直接恢复 31 个当前任务和 3 个审计归档390 × 844。
  5. 05-after-desktop-direct-task-entry.png桌面顶栏常驻导出任务入口1440 × 900。
  6. 06-before-after-mobile-entry-comparison.jpg:同视口、同空状态的移动端前后比较。

验证

  • HistoryPage.test.tsx43/43。
  • Web 正式测试507/507。
  • Go APIgo test ./... 全部通过。
  • 生产构建:web_build_gate=ok,开放平台前端及三个 Go 二进制同时构建通过。
  • 真实交互:桌面与移动端均从无查询的 /history 直接进入任务中心URL 更新为 historyTool=exports,关闭后恢复原页面。

无障碍边界

  • 常驻入口使用真实按钮,提供 aria-haspopup="dialog"aria-expandedaria-controls 和唯一可读名称。
  • 移动入口维持 52 px 高点击目标;任务 SideSheet 继续保留标题、关闭按钮、固定底栏和列表/分页语义。
  • 本轮通过 DOM 无障碍快照、角色、展开状态及桌面/移动重排检查;尚未执行独立读屏软件的端到端人工朗读测试。