Skip to content

analytics/index 落地页六处失实:4 cubes / 4 dashboards / 「10+ 报表含合同」/ 幻影报表名 / 不存在的 Analytics 导航组 / 悬空的 sales-copilot 链接 #976

Closed

Description

@yinlianghui

来源:#962 + #965 并单实施(PR #975)过程中的卫星命中。那两单的正文都把边界限定在各自那一页,本单是同族的落地页——content/docs/analytics/index.mdx(三语同址)。它是读者进入分析文档的第一屏,而它的每张表都在转述已经被 PR #954 / #975 改掉的旧口径。

逐条对照 src/

位置 页面上的话 src/ 的事实
《What's included》表 Cubes — 4 cubes (sales, pipeline, service, marketing) 本仓一个 cube 都没有声明:语义层是 src/datasets/ 的九个 dataset,objectstack.config.ts 明确不注册 analyticsCubes(ADR-0021),test/analytics-integrity.test.ts 把这一点写死。四个名字零命中——PR #975 已在 cubes 页收口
同表 Dashboards — 4 ready-made dashboards (CRM, Sales, Service, Executive) 五个:src/dashboards/ 还有 sales_activity_dashboard(Sales Activity),导航里挂在 Activity 组。pnpm build 输出 5 Dashboards
同表 Reports — 10+ standard reports across leads, deals, cases, contracts 正好 10 份(10 Reports),且没有任何合同报表——没有合同 dataset。真实分布是 deals 4 + cases 3 + leads 1 + accounts 1 + churn 1
《How sharing applies to analytics》 A rep running Pipeline by Stage sees only their pipeline Pipeline by Stage 不是报表:它是三个仪表盘共用的漏斗磁贴(src/dashboards/shared-widgets.ts)与真实报表 Opportunities by Stage 的图表标题。PR #975 已在 reports 页按 #924 先例点名
《Where to find things》 In the Enterprise CRM app, the Analytics group contains: Dashboards / Reports / Cubes src/apps/crm.app.ts 里没有 Analytics 组。对应的组叫 Insights,条目是 CRM Overview(仪表盘)、Forecasts(对象)与三个具名报表项 Pipeline Coverage / Lead Inflow / SLA Performance。没有「Dashboards」「Reports」「Cubes」任何一个条目 —— 与 #927 / #943 / #960 同型
《AI-powered insights》 The AI Copilot can read directly from cubes;末尾 See Sales Skills 两个问题:(1) 「Copilot 直接读 cube」是平台侧主张,PR #975 在 cubes 页按 #950 先例写成「本仓无从判定」而非断言为假——本页应取同一口径;(2) /docs/ai-copilot/sales-copilot 这个页面不存在,content/docs/ai-copilot/ 只有 index / knowledge-bases / live-schema,属 #866 / #934 的悬空链接族

三个示例问题("What's driving the gap between commit and forecast?" 等)本身不必逐字为真,但它们挂在「Copilot 直接读 cube」这句下面,随该句一并处理即可。

为什么要紧

PR #954 / #975 已经把 analytics/reports 与 analytics/cubes 写到源码,本页却仍在入口处按旧口径给出计数与名字——读者的第一印象仍然是「四个 cube、四个仪表盘、十多份含合同的报表」,点进去才发现对不上。导航那一条更直接:按「Analytics 组」去找,产品里找不到。

修复面(未做)

三语同步,以 src/datasets/*.ts、src/dashboards/*.ts、src/reports/index.ts、src/apps/crm.app.ts 为事实来源改写上表六处;平台侧那一条沿 PR #975 已立的中性措辞,不虚构机制也不预判为假;悬空链接改指真实页面或删除。

边界

Refs #962 #965 #954 #927 #943 #960 #866

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 R33,与 #977 并单,本单为主单)— session session_01VHrPAGEgFDoHjphqYG4BMa,分支 claude/issue-976-977-cube-vocabulary。

    文件面(×3 语言):#976 的 analytics/index 六处(PR #975 刚重写 analytics 另两页,fresh main 重定位)+ #977 的 cube 词汇残留 8 页(whats-new:105、for-developers:41、performance-and-limits:75/83、faq:133/138、pipeline-management:93、introduction:21、fork-hotcrm:21、sandbox-and-releases:93)。⚠️ glossary:54 的 cube 概念定义合法不误伤(dev 立单已标注)。

    裁定:

    1. 口径沿 PR docs(analytics): 把 reports 页剩余三节与 cubes 整页写到 src/ (#962, #965) #975 刚立的整套写法:本仓零 cube 声明、语义层 = src/datasets/ 九 dataset(ADR-0021)、新增 cube 等价于新增 dataset 文件;仪表盘数 5(含 Sales Activity)、报表恰 10 且无合同报表;「Analytics 导航组」真名 Insights(docs(getting-started): write the quick tour's navigation table to the real app (#960) #968 已写实 quick-tour,对齐);悬空链接 /docs/ai-copilot/sales-copilot 修为真实路径或去链。
    2. faq/performance 的刷新数值与 ⟳ 按钮属无配置支撑的行为主张——按 docs(administration): write the state-machine status vocabulary and the last two behavioural claims to source (#921, #940) #950/docs(analytics): 把 reports 页剩余三节与 cubes 整页写到 src/ (#962, #965) #975 中性化或删,依语境定并逐处说明;for-developers:41 指向 Analytics: broken chart axes, build-time frozen dates, unreferenced cubes duplicating datasets #492 已移除目录,写实。
    3. 各页仅动命中行族,「工作流规则」清扫后仍有 bare workflows 残留族:faq / performance-and-limits 的「重新评估 5 次后停止」是 PR #854 已判虚构那条说法的未清扫副本,quotes:141 指向不存在的配置面 #899/docs: 清扫 bare workflows 残留族 —— 引擎里没有「重新评估 5 次」这个计数器,报价对象上也没有可调的计划 (#899) #916/「营业时间」在 sla 页之外还有三处:administration/setup 整整一节教人配置一个不存在的 Setup → Business Hours 屏,reference/faq 把它写成 SLA 计时的前置条件,glossary 收了词条 #928/docs: write the three business-hours claims outside the SLA page to source (#928) #933 等已落地行零回退;SLA policy matrix: per-priority × tier clocks, first-response stamping, escalation that reassigns #595 不预判;三语同步;zh 内链带前缀不带锚。

    Generated by Claude Code

  4. yinlianghui commented on Aug 6, 2026

    @yinlianghui
    ContributorAuthor

    ✅ 验收通过(并单 #976+#977)—— PR #987 已转 ready 并挂 auto-merge(CI 9/9 全绿实核,29 文件)。

    验收要点:

    1. premise partial 双向修正:悬空链接半条证伪(sales-copilot 三语页一直在,Docs alignment: README/copilot pages describe retired agents; archived Salesforce comparison lacks a retired-architecture banner #589/docs: align README/copilot pages with the shipped skills-only surface (#589) #611 只改了链接文字——原样保留并加存在性 pin);刷新半条升级(仓里虽无 cube 刷新计划,但仪表盘自声明 refreshInterval 60/180/300s——「无从判定」变「有真数字可写」,拆两行分别处理)——两个方向都比 issue 更准。
    2. analytics/index 落地页六处失实:4 cubes / 4 dashboards / 「10+ 报表含合同」/ 幻影报表名 / 不存在的 Analytics 导航组 / 悬空的 sales-copilot 链接 #976 六处:退役名斜体保留、五仪表盘/十报表逐名、幻影 Pipeline by Stage 沿 docs(analytics): 把 reports 页剩余三节与 cubes 整页写到 src/ (#962, #965) #975 双真身、Insights 组沿 docs(getting-started): write the quick tour's navigation table to the real app (#960) #968 口径、Copilot 主张按应用侧/平台侧分界;「四个内置 cube」与 src/cubes/ 目录的词汇残留散在 8 个页面上:cubes 页已收口,其余各页仍按旧口径写 #977 八处逐页沿各页既有先例原地处理,glossary 正向 pin 防误伤。
    3. 新守卫 39 断言全部从 src/ 推导(仪表盘数/报表数/dataset 数/导航 children/refreshInterval),带 vacuity guard;逆向 25 红;zh 页 boldNames 跳过 CJK 的 locale 非对称如实报告且不为凑三语同红改判据——与 docs(service): write the index page's dashboards & reports section to source (#948) #955 同型记录一致。
    4. 五个既有守卫单跑 118 passed 不触;29 文件控制字节零命中。

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


    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