1

docs/technical/PROFILE_REDEEM_CODE_IMPLEMENTATION_2026-04-28.md

@@ -2,9 +2,9 @@
 
 ## 1. 目标
 
-本轮在现有“我的”资料与钱包 projection 上新增兑换码能力。用户兑换成功后直接增加陶泥币余额，写入 `profile_wallet_ledger`，并同步刷新 `profile_dashboard_state.wallet_balance`。
+本轮在现有“我的”资料与钱包 projection 上新增兑换码能力。用户兑换成功后直接增加光点余额，写入 `profile_wallet_ledger`，并同步刷新 `profile_dashboard_state.wallet_balance`。
 
-管理侧本轮只提供后端 API，不新增管理后台页面。私有兑换码创建时支持内部 `userId` 与公开陶泥号两类输入，后端创建阶段统一解析成内部 `userId` 存储。
+管理侧本轮只提供后端 API，不新增管理后台页面。私有兑换码创建时支持内部 `userId` 与公开百梦号两类输入，后端创建阶段统一解析成内部 `userId` 存储。
 
 ## 2. 兑换码类型
 
@@ -26,7 +26,7 @@
 | --- | --- | --- |
 | `code` | `String` | 主键，标准化后的兑换码。 |
 | `mode` | `RuntimeProfileRedeemCodeMode` | 兑换码模式。 |
-| `reward_points` | `u64` | 单次到账陶泥币。 |
+| `reward_points` | `u64` | 单次到账光点。 |
 | `max_uses` | `u32` | 公共码为单用户上限，唯一码/私有码为全局上限。 |
 | `global_used_count` | `u32` | 全局已使用次数。公共码也记录总使用次数，但不参与公共码上限判断。 |
 | `enabled` | `bool` | 是否启用。 |
@@ -42,7 +42,7 @@
 | `usage_id` | `String` | 主键，格式 `redeem:{code}:{user_id}:{micros}:{sequence}`。 |
 | `code` | `String` | 兑换码。 |
 | `user_id` | `String` | 兑换用户。 |
-| `amount_granted` | `u64` | 到账陶泥币。 |
+| `amount_granted` | `u64` | 到账光点。 |
 | `created_at` | `Timestamp` | 兑换时间。 |
 
 索引：`code`、`user_id`、`(code, user_id)`。
@@ -121,7 +121,7 @@
 
 “我的”页头像右侧入口由 `会员充值` 改为 `兑换码`。点击打开独立模态窗口，窗口内只保留输入框、兑换按钮和后端返回提示，不展示兑换规则说明。
 
-成功后展示 `已到账 X 陶泥币`，并刷新 profile dashboard。失败后直接展示后端 `message`。
+成功后展示 `已到账 X 光点`，并刷新 profile dashboard。失败后直接展示后端 `message`。
 
 ## 8. 测试矩阵