Files
cursor/plans/refer-earn_doc_update_ea5b425e.plan.md
ray zhou 2dd9f17da9 ok
2026-06-29 14:51:55 +08:00

48 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
name: refer-earn doc update
overview: 基于浏览器实测(数字随汇率浮动、佣金计算器拆解、分享弹窗细节),更新 docs/推荐返佣需求文档.md补全「1498.87 的来源与性质」「邀请奖金解锁机制」「佣金计算器」「立即邀请分享弹窗」四块内容。
todos:
- id: invite-bonus
content: 更新 §3.3/§3.41498.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 / 老虎机 / 存款 0USD下注 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`)、输入项(我的代理级别 Lv1Lv9、朋友货币类型、朋友存款金额、朋友赌注分类、朋友下注金额、输出预期奖金 `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清晰。