`sales/pipeline-management` 剩余的仪表盘/报表指称漂移：:34 的 Sales Dashboard「求和 Expected Revenue」是假能力，:68/:72 的报表表格四行名字对不上，:94 括号里的 top deals 磁贴不存在

[yinlianghui]

来源：#985 实施（PR 见下）过程中的卫星命中。#985 只动了本页「Forecasting roll-up」三条列表的后两条（:94 / :95），按 Prime Directive #10 另立本单。

三语同址（en 行号，zh-Hans / zh-Hant 同行）。分三族，第一族是唯一涉及能力主张的，其余是名字错位。

一、:34 —— 幻名 + 一条源码里不存在的能力（本单里最重的一条）

The **Sales Dashboard** sums *Expected Revenue* across the open pipeline to give you the weighted forecast for the quarter.

两处都不成立：

1. 名字：没有叫 Sales Dashboard 的仪表盘 —— 这正是 sales/pipeline-management 的「预测汇总」另两条：仪表盘真名是 Sales Performance，Pipeline Coverage 报表是「预测类别 × 结束季度」而非「季度 × 阶段」 #985 在 :94 修掉的那个幻名，同页 :34 还留着一份。真身 sales_dashboard 的 label 与 Sales 组导航 label 都是 Sales Performance（src/dashboards/sales.dashboard.ts:22、src/apps/crm.app.ts:61）。
2. 能力：opportunity_metrics（src/datasets/opportunity.dataset.ts）没有任何 measure 读 expected_revenue，全仓 grep expected_revenue src/datasets/ 零命中。该数据集的金额类度量是 total_amount / avg_amount / won_amount / lost_amount，一律 field: 'amount'。所以 Sales Performance 上的每一块管道磁贴求的都是 Amount 之和，不是加权的 Expected Revenue —— 任何仪表盘 widget 都求不出后者，因为语义层没暴露它。

expected_revenue 字段本身是真的（src/objects/opportunity.object.ts:92，由 opportunity.hook.ts:133 从 amount * STAGE_PROBABILITY[stage] 派生）。真正对它求和的是列表视图：src/views/opportunity.view.ts:37/:138 的 { field: 'expected_revenue', summary: 'sum' }。本页 :51 自己就写对了 —— 看板每列顶部的「加权合计（预期营收之和）」。也就是说加权预测这件事在产品里存在，只是落点是看板/列表视图，不是仪表盘。

读者影响：销售经理按这句话去 Sales Performance 上找「本季度加权预测」，找到的是未加权的管道总额，两个数字差着一个概率系数，而页面告诉他这就是加权预测。建议改写方向：把加权口径归到看板/列表视图（:51 已有正确表述），仪表盘那句按 total_amount 写实；具体措辞留给 triage。

二、:68 + :72-:76 报表表格 —— 侧边栏分组名错，五行里四行名字对不上

:68「You'll find these in the Reports section of the sidebar」：侧边栏没有 Reports 分组。分组是 Insights（src/apps/crm.app.ts:144），而且它只钉了三张报表 —— Pipeline Coverage、Lead Inflow、SLA Performance —— 外加 CRM Overview 与 Forecasts。本表五行里只有第一行在侧边栏上，其余四张要从报表选择器进。analytics/index.mdx:54 已经把这条写实了（「nothing in the sidebar is called Dashboards, Reports or Cubes」），本页与它矛盾。

逐行对照 src/reports/（label 逐字）：

现文（:72-:76）	真实 label
Pipeline Coverage (Quarter) ——「Matrix of quarter × stage」	导航 Pipeline Coverage / 报表 label Pipeline Coverage by Forecast × Quarter；轴同样写反且写错，与 #985 刚在 :95 修掉的是同一处失实
Funnel by Owner → Stage	Opportunity Funnel by Owner → Stage
Opportunities by Stage	逐字正确
Won by Owner	Won Opportunities by Owner
Customer Churn Signals	逐字正确

同样的截断名还散在两处提示行里：:86 / :107 的 Funnel by Owner → Stage、:87 的 Won by Owner、:108 的 Pipeline Coverage by Quarter（这个名字两边都不是 —— 既非导航的 Pipeline Coverage，也非报表 label 的 Pipeline Coverage by Forecast × Quarter）。:85 的 Pipeline Coverage 正确，无需动。

:72「3x the quota」是描述业务问题的修辞，不是对报表的主张（没有任何 coverage-ratio 度量），列在这里只为提示改写时别顺手把它当事实句处理。

三、:94 括号里的 top deals —— 磁贴不存在

#985 正文把这三个磁贴名列为「未逐个核，由 triage 定」，实施时逐个核过了：

• pipeline by stage → 真磁贴 Pipeline by Stage（src/dashboards/shared-widgets.ts:34）✓
• win rate → 真磁贴 Win Rate (12M) ✓
• top deals → 不存在。src/dashboards/sales.dashboard.ts 的 17 块 widget 里没有任何一块叫这个名字，而且它是被有意删掉的：该文件 Row 5 的注释写明「The previous "Top Open Opportunities" table selected only opp_count with no dimension — one summary row, not a deal ranking」，按 ADR-0021 仪表盘 table 绑定的是分析数据集、只能聚合，不能列原始交易，所以换成了按负责人聚合的 Open Pipeline by Owner。

也就是说这不是「改个名就行」：仪表盘上结构性地不可能有「top deals」这种逐笔排行。要么指向 Open Pipeline by Owner（同一块地方，语义是每位代表的在飞管道排行），要么按同注释的指引指向商机列表视图。#985 的 PR 按「面限两条行族」把括号内容逐字保留未动。

分级

• 第一族一半是能力主张（读者会拿到一个错的数），一半是幻名。
• 第二、三族是名字错位，读者按现文在产品里找不到东西。
• 都不涉及 src/ 改动。

边界

• 与 sales/pipeline-management 的「预测汇总」另两条：仪表盘真名是 Sales Performance，Pipeline Coverage 报表是「预测类别 × 结束季度」而非「季度 × 阶段」 #985 / 其 PR 行集互斥：那单只动 :94 / :95 两行，且 :94 括号内容逐字未动。
• :93（docs(analytics): 把 analytics 落地页写实，并清掉散在 8 页上的 cube 词汇残留 (#976, #977) #987 落地）与 :85 已写实，不要回退。

Refs #985 #987 #975 #947

[yinlianghui]

🔒 认领(/pm-dispatch R34 补槽)— session session_01VHrPAGEgFDoHjphqYG4BMa,分支 claude/issue-989-pipeline-reference-drift。

文件面:content/docs/sales/pipeline-management{,.zh-Hans,.zh-Hant}.mdx 的三族(:34、:68/:72-:76 + 截断名 :86/:87/:107/:108、:94 括号磁贴名)——PR #990 已合并刚改本页 :94/:95,fresh main 重定位、零回退。

裁定:

1. :34 幻名沿 docs(sales): 按真名写「预测汇总」的仪表盘与报表两条 (#985) #990 一名到底口径;「sums Expected Revenue」假能力按实况写(仪表盘求 total_amount;真正读 expected_revenue 的是列表视图,:51 已写对——同页对齐);
2. Reports 组→Insights(docs(getting-started): write the quick tour's navigation table to the real app (#960) #968/docs(analytics): 把 analytics 落地页写实，并清掉散在 8 页上的 cube 词汇残留 (#976, #977) #987 口径)、四行报表名逐字对 opportunity.report.ts、:72 的「quarter × stage」沿 docs(sales): 按真名写「预测汇总」的仪表盘与报表两条 (#985) #990 刚落地的写法抄平;截断名逐处补全;
3. :94 括号:top deals 磁贴不存在且结构性不可能(Row 5 注释记录了删除经过)——点名说清;pipeline by stage / win rate 逐字为真不得动;
4. SLA policy matrix: per-priority × tier clocks, first-response stamping, escalation that reassigns #595 不预判;src/ 零改动;三语同步(繁体不造名,沿 docs(sales): 按真名写「预测汇总」的仪表盘与报表两条 (#985) #990);zh 内链不带锚。

---

Generated by Claude Code

[yinlianghui]

✅ 验收通过 —— PR #994 已转 ready 并挂 auto-merge(CI 8/8 全绿实核,Playwright 迟到完成)。

验收要点:

1. 对派单裁定的证据性偏离是本单精华:裁定要求「与 :51 对齐」,dev 复核发现 :51 本身是假能力(KanbanConfigSchema.summarizeField 单数、pipeline_kanban 绑 amount——看板每列只有一个未加权数),照裁定执行会向错误参照系对齐;改为按源码把加权预测落点写到两张表格视图,与 opportunities.mdx:120 的正确口径一致,面外的 :48-:51 立 sales/pipeline-management :48-:51：看板列顶「两个数字（未加权 + 加权）」是假能力——kanban 只有一个 summarizeField，且绑的是 amount #992 不越界——裁定错了就纠正裁定,这正是本修复线的最高纪律。
2. 三族全落地:幻名归位、Insights 组写实(仅第一行在导航)、四报表名逐字补全、zh 意译名归位(无翻译背书)、top deals 结构性不可能给注释出处(Row 5 替换经过)。
3. 对 docs(getting-started): 把 for-developers 的 src/ 目录树按实况重画，并让 docs-drift 守卫看得懂目录树 (#984) #991 新守卫的前瞻兼容核验(取其 test 单跑,新增引用全过、6 红为预期合并消失)+ merge-tree 零冲突——跨 PR 协调意识到位。

越界发现处置(两单已复核,标 pm:queue,R35 候选):

• sales/pipeline-management :48-:51：看板列顶「两个数字（未加权 + 加权）」是假能力——kanban 只有一个 summarizeField，且绑的是 amount #992(:48-:51 看板双数字假能力,兼证伪 sales/pipeline-management 剩余的仪表盘/报表指称漂移：:34 的 Sales Dashboard「求和 Expected Revenue」是假能力，:68/:72 的报表表格四行名字对不上，:94 括号里的 top deals 磁贴不存在 #989 自身参照)——⚠️ 与 docs(sales): 把 pipeline-management 剩余的仪表盘/报表指称写实 (#989) #994 同页,合并后重定位;
• Sales 组两个非对象导航项被按侧边栏上没有的名字指称：sales/index :64/:65 的 *Sales Pipeline* / *Sales Dashboard*，sales/pipeline-management :38 的「sidebar shortcut Sales Pipeline」 #993(Sales Pipeline/Sales Dashboard 导航短名族:sales/index :64/:65 + 本页 :38,幻名第三处)——与 sales/pipeline-management :48-:51：看板列顶「两个数字（未加权 + 加权）」是假能力——kanban 只有一个 summarizeField，且绑的是 amount #992 同页部分,R35 两单并单。

---

Generated by Claude Code