From 75766824f6ae1939ffea456104f3b115363b5242 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= Date: Sun, 4 Oct 2026 11:59:05 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3(=E4=BC=9A=E5=91=98=E8=AE=A1?= =?UTF-8?q?=E8=B4=B9)=EF=BC=9A=E5=90=8C=E6=AD=A5=20granted=5Fpoints=5Fdelt?= =?UTF-8?q?a=20=E6=94=B9=20u64=20=E4=B8=8E=20wire=20token=20=E6=9E=9A?= =?UTF-8?q?=E4=B8=BE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - membership_granted_points_delta 列类型文档由 i64 更新为 u64 - 补充 shared-contracts 新增四个会员 wire token 枚举及其与模块枚举的映射说明 --- .../【技术设计】泥点三池与会员计费后端设计-2026-10-02.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/technical/【技术设计】泥点三池与会员计费后端设计-2026-10-02.md b/docs/technical/【技术设计】泥点三池与会员计费后端设计-2026-10-02.md index d837d45b2..20e29c7ad 100644 --- a/docs/technical/【技术设计】泥点三池与会员计费后端设计-2026-10-02.md +++ b/docs/technical/【技术设计】泥点三池与会员计费后端设计-2026-10-02.md @@ -133,7 +133,7 @@ pub struct ProfileMembershipPlan { | `membership_cycle_kind_after` | `Option` | `None` | 变更后周期 | | `membership_period_points_before` | `Option` | `None` | 变更前每期额度 | | `membership_period_points_after` | `Option` | `None` | 变更后每期额度 | -| `membership_granted_points_delta` | `i64` | `0` | 本次补点（进月度池的点数） | +| `membership_granted_points_delta` | `u64` | `0` | 本次补点（进月度池的点数）；与报价侧 `ProfileMembershipUpgradeQuoteResponse.granted_points_delta` 一致 | | `membership_cycle_index` | `Option` | `None` | 变更时所在期数 | | `membership_expires_at_before` | `Option` | `None` | 变更前到期 | | `membership_expires_at_after` | `Option` | `None` | 变更后到期 | @@ -150,6 +150,10 @@ pub struct ProfileMembershipPlan { - 新增 `RuntimeProfileMembershipCycleKind { Monthly, Yearly }`（全新，无历史数据）。 - 新增 `RuntimeProfileMembershipModelAccess { Basic, Full }`（仅新增字段，本期不执行）。 - 新增 `RuntimeProfileMembershipChangeKind { Purchase, Upgrade }`（订单快照用，替代字符串）。 +- `shared-contracts` 新增 wire 侧 `ProfileMembershipPlanToken` / `ProfileMembershipCycleKindToken` / + `ProfileMembershipModelAccessToken` / `ProfileMembershipChangeKindToken`，把 DTO 里原来的裸 + `String`（后台 upsert 请求、订单变更快照、会员 / 档位 / 报价响应）收口为 typed enum； + 与模块枚举通过 `From` 双向映射，JSON wire 值仍是小写 token，未知 token 在反序列化阶段被拒。 - **删除** `RuntimeProfileMembershipTier { Normal, Month, Season, Year, Starter, Basic, Pro, Ultimate }` 及其 `as_str()`（会员侧零存量，用户已授权破坏性变更）。 - `RuntimeProfileWalletLedgerSourceType` **末尾追加** `MembershipUpgradeGrant`