Repository navigation
content/docs/guides/email-and-calendar.mdx 的 "Log a Call" 段仍描述 #592 之前的写入行为（只写 sys_activity，没有 event/参会人） #738
Description
Activity
认领:PM 循环(17.0 发布修复线)第 6 轮
会话:session_01VHrPAGEgFDoHjphqYG4BMa
分支:claude/issue-738-email-calendar-log-call
Worktree:hotcrm-issue-738
文件面:content/docs/guides/email-and-calendar.mdx(+zh 页若存在)、changeset。⛔ 不动 sales/ 下各页(#752 同轮在飞于 opportunities.mdx)。派发注记:以 #737 落地的 meetings-and-calls 页与 src/ 实测为准修正 Log a Call 段(#592 后写 event + attendee + sys_activity 指针);正文列的另两处待核实项(仪表盘活动指标、连接器能力段)逐一实测后同 PR 处理或说明不改的理由。
Generated by Claude Code
验收 ACCEPT(PM 复核,对照 GitHub 实况):PR #755,关键检查全绿,已转 ready 并挂自动合并。
复核要点:
- Log a Call 三写路径按
global.actions.ts行号级实测改写,完整模型交给 meetings-and-calls 互链不复制。 - 两处待核实项双双证伪:活动指标只在 Sales Activity 仪表盘(逐仪表盘清点数据集绑定);连接器散文在 src/ 与平台侧均无任何实现(plugin-email 仅出站、无 bounced 状态、默认 LogTransport)。
- 「标注 (not shipped yet) vs 删段」的处置 PM 背书 A(标注):两处房内先例(mobile.mdx callout、whats-new 的 Honest about what's in the box)已定此类问题的答案,不过升级门槛;dev 不阻塞、留一句话否决口的做法正确。维护者若倾向直接删段,在 PR 或本单说一声即可,一次 sed 的事。
- 同页附带断言(Send Email 注册面/状态集、AI 只起草不发送、幽灵隐私操作、孤儿段落)全部按实测校正;三语一致由 locale callout 守卫盯住(真实反向验证,且 dev 明说散文断言无门禁、不编造红绿故事 —— 诚实)。
- 衍生:guides/integrations.mdx 把 10 类连接器列为「Built-in」、guides/index.mdx 仍把邮件页描述为 Gmail/Outlook 双向同步——仓库里没有任何连接器元数据 #756(integrations.mdx 十类连接器标 Built-in + guides/index 描述行,同类缺陷)已立单入队;zh mobile 页悬空锚点第二实例按查重纪律追评到 sla-and-escalation 三语都链到 /docs/administration/automation#case-escalation，而 automation 页没有这个锚点 #749 而非孪生立单。
Generated by Claude Code
- Log a Call 三写路径按
- added a commit that references this issue
on Aug 10, 2026
发现于 #672 / PR #737 的实施过程中（该 PR 的文件面只允许新增页面，不允许改既有 docs 页），故单独记录。
现状
content/docs/guides/email-and-calendar.mdx:74：这正是 #592 / PR #670 修掉的那个旧行为。当前落地的
log_call（src/actions/global.actions.ts）一次写三样东西：crm_event（主题、类型、状态held、开始时间、时长、地点、备注、负责人、related_to_*关联）；crm_event_attendee（发起人为组织者，回复accepted；联系人/线索目标记录自身；表单选中的联系人与同事）；sys_activity仅作为统一时间线的指针（ADR-0052source_object='crm_event'/source_id），metadata里不再塞参会人名单。同段还有两处需要一并核实（本 issue 未下结论）：
event_metrics数据集驱动，落在 Sales Activity 仪表盘上（src/dashboards/activity.dashboard.ts）；Sales / Service 两个仪表盘是否真有活动 tile 需按元数据逐条核对。建议
改写 "Log a Call" 段，指向新落地的
content/docs/sales/meetings-and-calls.mdx（PR #737 新增，含 zh-Hans / zh-Hant），避免同一件事在两页各说一套；顺带处理上面两条核实项。三个语言版本同改。注意：PR #737 新增的
test/docs-object-coverage.test.ts不检查这一页——它只保证「每个crm_*对象都有一页用户文档」，散文里的事实断言不在它的射程内。这类「散文描述与落地行为不符」目前仍无门禁覆盖。