From dc1d14cb9c09331d55cd12d9f3e8be34e256db3a Mon Sep 17 00:00:00 2001 From: guke Date: Fri, 7 Aug 2026 14:41:47 +0800 Subject: [PATCH] =?UTF-8?q?docs(coin-ledger):=20=E8=87=AA=E6=9F=A5?= =?UTF-8?q?=E8=A1=A5=E5=85=85=E5=88=86=E7=BB=84=E9=94=AE=20biz=5Ftype=20?= =?UTF-8?q?=E9=97=A8=E6=8E=A7=E4=B8=8E=20trace=20=E5=94=AF=E4=B8=80?= =?UTF-8?q?=E6=80=A7=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 (1M context) --- .../specs/2026-08-07-coin-ledger-aggregate-ad-rewards-design.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/superpowers/specs/2026-08-07-coin-ledger-aggregate-ad-rewards-design.md b/docs/superpowers/specs/2026-08-07-coin-ledger-aggregate-ad-rewards-design.md index 580bc65..72a979d 100644 --- a/docs/superpowers/specs/2026-08-07-coin-ledger-aggregate-ad-rewards-design.md +++ b/docs/superpowers/specs/2026-08-07-coin-ledger-aggregate-ad-rewards-design.md @@ -104,6 +104,8 @@ LIMIT :limit; 非分组类型、`trace_id` 为空的旧广告行 → 各自成组（`'I:'||id`），行为与现状完全一致。 +> 说明（分组安全性）：分组键按 `biz_type` **门控**——通用 `feed_ad_reward`（福利/旧端）即便偶带 trace_id 也走 `'I:'||id` 保持每条一行，只有比价/领券两类才按 trace_id 合并。trace_id 由后端按会话签发、全局唯一（一个 trace = 一次比价**或**一次领券），故仅按 trace_id 分组不会把两类混并，代表行的 `biz_type` 唯一确定展示标题。 + ## 7. 接口契约 `GET /api/v1/coin-transactions` 响应新增 `merged_count`（`CoinTransactionOut` 加字段，Pydantic 默认 1）：