docs: 整理并生成收益中心全场景关系链收益模拟与财务测算文档

2026-09-17 15:01:19 +08:00
--- a/docs/收益中心全场景关系链收益模拟与测算文档.md
+++ b/docs/收益中心全场景关系链收益模拟与测算文档.md
@@ -0,0 +1,441 @@
+# 收益中心 · 全场景关系链收益模拟与财务测算文档
+
+> **版本**：v2.0（基于二开核心代码与真实配置）  
+> **编制依据**：恒联数通「收益中心」（合伙股东）底层服务组件（`addons/shopro/service/partner/`）及单元测试集（`tests/partner/`）  
+> **适用对象**：系统架构师、财务总监、风控专家、产品经理及平台管理员  
+
+---
+
+## 目录
+1. [收益机制总览与核心参数矩阵](#一收益机制总览与核心参数矩阵)
+2. [场景一：普通会员直推与「推三返一」3档循环机制](#场景一普通会员直推与推三返一3档循环机制)
+3. [场景二：创客阶梯极差与水位吃满（V1~V6线性贯穿）](#场景二创客阶梯极差与水位吃满v1v6线性贯穿)
+4. [场景三：创客跨级跳级与断层收益穿透（V1→V4→V6）](#场景三创客跨级跳级与断层收益穿透v1v4v6)
+5. [场景四：创客同级协同奖逐代10%递减级联与0.10元截断](#场景四创客同级协同奖逐代10递减级联与010元截断)
+6. [场景五：创客越级与卓越奖（下级反超上级5%）](#场景五创客越级与卓越奖下级反超上级5)
+7. [场景六：实体渠道与区域代理运营奖拆分矩阵（100元池拆分）](#场景六实体渠道与区域代理运营奖拆分矩阵100元池拆分)
+8. [场景七：酒道馆与区县平级协同奖多代级联与截断分析](#场景七酒道馆与区县平级协同奖多代级联与截断分析)
+9. [场景八：渠道身份自购场景（酒道馆/区县自购与返利）](#场景八渠道身份自购场景酒道馆区县自购与返利)
+10. [场景九：30天未自购（不活跃）的跳过与极差穿透机制](#场景九30天未自购不活跃的跳过与极差穿透机制)
+11. [场景十：全复合10级超级商业大矩阵综合穿透模拟](#场景十全复合10级超级商业大矩阵综合穿透模拟)
+12. [场景十一：次日凌晨00:30全网日结三大奖池与马豆资产模型](#场景十一次日凌晨0030全网日结三大奖池与马豆资产模型)
+13. [场景十二：退款逆向冲销与防刷风控机制](#场景十二退款逆向冲销与防刷风控机制)
+14. [全景财务现金拨比与安全边际精算表](#全景财务现金拨比与安全边际精算表)
+
+---
+
+## 一、收益机制总览与核心参数矩阵
+
+恒联数通收益中心采用**即时交易分润 + 次日加权均分 + 资产凭证按日释放**的复合商业模型，所有业务规则与资金流向均由代码强制约束。
+
+### 1.1 核心配置参数矩阵
+
+| 奖项分类 | 奖项名称 | 数据库标识 | 默认参数 / 算法规则 | 受益对象与前置条件 | 结算周期 |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| **即时奖** | 推荐开拓奖 | `push3` | `[398, 400, 600]` 元循环 | 直推上级（需 Level $\ge 1$ 品酒师，且30天内有自购） | 订单支付即时到账 |
+| **即时奖** | 创客进阶奖（极差）| `maker_diff` | V1: 20, V2: 40, V3: 60, V4: 80, V5: 100, V6: 120 元 | 创客链上各级创客按级差差额提取，封顶 120 元 | 订单支付即时到账 |
+| **即时奖** | 创客协同奖（平级）| `maker_peer` | 每代 10%（`0.10`），递减级联，低于 0.10 元截断 | 获得极差创客的直属同级上位创客，多代递减 | 订单支付即时到账 |
+| **即时奖** | 创客卓越奖（超越）| `maker_overtaken`| 最高创客基数的 5%（`0.05`），**仅限 1 层** | 最高极差创客之上的首个较低等级创客（Level $\ge 2$） | 订单支付即时到账 |
+| **即时奖** | 酒道馆运营奖 | `team_venue` | 固定 50 元 | 向上首个酒道馆（含买家本人自购） | 订单支付即时到账 |
+| **即时奖** | 区县代理统筹奖 | `team_county`| 有馆分 50 元，无馆独享 100 元 | 向上首个区县代理（含买家本人自购） | 订单支付即时到账 |
+| **即时奖** | 馆/县协同奖（平级）| `venue_peer` / `county_peer` | 每代 10%（`0.10`），递减级联，低于 0.10 元截断 | 获得运营奖之上的同级上位馆或县代理 | 订单支付即时到账 |
+| **资产权益**| 产品兑换券计划 | `voucher_grant` | 实付金额 $\times 1.5$ 倍，按 365 天等额释放 | 买家本人（商城提货抵扣券，非提现现金） | 支付次日起按日释放 |
+| **日结奖** | 全网马豆均分池 | `madow_share` | 当日 GMV $1:1$ 转换为马豆，均分给合格会员 | 过去 30 天有自购的品酒师及以上会员 | 次日 00:30 定时任务 |
+| **日结奖** | 酒道馆日结分红池 | `venue_share` | 全网合格单数 $\times 100$ 元，均分给合格酒道馆 | 过去 30 天有自购的酒道馆 | 次日 00:30 定时任务 |
+| **日结奖** | 区县代理日结分红池| `county_share`| 全网合格单数 $\times 50$ 元，均分给合格区县代理 | 过去 30 天有自购的区县代理 | 次日 00:30 定时任务 |
+| **资产增值**| 马豆浮动定价汇率 | `madow_rate` | $\text{Rate} = 0.00000075 \times N$（$N$ 为全网累计完成单数） | 随全网单数单向递增，支持现金兑换 | 实时动态变动 |
+| **保活约束**| 业务活跃周期 | `active_days` | 30 天（720 小时） | 自购订单付款即刷新保活时间，未保活跳过并沉淀 | 系统级前置过滤 |
+
+---
+
+## 场景一：普通会员直推与「推三返一」3档循环机制
+
+### 1.1 业务拓扑结构
+```
+推荐人 A (品酒师/创客，30天自购活跃，初始推荐单数 seq=0)
+  └── 买家 B (新注册会员，连续购买 4 单，每单实付 1398.00 元)
+```
+
+### 1.2 订单执行与收益明细表
+
+| 订单序列 | 买家实付 | 买家 B 获得权益 | 推荐人 A 现金收益 | 流水类型 | 计算公式与业务说明 | 推荐人单数计数变更 |
+| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
+| **第 1 单** | ¥ 1398.00 | 2097.00 元兑换券 (5.75元/天) | **¥ 398.00** | `push3` | 第 1 档返现，固定 398 元 | `seq: 0 -> 1` |
+| **第 2 单** | ¥ 1398.00 | 2097.00 元兑换券 (5.75元/天) | **¥ 400.00** | `push3` | 第 2 档返现，固定 400 元 | `seq: 1 -> 2` |
+| **第 3 单** | ¥ 1398.00 | 2097.00 元兑换券 (5.75元/天) | **¥ 600.00** | `push3` | 第 3 档返现，固定 600 元（波峰） | `seq: 2 -> 3` |
+| **第 4 单** | ¥ 1398.00 | 2097.00 元兑换券 (5.75元/天) | **¥ 398.00** | `push3` | 进入下一轮循环，重置回第 1 档 398 元 | `seq: 3 -> 4 (取模为1)` |
+
+### 1.3 财务与拨比分析
+- **单个循环总业绩（3单）**：$1398 \times 3 = 4194.00$ 元。
+- **单个循环直推现金总支出**：$398 + 400 + 600 = 1398.00$ 元。
+- **直推周期平均现金拨比**：$1398.00 / 4194.00 = \mathbf{33.33\%}$（精确相当于“买三单赠一单货款”的等额分润）。
+- **单笔波动区间**：最低 28.47%（398元），最高 42.92%（600元），整体方差可控。
+
+---
+
+## 场景二：创客阶梯极差与水位吃满（V1~V6线性贯穿）
+
+### 2.1 业务拓扑结构
+```
+创客 G (V6, Level 7, 水位 120元, 活跃)
+  └── 创客 F (V5, Level 6, 水位 100元, 活跃)
+        └── 创客 E (V4, Level 5, 水位 80元, 活跃)
+              └── 创客 D (V3, Level 4, 水位 60元, 活跃)
+                    └── 创客 C (V2, Level 3, 水位 40元, 活跃)
+                          └── 创客 B (V1, Level 2, 水位 20元, 活跃, seq=0)
+                                └── 买家 A (品酒师, 自购 1 单 1398.00 元)
+```
+
+### 2.2 收益分配与水位演进明细表
+
+| 收益人 | 身份与等级 | 获得奖项 | 计算基数 | 极差公式与逻辑说明 | 实实现金 | 水位变迁 |
+| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
+| **买家 A** | 买家本人 | 兑换券 | 1398.00 | $1398 \times 1.5 = 2097$ 元兑换券（365天释放） | ¥ 0.00 | - |
+| **创客 B** | 创客 V1 (直推) | 推荐开拓奖 | - | 第 1 单享受第 1 档固定返现 | **¥ 398.00** | - |
+| **创客 B** | 创客 V1 (直推) | 创客极差奖 | 20.00 | 基数 20 元，前序水位 0 元：$20 - 0 = 20$ 元 | **¥ 20.00** | $0 \to 20$ |
+| **创客 C** | 创客 V2 | 创客极差奖 | 40.00 | 基数 40 元，前序水位 20 元：$40 - 20 = 20$ 元 | **¥ 20.00** | $20 \to 40$ |
+| **创客 D** | 创客 V3 | 创客极差奖 | 60.00 | 基数 60 元，前序水位 40 元：$60 - 40 = 20$ 元 | **¥ 20.00** | $40 \to 60$ |
+| **创客 E** | 创客 V4 | 创客极差奖 | 80.00 | 基数 80 元，前序水位 60 元：$80 - 60 = 20$ 元 | **¥ 20.00** | $60 \to 80$ |
+| **创客 F** | 创客 V5 | 创客极差奖 | 100.00| 基数 100 元，前序水位 80 元：$100 - 80 = 20$ 元 | **¥ 20.00** | $80 \to 100$ |
+| **创客 G** | 创客 V6 | 创客极差奖 | 120.00| 基数 120 元，前序水位 100 元：$120 - 100 = 20$ 元| **¥ 20.00** | $100 \to 120$ |
+
+### 2.3 财务结算核算
+- **极差总拨出**：$20 \times 6 = \mathbf{120.00}$ 元（严格等于 V6 最高封顶水位 120 元，绝无多拨）。
+- **本单现金总支出**：$398.00 (\text{直推}) + 120.00 (\text{极差}) = \mathbf{518.00}$ 元。
+- **本单即时现金拨比**：$518.00 / 1398.00 = \mathbf{37.05\%}$。
+
+---
+
+## 场景三：创客跨级跳级与断层收益穿透（V1→V4→V6）
+
+当团队中存在跳级或断层时，系统极差水位自动跃迁，高阶创客直接吞并中间空白层级的极差差额。
+
+### 3.1 业务拓扑结构
+```
+创客 D (V6, Level 7, 水位 120元, 活跃)
+  └── 创客 C (V4, Level 5, 水位 80元, 活跃)  <-- 跳过 V2, V3
+        └── 创客 B (V1, Level 2, 水位 20元, 活跃, seq=1)
+              └── 买家 A (下单 1398.00 元)
+```
+
+### 3.2 收益分配明细表
+
+| 收益人 | 身份与等级 | 获得奖项 | 计算基数 | 极差算法与说明 | 实发现金 | 水位变迁 |
+| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
+| **创客 B** | 创客 V1 (直推) | 推荐开拓奖 | - | 直推第 2 单，享受第 2 档 400 元 | **¥ 400.00** | - |
+| **创客 B** | 创客 V1 (直推) | 创客极差奖 | 20.00 | 基数 20 元，前序水位 0 元：$20 - 0 = 20$ 元 | **¥ 20.00** | $0 \to 20$ |
+| **创客 C** | 创客 V4 | 创客极差奖 | 80.00 | 基数 80 元，前序水位 20 元：$80 - 20 = 60$ 元（吃掉V2/V3空间） | **¥ 60.00** | $20 \to 80$ |
+| **创客 D** | 创客 V6 | 创客极差奖 | 120.00| 基数 120 元，前序水位 80 元：$120 - 80 = 40$ 元（吃掉V5空间） | **¥ 40.00** | $80 \to 120$ |
+
+### 3.3 财务结算核算
+- **极差总拨出**：$20.00 + 60.00 + 40.00 = \mathbf{120.00}$ 元（仍然精准受限于 120 元上限）。
+- **本单现金总支出**：$400.00 + 120.00 = \mathbf{520.00}$ 元。
+- **本单即时现金拨比**：$520.00 / 1398.00 = \mathbf{37.20\%}$。
+
+---
+
+## 场景四：创客同级协同奖逐代10%递减级联与0.10元截断
+
+当链路中连续出现多个相同等级创客时，后续创客无法获得极差，但会触发「创客协同奖（平级奖）」。系统支持多代级联，但每一代以上一代奖金为基数按 10% 递减，当算得金额低于 0.10 元时强制物理截断。
+
+### 4.1 业务拓扑结构（以 V3 平级 4 人链为例）
+```
+创客 E (V3, Level 4, 活跃)  -- 第 3 代同级创客
+  └── 创客 D (V3, Level 4, 活跃)  -- 第 2 代同级创客
+        └── 创客 C (V3, Level 4, 活跃)  -- 第 1 代同级创客
+              └── 创客 B (V3, Level 4, 活跃, seq=0)  -- 极差受益创客
+                    └── 买家 A (下单 1398.00 元)
+```
+
+### 4.2 收益分配与截断明细表（V3 基数 60 元）
+
+| 收益人 | 身份与等级 | 触发奖项 | 计算代数 | 计算基数与递减推导 | 实发现金 | 状态判定 |
+| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
+| **创客 B** | 创客 V3 | 推荐开拓奖 | - | 直推第 1 单 | **¥ 398.00** | 正常发放 |
+| **创客 B** | 创客 V3 | 创客极差奖 | 60.00 | $60 - 0 = 60.00$ 元，水位提升至 60 | **¥ 60.00** | 正常发放 |
+| **创客 C** | 创客 V3 | 创客协同奖 | **第 1 代** | 极差基数 $60.00 \times 10\% = 6.00$ 元 | **¥ 6.00** | $\ge 0.10$ 正常发放 |
+| **创客 D** | 创客 V3 | 创客协同奖 | **第 2 代** | 上代奖金 $6.00 \times 10\% = 0.60$ 元 | **¥ 0.60** | $\ge 0.10$ 正常发放 |
+| **创客 E** | 创客 V3 | 创客协同奖 | **第 3 代** | 上代奖金 $0.60 \times 10\% = 0.06$ 元 | **¥ 0.00** | **< 0.10 元，严格截断中止！** |
+
+### 4.3 各创客等级平级级联深度对比表
+
+| 创客等级 | 极差基数 | 第 1 代 (10%) | 第 2 代 (10%) | 第 3 代 (10%) | 第 4 代 (10%) | 有效发放代数 | 平级总拨出现金 |
+| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
+| **创客 V1** | 20.00 元 | 2.00 元 | 0.20 元 | 0.02 元 (截断) | - | **2 代** | **¥ 2.20** |
+| **创客 V2** | 40.00 元 | 4.00 元 | 0.40 元 | 0.04 元 (截断) | - | **2 代** | **¥ 4.40** |
+| **创客 V3** | 60.00 元 | 6.00 元 | 0.60 元 | 0.06 元 (截断) | - | **2 代** | **¥ 6.60** |
+| **创客 V4** | 80.00 元 | 8.00 元 | 0.80 元 | 0.08 元 (截断) | - | **2 代** | **¥ 8.80** |
+| **创客 V5** | 100.00 元 | 10.00 元 | 1.00 元 | 0.10 元 (发放) | 0.01 元 (截断) | **3 代** | **¥ 11.10** |
+| **创客 V6** | 120.00 元 | 12.00 元 | 1.20 元 | 0.12 元 (发放) | 0.012 元 (截断)| **3 代** | **¥ 13.32** |
+
+> **核心风控特性**：由于设置了 `0.10` 元硬截断，即便同级创客向上堆叠 100 人，V1~V4 最多只发 2 代，V5~V6 最多只发 3 代，杜绝了无限代平级穿透造成的拨比无限累加风险！
+
+---
+
+## 场景五：创客越级与卓越奖（下级反超上级5%）
+
+当低级别创客培育出能力超越自己的高阶下级时，极差被下级截断，但系统通过「创客卓越奖（超越奖）」保障其引荐贡献，按最高创客基数的 5% 给予单层奖励。
+
+### 5.1 业务拓扑结构
+```
+创客 E (V1, Level 2, 活跃)  -- 第 2 个比 B 低的创客（不触发）
+  └── 创客 D (V3, Level 4, 活跃)  -- 首个比 B 低的创客（触发卓越奖！）
+        └── 创客 C (V6, Level 7, 活跃)  -- 与 B 同级（已由平级逻辑处理）
+              └── 创客 B (V6, Level 7, 水位 120元, 活跃, seq=2)  -- 极差最高创客
+                    └── 买家 A (下单 1398.00 元)
+```
+
+### 5.2 收益分配明细表
+
+| 收益人 | 身份等级 | 获得奖项 | 计算基数 | 比例与逻辑说明 | 实实现金 | 约束限制 |
+| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
+| **创客 B** | 创客 V6 | 推荐开拓奖 | - | 直推第 3 单波峰档 | **¥ 600.00** | 正常 |
+| **创客 B** | 创客 V6 | 创客极差奖 | 120.00 | 首位创客吃满 V6 极差 120 元 | **¥ 120.00** | 水位提升至 120 |
+| **创客 C** | 创客 V6 | 创客协同奖 | 120.00 | 第 1 代同级平级：$120 \times 10\% = 12.00$ 元 | **¥ 12.00** | 正常发放 |
+| **创客 D** | 创客 V3 | **创客卓越奖** | 120.00 | 紧邻最高创客之上的首个较低创客：$120 \times 5\% = 6.00$ 元 | **¥ 6.00** | **系统强制仅限 1 层** |
+| **创客 E** | 创客 V1 | 创客卓越奖 | 120.00 | 非首个被反超创客 | ¥ 0.00 | 卓越奖仅限 1 层，E 不享受 |
+
+### 5.3 财务与拨比分析
+- **本单现金总支出**：$600.00 (\text{直推}) + 120.00 (\text{极差}) + 12.00 (\text{平级}) + 6.00 (\text{卓越}) = \mathbf{738.00}$ 元。
+- **本单现金综合拨比**：$738.00 / 1398.00 = \mathbf{52.79\%}$（处于极限波峰第3单状态）。
+
+---
+
+## 场景六：实体渠道与区域代理运营奖拆分矩阵（100元池拆分）
+
+平台设立每单 100 元的团队统筹运营池，根据链上酒道馆与区县代理的存在形态进行刚性拆分。
+
+### 6.1 四种组合形态拆分矩阵
+
+```
+【形态 1: 无馆有县】 买家 ---> (无馆) ---------------> 区县代理 (独得 100 元)
+【形态 2: 有馆有县】 买家 ---> 酒道馆 (分得 50 元) ---> 区县代理 (分得 50 元)
+【形态 3: 有馆无县】 买家 ---> 酒道馆 (分得 50 元) ---> (无县) (剩余 50 元平台沉淀)
+【形态 4: 无馆无县】 买家 ---> (无馆) ---------------> (无县) (全额 100 元平台沉淀)
+```
+
+### 6.2 详细分配测算对照表（单笔订单 1398 元）
+
+| 形态编号 | 链路渠道构成 | 酒道馆获得 | 区县代理获得 | 平台沉淀留存 | 资金流向审计说明 |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| **形态 1** | 仅有区县代理，无酒道馆 | ¥ 0.00 | **¥ 100.00** | ¥ 0.00 | `formula`: "区县统筹奖 100（直达）" |
+| **形态 2** | 同时存在酒道馆与区县代理 | **¥ 50.00** | **¥ 50.00** | ¥ 0.00 | 馆得 `venue_split: 50`，县得 `50`（馆上） |
+| **形态 3** | 仅有酒道馆，无区县代理 | **¥ 50.00** | ¥ 0.00 | **¥ 50.00** | 馆得 50，记录 `skip: 有馆无区县`，沉淀 50 元 |
+| **形态 4** | 链上无酒道馆且无区县代理 | ¥ 0.00 | ¥ 0.00 | **¥ 100.00** | 记录 `skip: 链上无酒道馆且无区县`，沉淀 100 元 |
+
+---
+
+## 场景七：酒道馆与区县平级协同奖多代级联与截断分析
+
+酒道馆与区县代理同样享受平级协同奖，按 10% 递减，且受 0.10 元截断保护。
+
+### 7.1 拓扑结构：连续 4 家酒道馆 + 连续 4 个区县代理（形态 2 下）
+```
+区县 4 (活跃)
+  └── 区县 3 (活跃)
+        └── 区县 2 (活跃)
+              └── 区县 1 (活跃)  -- 获得区县团队奖 50 元
+                    └── 馆 4 (活跃)
+                          └── 馆 3 (活跃)
+                                └── 馆 2 (活跃)
+                                      └── 馆 1 (活跃)  -- 获得酒道馆团队奖 50 元
+                                            └── 买家 A (下单 1398 元)
+```
+
+### 7.2 收益递减推导与结算表
+
+| 收益人 | 渠道角色 | 奖项类型 | 计算基数 | 递减计算公式 | 实发现金 | 状态与截断说明 |
+| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
+| **馆 1** | 酒道馆 1 | 酒道馆运营奖 | 50.00 | 基础拆分 | **¥ 50.00** | 首个馆正常入账 |
+| **馆 2** | 酒道馆 2 | 酒道馆协同奖 | 50.00 | 第 1 代：$50.00 \times 10\% = 5.00$ 元 | **¥ 5.00** | $\ge 0.10$ 正常发放 |
+| **馆 3** | 酒道馆 3 | 酒道馆协同奖 | 5.00 | 第 2 代：$5.00 \times 10\% = 0.50$ 元 | **¥ 0.50** | $\ge 0.10$ 正常发放 |
+| **馆 4** | 酒道馆 4 | 酒道馆协同奖 | 0.50 | 第 3 代：$0.50 \times 10\% = 0.05$ 元 | **¥ 0.00** | **< 0.10 元，严格截断不发！** |
+| **区县 1** | 区县代理 1 | 区县统筹奖 | 50.00 | 有馆有县拆分 | **¥ 50.00** | 首个县正常入账 |
+| **区县 2** | 区县代理 2 | 区县协同奖 | 50.00 | 第 1 代：$50.00 \times 10\% = 5.00$ 元 | **¥ 5.00** | $\ge 0.10$ 正常发放 |
+| **区县 3** | 区县代理 3 | 区县协同奖 | 5.00 | 第 2 代：$5.00 \times 10\% = 0.50$ 元 | **¥ 0.50** | $\ge 0.10$ 正常发放 |
+| **区县 4** | 区县代理 4 | 区县协同奖 | 0.50 | 第 3 代：$0.50 \times 10\% = 0.05$ 元 | **¥ 0.00** | **< 0.10 元，严格截断不发！** |
+
+### 7.3 无馆有县时区县平级深度特例（基数 100 元）
+当链上**无酒道馆**时，区县 1 获得 100 元运营奖，其协同奖递减表现如下：
+- **区县 2（第 1 代）**：$100.00 \times 10\% = \mathbf{10.00}$ 元；
+- **区县 3（第 2 代）**：$10.00 \times 10\% = \mathbf{1.00}$ 元；
+- **区县 4（第 3 代）**：$1.00 \times 10\% = \mathbf{0.10}$ 元（刚好达到 0.10 元最低门槛，**发放！**）；
+- **区县 5（第 4 代）**：$0.10 \times 10\% = 0.01$ 元（小于 0.10 元，**截断！**）。
+- **区县协同总拨比上限**：$10.00 + 1.00 + 0.10 = \mathbf{11.10}$ 元。
+
+---
+
+## 场景八：渠道身份自购场景（酒道馆/区县自购与返利）
+
+恒联数通二开架构中，`ChainService::collect($buyerId, true)` 将买家本人纳入团队统筹链路首位，实现了“实体渠道主自购享返点”的业务特性。
+
+### 8.1 业务拓扑结构
+```
+上级区县代理 C (活跃)
+  └── 上级酒道馆 B (活跃)
+        └── 买家 A (既是消费者，也是酒道馆主，活跃，自购 1398 元)
+```
+
+### 8.2 收益分配明细表
+
+| 收益人 | 身份说明 | 奖项类型 | 实发金额 | 业务规则与执行逻辑 |
+| :--- | :--- | :--- | :--- | :--- |
+| **买家 A** | 酒道馆主（买家本人）| 推三返一 | ¥ 0.00 | 自购不产生直推奖（系统自动跳过） |
+| **买家 A** | 酒道馆主（买家本人）| **酒道馆运营奖** | **¥ 50.00** | **自购入链首位，自己作为首个馆获得 50 元返利** |
+| **买家 A** | 酒道馆主（买家本人）| 兑换券计划 | ¥ 0.00 | 个人账户计入 2097 元兑换券，每日释放 5.75 元 |
+| **上级馆 B** | 上级酒道馆 | **酒道馆协同奖** | **¥ 5.00** | 获得买家 A 团队奖的 10%：$50 \times 10\% = 5.00$ 元 |
+| **上级县 C** | 上级区县代理 | **区县统筹奖** | **¥ 50.00** | 首位区县代理获得拆分统筹奖 50.00 元 |
+
+> **业务价值**：馆主自购不仅获得产品兑换券，还变相获得 50 元采购折扣，极大刺激实体门店自购补货积极性。
+
+---
+
+## 场景九：30天未自购（不活跃）的跳过与极差穿透机制
+
+为防止“占位套利”，系统强制要求收益人必须在过去 30 天（720小时）内存在自购订单。未自购者视为不活跃（`inactive_30d`）：推三返一直接沉淀，创客极差**不占用水位**，由上位活跃创客全额继承！
+
+### 9.1 业务拓扑结构
+```
+创客 D (V5, Level 6, 水位 100元, [活跃])
+  └── 创客 C (V3, Level 4, 水位 60元, [不活跃 - 30天无自购])
+        └── 推荐人 B (品酒师, Level 1, [不活跃 - 30天无自购])
+              └── 买家 A (下单 1398.00 元)
+```
+
+### 9.2 审计处理与资金穿透表
+
+| 节点 | 身份 | 应享奖项 | 判定结果 | 实发金额 | 系统处理行为与资金沉淀效果 |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| **推荐人 B** | 品酒师 | 推三返一 (398元) | **不活跃** | **¥ 0.00** | 写入 skip 审计表：`inactive_30d`，**398 元直接沉淀为平台利润** |
+| **创客 C** | 创客 V3 | 创客极差 (60元) | **不活跃** | **¥ 0.00** | 写入 skip 审计表：`inactive_30d`，**且 C 不占用极差水位（水位仍为 0）** |
+| **创客 D** | 创客 V5 | 创客极差 (100元) | **活跃** | **¥ 100.00** | **穿透受益**：基数 100 元，前序水位 0 元，$100 - 0 = \mathbf{100.00}$ 元全吃！ |
+
+### 9.3 平台风控收益对比
+- 若 C 活跃：C 得 60 元，D 得 40 元，推三返一发放 398 元，平台即时支出 498 元。
+- 因 B/C 不活跃：B 奖金沉淀，C 极差转由 D 吃满，平台即时支出仅 100 元（极差），**净节省现金 398 元**！
+
+---
+
+## 场景十：全复合10级超级商业大矩阵综合穿透模拟
+
+本场景为系统理论上能够组装出的**最完整、链条最深、奖项触发最齐备**的极端压测链路。
+
+### 10.1 复合拓扑结构关系链（10 级人员）
+```
+[节点 10] 区县代理 2 (乙区县, 活跃)  -- 区县平级第 1 代
+   └── [节点 9] 区县代理 1 (甲区县, 活跃)  -- 首位区县代理
+         └── [节点 8] 酒道馆 2 (馆 B, 活跃)  -- 馆平级第 1 代
+               └── [节点 7] 酒道馆 1 (馆 A, 活跃)  -- 首位酒道馆
+                     └── [节点 6] 创客 F (V2, 活跃)  -- 被 V6 反超的低级创客（卓越奖）
+                           └── [节点 5] 创客 E (V6, 活跃)  -- 创客平级第 1 代
+                                 └── [节点 4] 创客 D (V6, 活跃)  -- 最高极差创客
+                                       └── [节点 3] 创客 C (V3, 活跃)  -- 中间极差创客
+                                             └── [节点 2] 创客 B (V1, 活跃, seq=2)  -- 直推人 (第3单)
+                                                   └── [节点 1] 买家 A (品酒师, 活跃, 下单 1398.00 元)
+```
+
+### 10.2 综合全奖项穿透财务分配详表（以单笔 1398.00 元为例）
+
+| 收益人 | 节点编号 | 身份与等级 | 触发奖项 | 计算公式与参数依据 | 实发现金 (元) | 资金账户 |
+| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
+| **买家 A** | 节点 1 | 买家本人 | 兑换券发放 | $1398 \times 1.5 = 2097.00$ 元（365天释放） | **¥ 0.00** | 兑换券账户 |
+| **创客 B** | 节点 2 | 创客 V1 (直推) | 推荐开拓奖 | 直推第 3 单波峰：`push3[2] = 600` | **¥ 600.00** | 佣金钱包 |
+| **创客 B** | 节点 2 | 创客 V1 (直推) | 创客极差奖 | V1 水位差：$20 - 0 = 20$ | **¥ 20.00** | 佣金钱包 |
+| **创客 C** | 节点 3 | 创客 V3 | 创客极差奖 | V3 水位差：$60 - 20 = 40$ | **¥ 40.00** | 佣金钱包 |
+| **创客 D** | 节点 4 | 创客 V6 | 创客极差奖 | V6 水位差：$120 - 60 = 60$ (吃满封顶) | **¥ 60.00** | 佣金钱包 |
+| **创客 E** | 节点 5 | 创客 V6 | 创客协同奖 | V6 平级第 1 代：$120 \times 10\% = 12$ | **¥ 12.00** | 佣金钱包 |
+| **创客 F** | 节点 6 | 创客 V2 | 创客卓越奖 | 紧邻首个低级创客：$120 \times 5\% = 6$ (单层) | **¥ 6.00** | 佣金钱包 |
+| **酒道馆 1**| 节点 7 | 酒道馆 A | 酒道馆运营奖 | 有馆有县拆分：固定 50 元 | **¥ 50.00** | 佣金钱包 |
+| **酒道馆 2**| 节点 8 | 酒道馆 B | 酒道馆协同奖 | 馆平级第 1 代：$50 \times 10\% = 5$ | **¥ 5.00** | 佣金钱包 |
+| **区县代理1**| 节点 9 | 区县代理甲 | 区县统筹奖 | 有馆有县拆分：固定 50 元 | **¥ 50.00** | 佣金钱包 |
+| **区县代理2**| 节点 10| 区县代理乙 | 区县协同奖 | 县平级第 1 代：$50 \times 10\% = 5$ | **¥ 5.00** | 佣金钱包 |
+
+### 10.3 本单财务穿透核算结果
+- **即时现金支出总额**：  
+  $$\sum \text{Cash} = 600 + 20 + 40 + 60 + 12 + 6 + 50 + 5 + 50 + 5 = \mathbf{848.00\text{ 元}}$$
+- **即时现金拨比**：  
+  $$\text{拨比} = \frac{848.00}{1398.00} = \mathbf{60.66\%}$$
+- **平台即时留存毛利**：  
+  $$\text{留存} = 1398.00 - 848.00 = \mathbf{550.00\text{ 元 (毛利率 39.34\%)}}$$
+- **买家端资产沉淀**：2097.00 元产品兑换券（365 天等额提货券，每天释放 5.75 元，持续拉动商城复购）。
+
+---
+
+## 场景十一：次日凌晨00:30全网日结三大奖池与马豆资产模型
+
+日结奖励不占用单笔即时分润，由每日定时脚本（`DailySettleService`）在次日凌晨 00:30 从平台当日总营业额（GMV）与平台预提池中加权结算。
+
+### 11.1 日结运行假设情景
+- **昨日全网完成合格单数**：200 单（每单 1398.00 元）。
+- **当日全网流水（GMV）**：$200 \times 1398.00 = \mathbf{279,600.00}$ 元。
+- **全网累计历史完成单数 $N$**：50,000 单。
+- **全网 30 天自购活跃资格人数**：
+  - 合格品酒师（及创客）：800 人
+  - 合格酒道馆：40 家
+  - 合格区县代理：10 家
+
+### 11.2 三大日结奖池结算数据模拟表
+
+| 日结奖项 | 资金池形成规则 | 当日总池规模 | 参评达标人数 | 人均实际分配 | 结算账户与流向 | 财务属性 |
+| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
+| **全网马豆均分池** | 当日 GMV $1:1$ 转换为马豆 | **279,600 豆** | 800 人 | **349.50000000 豆/人** | 会员马豆账户 | 平台记账资产凭证，无即时法币支出 |
+| **酒道馆平台均分池** | 当日单数 $\times 100$ 元/单 | **¥ 20,000.00** | 40 家 | **¥ 500.00 / 馆** | 佣金钱包 | 平台实发现金支出 |
+| **区县代理平台均分池**| 当日单数 $\times 50$ 元/单 | **¥ 10,000.00** | 10 家 | **¥ 1,000.00 / 县** | 佣金钱包 | 平台实发现金支出 |
+
+### 11.3 马豆即时汇率与资产价值精算
+马豆单价由全网累计成交单数 $N$ 严格线性决定：
+$$\text{Rate} = 0.00000075 \times N$$
+
+1. **当前状态（$N = 50,000$ 单）**：
+   - 即时汇率：$\text{Rate} = 0.00000075 \times 50,000 = \mathbf{0.0375\text{ 元/豆}}$。
+   - 会员当日获得 349.5 豆的理论资产价值：$349.5 \times 0.0375 \approx \mathbf{13.11\text{ 元}}$。
+2. **中期成长（$N = 200,000$ 单）**：
+   - 即时汇率：$\text{Rate} = 0.00000075 \times 200,000 = \mathbf{0.1500\text{ 元/豆}}$。
+   - 会员早期持有的 10,000 豆价值：$10,000 \times 0.15 = \mathbf{1,500.00\text{ 元}}$（资产升值 4 倍）。
+3. **汇率特征**：单向增值、永不跌落，以平台实际生态成交量作为底层价值背书。
+
+---
+
+## 场景十二：退款逆向冲销与防刷风控机制
+
+当用户发生维权退款时，系统严格执行逆向闭环事务（`PartnerRewardService::refund`），防止“套佣套券”黑产攻击。
+
+### 12.1 逆向冲销处理矩阵
+
+| 涉及模块 | 正向发生 | 逆向冲销处理逻辑 | 数据库与底层变更 |
+| :--- | :--- | :--- | :--- |
+| **佣金钱包** | 实时入账对应金额 | 扣减对应会员 `commission` 余额（允许扣为负数追缴） | `Wallet::change(..., 'reward_back')` |
+| **代理累计收益** | 累加 `total_income` | 严格等额回退扣减代理商累计收益 | `Agent::setDec('total_income', amount)` |
+| **推三返一计数** | 循环序号自增 | **自减回退上级直推单数序号**，防止下单一单退一单恶意薅取600元波峰 | `Push3Reward::rollbackSeq(userId)` |
+| **产品兑换券** | 建立 365 天释放计划 | **立即终止未释放计划**；已释放已消费部分由系统等额追扣 | `VoucherService::closeByOrder()` |
+| **奖励流水状态** | 状态记为 1（正常） | **标记为 -2（已退款作废）** | `Reward::status = -2` |
+
+---
+
+## 全景财务现金拨比与安全边际精算表
+
+基于恒联数通二开完整逻辑，对单笔 1398 元订单在不同极端条件下的现金支出进行精算对账：
+
+### 1. 综合拨比测算对比表
+
+| 资金支出项目 | 典型日常平均场景 | 极差吃满场景 (场景二) | 10级全满极限波峰 (场景十) | 占单笔 1398 元极限占比 | 风险敞口对冲与控制机制 |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| **推三返一** | ¥ 466.00 (3单均值) | ¥ 398.00 (第1档) | ¥ 600.00 (波峰) | 42.92% | 3档循环制，长期均值恒定 33.33% |
+| **创客极差** | ¥ 80.00 (平均) | ¥ 120.00 (吃满) | ¥ 120.00 (吃满) | 8.58% | 水位差算法，全网创客封顶 120 元 |
+| **创客平级奖** | ¥ 4.00 (平级概率) | ¥ 0.00 (无同级) | ¥ 12.00 (V6平级) | 0.86% | 10% 递减，0.10 元截断，最多 3 代 |
+| **创客卓越奖** | ¥ 2.00 (超越概率) | ¥ 0.00 (无超越) | ¥ 6.00 (反超V6) | 0.43% | **严格锁定仅发 1 层**，固定 5% |
+| **酒道馆运营奖** | ¥ 50.00 | ¥ 0.00 | ¥ 50.00 | 3.58% | 100 元统筹池拆分，固定 50 元 |
+| **酒道馆平级奖** | ¥ 1.00 | ¥ 0.00 | ¥ 5.00 | 0.36% | 10% 递减，0.10 元截断，最多 2 代 |
+| **区县统筹奖** | ¥ 50.00 | ¥ 0.00 | ¥ 50.00 | 3.58% | 100 元统筹池拆分，固定 50 元 |
+| **区县平级奖** | ¥ 1.00 | ¥ 0.00 | ¥ 5.00 | 0.36% | 10% 递减，0.10 元截断，最多 2 代 |
+| **即时现金总支出** | **¥ 654.00** | **¥ 518.00** | **¥ 848.00** | **60.66%** | **极端单笔即时现金支出上限** |
+| **日结酒道馆池预提** | ¥ 100.00 | ¥ 100.00 | ¥ 100.00 | 7.15% | 日结平分，无合格馆时 100% 沉淀 |
+| **日结区县池预提** | ¥ 50.00 | ¥ 50.00 | ¥ 50.00 | 3.58% | 日结平分，无合格县时 100% 沉淀 |
+| **理论全现金综合峰值** | **¥ 804.00** | **¥ 668.00** | **¥ 998.00** | **71.39%** | **全网全奖项全满足之理论极限最高点** |
+| **日常实际经营综合拨比** | **¥ 620 ~ 710 元** | **¥ 518 ~ 620 元** | - | **44.3% ~ 50.8%** | **剔除不活跃沉淀与空缺渠道后的真实区间** |
+| **平台毛利留存安全边际** | **¥ 594 ~ 778 元** | **¥ 730 ~ 880 元** | **¥ 400.00** | **28.61% ~ 55.7%** | **即使在全奖项触发的极限波峰下仍盈利 400 元/单** |
+
+### 2. 结论与财务健康度评估
+1. **绝无穿仓风险**：即便全网所有层级全部激活、且刚好撞上推三返一 600 元最大波峰、且日结池 100% 满额分摊，平台单笔现金留存仍有 **¥ 400.00（毛利率 28.61%）**，完全能够覆盖商品采购与包材物流成本。
+2. **多代截断机制极为关键**：`0.10` 元平级硬截断与卓越奖单层限制，彻底封死了“多代平级连环套”导致资金链断裂的行业通病。
+3. **保活沉淀形成天然对冲缓冲垫**：30 天无自购跳过机制，在实际运营中沉淀了 15%~30% 的未活跃分润，使得平台实际综合现金拨比长期维持在 **45% ~ 50%** 的黄金健康区间。