User docs for crm_event / crm_event_attendee — AGENTS.md requires content/docs for every new object (follow-up to #592)

[os-zhuang]

Follow-up to #592 / PR #670。AGENTS.md 的 Coding Standards 要求「每个新对象/功能都要有 content/docs/ 下的用户文档(面向业务用户与管理员)」;#670 新增了两个用户可见对象但未随单交付文档 —— 该项不在派单文件面内,且没有任何 CI 门禁覆盖这条规则(这正是它能滑过去的原因)。

要做的

1. 新增活动模型的用户文档(建议 content/docs/sales/activities.mdx + zh-Hans/zh-Hant),覆盖:
   • 在 lead/contact/account/opportunity/case 上 Log a Call / Log a Meeting / Schedule a Meeting 的操作路径;
   • planned vs held 的语义(只有 held 刷新客户接触时点 —— 这是 Activity model: first-class meetings/events + call logging on every sales object #592 刻意的设计,文档必须把它讲对);
   • 参会人是可查询记录(junction),不再是 JSON;
   • last_activity_date / last_contacted_date 由哪些动作刷新(call/meeting held/email/task 完成)。
2. 措辞遵守 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 的定调:统一「AI assistant」,不引入人格化 Copilot 称呼。
3. 与 content/docs/analytics/dashboards.mdx describes tiles that no dashboard ships (near-total drift, plus a fabricated usage stat) #610(dashboards.mdx 重写)协调:Sales Activity 仪表盘的 tile 列表属于 content/docs/analytics/dashboards.mdx describes tiles that no dashboard ships (near-total drift, plus a fabricated usage stat) #610 的重写范围,本 issue 不要抢写,避免两单冲突 —— content/docs/analytics/dashboards.mdx describes tiles that no dashboard ships (near-total drift, plus a fabricated usage stat) #610 已标注 Blocked-by Activity model: first-class meetings/events + call logging on every sales object #592,两单顺序由下次 PM 循环排。
4. 顺手评估:给「新用户可见对象必须有 content/docs 页面」加一条 drift 守卫(test/docs-drift.test.ts 或 metadata-references 一族),把 AGENTS.md 的这条要求从约定升级为强制 —— 声明即强制。

Filed unassigned(PM 循环当前处于暂停态,由下次循环取用)。

[yinlianghui]

认领:PM 循环(17.0 发布修复线)第 4 轮
会话:session_01VHrPAGEgFDoHjphqYG4BMa
分支:claude/issue-672-activity-docs
Worktree:hotcrm-issue-672
文件面:新增 content/docs/sales/activities.mdx + zh-Hans/zh-Hant 两个语言页、「新用户可见对象必须有 docs 页」守卫(优先新测试文件或 metadata-references 一族)、changeset。⛔ 不改既有 docs 页(#627 在飞于 forecasting.mdx)、不动 src/data/**(#671 同轮在飞)。

派发注记:正文第 3 点的与 #610 协调约束已解除(#610 英文页随 #677 落地、zh 页随 #723 落地)—— Sales Activity 仪表盘的 tile 叙述以落地后的 dashboards 页为准,不重复。措辞遵守 #612 定调(「AI assistant」,无人格化 Copilot 称呼)。held vs planned 语义(仅 held 刷新接触时点)从 src/ 元数据实测后写,不从记忆写。

---

Generated by Claude Code

[yinlianghui]

验收 ACCEPT(PM 复核,对照 GitHub 实况):PR #737,CI 9/9 绿,已转 ready 并挂自动合并。

复核要点:

• 前提修正正确:议题建议的 activities.mdx 已存在(fix(line-items): F/P expression tags, null guard, shared price-fill (#514 items 8, 3, 15) #570,写的是 Task 模型),新页落 meetings-and-calls.mdx ×3 语言 + meta 注册,既有页零字节改动(Forecasting guide says attainment has "no dedicated field", but crm_forecast.attainment_pct is one #627 当时在飞,文件面纪律),两页以 Task/Event 对照表分工互链。
• 内容全部实测自 src/:三个活动 action 的逐对象生成、UTC 墙钟 workaround(objectstack#5061)、held 语义写成可操作动作而非含糊描述、接触时点四个写入者按钩子实测列出(含 account.hook 非互动来源的管理员注记)、删除行为按 fix(event-attendee): cascade the attendee row when its contact, lead or user is deleted (#711) #718 后的现状、参会人可见性按 controlled_by_parent children are readable regardless of parent access — contacts and quote line items reach every holder of object read (measured) #694 已落地事实——docs 描述已发货行为的姿态贯彻到位。
• 守卫判据论证过硬:「全部 crm_* 对象」而非「导航可达」——attendee 无 tab 但在报错/相关列表中真实可见,正是本守卫的存在理由;防白嫖(API 参考表不算数)、防前缀误匹配(crm_event 不被 crm_event_attendee 满足——quote/line_item 同理会咬)、guard-the-guard;17/17 对象落账无 allowlist。三方向反向验证全中。
• 衍生:content/docs/guides/email-and-calendar.mdx 的 "Log a Call" 段仍描述 #592 之前的写入行为（只写 sys_activity，没有 event/参会人） #738(email-and-calendar 的 Log a Call 段描述 Activity model: first-class meetings/events + call logging on every sales object #592 前行为)、content/docs/sales/activities.mdx 与事件模型对账：把「活动 = Task 记录」讲窄了，并承诺了 crm_opportunity 上并不存在的 last activity date 字段 #739(activities.mdx 三处过时 + index 表缺漏)已立单并分诊入队;「Copilot 人格化用语」正确判定为 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 既有覆盖不重复立单;case 头部只列 Log a Call 查为 changeset 明写的刻意取舍,不报——三类处置各得其所。

---

Generated by Claude Code