Skip to content

sales/index 的《Where to find things》(:62,三语) 漏掉 Sales 组里的 **Account Workbench**,与 quick-tour 已钉全的九项对不上 #997

Closed

Description

@yinlianghui

来源:#993 实施过程中的卫星命中,按 Prime Directive #10 另立。#993 的行集是同页 :63/:64 两条非对象导航项,与本单互斥。

现文(content/docs/sales/index.mdx:62,zh 两页同址)

- Leads · Accounts · Contacts · Opportunities · Quotes · Contracts

crm.app.ts 的 Sales 组有九项,不是八项

src/apps/crm.app.ts:47-62 里 group_sales.children 依源码顺序是:

# id label
1 nav_lead Leads
2 nav_account Accounts
3 nav_account_workbench Account Workbench
4 nav_contact Contacts
5 nav_opportunity Opportunities
6 nav_pipeline Pipeline
7 nav_quote Quotes
8 nav_contract Contracts
9 nav_sales_dashboard Sales Performance

本页 :62 列了 1/2/4/5/7/8 六项对象入口,:63/:64 两条覆盖 6 与 9(由 #993 归位),唯独第 3 项 Account Workbench 全页零命中。它是 ADR-0047 的 interface page(pageName: 'account_workbench'),zh-CN 语言包有真 label 客户工作台(src/translations/zh-CN.ts:1187),并非隐藏项。

与 quick-tour 的矛盾

content/docs/getting-started/quick-tour.mdx:53 的 Sales 行把九项列全了:

| **Sales** | Leads, Accounts, Account Workbench, Contacts, Opportunities, Pipeline, Quotes, Contracts, Sales Performance |

而且那张表由 test/docs-quick-tour-navigation.test.ts(#960)逐项钉死 —— 「exists ⇒ listed」,加一个导航项而不改 quick-tour 就红。同一件事在 sales/index 上没有任何门,于是两页给新读者的答案不一致。

读者影响

《Where to find things》是新读者找入口的第一站,这一节的写作意图就是「侧边栏 Sales 组里你会看到什么」。少一项的清单会让读者以为 Account Workbench 不存在,或以为自己看到的侧边栏是坏的。

边界

Refs #993 #938 #927 #960

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

    🔒 已随 #996 并单认领(/pm-dispatch R36,session session_01VHrPAGEgFDoHjphqYG4BMa,分支 claude/issue-996-997-sales-pages-final)——裁定与文件面见 #996 认领评论。


    Generated by Claude Code

  4. yinlianghui commented on Aug 6, 2026

    @yinlianghui
    ContributorAuthor

    ✅ 实施完成 — 随 #996 并单落在 draft PR #1000(claude/issue-996-997-sales-pages-final)。前提核实成立。

    补法:沿本节自身结构(六个对象入口共用 · 那条,非对象条目各占一行),Account Workbench 按源码顺序排在 Pipeline 之前,并说明它是什么——复用 All Accounts 视图的列/过滤/排序,加三个快捷筛选(行业、类型、负责人),刻意不提供视图管理与高级过滤,记录与 Accounts 相同。前导句补上分组规模「九个条目」。三语同址(zh 用语言包里的 客户工作台 / 繁体作字形转换)。与 quick-tour.mdx:53 的九项一致,两页对新读者的答案统一。

    采纳了本单的建议项 —— 加了守卫:test/docs-sales-index-navigation.test.ts,三语同跑。

    • exists ⇒ listed:本节与 group_sales 逐项比对;
    • 六个对象入口在 zh 页是译名、无法按英文 label 比,改钉数量(任何语言下多一个对象入口都会红),en 页额外逐个 label 校验;三个非对象条目每种语言都写了英文 label(en 裸写、zh 在括号里),故三语都按 label 校验;
    • 前导句的分组规模必须与 group_sales 一致;
    • 源码侧钉住:九个 children 的顺序、nav_account_workbench 紧跟 nav_account 且绑 account_workbench、interfaceConfig 复用 all_accounts、zh-CN/es-ES/ja-JP 三份语言包都给了 label。

    一处口径值得记下:nav_pipeline 的 type 也是 'object',但它钉了 viewName(落在具体看板视图而非商机列表),所以「六 / 三」的判据是「type 为 object 且无 viewName」而不是单看 type。第一版按 type 切分被测试当场判红,已修正并把理由写进注释——下一个改这一节的人不必再踩。

    反向验证:删掉本节的 Account Workbench 条目 → 三语各红 3 条(分组规模、非对象条目点名、Account Workbench 点名),方向与预测一致。

    六道门全 0,Test Files 77 passed。⚠️ CI 尚未派发任何 workflow run(GitHub Actions 侧 Service Unavailable,与本次改动无关),详见 #996 的完成评论。


    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