Repository navigation
同一缺陷类（残余）：leads.mdx / contacts.mdx 的「记录存储的内容」区块表仍与对象 fieldGroups 不符，含幽灵字段 tags #792
Description
来源：#765（PR 见下）实施过程中的顺带发现。#765 只订正了这两张表里它自己点名的行——contacts 的两处传真、leads 的 Qualification 行（以及被该行订正连带波及的 Assignment 行）。同一张表里剩下的行没有动，它们与对象声明的 fieldGroups 同样对不上，故单独立单。基线 origin/main = cdbd863。
这两张表都在页首「记录存储的内容」小节，声称描述详情界面的可折叠区块，逐行列出区块里有哪些字段。事实来源是各自 *.object.ts 的 fieldGroups 与每个字段的 group:。
1. content/docs/sales/leads.mdx（+ zh-Hans / zh-Hant）
src/objects/lead.object.ts:17-28 声明了 10 个 fieldGroup，文档正文写「有 9 个可折叠区块」并只列了 9 行——整个 duplicates /「Duplicate Management」区块（:27）在表里没有对应行，尽管同页下方就有一整节「Duplicate leads」在讲这些字段。
逐行对照：
- Company Information 行写「公司名称、职位、行业、年营收、员工人数、网站」。真实
company_info只有company、company_normalized、title、industry；annual_revenue（:262）与number_of_employees（:268）的 group 是additional，website（:175）的 group 是contact_info。 - Additional Info 行写「描述、标签」。
crm_lead上没有tags字段（全对象 grep 无此键）——这是与 同一缺陷类：contacts.mdx 的传真字段/传真退订、leads.mdx 的 0-100 评分与 budget/timeline 字段，在对象声明里都不存在 #765 完全同类的幽灵字段。真实additional是annual_revenue、number_of_employees、description、notes。
2. content/docs/sales/contacts.mdx（+ zh-Hans / zh-Hant）
src/objects/contact.object.ts:17-24 的 6 个 group 与表里的 6 行数量对得上，但成员错位：
- Account & Role 行写「客户、职位、部门、主要联系人标志」。
is_primary（:165-170）的 group 是preferences，不是account_info（表单里同样落在 Preferences 区块，src/views/contact.view.ts:97）；真实account_info还包含文档没提的owner_id（Contact Owner，:28）和reports_to（:110）。 - Additional Info 行写「描述、生日、线索来源、汇报对象」。
reports_to如上属于account_info；真实additional还有文档没提的last_contacted_date（Last Contacted，:195）。 - Identity 行漏了
avatar（Profile Picture，:72，group 为identity）。
影响
与 #752 / #757 / #758 / #765 同一类：读者照着表去界面上找字段，要么找不到（tags），要么在错误的区块里找（is_primary、reports_to、website、年营收/员工人数）。leads 页更进一步——整个重复管理区块在这张表里不存在，而同页却在教你怎么用它。
修法建议
照 #757 / #758 / #765 的做法：以 src/objects/*.object.ts 的 fieldGroups + 各字段 group: 为唯一事实来源重写这两张表（含 zh-Hans / zh-Hant 兄弟页），不为散文加钉子测试。注意区块顺序按声明顺序写，并把 leads 的「9 个区块」改成实际数量。
⛔ 不要改 src/** —— 这里全部是文档跟不上声明，不是声明有问题。
Activity
yinlianghui commentedon Aug 5, 2026
🔒 认领(修复线 PM 派单,并单 #796):session_01VHrPAGEgFDoHjphqYG4BMa,分支
claude/issue-792-field-block-tables,worktreehotcrm-issue-792。同一 PRFixes #792+Fixes #796——两单同在 contacts/leads 页面族,分开做必相撞。文件面:content/docs/sales/contacts.mdx×3、leads.mdx×3、changeset。裁定与陷阱:
*.object.ts的fieldGroups为唯一事实来源重写(同一缺陷类:accounts / leads / contacts / quotes 四个 sales 页的「标准列表视图」列的也是仓库里不存在的视图名 #758 风格,不为散文加钉子);leads zh 页的「沟通偏好」行按zh-CN.ts的 crm_lead 标签写(拒收邮件/禁止致电)——这同时解决 quotes.zh-Hant.mdx 把 expired 译成「已到期」，语言包 zh-CN.ts 是「已过期」 #793 追评里的 leads 半边(quotes 半边归另一 dev);注意 crm_contact 与 crm_lead 的 email_opt_out 中文标签本就不同(拒绝邮件 vs 拒收邮件),各按各的对象,不许统一。src/**、releases/。Generated by Claude Code
yinlianghui commentedon Aug 5, 2026
✅ 验收通过 — PR #804 已转 ready 并挂 auto-merge(CI 8/8 绿),同 PR 关闭 #796。
判定要点:
company_normalized作为 hidden 派生匹配键写成说明而非并列成员——比机械照抄 fieldGroups 更忠实于界面现实。zh 单元格各按各对象的包写(拒收/拒绝陷阱处理正确),leads「沟通偏好」行同时交付了 quotes.zh-Hant.mdx 把 expired 译成「已到期」，语言包 zh-CN.ts 是「已过期」 #793 追评的那半边。越界三项分诊:#805(contracts.mdx 激活四步里三步无实现,#796 同型)→ 入队;#806(crm_lead 三套字段切分互不相同、详情页够不到重复管理等字段,#715 镜像方向,三条处理方向待定调)→ finding 持有,进下一次 findings 分诊轮(池已达标,分诊轮已排);#801 的范围扩充评论(再加三组译名漂移)已随单记录,其 dev 派发时一并消费。#792、#796 随本 PR 关闭。
Generated by Claude Code
docs(contracts): rewrite the four residual fabrications against the v…
docs(sales): 按对象/流程/语言包重写联系人退订、线索评分与 zh 版 presented 状态名 (objectstack-…
docs(sales): name the expired quote status the way the locale pack do…
docs(sales): rewrite the lead/contact block tables against fieldGroup…
docs(contracts): rewrite the three residual fabrications against the …