docs(sales): 按对象/流程/语言包重写联系人退订、线索评分与 zh 版 presented 状态名 (#765)

[yinlianghui]

Fixes #765

三处 sales 文档描述了产品里不存在的表面。以 src/objects/*.object.ts、src/flows/*.flow.ts、src/objects/lead.hook.ts、src/translations/zh-CN.ts 为唯一事实来源重写，纯文档改动，不动 src/**，不为散文加钉子测试（#765 明确要求）。

前提复核（基线已过期，逐条在 cdbd863 上重核）

立单基线是 c55aaf5，leads.mdx 当天已被 #768、#774 改过。逐条结论：

issue 断言	复核结果
§1 传真字段/传真退订不存在	成立。全仓 grep fax 只命中 contacts.mdx 三行文档，src/** 零命中
§1「Do Not Call 阻止记录通话任务」	成立。crm_contact.do_not_call 只被对象声明、表单区块（contact.view.ts:97）和四个语言包引用，无 hook / flow / validation 读它
§1「仅管理员可取消」	成立。src/profiles/ 的四处 fields: 字段级权限里没有这两个字段
§2 Qualification 行的 score / budget / timeline	成立。lead.object.ts 只有 rating: Field.rating(5)（:200，label 是 Lead Score），无 score / budget / timeline
§2 评分是 0-100 且创建/更新都重算	成立。lead.hook.ts:130-149 的 computeRating 加权后 Math.round 到 1-5 整星，且只在 beforeInsert 且 typeof input.rating !== 'number' 时写入（:181）
§2 四星「下次跟进设为今天」	成立。lead-assignment.flow.ts:67 是 {TODAY() + 1}（明天），另一支 :91 是 {TODAY() + 3}
§2 五星「立即发邮件」	成立。通知由边 e2 的 record.rating >= 4 触发（:127），走 inbox + email 两通道，与满五星无关
§2 SLA 提示句（旧 :132）	已被 #768 修复，本 PR 不再改（现文案「四星及以上是明天，其余是三天后」与 flow 一致）
§2 Hot Leads / High Priority 两行	已被 #774 按 rating ≥ 4 订正，保留不动
§3 presented 译作「已呈现」	成立，但行号与范围与 issue 不同：现在是 :16（不是 :14），且同页另有 5 处句子把该状态称作「已呈现」（:21/:89/:93/:104/:128）。只改状态表会让同一页出现两种叫法，故 6 处一并对齐

按 #785 先例，实测与断言不符的地方以实测为准，已在上表标注。

改了什么

1. contacts.mdx ×3

• 字段区块表：Contact Information 删「传真」，Communication Preferences 删「传真退订」。是删不是补 —— 是否需要传真字段是产品决定，不该由一篇文档倒推。
• 「Communication preferences (GDPR / CCPA)」小节按落地程度重写为两个开关：
  • Email Opt Out —— 已强制执行：contact.actions.ts 的 send_email 带 visible: record.email_opt_out == false（locations: record_header / list_item），contact-welcome.flow.ts 的 start 条件也以它为门。
  • Do Not Call —— 仅是标记位：如实说明产品不阻止任何通话或 Call 任务。
  • 「仅管理员可取消」整句改为如实描述：这两个字段没有任何字段级权限规则，谁能编辑联系人谁就能勾选/取消。
• 顺带删掉同段里同样无落地的两处（都在 issue 点名的 :48-58 区间内，重写该段时无法保留）：「每个标志以红色徽章显示在界面顶部」（contact.view.ts 无任何 badge 声明）、「营销活动会将其排除」（campaign-enrollment.flow.ts:80 过滤的是 crm_lead.email_opt_out，联系人不进这条链路）。
• zh 页的两个开关名改用语言包写法（zh-CN.ts 的「拒绝邮件」「禁止致电」），与 §3 同一条 contract-first 规则。

第二个 commit 是对我自己第一版措辞的订正：contact_welcome 不是邮件模板，是 flow 名与 notify topic，通知发给联系人的负责人（"Reach out to welcome them"），不是发给联系人本人。所以 email_opt_out 挡掉的是「给负责人的打招呼提醒」。同页「Built-in rules」小节把它写成「自动向对方发送 contact_welcome 邮件模板」，三点都不对，已立 #796，本 PR 不顺手改。

2. leads.mdx ×3

• Qualification 行按 qualification group 的真实成员重写。这连带要求改一格：lead_source 与 next_followup_date 声明在 qualification（lead.object.ts:206/299）而非 assignment，若只改一行，两行会在同一张表里互相打架，故 Assignment 行收敛为「负责人」。
• 「Lead scoring」整节按 computeRating 重写：真实六项权重、上限 5 下限 1 四舍五入到整星、只在创建时运行、不覆盖调用方给的 rating。删掉「互动信号——近期网页访问、网络研讨会出席」（无任何对应实现）。
• SLA 表按 lead-assignment.flow.ts：四星及以上 → 明天 + inbox 与 email 双通道告警；其余（含无评级）→ 三天后 + 仅 inbox。并写明满五星不额外触发任何事。
• 销售代表提示里「使用星级评级——评分并不能捕捉一切」把 rating 与 score 当成两个东西，是本节订正的同一处混淆，改为说明「你填的评级会保留，自动评分只在留空时补上」。
• 「管理员可调整评分权重 → Administration › Automation」改为指向本页末尾已有的管理员提示（那里已正确写明权重在 src/objects/lead.hook.ts）。

3. quotes.zh-Hans.mdx / quotes.zh-Hant.mdx

presented 的译名跟 zh-CN.ts:471 的「已提交」，状态表加正文共 6 处。en 页无此问题，未改。:8 的「呈现时刻」与 :113 的「以看板呈现」是动词用法，不是状态名，保留。

越界发现（已单独立单，本 PR 不修）

• 同一缺陷类（残余）：leads.mdx / contacts.mdx 的「记录存储的内容」区块表仍与对象 fieldGroups 不符，含幽灵字段 tags #792 —— 同两张字段区块表里剩下的行同样与 fieldGroups 不符：leads 的 Company Information / Additional Info 行字段错位、tags 是幽灵字段、整个 Duplicate Management 区块缺行（表称 9 个区块而对象声明 10 个）；contacts 的 is_primary、reports_to 位置错、漏 owner_id / avatar / last_contacted_date。
• quotes.zh-Hant.mdx 把 expired 译成「已到期」，语言包 zh-CN.ts 是「已过期」 #793 —— quotes.zh-Hant.mdx:19 把 expired 译作「已到期」，语言包是「已过期」（zh-Hans 页是对的）。
• contacts.mdx 的「内置规则」说新建联系人会自动向对方发送 contact_welcome 邮件模板 —— 实际是发给负责人的站内提醒，且无负责人时什么都不发 #796 —— contacts.mdx「内置规则」的欢迎邮件条目：收件人、载体、触发条件三点都与 contact-welcome.flow.ts 不符。

验证

全量跑（docs 改动，确认零测试影响）：

pnpm hygiene    ✓ source hygiene clean（含 no raw control bytes；两次 commit 后各跑一次）
pnpm typecheck  TYPECHECK_EXIT=0
pnpm validate   ✓ Validation passed (1516ms) —— 5 条 warning 均为既有项（approval / campaign_member），与本改动无关
pnpm lint       13 warning(s), 14 suggestion(s)，0 error，均为既有项
pnpm test       Test Files 63 passed (63) · Tests 1521 passed | 1 skipped (1522)

控制字符自扫全部改动文件 + changeset：grep -naP '[\x00-\x08\x0b\x0c\x0e-\x1f]' 零命中。

本 PR 未新增任何链接（只删除了一处 /docs/administration/automation 链接），link-check 无新增面。changeset：.changeset/sales-docs-ghost-fields.md（hotcrm, patch）。

[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 8:22pm