多渠道通知与钉钉私聊产品需求文档（PRD）
1. 文档信息
| 项目 | 内容 |
|---|---|
| 版本 | V0.2 |
| 更新日期 | 2026-10-14 |
| 产品范围 | Plane 钉钉企业机器人一对一消息与现有通知能力 |
| 第一批交付身份 | e7ff8a26-65a7-4ea1-a06e-7e39a62b7398 |
| 任务事实源 | Linear wenjingai / AutoDev；Symphony 执行；GitLab 与外部 CI 发布 |
| 基线源码 | Plane 77cf8dd9c4576566dd44b780f5fb24da7d6120da |
用户在项目对话中批准第一批本人相关钉钉消息实施。批准范围不包含通知视图。 本页定义产品目标；精确事件、接收人、事务与去重合同由领域合同拥有。 新增目标未经对应源码、发布和运行证据不能称为已上线。
2. 背景与目标
当前 notification kernel 登记指派和提及两类事件；实际受管投递为钉钉单聊， 站内和邮件保留其既有业务链路。本次让已主动启用钉钉的用户收到轮到自己验收、被退回、 阻塞变化、直接回复和日期变更，减少需要反复进入 Plane 检查的工作。 钉钉只表达 Plane 已提交的事实，不能成为业务状态、验收、执行或权限事实源。
旧 Epic、Plane Run、AutomationReview 与项目 Run 摘要已退役；本次不恢复其事件或 UI。 既有普通站内/邮件能力不统一迁移；不创建另一个通知系统。
3. 用户与关系
“关于本人”由当前 Issue assignee、有效人类阶段责任、明确 mention 或被直接回复评论的作者关系确定。 普通 Project membership、关注或创建者身份本身不产生第一批提醒。 Workspace Admin 管连接/绑定和诊断，Project Admin 管本项目规则，用户只管理自己的设置。 所有关系、访问权、connection/binding generation 在实际发送前重验。
4. 批次范围
| 新增消息 | 用户结果 |
|---|---|
| 轮到我验收 | 原生专业/测试验收进入活动或责任改为我时，收到阶段和事项入口 |
| 我的事项被退回 | 验收明确退回要求本人重新处理时，收到已保存反馈入口 |
| 我的事项阻塞变化 | 当前负责的事项进入或解除阻塞时，获知原生状态变化 |
| 有人回复我的评论 | 别人直接回复自己的评论时，收到评论入口；同时提及只发一条 |
| 我的截止日期被修改 | 别人修改或移除本人负责事项日期时，看到前后值 |
保留既有指派和提及。五类新消息采用个人与项目独立开关，默认开启，但个人钉钉总开关、 全局发送开关、连接 readiness 和身份绑定仍是前置条件；已有关闭状态不会自动激活。
不增加通知视图、普通评论流、定时到期/逾期提醒、摘要、创建者结果、执行失败、 群消息、审批卡片、通知内业务命令或邮件 fallback。
5. 产品行为
- 自己的操作不提醒自己；有效的系统自动触发仍提醒明确责任人。bot/inactive/无访问权者不发送。
- 新回复只通知直接父评论作者，编辑不重发；回复与提及重叠时保留原因并合并发送。
- 事件发生一次、持久化 source identity 一次；请求重放/重复保存不能多发。
- 来源删除、责任转移、阶段完成、反馈被处理或日期再变更时取消过期提醒。
- 免打扰结束后重验再发送；结果不明确时保留 outcome_unknown，不能盲目重发。
- 消息含原因、Issue 编号、短标题、关键变化与可信 Plane link，不发送完整反馈/评论或秘密。
- 通知、accepted、已读或点击不推进 Issue.state、不验收、不退回、不重试执行。
6. 用户体验与权限
在已有 Profile Notifications 增加五类个人开关；在已有 Project Notifications 增加对应项目开关。 沿用现有连接、绑定、免打扰、加载、保存、错误、权限与诊断界面。 支持 en/zh-CN、键盘和现有响应式布局，不重排无关设置或新增视图。 设置 API 与 types/service/UI 同一 revision 更新；其它成员的手机号、provider identity、secret 不公开。 详见API 与产品体验。
7. 非功能要求
复用现有 notification event/outbox、唯一 delivery、追加 attempt、单用户 Provider request、 Celery routing/sweeper、有界 retry 与脱敏诊断。业务事实和 notification event 同事务提交。 受影响 contract clean break；历史保留，不重放、不双写、不增加 alias、旧参数映射或过渡开关。 渠道与投递拥有身份、连接与投递合同。
8. 验收与发布
精确验收行为及交付步骤见实施与交付。 未授权新增/扩写测试；验证只由外部 CI Runner 执行。代码、设置、migration、文案与文档均需源码审查， fresh-base MR、exact-head CI 和 SHA guard 合并。Plane 功能需对应版本 TEST 验收及 PROD 版本/健康 外部证据后才能进入 Linear In Review；wjai 保留人工产品验收与 Done。
本地验证：根据项目策略禁止执行。