Files
junhong_cmp_fiber/openspec/changes/bound-outbox-event-identifiers/proposal.md
break 7aa03e91fb
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 8m25s
修复
2026-08-07 18:00:15 +08:00

24 lines
968 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## Why
卡与设备停复机生成的业务观测 Outbox 事件 ID 超过数据库 64 字符上限,导致上游操作后本地事务回滚;同一观测链路的网络、流量事件也存在相同隐患。
## What Changes
- 为业务观测可靠事件生成不超过公共 Outbox 上限的稳定事件 ID并保持重试幂等。
- 在公共 Outbox 持久化边界提前校验事件 ID 与父事件 ID避免以 PostgreSQL 字段错误暴露契约违规。
- 覆盖卡停复机、设备停复机、网络状态变化和流量正增量四条已确认风险路径。
## Capabilities
### New Capabilities
无。
### Modified Capabilities
- `asset-device`: 卡与设备控制及其后续业务观测应使用合法、稳定的可靠事件标识,不因标识超长回滚本地事务。
## Impact
影响卡与设备停复机、卡网络与流量观测、公共 Outbox Repository不改变 API、数据库 Schema 或第三方契约,不新增依赖。