1

docs/technical/MY_TAB_ACCOUNT_RECHARGE_IMPLEMENTATION_2026-04-25.md

@@ -6,33 +6,33 @@
 
 本轮在“我的”页面的“会员充值”入口落地账户充值弹窗，包含两个页签：
 
-1. `光点充值`
+1. `泥点充值`
 2. `会员卡充值`
 
 前端只负责展示与发起购买，套餐、价格、赠送规则、会员权益、生效时间、钱包余额与交易流水统一由 `server-rs` 后端返回。普通 H5 / 本地联调继续使用 `mock` 渠道：创建订单后立即写入余额或会员状态，并返回最新账户中心快照。微信小程序 web-view 使用 `wechat_mp` 渠道：创建订单时只写入 `pending` 订单并返回小程序 `wx.requestPayment` 参数，真实到账以后端微信支付通知为准。
 
 ## 2. 产品规则
 
-### 2.1 光点充值套餐
+### 2.1 泥点充值套餐
 
-| productId     | 光点 | 金额分 | 徽标     | 说明           |
+| productId     | 泥点 | 金额分 | 徽标     | 说明           |
 | ------------- | ---: | -----: | -------- | -------------- |
-| `points_60`   |   60 |    600 | 首充双倍 | 首充送60光点   |
-| `points_180`  |  180 |   1800 | 首充双倍 | 首充送180光点  |
-| `points_300`  |  300 |   3000 | 首充双倍 | 首充送300光点  |
-| `points_680`  |  680 |   6800 | 首充双倍 | 首充送680光点  |
-| `points_1280` | 1280 |  12800 | 首充双倍 | 首充送1280光点 |
-| `points_3280` | 3280 |  32800 | 首充双倍 | 首充送3280光点 |
+| `points_60`   |   60 |    600 | 首充双倍 | 首充送60泥点   |
+| `points_180`  |  180 |   1800 | 首充双倍 | 首充送180泥点  |
+| `points_300`  |  300 |   3000 | 首充双倍 | 首充送300泥点  |
+| `points_680`  |  680 |   6800 | 首充双倍 | 首充送680泥点  |
+| `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` 六个档位。全部档位参与首充双倍：用户历史上没有 `points_recharge` 流水时，本次购买到账泥点为基础泥点与等额赠送泥点之和；已有充值流水后只到账基础泥点。实际到账泥点写入交易流水，余额以 SpacetimeDB projection 为准。
 
 ### 2.2 会员卡套餐
 
 | productId       | 类型 | 天数 | 金额分 | 权益                              |
 | --------------- | ---- | ---: | -----: | --------------------------------- |
-| `member_month`  | 月卡 |   30 |   2800 | 免光点回合数100，每日签到加成0%   |
-| `member_season` | 季卡 |   90 |   7800 | 免光点回合数100，每日签到加成100% |
-| `member_year`   | 年卡 |  365 |  24800 | 免光点回合数100，每日签到加成210% |
+| `member_month`  | 月卡 |   30 |   2800 | 免泥点回合数100，每日签到加成0%   |
+| `member_season` | 季卡 |   90 |   7800 | 免泥点回合数100，每日签到加成100% |
+| `member_year`   | 年卡 |  365 |  24800 | 免泥点回合数100，每日签到加成210% |
 
 购买会员时，如果当前会员仍有效，则从当前到期时间顺延；如果已过期或从未购买，则从当前服务端时间开始计算。状态只区分 `普通` 与已生效会员，前端不自行推断。
 
@@ -42,8 +42,8 @@
 
 需要 Bearer JWT。返回：
 
-1. 当前光点余额、会员状态、到期时间
-2. 光点套餐与会员套餐
+1. 当前泥点余额、会员状态、到期时间
+2. 泥点套餐与会员套餐
 3. 会员权益表
 4. 最近订单摘要
 
@@ -65,8 +65,8 @@
 1. 校验 `productId`
 2. `paymentChannel = "mock"` 时后端创建已支付订单
 3. `paymentChannel = "wechat_mp"` 时后端创建待支付订单，并调用微信支付 JSAPI 下单生成小程序支付参数
-4. mock 光点套餐立即写入钱包余额与流水，mock 会员套餐立即写入会员状态
-5. wechat_mp 订单不提前发光点或会员，只返回待支付订单、账户中心快照与 `wechatMiniProgramPayParams`
+4. mock 泥点套餐立即写入钱包余额与流水，mock 会员套餐立即写入会员状态
+5. wechat_mp 订单不提前发泥点或会员，只返回待支付订单、账户中心快照与 `wechatMiniProgramPayParams`
 
 兼容路径：`POST /api/runtime/profile/recharge/orders`
 
@@ -113,15 +113,15 @@
 
 1. “我的”页会员充值按钮打开独立弹窗，不在当前面板下方展开。
 2. 弹窗顶部标题为 `账户充值`，右上角关闭。
-3. 默认打开 `光点充值`，可切换到 `会员卡充值`。
+3. 默认打开 `泥点充值`，可切换到 `会员卡充值`。
 4. 点击套餐后调用下单接口，按钮进入处理中状态；小程序环境走 native 支付页拉起 `wx.requestPayment`，支付页返回后刷新 `profileDashboard`。
-5. 弹窗内不写大段说明文案，只保留必要金额、光点、会员权益和状态反馈。
+5. 弹窗内不写大段说明文案，只保留必要金额、泥点、会员权益和状态反馈。
 6. 会员卡充值区以套餐卡片优先展示周期、价格和处理状态；移动端单列，桌面端三列，权益表允许横向滚动，避免小屏挤压。
 
 ## 5. 验收
 
-1. 普通用户打开弹窗能看到光点与会员套餐。
-2. 光点购买后余额增加，流水来源为 `points_recharge`。
-3. 首充赠送只在首次光点充值时生效。
+1. 普通用户打开弹窗能看到泥点与会员套餐。
+2. 泥点购买后余额增加，流水来源为 `points_recharge`。
+3. 首充赠送只在首次泥点充值时生效。
 4. 会员购买后会员状态与到期时间立即更新。
 5. 移动端弹窗单列可滚动，桌面端接近参考图卡片网格。