Skip to content

getting-started/quick-tour 的导航表(:35-:44,三语)整表失实:8 行里 4 个分组不存在、3 个真实分组缺席、条目名多处对不上 crm.app.ts #960

Description

@yinlianghui

发现自 #943 / PR #953 的实施过程(把 content/docs/revenue/index*.mdx 的《Where to find things》按 src/apps/crm.app.ts 写实时,grep -rn "Action History" content/ 顺带扫出这张表)。

基线 origin/main = b7791caf(平台 17.0.0-rc.3)。不与 #943 / PR #953 重叠:那单只动 content/docs/revenue/index*.mdx 一节,完全不碰 getting-started/。

事实

content/docs/getting-started/quick-tour.mdx:35-:44(zh-Hans 同址 :35-:44,zh-Hant :33-:42,三语同形):

| Group | Contents |
| --- | --- |
| **Sales** | Leads, Accounts, Contacts, Opportunities, Quotes, Contracts |
| **Service** | Cases, Knowledge Base |
| **Marketing** | Campaigns, Campaign Members |
| **Products** | Products |
| **Activities** | Tasks, Events |
| **Analytics** | Dashboards, Reports |
| **AI** | Copilot, Knowledge Bases |
| **Approvals** | Approval Requests, Action History |

src/apps/crm.app.ts 的 navigation 只有 1 个顶层条目 + 7 个分组:nav_home(Home,仪表盘)、group_sales(:42)、group_work(My Work,:69)、group_activity(Activity,:103)、group_marketing(:120)、group_service(:131)、group_insights(Insights,:144)、group_approvals(:160)。逐行对照:

表中行 源码实况
Sales 分组存在,但 children 是 9 项不是 6 项:表里漏了 Account Workbench(:52)、Pipeline(:55)、Sales Performance(:61)
Service 分组存在;Knowledge Base 的真实 label 是 Knowledge(:138),且表里漏了 Service Overview(:139)——同一族已由 #927 / PR #932 在 service/index 上写实过
Marketing 分组存在,但 children 是 Campaigns + Products(:125-:126)。Campaign Members 不是导航条目(crm_campaign_member 在 src/apps/ 零命中)——顺带参见 #944
Products 分组不存在。 真身是 group_marketing 的 child nav_product(:126)——与 #938 / #943 同一处
Activities 分组不存在。 真实分组叫 Activity(group_activity,:103),children 是 Events / Calendar / Interaction History / Sales Activity;Tasks 根本不在其中,crm_task 的两个入口是 My Tasks(:84)与 All Tasks(:93),都在 My Work 分组下
Analytics 分组不存在。 真实分组叫 Insights(group_insights,:144),children 是 CRM Overview / Forecasts / 三张报表;没有叫 Dashboards 或 Reports 的条目
AI 分组不存在,全仓无此分组。也没有叫 Copilot 或 Knowledge Bases 的导航条目
Approvals 分组存在,但只有 1 个 child,label 是 Inbox(:165)。Approval Requests 与 Action History 都不存在——详见 #943 / PR #953

即:8 行里 4 行的分组是虚构的(Products / Activities / Analytics / AI),3 个真实分组(My Work、Activity、Insights)一个都没出现,剩下 4 行的条目清单也各有漏项或错 label。

为什么要紧

这是《快速上手》——新用户读的第一页,且这张表的全部作用就是"告诉你左边有什么、去哪里点"。它比 #927 / #932(service/index)、#938 / #942(marketing/index)、#943 / #953(revenue/index)三处加起来还偏,因为那三处各只错一节里的几条,这里是整表按一个早已不存在的 IA 写的。My Work 分组(我的任务 / 我的商机 / 我的线索 / 我的工单 / 我的日历)完全没被提到,而它恰恰是销售代表每天真正用的那一组。

边界与口径建议

Refs #927 #932 #938 #942 #943 #953

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
    CollaboratorAuthor

    🔒 认领(/pm-dispatch R32)— session session_01VHrPAGEgFDoHjphqYG4BMa,分支 claude/issue-960-quick-tour-nav。

    文件面:content/docs/getting-started/quick-tour{,.zh-Hans,.zh-Hant}.mdx 的导航表(基线 :35-:44)——fresh main 重定位。

    裁定:①整表按 crm.app.ts 的 nav_home + 7 分组实况重写(#932/#942/#953 三次先例:label 以源码为准、真实分组一个不漏、假分组点名说清);②Knowledge Base→Knowledge、Campaign Members 非导航条目、Approvals 组只有 Inbox(待我审批)等逐项对齐已落地口径;③默认折叠机制(#942/#953 已写实)如适用本表一并提示;④#595/#596 不预判;src/ 零改动;三语同步;zh 内链不带锚。


    Generated by Claude Code

  4. yinlianghui commented on Aug 6, 2026

    @yinlianghui
    CollaboratorAuthor

    ✅ 验收通过 —— PR #968 已转 ready 并挂 auto-merge(CI 9/9 全绿实核)。

    验收要点:8 行逐行复核全成立且证据超出 issue(Sales 实为 9 children、漏项精确到行号);整表按源码顺序逐字重写,消失的名字逐个点名去向(Copilot=右侧聊天面板、成员经详情页进入),zh 补真实界面译名;三分组默认收起机制沿 #942/#953 写实。新增守卫 test/docs-quick-tour-navigation.test.ts 21 断言:导航表与 CrmApp.navigation 三语逐分组逐 child 全等比对 + bold/italic 排版约定 + 源码事实钉;逆向验证预告 RED 实测 15 红,首条失败输出即分组清单 diff——自此导航表漂移有门可拦(#932/#942/#953 三轮人眼撞见的缺陷类型被制度化)。

    越界发现处置:#971(同页第 1 节整节失实:落地页实为 executive_dashboard/Executive Overview,5 条要点 4 条在两块盘上都不存在)已复核成立,标 pm:queue,R33 候选——⚠️ 与本 PR 同页,合并后重定位。


    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