ai-contract-platform/project-docs/V2-ai-quality-dashboard-effect-queue-2026-06-25.md

AI 质量看板效果队列增强记录

日期：2026-06-25

背景

上一轮已经在质量改进项详情页展示了执行后的效果回写，包括标签异常率、后续受影响 Trace、质量分变化等。本轮继续把这些能力提升到质量看板列表层，让管理员不用进入每个详情页也能快速判断哪些改进项有效、哪些需要继续处理。

本轮目标

• 在质量看板的“改进动作闭环”队列中直接看到效果状态概览。
• 支持按效果状态筛选改进项。
• 支持只看已有完成后观察数据或暂无观察数据的改进项。
• 对已改善的改进项提供“归档关闭”入口。
• 对未明显改善或恶化的改进项提供“重新处理”入口。

已完成内容

文件：

• yuqei-contract-platform/apps/contract-web/src/app/admin/ai-quality-dashboard/page.tsx

完成点：

• 队列头部新增效果汇总：
  • 待推进
  • 已改善
  • 恶化
  • 待观察
• 筛选区新增：
  • 效果状态筛选
  • 完成后观察数据筛选
• 改进项列表卡片增强：
  • 异常率变化优先展示完成后变化。
  • 已改善且已完成的改进项可直接归档关闭。
  • 未明显改善或恶化且已完成的改进项可重新进入处理中。
• 更新状态时自动写入更准确的处理说明。

验证结果

已通过：

npm run web:typecheck
npm run web:build

当前闭环

现在管理员可以在看板层完成：

1. 筛选已改善、恶化、待观察的改进项。
2. 对已改善项归档关闭。
3. 对未改善或恶化项重新处理。
4. 进入详情页继续查看后续 Trace 与标签改善明细。

这让“质量改进项”从单纯的记录，进一步变成可运营的处理队列。