# 运维质量大队列与交付回执审计

## 本轮结论

差异队列从“固定 50 条分页 + 自由输入负责人 + 无可下载回执”升级为可恢复、可交付的大队列工作流：20/50/100 条页容量与页码进入 URL，关键字与精确负责人均在服务端跨全量数据检索；当前筛选直接生成全量 CSV；批量处置和交接可下载逐项成功/跳过结果；负责人统一来自当前账号、启用管理员账号和历史交接目录。测试还发现并修复了 50 条桌面表格持续渲染时的更新循环崩溃。

本轮属于现有中台设计系统内的小型任务流改进，沿用 Semi UI、运行治理蓝绿语义、现有 WorkspaceSideSheet 与密集表格，现有页面与本轮基线截图就是视觉目标，因此没有使用 ImageGen 生成脱离产品的视觉概念。

## 审计步骤与健康度

1. **浏览大队列 — 需优化 → 健康。** 基线固定 50 条/页，且在 128 条模拟数据持续停留约 10 秒后 Semi Table 触发 `Maximum update depth exceeded`。优化后列定义、选择集合和批量回调保持稳定，20/50/100 条页容量可选并写入 `reconcileLimit`；1440 × 1000 持续停留 12 秒仍保留 128 条队列。证据：[优化前队列](before/01-large-queue.jpg)、[优化后队列](after/01-large-queue-search-export.jpg)。
2. **跨全量定位责任对象 — 需优化 → 健康。** 原关键字虽已服务端检索，但负责人只能筛“已分配/未分配”。现在目录提供精确负责人，服务端 `owner=<负责人>` 跨页匹配，关键字、状态、等级、规则、负责人、SLA、页容量、页码和详情共同恢复。
3. **形成责任交接 — 需优化 → 健康。** 自由输入改为可搜索目录，选项显示账号、当前账号标记与活跃任务数，单条和批量交接共用同一来源，减少拼写分叉。证据：[团队目录交接](after/02-team-directory-assignment.jpg)。
4. **交付筛选和批量结果 — 需优化 → 健康。** “导出当前筛选”由服务端以 200 条游标页聚合，最多 50,000 条，CSV 带 UTF-8 BOM 并防表格公式注入；批量结果导出保留记录编号、成功/跳过、原因、车辆、负责人、期限、状态和版本。证据：[批量结果回执](after/03-batch-result-export.jpg)。
5. **移动端继续工作 — 健康。** 390 × 844 无横向溢出，筛选默认折叠，导出缩写为“导出”，20/50 条页容量保持可读，底部导航与队列分页没有互相覆盖。证据：[移动端队列](after/04-mobile-queue.jpg)。

## 五点视觉一致性账本

| 检查点 | 基线 | 实现 | 结论 |
| --- | --- | --- | --- |
| 页面容器 | 单一质量队列卡片 | 原标题操作区增加导出，原分页增加页容量 | 未新增页面层或套卡片 |
| 信息层级 | 批量、趋势、刷新 | 批量、导出、趋势、刷新 | 导出是次级工具，不抢处置主路径 |
| 桌面密度 | 50 条固定分页 | 同表格密度，增加 20/50/100 条容量 | 1440px 首屏列宽与行高未改变 |
| 负责人输入 | 自由文本 | 可搜索团队目录 | 与现有 Select 组件和表单对齐 |
| 移动端 | 紧凑卡片 + 分页 | 保留卡片，导出短标签，页容量可读 | 390px `scrollWidth === clientWidth` |

## 验证

- API：`go test ./...` 全部通过；负责人目录、精确负责人 SQL、当前筛选 CSV 与路由合同均有测试，导出中和公式开头相同的值会被安全转义。
- Web：77 个测试文件、474 个测试全部通过；生产构建和 release asset gate 通过。新增目录/导出客户端合同、批量 CSV 与运维页面覆盖，页容量和精确负责人可从 URL 恢复。
- 浏览器：1440 × 1000 检查队列、团队目录、批量结果、导出回执与 12 秒持续稳定性；390 × 844 检查移动布局与无横向溢出。
- 视觉比较：使用同一 1440 × 1000 状态对比 `before/01-large-queue.jpg` 和 `after/01-large-queue-search-export.jpg`，并用 `view_image` 人工核对标题操作密度、指标层级、筛选行、表格列宽和分页。

## 无障碍证据与限制

导出按钮、负责人目录、每页差异数、批量结果导出和关闭动作均有唯一可访问名称；桌面表格行继续支持 Enter / Space，移动端保持无横向溢出。当前验证覆盖 DOM 语义、键盘入口和 390px/1440px 布局，但没有运行 NVDA/VoiceOver、强制色彩、200% 缩放或完整焦点返回矩阵，因此不宣称完整 WCAG 合规。