Repository navigation
同一缺陷类：contacts.mdx 的传真字段/传真退订、leads.mdx 的 0-100 评分与 budget/timeline 字段，在对象声明里都不存在 #765
Description
Activity
🔒 认领(修复线 PM 派单):session_01VHrPAGEgFDoHjphqYG4BMa,分支
claude/issue-765-sales-docs-ghost-fields,worktreehotcrm-issue-765。文件面:content/docs/sales/contacts.mdx×3、leads.mdx×3、quotes.zh-Hans.mdx+quotes.zh-Hant.mdx、changeset。修法照 issue 建议与 #757/#758 先例(以 object/flow/translations 为唯一事实来源,不为散文加钉子)。⚠️ 时效提醒:立单基线是 c55aaf5,今天leads.mdx×3 已被 #768、#774(PR)改过——Hot Leads / High Priority 两行是 #774 刚按新阈值(≥4)订正的,保留不动;逐条前提须在最新 main 上重核(行号必变,事实可能部分已修)。⛔ 不动src/**(hot 阈值已由 #766 处理完毕;传真是删不是补)。
Generated by Claude Code
- added a commit that references this issue
on Aug 5, 2026 ✅ 验收通过 — PR #794 已转 ready 并挂 auto-merge(head db12913,CI 全绿)。
判定要点:
- 前提复核按新基线逐条做(cdbd863,非立单基线):三节全部成立,其中 SLA 提示句已被 docs(sales): 用真实的视图名册重写 accounts / leads / contacts / quotes 四页的「标准列表视图」 #768 修、Hot Leads / High Priority 两行已被 fix(leads): 一个 hot 定义 —— Hot Leads 视图阈值对齐 lead_assignment 路由流（rating ≥ 4） #774 订正——如实标注不重复改,正是派单时效警告要的处置。
- §3 的范围扩展合理:
presented不止状态表一处,同页 5 处句子同名——只改表会让一页两种叫法,6 处一并对齐;动词用法(「呈现时刻」「以看板呈现」)正确保留。zh 页开关名同步走语言包(contract-first)。 - §1 的分层写法准:email_opt_out 写「已强制执行」(send_email 的 visible 谓词 + welcome flow 门),do_not_call 写「仅是标记位」——不粉饰、不留假承诺;同段内无法保留的另两处无落地断言(红徽章、营销排除)删除并披露。传真是删不是补,产品决定不由文档倒推。
- §2 的连带修正有据:Qualification 行订正连带 Assignment 行收敛(lead_source/next_followup_date 实际声明在 qualification group,否则同表打架);评分节按 computeRating 真实口径(六项权重、整星、仅创建时、不覆盖手填)。
- 自我反向核实加分:写完「欢迎邮件」措辞后回读 flow 源码,发现收件人是 owner、载体是 notify 而非邮件模板——第二个 commit 自我订正,并把同页「内置规则」的原始错误说法立为 contacts.mdx 的「内置规则」说新建联系人会自动向对方发送 contact_welcome 邮件模板 —— 实际是发给负责人的站内提醒，且无负责人时什么都不发 #796 而不是顺手改(不在 issue 点名区间内,越界即停)。
- 纯散文改动不造假反向验证,如实说明——正确。
越界四项已分诊:#792(字段区块表整体错位,#758 类)、#793(zh-Hant「已到期」误译 + 追评的 leads 页开关名对齐提醒,含「两对象中文标签本就不同,各按各的」这个重要陷阱)、#796(欢迎通知描述错误)→ 全部入队;#765 随本 PR 关闭。
Generated by Claude Code
- added a commit that references this issue
on Aug 10, 2026
来源：#758（四个 sales 页「标准列表视图」重写）实施过程中的顺带发现。#758 的文件面只覆盖各页的列表视图小节 + 幽灵视图引用，下面这些在别的小节里，故单独立单。基线
origin/main= c55aaf5。与 #752 / #758 同一类：文档描述了一套产品里不存在的表面，读者照着找不到。区别只在于这次错的是字段、状态名和自动化数字，不是视图名。
1.
content/docs/sales/contacts.mdx:48-58（+ zh-Hans / zh-Hant）「Communication preferences (GDPR / CCPA)」小节写着 三个 退订开关，并逐条描述行为：
crm_contact上没有任何传真字段（src/objects/contact.object.ts的字段表里既无fax也无fax_opt_out），同一页contacts.mdx:18的「Contact Information | Email, phone, mobile, fax」也一样把 fax 列成了记录字段。实际只有两个开关：do_not_call（contact.object.ts:172）与email_opt_out（:178）。do_not_call全仓只被对象声明和表单引用（src/views/contact.view.ts:97），没有任何 hook / flow / validation 读它，所以这条「阻止记录通话任务」是声明未落地的行为。src/profiles/里没有针对这两个字段的字段级权限声明，这条限制同样无处兑现。2.
content/docs/sales/leads.mdx:45,56-68（+ zh-Hans / zh-Hant）src/objects/lead.object.ts上只有rating: Field.rating(5)（:200，help 文案自己写的是「1-5 星」），没有 score / budget / timeline 任何一个字段。src/objects/lead.hook.ts:130-149的computeRating：按邮箱域名、电话、职位、行业、人数、营收加权后Math.round到整星（1-5），只在beforeInsert且调用方没给rating时写入。src/flows/lead-assignment.flow.ts:67的{TODAY() + 1}（明天），另一支:91是{TODAY() + 3}。rating >= 4（lead-assignment.flow.ts边e2），走 inbox + email 两个通道，与是否满五星无关。3.
content/docs/sales/quotes.zh-Hans.mdx:14/quotes.zh-Hant.mdx:14状态表把
presented译成已呈现，而src/translations/zh-CN.ts的crm_quote.status.options.presented是已提交。中文读者按文档里的词在界面上对不上号。（英文页无此问题，label 就是 Presented。）修法
按 PR #757 / #758 的做法：以
src/objects/*.object.ts、src/flows/*.flow.ts、src/translations/zh-CN.ts为唯一事实来源重写这三处，不要为散文加钉子测试。传真那一行是删（对象上没有这个概念），不是补字段——是否需要传真字段是产品决定，不该由一篇文档倒推。「Do Not Call 阻止记录通话任务」与「只有管理员能取消」两条，要么改成描述现状（只是一个标记位），要么单独立单去实现；同一句里两种写法都行，但不能继续按现在这样写。文件面：
content/docs/sales/contacts.mdx、leads.mdx、quotes.zh-Hans.mdx、quotes.zh-Hant.mdx及各自 zh 兄弟页。⛔ 不要改src/**（第 2 节里 hot 阈值本身的问题另见单独 issue）。Refs #752 #757 #758