文档(计费): 同步会员档位 rank 可失败返回说明

ADR §3 更新 runtime_profile_membership_plan_rank 签名为 Option<u8>

说明目录缺行时返回 None,不再用 unwrap_or(0) 伪装成 Normal

Co-authored-by: Junie <junie@jetbrains.com>
This commit is contained in:
2026-10-02 20:06:01 +08:00
parent 047e6d72e4
commit 51c5784c46
@@ -254,8 +254,9 @@ pub struct RuntimeProfileMembershipUpgradeQuote {
`model_access` / `concurrent_job_limit` / `sort_order` / `enabled`)。
- `resolve_runtime_profile_membership_plan_snapshot(plan, cycle_kind)`:
「档位 + 周期 → 可下单套餐」的唯一解析入口,`price_cents` 取所选周期的价格字段。
- `runtime_profile_membership_plan_rank(plan)` / `is_runtime_profile_membership_plan_purchasable(plan)`:
升级比较与可购买判定的唯一入口(`Normal` 与下架档位都不可购买)。
- `runtime_profile_membership_plan_rank(plan) -> Option<u8>` / `is_runtime_profile_membership_plan_purchasable(plan) -> bool`:
升级比较与可购买判定的唯一入口;`rank` 缺行时返回 `None`(不再用 `unwrap_or(0)` 把缺失伪装成 `Normal`),
`Normal` 与下架档位都不可购买。
`RuntimeProfileMembershipSnapshot` / `RuntimeProfileMembershipRecord`:
`tier` → `plan`(枚举),删 `cycle_period_days`,新增 `cycle_index` / `cycle_count` / `cycle_kind`。