Repository navigation
「首次响应 SLA」被三处文档写成可度量的目标:setup 清单 §11 的 SLA 矩阵整列、analytics/reports 的 SLA Performance 行、analytics/cubes 的 Service Cube 措施 —— 全仓没有任何首次响应目标、达标度量或超时信号 #936
Description
发现自 #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 的提示
- 与 「营业时间」在 sla 页之外还有三处:
administration/setup整整一节教人配置一个不存在的 Setup → Business Hours 屏,reference/faq把它写成 SLA 计时的前置条件,glossary 收了词条 #928 / PR docs: write the three business-hours claims outside the SLA page to source (#928) #933 不重叠:那单只动setup§2 营业时间节、faq :92-:95、glossary :34;§11 未动,本单是它。 - 未并入的同族一处:
content/docs/service/cases.mdx:166(「New cases should not sit for more than the first-response SLA」)属同族,但该页正被 bareworkflows残留族在 #899 枚举之外还有 4 处:whats-new 把真实的contract_renewal流程叫成 workflow,state-machines:133 在 PR #894 扫过该文件后仍留着 #912 族的 dev 在改,未并入本单,请判定归属。同页:167(「it stops the SLA clock in some configurations」)是 docs(service): write the sla page's views, report dimensions and business-hours claims to source (#917) #924 已在 sla 页杀掉的同一条说法的残留。 - 本单不主张的部分:
analytics/cubes/analytics/reports两页的其余条目(CSAT、agent/team、product、account tier 等维度)看上去同样与case_metrics的五维三度量对不上。本单只主张首次响应这一条线索;若另有 analytics 文档漂移的单,建议把第 2 / 3 处并进去,避免重复。 - 口径建议沿 docs(automation): 按 flow 源码写实内置流程表两行,并修 opportunity_won_alert 的 description (#851) #870 / docs(flows): name what the flow nodes do, not what they were once meant to do #877 / docs(service): 按 flow 与 hook 写实 SLA 页的升级说明(#876) #885 / docs(service): write the sla page's views, report dimensions and business-hours claims to source (#917) #924 / docs: write the three business-hours claims outside the SLA page to source (#928) #933:点名说清不存在 + 给出真实归属(戳是
logActivityAction写的,但没有目标、没有度量、没有告警),不静默删名。至于是否应该有首次响应 SLA,是 SLA policy matrix: per-priority × tier clocks, first-response stamping, escalation that reassigns #595 的产品问题,本单不预判。
Activity
yinlianghui commentedon Aug 6, 2026
🔒 认领(/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 刚改过):
administration/setup:「首次响应 SLA」被三处文档写成可度量的目标:setup 清单 §11 的 SLA 矩阵整列、analytics/reports 的 SLA Performance 行、analytics/cubes 的 Service Cube 措施 —— 全仓没有任何首次响应目标、达标度量或超时信号 #936 的 §11 SLA 矩阵首响列 + #952A 的 :96(设置 → 商机 → 阶段 配置面不存在);analytics/reports:「首次响应 SLA」被三处文档写成可度量的目标:setup 清单 §11 的 SLA 矩阵整列、analytics/reports 的 SLA Performance 行、analytics/cubes 的 Service Cube 措施 —— 全仓没有任何首次响应目标、达标度量或超时信号 #936 的 :40(SLA Performance 行)+analytics/reports的「Lead reports」整节失实:三份报表src/里一份都不存在,而仅有的那份没被列出;两行还把导入别名Working当成 lead 状态在用 #951 整节(Lead reports:导入别名 Working 当状态 + 三份不存在的报表 + 真实 lead.report 零出现);analytics/cubes:「首次响应 SLA」被三处文档写成可度量的目标:setup 清单 §11 的 SLA 矩阵整列、analytics/reports 的 SLA Performance 行、analytics/cubes 的 Service Cube 措施 —— 全仓没有任何首次响应目标、达标度量或超时信号 #936 的 :84/:86;administration/state-machines:#952B 的 :140(「性能要好得多」无据且机制前提存疑)。裁定:
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 不同行,本单一次改齐即消灭同页两单)。Generated by Claude Code
yinlianghui commentedon Aug 6, 2026
✅ 验收通过(三单并单 #936+#951+#952 + PM 面扩 Service reports 整表)—— PR #954 已转 ready 并挂 auto-merge(CI 8/8 全绿实核,head 9f097de,13 文件 +193/−69)。
验收要点:
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 的结构原因写清、末尾给真实替代品——不止删假,还给读者活路。越界发现处置(两单已复核,标 pm:queue,R32 候选):#962(reports 页 Sales/Revenue/Marketing 三节 13 个幻影报表名 + 6 份真实报表零出现)与 #965(cubes 整页建立在四个不存在的 cube 上——analytics 文档族最大单;平台侧主张部分已正确标记需实测不预判)。⚠️ 两单同属 analytics 两页,R32 与 #612 派发时互斥排期。
Generated by Claude Code
docs(analytics,administration): write the first-response claims, the …