remove(plugin-audit): drop kernel-built-in assignment notifications (#3403)

[baozhoutao]

Closes#3403. Takes over and closes#3402.

背景

上传文件会刷「系统文件 "xxx" 已分配给你」噪音通知(#3402)。根因:分配通知作为全局行为硬编码在 plugin-audit 的 afterInsert/afterUpdate 钩子(writeAssignmentNotifications),靠字段名启发式(OWNER_FIELDS 含 owner_id)猜「负责人」,把 sys_file.owner_id(存储层 ACL 归属)误判成业务指派;sys_file 由存储服务裸引擎写库(actorId=null)穿透自我分配守卫,多次写库(pending→committed)重复刷屏。

经维护者讨论,结论是问题不在缺一个跳过名单或开关,而在这个功能放错了层。

决策

移除内核内置分配通知,「分配通知」回归用户态:平台只提供机制(记录变更触发器 + notify 节点 + 消息模板),通知策略由应用/管理员用自动化流程按需配置,文案可自定义。业界同类产品(Salesforce / ServiceNow / Odoo)均为「机制内置、策略配置」,且没有平台对文件/附件等系统记录发分配通知。

改动

• audit-writers.ts — 删 writeAssignmentNotifications、OWNER_FIELDS、pickOwner 及 writeAudit 内调用点(含 makeTitle)。保留sys_audit_log/sys_activity 写入、@mention 通知(writeCommentMentions)。
• translations/messages.ts — 删 en/zh-CN/ja-JP/es-ES 四处 assignedToYou key(mentionedYou 等保留)。TranslationData['messages'] 是开放 z.record,非枚举,spec 无需改。
• audit-writers.test.ts — 删两条 assignment 用例,补一条回归用例「设置 owner 字段不再产生 collab.assignment」。全套 44 passed。
• recipient-resolver.ts — DEFAULT_OWNER_FIELDS 注释更新;owner_of: audience 是独立、调用方显式请求的机制,保留。
• 设计文档(notification-platform-convergence.md / adr-0030-notification-convergence.md)assignment 段落加废弃标注,历史不重写。
• changeset(minor + FROM→TO 迁移) — 想保留分配通知的用户,按 showcase_task_assigned_notify 范例给目标对象配一条 record-after-update + notify 流程。

迁移(FROM → TO)

{id: 'start',type: 'start',config: {objectName: 'your_object',triggerType: 'record-after-update',condition: 'assignee != previous.assignee',}},{id: 'notify_assignee',type: 'notify',config: {topic: 'task.assigned',recipients: ['{record.assignee}'],channels: ['inbox'],title: 'New assignment: {record.title}',actionUrl: '/your_object/{record.id}',}},

真机验证(showcase :3377,真实运行,REST API 驱动)

全量 build(71/71),plugin-audit/dist grep collab.assignment = 0。

场景	操作	结果
#3402 本体	完整上传三步,sys_file.owner_id=admin、committed	✅ 0 条 collab.assignment、0 条「已分配给你」/文件噪音
业务对象分配	PATCH task assignee→admin(owner_id 亦为 admin)	✅ 内核未发铃铛
替代路径	同一次 assignee 变更	✅ 范例流程 showcase_task_assigned_notify 照常触发,收件箱「New task assigned」
保留功能	发带 mention 的评论	✅ collab.mention 正常产生

最终 sys_notification topic 分布:collab.mention:1, project.digest:4, task.assigned:1 —— 无 collab.assignment。

验收

• 上传文件不再产生任何「已分配给你」通知(上传文件后收到大量「系统文件 xxx 已分配给你」噪音通知 #3402 现象消失,sys_saved_report/sys_report_schedule 同类潜在噪音一并消除);
• 业务对象 owner/assignee 变更默认不再自动发铃铛;showcase 范例流程照常可发;
• plugin-audit 测试更新后全绿;changeset 携带迁移说明。

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
spec	Ready	Preview, Comment	Jul 22, 2026 8:03am

[github-actions]

📓 Docs Drift Check

This PR changes 2 package(s): @objectstack/plugin-audit, packages/services.

9 hand-written doc(s) reference the affected code and may need an implementation-accuracy re-verification:

• content/docs/automation/webhooks.mdx(via packages/services)
• content/docs/deployment/production-readiness.mdx(via @objectstack/plugin-audit)
• content/docs/getting-started/cli.mdx(via @objectstack/plugin-audit)
• content/docs/kernel/runtime-services/audit-service.mdx(via packages/services)
• content/docs/kernel/runtime-services/index.mdx(via packages/services)
• content/docs/kernel/runtime-services/settings-service.mdx(via packages/services)
• content/docs/plugins/packages.mdx(via @objectstack/plugin-audit, packages/services)
• content/docs/protocol/kernel/i18n-standard.mdx(via packages/services)
• content/docs/releases/implementation-status.mdx(via @objectstack/plugin-audit)

Advisory only. To re-verify, run the docs-accuracy-audit workflow scoped to these files:
node scripts/docs-audit/affected-docs.mjs origin/main → pass the list as args.docs.