Skip to content

PRODUCT_SPEC.md

Latest commit

 

History

History
112 lines (79 loc) · 6.55 KB

PRODUCT_SPEC.md

File metadata and controls

112 lines (79 loc) · 6.55 KB

AlphaRoute 产品说明文档

最后更新日期： 2026年4月23日

本文档基于系统核心业务代码（分润机制、跟单引擎、用户体系、资金管理等）整理，详细说明了平台各模块的业务流程、数据定义及计算公式。

1. 用户体系与层级关系

1.1 用户注册与邀请机制

  • 邀请码强制机制：新用户注册必须填写有效的邀请码。
  • 绑定关系：注册成功后，新用户永久绑定到邀请人的 referrerId 下，形成上下级层级关系。
  • 层级深度：系统支持无限层级的推荐关系网络。

1.2 有效用户定义

  • 判定标准：用户在平台的累计已审批充值金额 ≥ 100 USDT。
  • 作用：有效用户的数量仅用于计算上级节点是否满足直推奖的获取条件。用户的账户当前余额不影响其"有效用户"的身份。

1.3 用户身份与 P 级别（P1 - P7）

用户的 P 级别决定了其在"级别奖"（Rank Reward）中能获取的分润比例。

  • 业绩定义：每日 00:00（UTC+8），系统会自动通过交易所 API 读取用户绑定的所有交易所账户的 USDT 余额之和，以此作为该用户的当日业绩。
  • 伞下总业绩（Umbrella Performance）：用户自身业绩 + 其所有下级节点（包含间接下级）的业绩之和。
  • 小区业绩（Small-Zone Performance）：用于评定 P 级别的核心指标。计算公式为：伞下总业绩 - 伞下最大直推分支的业绩。即"去大区取小区"。

P 级别考核标准（基于小区业绩）：

级别 考核小区业绩门槛 分润比例（极差制）
P1 5,000 USDT 10%
P2 15,000 USDT 20%
P3 30,000 USDT 30%
P4 100,000 USDT 35%
P5 300,000 USDT 40%
P6 1,000,000 USDT 45%
P7 3,000,000 USDT 55%

注：每日 00:00 系统会自动根据最新余额快照重新计算并更新所有用户的 P 级别。

2. 资金与分润机制

2.1 平台扣费基准

当用户的跟单订单产生**已实现盈利（Realized PnL）**且净利润（Net PnL = Realized PnL - 交易所手续费）> 0 时，系统会从用户的平台 USDT 余额中扣除该净利润的 40%。

  • 分配池（20%）：用于向上级节点发放各项奖励（直推奖、级别奖、平级奖）。
  • 流动性池（20%）：沉淀为平台的流动性资金（归平台所有）。

边界条件：如果用户平台余额不足以扣除 40% 的分成，系统会最多扣减至余额为 0，随后自动暂停该用户的所有跟单策略，直至用户补充余额。

2.2 奖励分配规则

分配池的资金（占净利润的 20%）被视作 100% 的奖励基数进行分配。

2.2.1 直推奖（Direct Referral Reward）

发放给交易用户的直接邀请人。发放比例取决于直接邀请人名下的"有效直推用户"数量：

  • ≥ 9 个有效直推：获得分配池的 15%
  • ≥ 6 个有效直推：获得分配池的 10%
  • ≥ 3 个有效直推：获得分配池的 8%
  • < 3 个有效直推：不获得直推奖

2.2.2 级别奖（Rank Reward / 极差奖）

沿推荐关系链向上追溯，按照各节点的 P 级别对应的分润比例，采用**极差制（差额分配）**发放。

  • 计算方式：当前节点可获得的比例 = 当前节点的 P 级别比例 - 下方已分配的最大比例。
  • 阻断机制：当向上追溯遇到 P7 节点（比例达到 55%）或差额 ≤ 0 时，该部分分配结束。

2.2.3 平级奖（Same-Rank Reward）

沿推荐关系链向上追溯时，如果某个上级节点的 P 级别与紧邻其下方的节点 P 级别完全相同（且 P 级别 > 0），则触发平级奖。

  • 奖励金额：分配池的 10%。
  • 限制：单次分润中，平级奖在整条链路上只触发一次（即只平一级）。

3. 跟单引擎与交易执行

3.1 信号接收与解析

  • 信号源：通过 Webhook 接收外部交易信号（目前主要对接 OKX WebSocket 仓位变化）。
  • 安全验证：信号源必须配置 webhookSecret，未配置或密钥不匹配的请求将被直接拒绝。
  • 信号去重与解析：引擎会对比上一次仓位快照，自动计算出仓位变化（如：平仓旧方向、开仓新方向、加仓、减仓），并生成标准的内部交易动作（Action）。

3.2 订单执行

  • 支持交易所：Binance, OKX, Bybit, Bitget, Gate。
  • 并发控制：引擎采用分批并发执行（默认每批 20 个用户），避免触发交易所 API 频率限制。
  • 开仓价格：下单后会异步查询交易所实际成交价，并更新为订单的 openPrice。
  • 跨信号源隔离：用户可同时订阅多个信号源。平仓时，系统严格按照 signalSourceId 匹配订单，确保不同信号源的同交易对订单不会相互污染。

3.3 平仓与 PnL 计算

  • 部分平仓（Reduce）：按照 FIFO（先进先出）原则，逐个扣减历史开仓订单的可用数量。完全平掉的订单标记为 closed，未平完的订单保持 open 状态并更新剩余数量。
  • 数据真实性：平仓价格、手续费、已实现盈亏（Realized PnL）均直接调用交易所 API 获取真实数据，不进行二次估算，确保平台展示数据与交易所后台完全一致。

4. 资金充提与管理

4.1 充值（Deposit）

  • HD 钱包机制：系统通过 HD 钱包为每个用户生成唯一的 BSC (BEP-20) 充值地址。
  • 自动扫链：后台定时任务自动扫描 BSC 链上转账记录，识别 USDT 充值并自动增加用户余额。

4.2 提现（Withdrawal）

  • 提现规则：最低提现金额可配置（默认 10 USDT），提现手续费可配置（默认 1%）。
  • 自动打币：对于小于自动审核阈值（默认 50 USDT）的提现申请，系统会自动调用中心钱包私钥完成链上转账（打币）。
  • 人工审核：大额提现需管理员在后台手动审核通过后方可打币。

5. 异常处理与边界情况

  1. API 密钥失效：如果用户的交易所 API 密钥过期或权限不足，跟单将失败，订单标记为 failed 并记录错误信息，但不影响其他用户的执行。
  2. 余额归零：每日分润扣费后，若用户平台余额 ≤ 0，系统会立即调用 disableAllUserStrategies 停用该用户的所有跟单策略。
  3. 重复平仓保护：管理员手动触发 simulateClose 时，系统会检查订单状态，若已为 closed 则拒绝执行，防止重复扣取分润。