feat: 支持充值商品配置和档位首充

docs/technical/MY_TAB_ACCOUNT_RECHARGE_IMPLEMENTATION_2026-04-25.md

@@ -24,9 +24,13 @@
 | `points_1280` | 1280 |  12800 | 首充双倍 | 首充送1280泥点 |
 | `points_3280` | 3280 |  32800 | 首充双倍 | 首充送3280泥点 |
 
-泥点充值固定为 `¥6 / ¥18 / ¥30 / ¥68 / ¥128 / ¥328` 六个档位。全部档位参与首充双倍：用户历史上没有 `points_recharge` 流水时，本次购买到账泥点为基础泥点与等额赠送泥点之和；已有充值流水后只到账基础泥点。实际到账泥点写入交易流水，余额以 SpacetimeDB projection 为准。
+泥点充值默认初始化 `¥6 / ¥18 / ¥30 / ¥68 / ¥128 / ¥328` 六个档位。默认档位只作为空库种子写入 `profile_recharge_product_config`，运行时充值中心展示、下单校验和支付确认结算都以 SpacetimeDB 配置表为准，不再把代码中的商品目录作为业务真相源。
 
-充值中心返回的 `hasPointsRecharged` 是首充资格的展示与结算共同依据：当它为 `true` 时，后端下发的泥点套餐应只保留基础泥点、清空首充徽标与赠送文案；前端即使收到旧版本快照中残留的 `bonusPoints` / `badgeLabel`，也必须按 `hasPointsRecharged` 隐藏“首充双倍”和 `基础+赠送` 展示。这样可以避免第二次充值只到账基础泥点时，弹窗仍显示 `60+60` 等已失效权益。
+全部泥点档位参与档位首充双倍：首充资格按 `productId` 独立判断。用户购买过 `points_60` 后，再次购买 `points_60` 只到账基础泥点；但 `points_180`、`points_300` 等未购买过的档位仍保留各自的首充赠送。实际到账泥点写入 `profile_recharge_order.points_delta` 与钱包流水，余额以 SpacetimeDB projection 为准。
+
+充值中心返回的 `pointProducts` 已由后端按当前账号和每个 `productId` 计算有效展示状态：已完成首充的档位清空 `bonusPoints`、`badgeLabel` 与首充说明，未完成首充的档位继续显示 `首充双倍` 和 `基础+赠送`。`hasPointsRecharged` 仅保留为兼容字段，表示账号是否发生过任一泥点充值，不再作为隐藏所有档位首充或计算结算金额的依据。前端不得再用 `hasPointsRecharged` 对所有泥点商品做统一屏蔽。
+
+后台通过“充值商品”页维护 `profile_recharge_product_config`，字段包括 `productId`、标题、商品类型、金额分、基础泥点、首充赠送泥点、会员天数、徽标、说明、会员层级、启用状态和排序。保存后新的充值中心快照、下单与支付确认立即读取配置表；历史订单继续保留下单当时写入的商品标题、金额和状态。
 
 ### 2.2 会员卡套餐
 
@@ -157,7 +161,7 @@
 
 1. 普通用户打开弹窗能看到泥点与会员套餐。
 2. 泥点购买后余额增加，流水来源为 `points_recharge`。
-3. 首充赠送只在首次泥点充值时生效。
-4. 已产生 `points_recharge` 流水后，再打开充值弹窗不应展示“首充双倍”徽标或 `60+60` 等赠送泥点组合。
+3. 首充赠送按泥点档位独立生效。
+4. 某个 `productId` 已成功完成泥点充值后，再打开充值弹窗时仅该档位不再展示“首充双倍”徽标或 `60+60` 等赠送泥点组合，其他未购买过的泥点档位仍展示各自首充权益。
 5. 会员购买后会员状态与到期时间立即更新。
 6. 移动端弹窗单列可滚动，桌面端接近参考图卡片网格。