docs(sales): 用真实的视图名册重写 accounts / leads / contacts / quotes 四页的「标准列表视图」

[yinlianghui]

Fixes #758

延续 PR #757（opportunities.mdx）的写法：以各对象的 src/views/*.view.ts 声明为唯一事实来源，逐个视图对账过滤条件、排序和入口，按现状描述行为，不为散文加钉子测试。四个页 × 三个语言 = 12 个文件，改动限定在列表视图小节 + 幽灵视图引用，其余小节没动。

逐页对账结果（基线 origin/main = c55aaf5）

四页没有一页是准确的，#758 的前提全部成立：

页	文档原先写的	仓库里真正声明的
accounts	My Accounts、All Customers、Top Accounts by Revenue、Inactive Accounts、By Industry、Recently Updated	All Accounts、Account Cards、Accounts by Location、Enterprise Accounts、My Accounts、🔄 Upcoming Renewals、⚠️ At-Risk Accounts（7 个，全部在 list.tabs 里，可达）
leads	My Open Leads、Hot Leads、Today's Follow-ups、Recently Created、By Source	All Leads、My Leads、🔥 Hot Leads、High Priority、Suspected Duplicates、Lead Pipeline、Lead Calendar、Lead Cards（8 个；该列表没有 tabs，切换器列出全部）
contacts	My Contacts、Primary Contacts、Decision Makers、By Title、Recently Added	All Contacts、People Directory、Primary Contacts（3 个）
quotes	My Quotes、Active Quotes、Expiring This Week、Won Quotes、By Account	All Quotes、Quote Pipeline、Quote Calendar（3 个）

对得上的只有 accounts 的 My Accounts、leads 的 Hot Leads（名字对、阈值写错）和 contacts 的 Primary Contacts。

散文里的幽灵视图（#757 同款顺带清扫）

• leads.mdx 给销售代表的提示曾写「填下次跟进日期——它驱动 Today's Follow-ups 视图」。该视图不存在；这个日期真正驱动的是 🔥 Hot Leads 的排序，且由 lead_assignment 在入库时盖章（四星及以上明天、其余三天后），schedule_followup 会按新建任务的到期日重新盖章。三个语言页都已改写。
• leads.zh-Hant.mdx:81 把视图叫「疑似重複潛在客戶」，语言包里是「疑似重复线索」——改为「疑似重複線索」，并在小节开头一句说明：视图名依产品界面中文名写作「線索」，与本页行文的「潛在客戶」是同一件事。
• leads.mdx:81 / zh-Hans 引用的 Suspected Duplicates 视图核对属实（lead.view.ts:398），未动。

三处值得单独看的实测结论

• 🔥 Hot Leads 按现状写，不按直觉写。 它的过滤是 rating >= 4.5（lead.view.ts:358），而 rating 是 Field.rating(5)、打分钩子 Math.round 到整星，所以它实际上是五星队列；四星线索在 High Priority 里。文档因此明确写「四星的线索没有丢，它在 High Priority」。阈值本身与路由流 Hot Lead (rating ≥ 4) 的分叉是 src 侧问题，另立 🔥 Hot Leads 视图的 rating ≥ 4.5 与整星评分/路由流的「hot = rating ≥ 4」不一致：被判定为 hot、发了告警的四星线索永远进不了这个队列 #766，本 PR 不碰 src/**。
• Enterprise Accounts 是营收切，不是客户分层。 annual_revenue >= 10000000（account.view.ts:129），与 tier: 'enterprise' 无关——种子数据里 Acme（tier=enterprise、营收 500 万）就不在这个视图里。文档写明了这一点。同理 Accounts by Location 的图钉取自 office_location，不是账单地址。
• 空列表按声明解释，不编空态文案。 Upcoming Renewals / At-Risk Accounts 都先按 type = customer 过滤，再读手工维护、无默认值的 health_score / next_renewal_date——空是数据缺口而非过滤条件坏了，页面这样写。Quotes 三个视图都没有声明 emptyState，而报价只能从商机生成，所以新组织看到的就是一张空网格；文档如实说明，没有替它虚构一段解释文案（与 opportunities 的 closing_this_quarter 有真实 emptyState 的情况不同）。

语言

英文页用 metadata label；zh 页用 src/translations/zh-CN.ts 的 _views 译名（zh-Hant 为对应繁体写法），跨节链接按语言前缀。机械核对：四个对象声明的全部 21 个视图名在对应英文页中均出现；21 个中文/繁体译名在对应 zh 页中均出现；原先 18 个不存在的视图名在 12 个文件里已一个不剩。

验证

pnpm hygiene    ✓ source hygiene clean（含 no raw control bytes）
pnpm typecheck  ✓ tsc --noEmit 无输出
pnpm test       Test Files 62 passed (62) / Tests 1475 passed | 1 skipped (1476)

首轮 pnpm test 是红的，而且红得有价值：docs-drift.test.ts 的 callout 平价守卫抓到我在 zh-Hant 版 leads 页多加了一个 > … 说明框（3 vs 英文页的 2）。那段说明是繁体页特有的术语提示，不是「别人踩过的坑」，因此并入小节开头的正文而不是保留成 callout——不是为了让检查变绿而删英文页的框。第二轮全绿。

变更集：.changeset/sales-list-view-rosters.md。未触碰 content/docs/releases/、opportunities.mdx（#757 刚定稿）、guides/**（#756 在飞）、index.mdx 与 src/**；平台版本保持 17.0.0-rc.2。

顺带发现（均已另立单，本 PR 不修）

• 同一缺陷类：contacts.mdx 的传真字段/传真退订、leads.mdx 的 0-100 评分与 budget/timeline 字段，在对象声明里都不存在 #765 —— contacts.mdx 的传真字段/传真退订、leads.mdx 的 0-100 评分与 budget/timeline 字段在对象上都不存在；另含 zh 报价状态「已呈现 / 已提交」译名分叉。
• 🔥 Hot Leads 视图的 rating ≥ 4.5 与整星评分/路由流的「hot = rating ≥ 4」不一致：被判定为 hot、发了告警的四星线索永远进不了这个队列 #766 —— hot_leads 的 rating >= 4.5 与路由流「hot = rating ≥ 4」不一致：被判为 hot、发了 24 小时告警的四星线索永远进不了这个队列（需产品决定收哪一边）。
• en.ts 的 _views 少了三个视图标签（renewals_due / at_risk_accounts / hot_leads），而其余三个语言包都有；_views 没有任何跨语言覆盖守卫 #767 —— finding：en.ts 的 _views 少了三个视图标签，其余三个语言包都有；_views 没有跨语言覆盖守卫。

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
hotcrm	Ignored		Aug 5, 2026 6:18pm