Skip to content

「首次响应 SLA」被三处文档写成可度量的目标:setup 清单 §11 的 SLA 矩阵整列、analytics/reports 的 SLA Performance 行、analytics/cubes 的 Service Cube 措施 —— 全仓没有任何首次响应目标、达标度量或超时信号 #936

Closed

Description

@yinlianghui

发现自 #928 / PR #933 的实施过程(写实 administration/setup §2 营业时间节时,读到同页 :102-:110 的 SLA 矩阵)。

基线 origin/main = 4855d50b(平台 17.0.0-rc.3)。

事实:有戳,没有目标

  • crm_case.first_response_date(src/objects/case.object.ts:185)有写入方:src/actions/global.actions.ts:368-:398 的 logActivityAction 在工单第一条 sys_activity 落地时打戳(Follow-up to #514: remaining behaviour fixes, conventions, and the action-sandbox test gap #575 B2,test/case-first-response.test.ts 钉住)。这一半是真的。
  • 但没有任何"首次响应目标":grep -rn "first_response_date" src/flows/ src/objects/*.hook.ts src/reports/ src/datasets/ 零命中 —— 没有任何地方把这个戳与一个按优先级的目标做比较,没有违约标记,没有对应的扫描。case_sla_monitor 只读 sla_due_date。
  • 语义层里也没有度量:src/datasets/case.dataset.ts 的 case_metrics 只有三个 measure —— case_count / avg_resolution / avg_sla_violated,没有首次响应时间,也没有任何"达标 %"。
  • 报表同样没有:src/reports/case.report.ts:18-:28 的 sla_performance 是 rows: ['priority'] + values: ['case_count', 'avg_sla_violated', 'avg_resolution']。

三处

1. content/docs/administration/setup.mdx:102-:110(§11 Case SLAs)

「Confirm the default SLA matrix」的四行表带一整列 First response(Critical 1 小时 / High 2 小时 / Medium 4 小时 / Low 1 个工作日),并把「SLA matrix」链回 service/sla-and-escalation。而那一页(#924 写实后)根本没有「first response」这三个字 —— grep -c -i "first response" content/docs/service/sla-and-escalation.mdx = 0。点进去的读者找不到这一列的任何落点。

2. content/docs/analytics/reports.mdx:40

| **SLA Performance** | % first-response on time, % resolved on time, by priority |

真实的 sla_performance 两个都不是:它出的是违约率(avg_sla_violated)与平均解决时长,没有任何「准时 %」。

3. content/docs/analytics/cubes.mdx:84 / :86

Service Cube 的 measure 列表含 First-response time (minutes) 与 SLA met % (first response and resolution),case_metrics 两者都没有。

三语同址(.zh-Hans / .zh-Hant 行号一致)。

为什么要紧

管理员照 §11「确认默认 SLA 矩阵」逐行确认之后,会相信首次响应超时会被系统计量;服务经理照 analytics 两页会去找一个「首次响应达标 %」的报表列。两者都不存在,也没有任何东西会在超时时报警 —— 一个 New 工单坐多久都不会有信号。这与 #928 修掉的那一族是同一种伤害:读者把不存在的度量当成已有的防线。

边界 / 给 triage 的提示

Refs #928 #924 #917 #595

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,三单并单 #936+#951+#952,本单为主单)— session session_01VHrPAGEgFDoHjphqYG4BMa,分支 claude/issue-936-951-952-metrics-claims。

    文件面(×3 语言,全部 fresh main 重定位——setup/state-machines 经 PR #950、analytics 经 #923 刚改过):

    裁定:

    1. 「首次响应 SLA」被三处文档写成可度量的目标:setup 清单 §11 的 SLA 矩阵整列、analytics/reports 的 SLA Performance 行、analytics/cubes 的 Service Cube 措施 —— 全仓没有任何首次响应目标、达标度量或超时信号 #936 口径:first_response_date 有写入方(logActivityAction 的 'held' 分支)但全仓无目标比较/度量/告警(case_metrics 无相关 measure)——「可度量目标”降格为服务承诺,写实真实写入时机;沿 docs: write the three business-hours claims outside the SLA page to source (#928) #933/docs(service): 把工单页眉与首次响应打戳两行写实到源码 (#941) #946 已落地写法抄平。
    2. analytics/reports 的「Lead reports」整节失实:三份报表 src/ 里一份都不存在,而仅有的那份没被列出;两行还把导入别名 Working 当成 lead 状态在用 #951 口径:沿 docs(service): write the cases and state-machine pages' remaining claims to source (#912, #920, #925, #926) #939/docs(marketing): name Products in the index page's "Where to find things" (#938) #942 处理「不存在的清单」先例——按 src/reports/lead.report.ts 实况重写(真实报表 'Lead Engagement by Month × Source' 写进来),状态词用真值(PR docs(administration): write the state-machine status vocabulary and the last two behavioural claims to source (#921, #940) #950 词表);triage 去重已核(与 「首次响应 SLA」被三处文档写成可度量的目标:setup 清单 §11 的 SLA 矩阵整列、analytics/reports 的 SLA Performance 行、analytics/cubes 的 Service Cube 措施 —— 全仓没有任何首次响应目标、达标度量或超时信号 #936 的 :40 不同行,本单一次改齐即消灭同页两单)。
    3. administration 两页两条枚举外行为性主张:setup:96 指向不存在的「设置 → 商机 → 阶段」配置面;state-machines:140 的「性能要好得多」无据 #952 两条:A 沿 docs(service): write the cases and state-machine pages' remaining claims to source (#912, #920, #925, #926) #939 state-machines:108 同型处理(真身是元数据,无 Setup 屏);B 改写或删句依语境定,不虚构「转换事件触发自动化」机制。
    4. PR docs(analytics): 两页 zh-Hant 的「轉換率」跟简体侧改写为「轉化率」(#905) #923/docs(administration): write the state-machine status vocabulary and the last two behavioural claims to source (#921, #940) #950 落地行零回退;SLA policy matrix: per-priority × tier clocks, first-response stamping, escalation that reassigns #595 不预判;src/ 零改动;三语同步;zh 内链不带锚。

    Generated by Claude Code

  4. yinlianghui commented on Aug 6, 2026

    @yinlianghui
    ContributorAuthor

    ✅ 验收通过(三单并单 #936+#951+#952 + PM 面扩 Service reports 整表)—— PR #954 已转 ready 并挂 auto-merge(CI 8/8 全绿实核,head 9f097de,13 文件 +193/−69)。

    验收要点:

    1. 「首次响应 SLA」被三处文档写成可度量的目标:setup 清单 §11 的 SLA 矩阵整列、analytics/reports 的 SLA Performance 行、analytics/cubes 的 Service Cube 措施 —— 全仓没有任何首次响应目标、达标度量或超时信号 #936:三处按 docs: write the three business-hours claims outside the SLA page to source (#928) #933/docs(service): 把工单页眉与首次响应打戳两行写实到源码 (#941) #946 口径抄平;setup §11 整列删除、保留解决目标表并点名只有 Critical 行是真期限;cubes 幻影 measure 换真实 SLA Violation Rate 并注明是违约率非达标率;示例问题同名句主动纳入避免同页矛盾——面控有据的越出。
    2. analytics/reports 的「Lead reports」整节失实:三份报表 src/ 里一份都不存在,而仅有的那份没被列出;两行还把导入别名 Working 当成 lead 状态在用 #951:整节沿 docs(service): write the cases and state-machine pages' remaining claims to source (#912, #920, #925, #926) #939 口径重写,真实报表写进来、三份幻影逐条点名、Working→contacted 用 docs(administration): write the state-machine status vocabulary and the last two behavioural claims to source (#921, #940) #950 真值词表、lead_metrics 答不出 ROI 的结构原因写清、末尾给真实替代品——不止删假,还给读者活路。
    3. PM 面扩:Service reports 整表按三份真实报表重写,五份不存在的逐条给不可达理由,订阅示例同步换真——一次收口执行完整。
    4. administration 两页两条枚举外行为性主张:setup:96 指向不存在的「设置 → 商机 → 阶段」配置面;state-machines:140 的「性能要好得多」无据 #952:A 给真身(_picklists.ts + STAGE_PROBABILITY 每次保存重推);B 删无据比较、写实真实自动化路径(record_change 比对 previous.stage)。
    5. 反向验证利用 docs(analytics): 两页 zh-Hant 的「轉換率」跟简体侧改写为「轉化率」(#905) #923 守卫做了受控红实测;docs(service): write the index page's dashboards & reports section to source (#948) #955 新守卫的交叉印证(三报表 label 逐字一致)是意外的双向校验。落地行零回退。

    越界发现处置(两单已复核,标 pm:queue,R32 候选):#962(reports 页 Sales/Revenue/Marketing 三节 13 个幻影报表名 + 6 份真实报表零出现)与 #965(cubes 整页建立在四个不存在的 cube 上——analytics 文档族最大单;平台侧主张部分已正确标记需实测不预判)。⚠️ 两单同属 analytics 两页,R32 与 #612 派发时互斥排期。


    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