2.0 KiB
2.0 KiB
13 — 交付请求、业务链路和外部集成时间线
What to build: 运维人员可以按 request ID 或 correlation ID 查看同一请求或完整业务链路中的 Audit Event、Integration Log、Outbox 和异步任务摘要,并可按外部提供方、操作、方向、结果、资源、场景和序列检索外部尝试。
Blocked by:
- 02 — 交付可恢复的 Integration Log 尝试闭环
- 09 — 承接手动轮询状态并记录同步外部尝试
- 11 — 交付全局事件和资源轨迹查询闭环
.scratch/tech-public-foundation/issues/02-transactional-public-outbox-write.md— 02 — 在业务事务中可靠写入公共 Outbox.scratch/tech-public-foundation/issues/06-unified-async-task-contract.md— 06 — 冻结统一异步任务五态和查询契约
Status: ready-for-agent
架构通道: Query。
完整业务边界: 本票收口请求时间线、关联时间线和 Integration Log 列表/详情查询。明确不在 API 请求中扫描本地 Access Log,不复制 Outbox/任务完整载荷,不把外部交互结果解释成业务权威状态。
- Request Timeline 组合可关联的审计事件、外部尝试、Outbox 和任务安全摘要,并返回 Access Log 检索标识而不读取日志文件。
- Correlation Timeline 以稳定 correlation 串联跨请求、回调和异步处理,
parent_event_id只表达直接因果,不替代 correlation。 - Integration 查询支持 provider、operation、方向、结果、资源、触发来源、场景、序列、尝试和时间过滤,列表默认 20、最大 100。
- 同一同步序列能够按尝试顺序连续展示立即、3 分钟、5 分钟结果,包括合并、限频和提前完成等未发送终态。
- 原始外部正文、密文、签名、附件、Outbox 载荷和任务敏感失败明细不进入普通查询 DTO。
- 真实链路测试覆盖单请求、多请求 correlation、异步传播、重复尝试、0/3/5 序列、权限隔离和常用查询索引;OpenAPI 文档同步更新。