文档(会员计费):同步 granted_points_delta 改 u64 与 wire token 枚举

- membership_granted_points_delta 列类型文档由 i64 更新为 u64
- 补充 shared-contracts 新增四个会员 wire token 枚举及其与模块枚举的映射说明
This commit is contained in:
2026-10-04 11:59:05 +08:00
parent d7dec9b475
commit 75766824f6
@@ -133,7 +133,7 @@ pub struct ProfileMembershipPlan {
| `membership_cycle_kind_after` | `Option<RuntimeProfileMembershipCycleKind>` | `None` | 变更后周期 |
| `membership_period_points_before` | `Option<u64>` | `None` | 变更前每期额度 |
| `membership_period_points_after` | `Option<u64>` | `None` | 变更后每期额度 |
| `membership_granted_points_delta` | `i64` | `0` | 本次补点(进月度池的点数) |
| `membership_granted_points_delta` | `u64` | `0` | 本次补点(进月度池的点数);与报价侧 `ProfileMembershipUpgradeQuoteResponse.granted_points_delta` 一致 |
| `membership_cycle_index` | `Option<u32>` | `None` | 变更时所在期数 |
| `membership_expires_at_before` | `Option<Timestamp>` | `None` | 变更前到期 |
| `membership_expires_at_after` | `Option<Timestamp>` | `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`