diff --git a/docs/technical/【技术设计】泥点三池与会员计费后端设计-2026-10-02.md b/docs/technical/【技术设计】泥点三池与会员计费后端设计-2026-10-02.md
index b23958b0e..38420eef9 100644
--- a/docs/technical/【技术设计】泥点三池与会员计费后端设计-2026-10-02.md
+++ b/docs/technical/【技术设计】泥点三池与会员计费后端设计-2026-10-02.md
@@ -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`。