Files
junhong_cmp_fiber/openspec/changes/archive/2026-08-11-enforce-integration-audit-links/proposal.md
break 619d0c5efe
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 51s
提案
2026-08-11 15:39:51 +08:00

1.0 KiB

Why

Integration Log 的 audit_event_id 从未由调用方写入,导致未来外部交互也无法从全局审计事件跳转至对应记录。现在将关联改为新记录的写入不变量,避免查询层继续收到空引用。

What Changes

  • 新建的 Integration Log 在审计事件可用时稳定关联该事件;关联生成失败时仍保留外部交互事实。
  • 外部调用、回调、未发送裁决与终态更新保持同一稳定关联,不以名称、时间或摘要补猜。
  • 缺少关联时记录可排查告警,不阻断 Integration Log、外部调用或回调处理。

Capabilities

New Capabilities

  • 无。

Modified Capabilities

  • operations-audit: 外部集成交互日志与审计事件的稳定关联成为新记录的必需事实。

Impact

  • internal/infrastructure/integrationlog 的写入契约与所有调用链。
  • 审计事件写入链路及 Integration Log 的创建、终态、入站回调和未发送裁决。
  • 无需为历史 Integration Log 回填数据、无需新增依赖或迁移。