contracts.mdx 还剩四处与实现不符：五条幽灵列表视图、三个幽灵选项、无实现的「已激活不能删除」、教销售代表做他无权做的事 #832

来源：#826（PR #831）实施过程中的顺带发现。#826 的裁定面是同页的三处（到期扫描第 3 条、续约提醒的一键操作、记录字段表的四个幽灵字段），本条是该页其余四处，均与那三处无因果关系，也都不由 #831 的改动导致，故单独立单。基线 origin/main = 4c12791（#823 已在其中）。

文件面：content/docs/revenue/contracts.mdx + zh-Hans / zh-Hant（三语同款）。

与 #752 / #757 / #758 / #765 / #792 / #796 / #805 / #826 同一类：页面声称的东西在 src/ 下不存在。四处可在一遍里改完（同页、同三个文件）。

1. 「标准列表视图」五条全是幽灵（:115-121）

页面写：

- **My Active Contracts** — `owner_id = me AND status = Activated`.
- **Expiring in 60 Days** — `end_date <= TODAY + 60 AND status = Activated`.
- **Up for Renewal** — within renewal-notice window.
- **Expired This Month** — `status = Expired AND last_modified IN this month`.
- **Pending Activation** — `status IN [Draft, In Approval]`.

src/views/contract.view.ts 里一条都没有。真实的四个视图是：

而且四者是同一份数据的四种可视化（appearance.allowedVisualizations + tabs[]），不是五个按条件过滤的列表——读者按页面去找「我的活跃合同」这一栏，找到的是一个没有任何过滤的全量网格。与 #792 那批 sales-list-view-rosters / opportunities-docs-view-roster 同型，只是落在合同上。

2. 计费周期与付款条款各有幽灵选项（:44-62）

• 计费周期：页面列 One-Time / Monthly / Quarterly / Annual / Custom。contract.object.ts:131-140 的 billing_frequency 只有 monthly(default) / quarterly / annually / one_time —— 没有 Custom。
• 付款条款：页面列 Net 15 / Net 30 / Net 45 / Net 60 / Net 90 / Due on Receipt / Prepaid。PAYMENT_TERMS_OPTIONS（src/objects/_picklists.ts:83-89）只有 net_15 / net_30(default) / net_60 / net_90 / due_on_receipt —— 没有 Net 45，也没有 Prepaid。

这一组是「在表单上找不到」型：读者按页面去选 Net 45 或 Prepaid，下拉里根本没有。注意 PAYMENT_TERMS_OPTIONS 是与 Quote 共用的规范集（#490），所以同一处失真可能也落在 quotes 页，改前顺带核一下。

3. 「内置规则」小节：一条无实现，两条真规则没写（:99-103）

页面写：

- **End date must be after start date** — basic sanity check.
- **Contract value must be zero or positive** — NDAs can be $0.
- **Activated contracts cannot be deleted** — change status to Terminated instead.

• 第 1 条成立（validations[].end_after_start）。
• 第 2 条勉强成立，但它不是 validation rule，是 contract_value 的 min: 0 字段约束。
• 第 3 条没有任何实现：contract.object.ts / contract.hook.ts 里没有 beforeDelete，没有任何按 status 拦删除的校验。删除权限完全由 profile 决定，且与状态无关：system-admin allowDelete: true（连已激活的也能删），sales-manager 与 sales-rep 都是 allowDelete: false（连草稿也删不掉）。也就是说这句话对管理员是假的安全感、对其他人是多余的限制说明。

同时这一节漏掉了合同上真正会拦住保存的三条规则，而它们恰恰是用户最容易撞上的：

• contract_validation hook（contract.hook.ts:19-73）：end_date 与 start_date + contract_term_months 相差超过 1 个月直接抛错；
• 同一 hook：合同激活后不允许把 end_date 往前改（"Cannot shrink end_date … after activation"）；
• contract_status_progression 状态机（contract.object.ts:257-275）：draft 不能直接跳 activated，expired / terminated 都是终态。

4. 「给销售代表的提示」教销售代表做他无权做的事（:129-132）

页面写：「当报价被接受、你创建合同时，商机链接会被预填——保留它；它驱动售后报表。」

两处都不成立：

• src/profiles/sales-rep.profile.ts:52 上 crm_contract 是 allowCreate: false, allowEdit: false —— 销售代表既不能建也不能改合同（sales-manager 也是 allowEdit: true 但 allowDelete: false；只有 admin 能建能改能删）。这条提示整段的前提就不成立。
• 没有任何地方预填这个链接：crm_contract.crm_opportunity 只有 dependsOn: ['crm_account']（把选择器按客户过滤），没有 defaultValue；grep -rn "crm_contract" src/actions/ src/flows/ 除两条合同 flow 外只有 demo-bootstrap 的一行导航配置——没有任何 action 或 flow 从报价/商机创建合同。

顺带：同页「共享」小节写「合同所有者 读取并编辑自己的合同」，对销售代表同样不成立（allowEdit: false）——记录级共享放开了也过不了对象级的 CRUD 门。这一句要不要一起改，看维护者判断（它属于 #549 的邻域）。

影响

第 1、2 条是「在界面上找不到」型，读者照做会卡住；第 4 条更重一点，是「教读者去做一件权限层直接拒绝的事」，而且提示语气是肯定的（"保留它；它驱动售后报表"）；第 3 条第三句属于「以为有护栏」——管理员照着它以为已激活的合同删不掉，实际 admin 一键就能删。

修法建议

以 src/views/contract.view.ts、src/objects/contract.object.ts、src/objects/_picklists.ts、src/objects/contract.hook.ts、src/profiles/*.profile.ts 为事实来源改这四处（三语）。列表视图一节建议按 #792 在 sales-list-view-rosters 里的做法重写成「一份数据 + 四种可视化」。不为散文加钉子测试。

⛔ 不要改 src/** —— 要不要真加 Custom 计费周期 / Net 45 / Prepaid、要不要给已激活合同加删除护栏、要不要放开销售代表建合同的权限，都是产品决定；若确定要做，另开实现单。

Refs #826 #805 #792 #796 #549