Skip to content

service/index 的《Standard dashboards & reports》四行全部失实:仪表盘描述里的 top agents / oldest open cases 不存在,三张报表名与 case.report.ts 的 label 都对不上 #948

Closed

Description

@yinlianghui

发现自 #937 / PR #947 的实施过程(改 :53 那行的仪表盘名字时,顺手核了同一节剩下的三行与那行自己的描述)。

基线 origin/main = 11f62429(平台 17.0.0-rc.3)。#937 只裁定了「叫什么名字」,这一节的其余内容没被核过,本单记录的是名字之外的四处。

事实

content/docs/service/index.mdx:51-:56(zh-Hans / zh-Hant 同结构同行号):

## Standard dashboards & reports

- **Service Dashboard** — open cases by priority, SLA performance, top agents, oldest open cases.
- **Cases Opened by Day × Priority** — daily inflow.
- **Cases by Status × Priority** — current snapshot.
- **SLA Performance** — % of cases resolved within SLA target.

1. :53 的描述里有两项磁贴不存在,其中一项在分析层根本不可能存在

src/dashboards/service.dashboard.ts 一共 10 个 widget,title 依次是:Open Cases、Critical Cases、Avg Resolution Time、SLA Violations、Cases by Status、Cases by Priority、Cases by Origin、Daily Case Volume、SLA Compliance、Open Cases by Priority。

  • open cases by priority ✅(Open Cases by Priority / Cases by Priority)
  • SLA performance ✅(SLA Compliance / SLA Violations)
  • top agents ❌ 没有这个磁贴
  • oldest open cases ❌ 没有这个磁贴

top agents 尤其不是「少做了一个磁贴」那么简单:同一个仓库的另一页已经把它为什么不可能写实了。content/docs/service/cases.mdx:188(#912 / PR #939 落地):

There is no agent leaderboard: case_metrics, the dataset behind every service report and dashboard widget, declares Status, Priority, Origin, Type and Created as its only dimensions, so nothing in analytics can group cases by agent.

也就是说 service/index:53 承诺的「顶尖客服」,在 src/datasets/case.dataset.ts 的维度集合下无法被任何报表或部件做出来 —— 两页当前互相矛盾。

2. 三张报表名与 src/reports/case.report.ts 的 label 都对不上

文档 service/index 源码 case.report.ts 差异
:54 Cases Opened by Day × Priority :41 label: 'Cases Opened by Priority × Day' 两个维度的顺序反了
:55 Cases by Status × Priority :7 label: 'Cases by Status and Priority' × vs and
:56 SLA Performance :19 label: 'SLA Performance Report' 少了 Report

:54 的顺序不只是措辞:content/docs/service/sla-and-escalation.mdx(#917 / PR #924 落地)已经按源码写作「按优先级 × 天」的矩阵,两页对同一张报表给出了相反的维度顺序。

3. :56 的描述正是 PR #924 在另一页上改掉的那一句

:56 写 % of cases resolved within SLA target。sla-and-escalation.mdx 的《SLA Performance 报表》一节已经写实:

它报的也不是「在目标内解决的百分比」,而是 SLA 违约率 —— SLA 已违约标记的平均值 —— 与工单数、平均解决时长并列,并且只统计已关闭的工单(runtimeFilter: { is_closed: true })。

同一个错误说法在 service/index:56 上原样留着。

为什么要紧

与 #927 / #937 同族:读者按文档去产品里找,找不到;或者按文档的理解去读一张报表,读出来的不是那个数。区别是本单的四处不是名字漂移,是描述与源码不符,其中 top agents 还与本仓另一页的写实结论直接冲突 —— 两页里必有一页在骗人,而当前是 service/index 那页。

边界

Refs #937 #947 #917 #924 #912 #939

Activity

  1. added
    documentationImprovements or additions to documentation
    pm:queueReady for the PM dispatch loop
    pm:dispatchedDispatched to a dev agent by /pm-dispatch
    and removed
    pm:queueReady for the PM dispatch loop
    on Aug 6, 2026
  2. self-assigned this
    on Aug 6, 2026
  3. yinlianghui commented on Aug 6, 2026

    @yinlianghui
    ContributorAuthor

    🔒 认领(/pm-dispatch R31)— session session_01VHrPAGEgFDoHjphqYG4BMa,分支 claude/issue-948-index-dashboards-reports。

    文件面:content/docs/service/index{,.zh-Hans,.zh-Hant}.mdx 的《Standard dashboards & reports》:53-:56 四行描述部分——PR #947 刚动本页(:53/:66 词面),fresh main 重定位,#947 已落地的 Service Overview 指称与首现附注零回退。

    裁定:①stale-premise 复核 service.dashboard.ts(磁贴实况)与 src/reports/case.report.ts(三报表真名与维度顺序:'Cases Opened by Priority × Day' 等);②「top agents/客服排行榜」沿 #924/#939 口径(case_metrics 无 owner 维度,分析层不可实现)写实,消除与 cases:188 的两页矛盾;③「% resolved within SLA target」沿 #924 已立写法(该度量不存在);④#595 不预判;src/ 零改动;三语同步;zh 内链不带锚。


    Generated by Claude Code

  4. yinlianghui commented on Aug 6, 2026

    @yinlianghui
    ContributorAuthor

    ✅ 验收通过 —— PR #955 已合并(CI 9/9 全绿实核)。

    验收要点:四行前提全成立且证据升级(十 widget 全聚合无单条记录列表——「最久未结做不出来」的源码理由比 issue 更深一层;三报表真名逐字;% resolved 度量不存在);新增守卫 test/docs-service-index-analytics.test.ts 20 断言双向钉住(listed⇒exists + exists⇒listed + 否定断言的源码侧 + 四条退役说法禁回潮),逆向验证预告 RED 实测 13 红、失败输出逐名点出;zh 加粗 CJK 跳过的边界如实写明。#947/#932 落地行零回退,两页矛盾(cases:188 / sla:51)就此闭环。

    越界发现处置:两个发现因限流未能立单转交 PM——①《Service reports》整表已面扩给 #936 族 dev 并随 PR #954 落地(无需另立);②service.dashboard globalFilters 的 owner_id 绑定 case_metrics 无此维度(dashboards.mdx:117 据此写 Agent 筛选器)——观察类需浏览器 dogfood 判定,PM 已立 finding 单收档。


    Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationpm:dispatchedDispatched to a dev agent by /pm-dispatch

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions