Repository navigation
getting-started/quick-tour 第 1 节配图是 Sales Performance 仪表盘,而该节讲的是 Home 打开的 Executive Overview;且 zh-Hant 无图,三语不齐 #981
Description
发现自 #971 / PR #978 的实施过程(重写该节文案时,配图不在该单可修的面内 —— 修它需要新截图资产)。基线 origin/main = 01da4a8e。
事实
content/docs/getting-started/quick-tour.mdx:24(PR #978 前后行号不变,该行未被 #978 触碰):
[Sales performance dashboard](/screenshots/hotcrm/sales-dashboard/en.jpg)
它紧跟在「## 1. The home dashboard」一节末尾,读者会把它读成"这就是我落地时看到的那块盘"。但:
- 该节讲的是
nav_home绑的executive_dashboard(label Executive Overview,src/apps/crm.app.ts:33-39)。 - 图是
sales_dashboard(label Sales Performance),挂在 Sales 分组下的nav_sales_dashboard(crm.app.ts:61),是第三块盘。 - 两块盘的 tile 几乎不重叠:executive 的 9 个是 Total Revenue (YTD) / Active Accounts / Total Contacts / Open Leads / Revenue Trend / Revenue by Industry / Pipeline by Stage / New Accounts / Accounts by Industry;sales 的是 Total Pipeline / Closed Won (QTD) / Open Opportunities / Avg Deal Size / … 只有共享工厂的 Pipeline by Stage 同时在两块盘上。
alt 文本本身没说谎(它写的就是 "Sales performance dashboard"),问题在位置:PR #978 刚把这一节的文字逐条写实到 Executive Overview 的真实 tile,文字与紧邻的图现在指向两块不同的盘。
三语不齐
| 文件 | 第 1 节配图 |
|---|---|
quick-tour.mdx:24 |
/screenshots/hotcrm/sales-dashboard/en.jpg |
quick-tour.zh-Hans.mdx |
/screenshots/hotcrm/sales-dashboard/zh-Hans.jpg |
quick-tour.zh-Hant.mdx |
无图 |
assets/screenshots/hotcrm/sales-dashboard/ 下只有 en.jpg / zh-Hans.jpg / meta.yaml,没有繁体资产,zh-Hant 因此一直是空的。assets/screenshots/hotcrm/ 全目录下也没有任何 executive dashboard 的截图(现有:campaign-detail / customer-360 / large-deal-approval / lead-detail / quote-pipeline / sales-dashboard / sales-pipeline / sales-representative-permissions)。
为什么这不是 #971 的一部分
#971 的面是该节的文字描述,src/ 与资产零改动;补图需要起应用、造种子数据、截 Executive Overview 至少两个语言版本,是另一类工作。所以 #978 只写实文字,把配图原样留下并在此立单。
可选处理(不预判)
- 补截 Executive Overview(en / zh-Hans,zh-Hant 是否需要单独一份取决于本仓有没有繁体界面 —— 应用只提供 en / zh-CN / ja-JP / es-ES 四种界面语言,zh-Hant 文档页一直借用简体界面截图,这本身也需要一个口径)。
- 把这张 Sales Performance 图移到讲 Sales Performance 的地方(第 2 节导航表附近,或
content/docs/analytics/dashboards.mdx),第 1 节暂时无图。 - 保留图但在文字里点明它是 Sales Performance 而非落地页 —— 成本最低,但等于在教程首屏承认配图不对版。
面:content/docs/getting-started/quick-tour{,.zh-Hans,.zh-Hant}.mdx 的配图行 + 可能的 assets/screenshots/hotcrm/。
Activity
huangyiirene commentedon Aug 25, 2026
定级（首触）→
pm:queue。三条事实全部原样成立。按本席常设授权定级。
finding同笔摘除。前提对
origin/main@6ed7b8d重测行号相对卡片位移（
:24→:40，该页后来加长），三条事实一条没变：第 1 节配的还是 Sales Performance，zh-Hant 还是无图，executive 截图还是不存在。为什么晋级
这是入门教程首屏的配图。读者读完「## 1. The home dashboard」讲的 Executive Overview，紧接着看到的是另一块盘（Sales Performance），两块盘 9 个 tile 里只有共享工厂的 Pipeline by Stage 重叠 —— 也就是说图上几乎没有一个 tile 是上文刚讲过的。样板工程的入门第一屏就对不上版，这正是本车道宪章说的「展品撒谎等于教每个照抄的 AI 撒谎」。
加上 zh-Hant 整页无图，三语体验不齐。
三条路都在卡片里，本席给排序而不代裁
卡片列了三个选项且明确「不预判」。我给一个推荐顺序，实施者可依实测推翻：
analytics/dashboards.mdx后是对版的。顺带解决 zh-Hant 不齐：三语一起无图，比两语有错图更诚实。面：
content/docs/getting-started/quick-tour{,.zh-Hans,.zh-Hant}.mdx的配图行 + 可能的assets/screenshots/hotcrm/。src/零改动。Generated by Claude Code