Skip to main content

实施与交付

Asset
ADP-DLV-DOC-DOC-0004
Feature
dingtalk-direct-notifications
领域
delivery-integrations
文档状态
draft
文档 Owner
DOC
事实源
canonical-docs
更新
2026/10/14

第一批范围与来源​

source_id e7ff8a26-65a7-4ea1-a06e-7e39a62b7398 的唯一产品合同是本 Feature 的 领域合同。五类消息是待本人验收、退回本人处理、阻塞变化、回复本人评论、截止日期修改。 不扩展通知视图、其它渠道、普通评论、截止提醒、摘要、执行失败、群消息或审批按钮。

实现顺序​

  1. 从注册 Plane master fresh base 确定当前 mutation/producer 与阶段责任解析；复用现有 notification kernel。
  2. 在 owning issue/comment/验收事务产生稳定源事件，覆盖现有普通与 bulk 写入、业务状态与责任操作。
  3. 增加事件路由、发送前 relevance/access 重验、消息文案、deep link、回复/提及合并及有界恢复。
  4. 同步个人与项目事件开关的模型、一次性 migration、API、typed client、已有设置 UI 和 en/zh-CN。
  5. 删除直接受影响的失效入口/分支；不实现兼容映射、不回填或重放旧通知，重要历史保留。
  6. 源码审查后由外部 CI 执行既有 repo gate；处理真实失败，禁止机械更新锁定旧字面量的断言。
  7. 同一 source MR 更新 release/package.json 与 CHANGELOG，exact-head CI 通过后 SHA guard 合并； 跟踪版本对应的 native GitLab/Harbor/GitOps/Argo CD 发布至 PROD。

行为验收​

  • 原生状态进入专业或测试验收、以及在该阶段更换负责人后，提醒当前有效的人类验收负责人。
  • 专业/测试验收明确退回时，提醒当前执行责任人与 Issue assignees；不靠任意 ready 状态或评论猜测退回。
  • 当前责任人收到阻塞/解除阻塞消息，重复保存同状态不重新发送。
  • 直接回复发给父评论作者；编辑已有回复不重发；回复兼提及只发一条且关闭其中一类偏好不吞掉另一类。
  • 截止日期修改/移除展示前后值，发送给当前责任人，日期不变不发送。
  • actor 排除、inactive/bot 排除、权限与当前责任重验、免打扰、过时取消和 outcome_unknown 语义成立。
  • 个人五类设置独立生效，项目管理员可关闭项目事件；现有关闭的总开关、连接和绑定不被自动开启。
  • 新设置支持中英文、加载/保存/权限/网络失败表达；不改变通知视图与无关设置布局。
  • 不改变 Issue 业务状态或人类验收权；没有旧运行库/旧 Automation 评审事件或新执行系统。

上述是产品行为合同，不是新增测试授权。未获用户指定测试用例与输入/预期结果，不新增或扩写测试、 断言、fixture、snapshot、Mock、辅助代码或测试数据。只读检查既有测试；直接受影响且锁死退役实现的 断言可删除/收窄，不以新断言替代。测试修改如发生须逐项记录，无修改则明确说明。

外部验证与发布证据​

本地验证：根据项目策略禁止执行。

所有测试、lint、types、build、migration drift、validator、smoke 与运行观察由外部 CI Runner 执行。 来源 source/merge SHA、精确 head CI、release version/tag/commit/pipeline、bundle digest、TEST acceptance、 merged PROD GitOps MR、期望版本与 Argo/工作负载健康 observation 均记录在 Linear workpad。 源码合并或 source CI 绿色不能替代 PROD 完成；等待发布保持 In Progress，具体阻塞记录后返回 Backlog。 达到对应版本 PROD 健康证据后才进入 In Review，人工产品验收与 Done 仍由 wjai 完成。

缺少 CI 时记录无法验证，不运行本地补偿；不得用其它版本的成功记录、直接改集群/数据库或宿主自救完成交付。

Last updated on by source2728