docs(service): write the case detail customer panel, Related tab and AI rail to source (#945)

[yinlianghui]

Fixes #945

三语同步改写 content/docs/service/cases{,.zh-Hans,.zh-Hant}.mdx 中「打开一个工单时，你会看到」这份清单里剩下的三条：:145 客户面板、:148 Related 页签内容、:150 AI 参考栏。三条前提逐一复核，全部成立，按 #918 / #946 已立口径写实（点名说清不存在 + 给出真实归属，不静默删名）。src/ 零改动，三个文件各只动 3 行。

复核基线

分支基线 b7791caf（main，平台 17.0.0-rc.3）。#946 / #947 落地后这三条行号未再位移，三语同址：cases.mdx / cases.zh-Hans.mdx / cases.zh-Hant.mdx 的 :145 / :148 / :150 逐一原址命中。issue 里存疑的一点也一并核了：zh-Hant 的 Related 那条措辞与另外两语一致，同在 :148，不需要按当地行文另行处理。

src/pages/case_detail.page.ts 的 regions 只有两个：

region	组件
header（:38-95）	page:header（:43）、record:highlights（:57，label Key Information）、record:path（:76）
main（:96-220）	一个 page:tabs（:101），details / related / activity 三个页签

regions 在 :221 收口，紧接着是 isDefault（:223）、assignedProfiles（:224）、aria（:226）。没有第三个 region，没有侧栏，页面上没有任何 AI 组件。

一、:145 客户面板 —— 成立

页面上不存在这样一个组件。它点名的四样东西逐一定位：

• 账户：页面上出现三次 —— 页眉副标题 {crm_account}（:50）、record:highlights 的字段列表（:71）、record:details 的 Case Information 分区（:125）。
• 主要联系人：只有一处 —— record:details 的 Case Information 分区（crm_contact，:126）。
• 合同等级：无承载。crm_case 没有任何指向合同的关系字段；crm_contract 上也没有等级字段（src/objects/contract.object.ts 只有 contract_type / status / billing_frequency / payment_terms 等）。全仓最接近的是 crm_account.tier，label 是 Customer Tier（src/objects/account.object.ts:344），它在账户记录上，本页不展示。
• 本月未结工单：无承载。src/objects/ 下一个 Field.summary 都没有，也没有任何按月计数的汇总。

改法：保留「客户面板」这个名字并说清它不存在，把账户与主要联系人指回真实位置，后两样写明在工单的任何界面上都没有承载。

二、:148 Related 页签 —— 成立

Related 页签是一个 page:accordion（:162），items 里只有一项 Open Tasks（:167-190）：record:related_list，objectName: 'crm_task'、relationshipField: 'related_to_case'、filter 为 status neq completed、limit: 10。原文四样：

• 子任务 —— 半对：它是「尚未完成的关联任务」，不是全部子任务，且一次最多十条。
• 附件 —— 这一页没有任何附件组件（src/pages/ 全目录都没有文件类组件）。对象层面 crm_case.enable.files = true（src/objects/case.object.ts:300），所以工单确实可以挂附件 —— 文中把「能挂」与「这一页不列」分开写，不含糊带过。
• 关联商机 —— crm_case 与 crm_opportunity 双向都没有关系字段（全仓指向 crm_case 的 lookup 只有 crm_task / crm_event / crm_knowledge_article 三个，外加 parent_case 自引用）。
• 里程碑 —— 存在，但归属不同：crm_case.activityMilestones（:302-310）声明 escalated / resolved / closed 三条，由平台发到 Activity 时间线，不是 Related 上的记录列表。

三、:150 AI 参考栏 —— 成立

没有第三个 region，main 里除了 page:tabs 什么都没有；src/pages/ 全目录唯一与 AI 沾边的是 home.page.ts:234 的一段文案卡片。真实归属：服务技能（src/skills/）是真的，页面下方《AI Copilot 如何提供帮助》一节已经在讲它们 —— 靠提问触达，而不是靠工单旁边的面板。文中指回该节的名字而不加链接锚点。

顺带给读者一个坐标：本仓唯一真正渲染 record:reference_rail 的地方是商机详情页（src/pages/opportunity_detail.page.ts:226-256），而且它列的是 Quotes / Products / Open Tasks 三个关联记录列表，不是建议。

#612 不等待、也不预判：本条改的是「这一页没有这个组件」，与它该叫 Copilot 还是别的名字无关；Service Copilot 这个称呼在本 PR 里一字未改，全站用语定调仍归 #612。#595 同样不预判：全文只写今天的行为，没有评价 High/Medium/Low 该不该有时钟、账户等级该不该驱动 SLA。

落地行零回退

三个文件各只有 3 行变动（合计 9 insertions(+), 9 deletions(-)），PR #939 / #946 / #947 落地的 :142 页眉、:143 关键信息、:144 状态路径，以及标准列表视图小节、经理提示各行，原文逐字未动。

反向验证的方向

纯文档改写，没有可以「删掉再看诊断变红」的代码分支；test/ 下 70 个测试文件没有任何一个读 content/docs/service/cases*.mdx（docs-drift.test.ts 的规则面是 src/docs/*.md 的流程阈值、仪表盘磁贴引用、译页 callout 计数，都不覆盖本页这几句散文）。按裁定如实报告：守卫盲区（散文列），predicted GREEN —— 六道门在改前改后都应绿，绿本身不构成对文案正确性的证据；证据是上面每条的 file:line。

验证

全部在 flock -w 7200 /tmp/os-heavy-verify.lock 内串行执行，NODE_OPTIONS=--max-old-space-size=4096：

门	退出码	关键行
pnpm validate	0	✓ Validation passed (1056ms)
pnpm typecheck	0	无输出
pnpm lint	0	13 warning(s), 14 suggestion(s) —— 与 main 既有一致
pnpm hygiene	0	✓ no raw control bytes in first-party files / ✓ source hygiene clean
pnpm build	0	✓ Build complete (1149ms)
pnpm test -- --maxWorkers=2	0	Test Files 70 passed (70) / Tests 1602 passed | 1 skipped (1603)

push 前控制字节自扫：grep -naP '[\x00-\x08\x0b\x0c\x0e-\x1f]' 覆盖三个 mdx 与 changeset，退出码 1（无命中）。未起任何 dev server。

附带

• changeset：.changeset/cases-detail-layout-write-real.md（patch），站内路径一律反引号包裹。
• 自查后追加的两个提交只做字段标签校正：crm_task 那个 lookup 的 label 是 Related Case（src/objects/task.object.ts:175）而不是 Related To Case；crm_account.tier 的中文 label 是「客户分层」（src/translations/zh-CN.ts:96）而不是「客户等级」。
• 施工中发现两族越界失实，行集与本单互斥，未在本 PR 顺手改：①同页 :147 Details 页签「所有元数据字段」与 :55 「详情屏幕分为 6 个分区」表；②sales/opportunities{,.zh-Hans,.zh-Hant}.mdx 的 :151 / :152 与 opportunity_detail.page.ts 的 aside 区实况不符。两族的 issue 编号在立单后补在本 PR 的评论里。

---

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 6, 2026 1:29pm

[yinlianghui]

补上正文里预留的两个 issue 编号（均未指派，只打 documentation，不打 pm:queue）：

• service/cases 详情字段两族失实：:147 Details 页签「所有元数据字段」（实为 16/28）与 :55 「详情屏幕分为 6 个分区」表（真实界面各只有 3 个分区） #958 —— 同页 :147 Details 页签「所有元数据字段」（实为 3 个分区 16 个字段，crm_case 声明 28 个）与 :55 「详情屏幕分为 6 个分区」表（详情页 record:details 与表单各只有 3 个分区，Origin & Routing / Escalation / System 三个名字在 src/ 里零命中）。
• sales/opportunities 详情布局 :151 / :152 与 opportunity_detail.page.ts 的 aside 区不符：参考栏列的是关联记录不是建议，且没有 Competitors & Notes 面板 #959 —— content/docs/sales/opportunities{,.zh-Hans,.zh-Hant}.mdx:151 / :152 与 src/pages/opportunity_detail.page.ts 的 aside 区不符：参考栏确实存在，但列的是 Quotes / Products / Open Tasks 三个关联记录列表；Competitors & Notes 面板不存在。与 Docs drift (round 2 leftovers): ~39 product pages still name "Sales/Service Copilot" as a persona; config comment and RELEASE_STRATEGY.md still stale #612 的用语定调相邻但不同。

两单的重复检查方式写在各自正文里：本轮 search_issues 对有命中的查询一律返回 API rate limit already exceeded（零命中的查询正常返回），故以「零命中作反证」的方式做的检查，逐条列了查询串。

---

Generated by Claude Code