ok

plans/refer-earn_doc_update_ea5b425e.plan.md

@@ -0,0 +1,47 @@
+---
+name: refer-earn doc update
+overview: 基于浏览器实测（数字随汇率浮动、佣金计算器拆解、分享弹窗细节），更新 docs/推荐返佣需求文档.md，补全「1498.87 的来源与性质」「邀请奖金解锁机制」「佣金计算器」「立即邀请分享弹窗」四块内容。
+todos:
+  - id: invite-bonus
+    content: 更新 §3.3/§3.4：1498.87 = 1500 USDT 基准÷汇率，性质为每位好友锁定奖金上限，配置存整数 USDT
+    status: completed
+  - id: calculator
+    content: 新增佣金计算器章节：入口/路由、输入项、输出口径、实测样例数据表
+    status: completed
+  - id: share-modal
+    content: 补全立即邀请分享弹窗：社交渠道、推荐链接/二维码/推荐码+复制
+    status: completed
+  - id: usdt-fx
+    content: §5 补 USDT 基准币 + 汇率折算导致展示浮动；§6 配置项补基准额/解锁速率/上限
+    status: completed
+  - id: open-questions
+    content: §7 补充邀请奖金解锁公式与上限、计算器与费率表一致性 待确认项
+    status: completed
+isProject: false
+---
+
+# 更新推荐返佣需求文档
+
+仅修改 [docs/推荐返佣需求文档.md](docs/推荐返佣需求文档.md) 一个文件，把本轮浏览器实测结论补进去。无代码改动。
+
+## 关键实测结论（写入依据）
+
+- 重载页面后数字变化：邀请奖金 `1498.87 → 1499.01`、EXP `4,996.27 → 4,996.71`。证实「整数基准 + 实时汇率」模型。
+- 佣金计算器输出 `US$ ≈ USDT`，证实**基准币为 USDT**，USD 为汇率折算、随汇率浮动。
+- `1498.87 ≈ 1500 USDT / 实时汇率`，是**每位被邀请好友可解锁的邀请奖金上限（单人 + 上限）**，非即时白送。
+- 计算器实验（Lv9 / 老虎机 / 存款 0，USD）：下注 1万→144.96、10万→1,174.86、100万→10,699.47；存款 1000 额外 +50.00（=5%，确认 Lv9 存款奖金率）。
+- 按 Lv9 老虎机团队 A 佣金 1%（100/10k）拆分，剩余 ≈45/175/699 随投注增长但边际递减 → 符合「锁定邀请奖金按投注解锁且封顶」模型（精确曲线待产品确认）。
+
+## 文档改动点
+
+- **§3.3 / §3.4（邀请奖金）**：明确 `1498.87` = `1500 USDT 基准 ÷ 实时汇率`，性质为「每位好友锁定奖金上限」，由该好友投注逐步解锁；落地配置应存整数基准（USDT），展示层做汇率折算，不得硬编码 `1498.87`。
+- **新增 §3.x 佣金计算器**：记录入口（可领奖金卡片左侧计算器图标，路由 `/refer-earn-calc`）、输入项（我的代理级别 Lv1–Lv9、朋友货币类型、朋友存款金额、朋友赌注分类、朋友下注金额）、输出（预期奖金 `US$ ≈ USDT`）、口径（= 存款奖金 + 投注佣金 + 解锁的邀请奖金），并附本轮实测样例数据表。
+- **补全 §3.4「立即邀请」分享弹窗**：标题「分享到」，社交渠道 Facebook / WhatsApp / LINE / Messenger / Telegram / X / Email；推荐链接 `https://vpgame1.vip/?c=<推荐码>`、推荐二维码、推荐代码（如 `aP53Alj`）+ 复制按钮。
+- **§5 业务规则**：补「金额基准币为 USDT，前端按实时汇率折算为展示币种，故展示值会随汇率浮动」。
+- **§6 落地建议**：`referral_global_config` 增加「邀请奖金基准额（USDT 整数）、单人解锁速率、单人解锁上限」；明确展示层汇率折算职责。
+- **§7 待确认**：把「邀请奖金单人解锁公式与上限（实测 1M 投注仅解锁约 699，未达 1500 上限，曲线疑似边际递减）」「各等级/各游戏类型佣金率与计算器是否完全一致」列为重点对齐项。
+
+## 验证
+
+- 文档为 markdown，无 PHP 改动，不触发后端校验门禁。
+- 自查：保留原文档结构与已有表格，新增内容与实测数据一致、单位标注（USD/USDT/每10k）清晰。