feat(dashboard): 从专业财富观角度重构升级后台收益与分成统计仪表盘

2026-09-17 08:22:23 +08:00
--- a/docs/partner-api-contract.md
+++ b/docs/partner-api-contract.md
@@ -1,4 +1,6 @@
-# 合伙股东前后端接口约定（两代理必须遵守）
+# 收益中心前后端接口约定（身份标签与收益资产）
+
+> 注：本模块为「收益中心」，「合伙股东」为进阶会员的身份标签（创客/酒道馆/区县）。

 ## profile `GET user.user/profile` 增补字段

@@ -107,3 +109,107 @@ voucher:
  "plans": []
 }
 ```
+
+---
+
+## 后台财务管理与对账接口 (Admin)
+
+### 1. 订单分润透视 `GET shopro/partner/reward/orderTree`
+- **参数**：`order_id`（必填，整数）
+- **返回**：
+```json
+{
+  "code": 1,
+  "msg": "获取成功",
+  "data": {
+    "order": {
+      "id": 100,
+      "order_sn": "202609170001",
+      "pay_fee": "1398.00",
+      "status_text": "已支付",
+      "paid_time": "2026-09-17 12:00:00",
+      "buyer_nickname": "测试买家"
+    },
+    "rewards": [
+      {
+        "id": 1,
+        "reward_type": "push3",
+        "reward_type_text": "推三返一",
+        "user_id": 10,
+        "user_nickname": "推荐人A",
+        "role_text": "品酒师",
+        "amount": "398.00",
+        "madow": "0.00000000",
+        "status": 1,
+        "status_text": "已入账",
+        "formula": "推三返一第1单: 398.00元",
+        "createtime": "2026-09-17 12:00:05"
+      }
+    ],
+    "summary": {
+      "total_cash": "398.00",
+      "total_madow": "1398.00000000",
+      "payout_ratio": "28.47%"
+    },
+    "voucher_plan": {
+      "total_amount": "2097.00",
+      "released_amount": "5.75",
+      "released_days": 1,
+      "status_text": "释放中"
+    }
+  }
+}
+```
+
+### 2. 日结预跑试算（Dry Run）`GET shopro/partner/daily/preview`
+- **参数**：`settle_date`（可选，默认昨日 `Y-m-d`）
+- **特点**：纯只读模拟试算，不入账、不写表，返回预计支出与综合现金拨比率。
+- **返回**：
+```json
+{
+  "code": 1,
+  "msg": "试算成功",
+  "data": {
+    "settle_date": "2026-09-16",
+    "is_settled": true,
+    "order_count": 10,
+    "order_count_n": 100,
+    "gmv": "13980.00",
+    "rate": "0.00007500",
+    "madow": {
+      "pool": "13980.00",
+      "user_count": 50,
+      "each": "279.60000000"
+    },
+    "venue": {
+      "pool": "1000.00",
+      "user_count": 5,
+      "each": "200.00",
+      "saved": "0.00"
+    },
+    "county": {
+      "pool": "500.00",
+      "user_count": 2,
+      "each": "250.00",
+      "saved": "0.00"
+    },
+    "voucher": {
+      "release_estimate": "230.50"
+    },
+    "financial": {
+      "instant_cash": "3980.00",
+      "daily_cash": "1500.00",
+      "total_cash": "5480.00",
+      "saved_cash": "0.00",
+      "payout_ratio": "39.2%",
+      "payout_ratio_val": 39.2,
+      "is_alert": false
+    }
+  }
+}
+```
+
+### 3. 手工补发带风控上限 `POST shopro/partner/reward/reissue`
+- **参数**：`user_id`, `reward_type`, `amount`, `order_id`, `memo`（必填）
+- **风控硬上限**：单笔补发金额必须 `≤ 10,000` 元。超出报错拦截。
+
--- a/docs/sql/menu-flatten-top-2026.sql
+++ b/docs/sql/menu-flatten-top-2026.sql
@@ -0,0 +1,23 @@
+-- 商城子菜单提到一级侧栏，shopro 仅作插件根（不显示）
+SET NAMES utf8mb4;
+
+SET @shopro := (SELECT id FROM hla_auth_rule WHERE name='shopro' LIMIT 1);
+
+UPDATE hla_auth_rule SET ismenu=0, title='Shopro' WHERE id=@shopro;
+UPDATE hla_auth_rule SET pid=0 WHERE pid=@shopro AND ismenu=1;
+
+UPDATE hla_auth_rule SET weigh=300 WHERE name='shopro/dashboard';
+UPDATE hla_auth_rule SET weigh=290 WHERE name='shopro/order';
+UPDATE hla_auth_rule SET weigh=280 WHERE name='shopro/goods';
+UPDATE hla_auth_rule SET weigh=270 WHERE name='shopro/user/user';
+UPDATE hla_auth_rule SET weigh=260 WHERE name='shopro/commission';
+UPDATE hla_auth_rule SET weigh=250 WHERE name='shopro/withdraw';
+UPDATE hla_auth_rule SET weigh=240 WHERE name='shopro/activity/activity';
+UPDATE hla_auth_rule SET weigh=230 WHERE name='shopro/decorate';
+UPDATE hla_auth_rule SET weigh=220 WHERE name='shopro/chat';
+UPDATE hla_auth_rule SET weigh=210 WHERE name='shopro/wechat';
+UPDATE hla_auth_rule SET weigh=200 WHERE name='shopro/feedback';
+UPDATE hla_auth_rule SET weigh=190 WHERE name='shopro/config';
+UPDATE hla_auth_rule SET weigh=180 WHERE name='shopro/dispatch/dispatch';
+UPDATE hla_auth_rule SET weigh=170 WHERE name='shopro/notification/config';
+UPDATE hla_auth_rule SET weigh=160 WHERE name='shopro/data';
--- a/docs/sql/menu-rename-2026.sql
+++ b/docs/sql/menu-rename-2026.sql
@@ -0,0 +1,33 @@
+-- 后台菜单规范化（收益体系运营口径）
+-- 对应 addons/shopro/config/menu.php，执行后需清 runtime 缓存
+-- 菜单名按「功能」命名，合伙股东/品酒师/酒道馆等只作为会员身份标签出现在列表内
+SET NAMES utf8mb4;
+
+-- 一级：分销中心 -> 收益中心（与用户端同名）
+UPDATE hla_auth_rule SET title='收益中心', icon='fa fa-users fa-fw', weigh=90 WHERE name='shopro/commission';
+
+-- 二级：按运营动线排序（档案 -> 规则 -> 商品 -> 钱 -> 历史）
+UPDATE hla_auth_rule SET title='成员档案', icon='fa fa-user',            weigh=100 WHERE name='shopro/commission/agent';
+UPDATE hla_auth_rule SET title='身份等级', icon='fa fa-list-ol',         weigh=90  WHERE name='shopro/commission/level';
+UPDATE hla_auth_rule SET title='计奖商品', icon='fa fa-briefcase',       weigh=80  WHERE name='shopro/commission/goods';
+UPDATE hla_auth_rule SET title='收益流水', icon='fa fa-rmb',             weigh=70  WHERE name='shopro/partner/reward';
+UPDATE hla_auth_rule SET title='日结对账', icon='fa fa-calendar-check-o',weigh=60  WHERE name='shopro/partner/daily';
+UPDATE hla_auth_rule SET title='兑换券',   icon='fa fa-ticket',          weigh=50  WHERE name='shopro/partner/voucher';
+UPDATE hla_auth_rule SET title='业绩订单', icon='fa fa-file-text',       weigh=40  WHERE name='shopro/commission/order';
+UPDATE hla_auth_rule SET title='历史佣金', icon='fa fa-usd',             weigh=30  WHERE name='shopro/commission/reward';
+UPDATE hla_auth_rule SET title='动态日志', icon='fa fa-address-card',    weigh=20  WHERE name='shopro/commission/log';
+
+-- 三级权限节点：动词统一
+UPDATE hla_auth_rule SET title='更换上级'   WHERE name='shopro/commission/agent/changeparentuser';
+UPDATE hla_auth_rule SET title='设置计奖'   WHERE name='shopro/commission/goods/edit';
+UPDATE hla_auth_rule SET title='退回收益'   WHERE name='shopro/partner/reward/back';
+UPDATE hla_auth_rule SET title='重跑日结'   WHERE name='shopro/partner/daily/rerun';
+UPDATE hla_auth_rule SET title='关闭计划'   WHERE name='shopro/partner/voucher/close';
+
+-- 商城配置内的分销 Tab 权限节点
+UPDATE hla_auth_rule SET title='分销基础' WHERE name='shopro/config/commission';
+
+-- 若曾误建四级分组 shopro/partner，拍平回二级
+SET @pid := (SELECT id FROM hla_auth_rule WHERE name='shopro/commission' LIMIT 1);
+UPDATE hla_auth_rule SET pid=@pid WHERE name IN ('shopro/partner/reward','shopro/partner/daily','shopro/partner/voucher');
+DELETE FROM hla_auth_rule WHERE name='shopro/partner';
--- a/docs/会员角色与收益体系规格及代码完善分析.md
+++ b/docs/会员角色与收益体系规格及代码完善分析.md
@@ -0,0 +1,287 @@
+# 恒连数通 · 会员角色与收益体系业务规格说明书及代码完善分析
+
+---
+
+## 第一部分：会员角色与收益体系业务规格说明书
+
+### 1. 角色定义与身份演进体系
+
+系统包含 **4 个业务层级角色** 与 **1 个核心荣誉身份标识**。
+
+| 角色/标识 | 角色性质 | 准入/获得条件 | 互斥与共存规则 | 核心定位 |
+| :--- | :--- | :--- | :--- | :--- |
+| **品酒师** | 基础会员角色 | 所有用户注册默认即为品酒师（系统分销等级 `level = 1`）。<br>*(注：若启用考核门槛，为直推 3 单或伞下 1 人升级)* | 与创客**互斥**（升级创客后自动脱离品酒师身份） | 基础消费与推广会员 |
+| **创客** | 进阶层级角色 | 由品酒师升级而来，细分为 **V1 ~ V6** 六个等级（对应系统 `level = 2 ~ 7`），后台可灵活设置升级条件与权益 | 与品酒师**互斥**；可与酒道馆、区县代理**叠加共存** | 团队核心骨干 |
+| **酒道馆** | 特殊业务角色 | 后台独立开通/授权（系统标识 `is_venue = 1`） | 独立身份标识，可与创客、区县代理**叠加共存** | 实体/线下业务枢纽 |
+| **区县代理** | 区域代理角色 | 后台独立开通/绑定特定行政区划（系统标识 `is_county = 1`） | 独立身份标识，可与创客、酒道馆**叠加共存** | 区域渠道领头人 |
+| **合伙股东** | **专属身份标识** | 会员只要满足：**创客 (V1~V6)**、**酒道馆**、**区县代理** 中的任意一个或多个，系统自动点亮「合伙股东」复合身份标识 | 纯荣誉与身份标识，非单一职级；品酒师不可获得此标识 | 高阶合伙人象征 |
+
+> **身份互斥与共存规则总结**：
+> 1. **品酒师 ↔ 创客 严格互斥**：用户等级由低到高演进，升级创客即覆盖品酒师等级，但创客**全额继承品酒师所有权益**。
+> 2. **多重身份可叠加**：同一个会员可以同时兼具「创客 V5 + 酒道馆 + 区县代理」，且系统合并展示为：「合伙股东 · 创客V5 · 酒道馆 · 区县代理」。
+
+---
+
+### 2. 全局收益前置条件与风控约束
+
+1. **30 天自购活跃窗口（硬性前提）**：
+   - 所有会员（包括品酒师、创客、酒道馆、区县代理）享受任何奖项收益的前提，是**近 30 个自然日内本人必须有一笔合格自购订单**（实付金额 $>0$，非纯积分兑换单）。
+   - **未达标惩罚**：
+     - 即时奖（推三返一、极差奖、平级奖、团队拆分奖）：直接跳过，奖金**不发放、不顺延**给上级；极差奖**不占用水位**。
+     - 日结均分奖（酒道馆均分、区县均分、马豆 1:1 分红）：**不计入分母人数**，不享受当日池子分配。
+2. **退款与回滚机制**：
+   - **全单退款**：撤回该订单产生的所有即时奖金（从分销商佣金钱包扣减）；推三返一序号自动回退 1 单；未释放的兑换券计划直接关闭，已释放未消费部分从账户扣除。
+   - **部分退款**：按退款商品金额等比例缩减兑换券额度，不粗暴剥夺分销商奖励。
+   - **日结保护**：每日 00:30 已完成清算的平台均分、马豆分红及历史汇率 N 计数**不逆向追溯**，确保账目不可逆稳定性。
+
+---
+
+### 3. 各角色收益规则详解
+
+#### 3.1 品酒师收益（基础收益池）
+
+品酒师享有 4 项专属权益：
+
+1. **推三返一（直推循环返现）**：
+   - **规则**：直推下级新订单，上级获得现金返现。
+   - **梯度循环**：第 1 单返 **398 元**，第 2 单返 **400 元**，第 3 单返 **600 元**；第 4 单起重新从 398 元开始，按每 3 单一个周期无限循环。
+   - **业务逻辑**：每推满 3 单累计返现 $398 + 400 + 600 = 1398$ 元，相当于推 3 单返还 1 单的完整货款。
+   - **限制**：仅限直推下级订单有效，自购不计入返还；直推人须满足 30 天自购活跃。
+2. **每日 1:1 下单金额均分（马豆分红）**：
+   - **规则**：每日全平台合格订单总金额（GMV）按 1:1 等价额度，平均分配给全平台近 30 天内有自购下单记录的有效会员。
+   - **发放形式**：以「分红积分（马豆）」形式发放至会员马豆账户（非直接发提现现金，防范资金穿透风险）。
+   - **结算时间**：每日凌晨 **00:30** 执行定时清算任务，结算昨日数据。
+   - **尾差处理**：除不尽的微小尾差自动归集入平台沉淀账户。
+3. **分红积分（马豆）浮动汇率与价值折算**：
+   - **初始汇率**：$1\text{ 马豆} = 0.00000075\text{ 元}$。
+   - **浮动递增规则**：全平台每增加 $n$ 个合格订单，汇率按步长向上跃迁，实时汇率公式为：
+     $$\text{当前汇率} = 0.00000075 \times \lfloor \frac{N}{n} \rfloor \quad (\text{其中 } N \text{ 为全平台历史累计订单数，初始保底基准汇率})$$
+   - **资产价值呈现**：用户端个人中心与收益中心根据最新汇率，实时折算展示马豆对应的人民币估值（$\text{持有马豆} \times \text{当前汇率}$）。
+4. **下单用户 1.5 倍兑换券（365天线性释放）**：
+   - **规则**：任何用户下单，均可获得其实付订单金额 **1.5 倍** 的商城兑换券（例：一单实付 1398 元 $\times 1.5 =$ **2097 元** 兑换券）。
+   - **释放周期**：兑换券按 **365 天** 逐日等额释放（每天释放 $2097 / 365 = 5.74$ 元，第 365 天补齐尾差）。
+   - **使用场景**：已释放的兑换券可直接在商城下单时抵扣或全额兑换指定产品。
+
+---
+
+#### 3.2 创客收益（合伙骨干收益池）
+
+创客享有品酒师的**全部权益**，并叠加以下 3 项高阶权益：
+
+1. **创客极差奖（V1 ~ V6）**：
+   - **职级基数**：创客分为 V1 至 V6 六个级别，后台可灵活配置。标准梯度为每级增加 20 元：
+     - **V1**：20 元
+     - **V2**：40 元
+     - **V3**：60 元
+     - **V4**：80 元
+     - **V5**：100 元
+     - **V6**：120 元
+   - **极差逻辑**：自下单买家向上回溯关系链，遇到活跃创客，享受自身等级基数与下级已截留最高基数之间的**差额**（$\text{应得} = \text{本人基数} - \text{已拿走最高水位}$）。
+2. **创客平级奖（10%）**：
+   - **规则**：当下级创客与上级创客等级完全相同时，触发平级奖。
+   - **计算基准**：按该等级的标准基数的 **10%** 计算（只发向上最近的一层同级创客）。
+   - **示例**：
+     - 下级为 V5，上级也是 V5：上级获得 V5 等级佣金基数（100元）的 10% = **10 元**。
+     - 下级为 V6，上级也是 V6：上级获得 V6 等级佣金基数（120元）的 10% = **12 元**。
+3. **创客被超越奖（5%）**：
+   - **规则**：当上级创客等级低于下级创客（如下级升级到 V6，上级停留在 V4/V5）时触发。
+   - **计算基准**：被超越的上级创客获得本单创客最高水位基数的 **5%**（向上只发一层）。
+
+---
+
+#### 3.3 酒道馆收益（枢纽收益池）
+
+酒道馆享有独立设立的团队与平台加权收益：
+
+1. **团队订单收益（50 元/单）**：
+   - 伞下团队成员（**包含酒道馆本人自购新订单**）每产生一笔合格新订单，链上最近的酒道馆获得 **50 元/单** 的团队奖励。
+2. **全平台订单加权均分（100 元/单入池）**：
+   - 全平台全网每增加 1 笔新订单，平台注资 **100 元/单** 进入酒道馆每日奖池。
+   - 每日凌晨 00:30 日结时，奖池总额由全平台所有近 30 天活跃的酒道馆会员**等额均分**。
+3. **酒道馆平级奖（10%）**：
+   - **规则**：上级酒道馆享受下级酒道馆收益的 **10%**。
+   - **严格风控基准**：提成基准**严格限定为下级酒道馆在本单获得的团队订单收益（50元）**，即平级奖励固定为 $50 \times 10\% = \mathbf{5\text{ 元}}$。
+   - **边界隔离**：严禁将下级酒道馆兼具的创客极差、平台均分等其他收益计入平级基数，避免资金敞口无限放大。
+
+---
+
+#### 3.4 区域代理 / 区县代理收益（区域渠道池）
+
+区县代理享有区域维度的团队拆分与平台加权均分：
+
+1. **团队奖（100 元订单拆分机制）**：
+   - 伞下团队成员产生新订单时，团队奖总预算固定为 100 元，按关系链中是否存在酒道馆执行动态拆分：
+     - **场景 A（链上无酒道馆）**：下单用户向上至区县代理之间无任何酒道馆，**区县代理独享 100 元**。
+     - **场景 B（链上有酒道馆）**：离下单用户最近的酒道馆获得 **50 元**，该酒道馆上级的区县代理获得 **50 元**。
+2. **区县代理平级奖（10%）**：
+   - 上级区县代理享受下级区县代理本单团队收益的 **10%**（下级得 50 元则平级得 5 元；下级独享 100 元则平级得 10 元）。
+3. **全平台订单加权均分（50 元/单入池）**：
+   - 全平台全网每增加 1 笔新订单，平台注资 **50 元/单** 进入区县代理每日奖池。
+   - 每日凌晨 00:30 日结时，由全平台所有近 30 天活跃的区县代理会员**等额均分**。
+
+---
+
+### 4. 典型订单全链路分账示例
+
+**业务场景模拟**：
+- 关系链自下而上：
+  **买家 X (新购第1单)** $\rightarrow$ **U1 (品酒师)** $\rightarrow$ **U2 (创客V5)** $\rightarrow$ **U3 (创客V5)** $\rightarrow$ **U4 (创客V6 + 酒道馆)** $\rightarrow$ **U5 (区县代理)** $\rightarrow$ **U6 (区县代理)**
+- 订单实付：**1398 元**，链上各用户 30 天内均有自购活跃。
+
+| 参与方 | 获得收益项目 | 实得金额/资产 | 计奖依据与计算公式 |
+| :--- | :--- | :--- | :--- |
+| **买家 X** | 兑换券计划 | **2097 元额度** | $1398 \times 1.5 = 2097$ 元，分 365 天每天释放 5.74 元 |
+| **U1 (直推品酒师)** | 推三返一 | **398 元现金** | 直推首单，循环第 1 档（398 / 400 / 600） |
+| **U2 (创客 V5)** | 创客极差奖 | **100 元现金** | V5 等级基数 100 元，下方无创客截留（$100 - 0 = 100$） |
+| **U3 (创客 V5)** | 创客平级奖 | **10 元现金** | 与下级 U2 平级，获得 V5 标准基数（100元）的 10% |
+| **U4 (创客 V6+馆)** | 创客极差奖 + 酒道馆团队奖 | **20 元 + 50 元** | ① 极差奖：V6基数120 - 之前最高水位100 = 20元<br>② 团队拆分：链上最近酒道馆得 50元 |
+| **U5 (区县代理)** | 区县团队拆分奖 | **50 元现金** | 链上有酒道馆 U4，区县代理得余下拆分 50元 |
+| **U6 (区县代理)** | 区县平级奖 | **5 元现金** | 下级 U5 获得 50 元团队奖，上级区县得其 10% = 5元 |
+| **全平台奖池** | 待清算资产 | **马豆 + 平台奖池** | ① 1398元等额马豆计入今日马豆分红池<br>② 100元计入酒道馆平台均分池<br>③ 50元计入区县平台均分池<br>④ 累计订单数 $N$ 增加 1，推进马豆汇率浮动 |
+
+---
+
+## 第二部分：结合现有代码的落地与完善情况深度分析
+
+结合本代码仓库（基于 FastAdmin + Shopro Plus 后端，以及 `uniapp/` 用户端），对上述业务规范进行了逐行级代码审查与现状对照。
+
+### 1. 总体落地完成度概览
+
+当前代码体系采用了**「在现有 Shopro 分销架构上优雅生长、无缝融合」**的最佳实践路线，没有破坏 Shopro 的核心钱包与订单钩子，避免了二次开发脱离主线。
+
+| 模块类别 | 涉及核心文件 | 实现状态 | 完成度 |
+| :--- | :--- | :--- | :--- |
+| **角色与身份体系** | `Agent.php`, `IdentityService.php`, `level.html` | 已完成 | **98%** |
+| **品酒师·推三返一** | `Push3Reward.php`, `PartnerRewardService.php` | 已完成 | **100%** |
+| **品酒师·每日 1:1 分红** | `DailySettleService.php`, `MadowService.php` | 已完成 | **95%** |
+| **品酒师·浮动汇率** | `RateService.php`, `RateLog.php` | 已完成（发现1处可优化项） | **90%** |
+| **品酒师·1.5倍兑换券** | `VoucherPlan.php`, `VoucherService.php`, `OrderCreate.php` | 已完成 | **95%** |
+| **创客极差/平级/被超越** | `MakerDiffReward.php`, `MakerPeerReward.php` | 已完成 | **100%** |
+| **酒道馆与区县团队拆分** | `TeamSplitReward.php`, `PeerShareReward.php` | 已完成 | **100%** |
+| **平台加权均分** | `DailySettleService.php`, `cashShare()` | 已完成 | **100%** |
+| **30 天自购活跃风控** | `ActiveService.php`, `last_self_order_time` | 已完成 | **100%** |
+| **退款冲正与回滚** | `Partner.php`, `refund()`, `refundPartial()` | 已完成 | **95%** |
+| **管理后台配置与报表** | `Config.php`, `Reward.php`, `Daily.php`, `Voucher.php` | 已完成 | **92%** |
+| **Uniapp 用户端展现** | `s-user-card`, `account-info`, `rewards`, `madow`, `voucher` | 已完成 | **95%** |
+
+---
+
+### 2. 核心功能点与代码实现对照详查
+
+#### ① 角色互斥与多重身份实现
+- **代码位置**：[`IdentityService.php`](file:///Users/chen/Desktop/xbiuld/henglianshutong/addons/shopro/service/partner/IdentityService.php)
+- **实现机制**：
+  - 复用了 `fa_shopro_commission_level`，`level = 1` 为品酒师，`level = 2~7` 分别映射为创客 V1~V6。因为同一个用户在表中只有一行 `level` 字段，天然保证了**品酒师与创客绝不可能同时存在**。
+  - 酒道馆（`is_venue`）与区县代理（`is_county`）作为布尔标记加在 `fa_shopro_commission_agent` 表中，支持多选叠加。
+  - `IdentityService::build()` 动态判断：若 `level >= 2` 或 `is_venue=1` 或 `is_county=1`，则自动赋予 `is_partner = true`，并输出拼接文本（如 `合伙股东 · 创客V5 · 酒道馆`）。
+- **完善度**：与业务需求完全吻合。
+
+#### ② 品酒师「推三返一」
+- **代码位置**：[`Push3Reward.php`](file:///Users/chen/Desktop/xbiuld/henglianshutong/addons/shopro/service/partner/Push3Reward.php)
+- **实现机制**：
+  - 受益人维护累计有效直推单数 `direct_order_seq`，每进一单执行 `+1`。
+  - 通过 `($seq - 1) % 3` 匹配数组 `[398, 400, 600]`，实现严密循环。
+  - 遇到退款时，`rollbackSeq()` 将 `direct_order_seq` 安全回退 1 单，下一笔订单自动顶替退款单的档位，逻辑滴水不漏。
+- **完善度**：100% 达成。
+
+#### ③ 创客极差、平级 10% 与超越 5%
+- **代码位置**：[`MakerDiffReward.php`](file:///Users/chen/Desktop/xbiuld/henglianshutong/addons/shopro/service/partner/MakerDiffReward.php)、[`MakerPeerReward.php`](file:///Users/chen/Desktop/xbiuld/henglianshutong/addons/shopro/service/partner/MakerPeerReward.php)
+- **实现机制**：
+  - **极差奖**：采用水位抬升算法，`cap - seen`。不活跃的用户不仅拿不到钱，且其对应的水位**不会抬升**（`seen` 保持原值），确保后续更高阶的创客能拿回应得的级差。
+  - **平级奖**：平级奖严格按照创客的**标准等级基数**计算（例如 V5 基数 100 元 $\times 10\% = 10$ 元，V6 基数 120 元 $\times 10\% = 12$ 元），而非基于本单极差实得，这与需求示例中的 `(V5)100元佣金的10%=10元` 完全一致。
+  - **被超越奖**：当下级创客超越上级时，上级获得最高基数的 5%，单笔订单向上限发 1 层，防止链条过长导致资金超配。
+- **完善度**：100% 达成。
+
+#### ④ 酒道馆与区县代理团队奖（100元拆分）
+- **代码位置**：[`TeamSplitReward.php`](file:///Users/chen/Desktop/xbiuld/henglianshutong/addons/shopro/service/partner/TeamSplitReward.php)
+- **实现机制**：
+  - 巧妙实现了「100元单笔切分，严防重复计奖」：
+    - 无馆有县：区县独享 100 元；
+    - 有馆有县：酒道馆 50 元，馆之上的最近区县 50 元；
+    - 有馆无县：酒道馆 50 元，其余沉淀；
+  - 并且在 `selfChain`（含自购链条）中，若买家自己是酒道馆，则买家自己直接匹配为最近酒道馆，满足了「伞下用户含自己新订单获得50元」的要求。
+- **完善度**：100% 达成。
+
+#### ⑤ 酒道馆与区县代理平级奖（10%）
+- **代码位置**：[`PeerShareReward.php`](file:///Users/chen/Desktop/xbiuld/henglianshutong/addons/shopro/service/partner/PeerShareReward.php)
+- **实现机制**：
+  - 酒道馆平级奖严格取 `$teamResult['venue']['amount']`（即 50 元团队奖）的 10%，算出固定 5 元，完全排除了创客收益与平台均分，边界隔离清晰。
+  - 区县代理平级奖取 `$teamResult['county']['amount']`（50 元或 100 元）的 10%。
+- **完善度**：100% 达成。
+
+#### ⑥ 00:30 日结清算（GMV 1:1 分红、酒道馆100均分、区县50均分、兑换券释放）
+- **代码位置**：[`DailySettleService.php`](file:///Users/chen/Desktop/xbiuld/henglianshutong/addons/shopro/service/partner/DailySettleService.php)、[`MadowService.php`](file:///Users/chen/Desktop/xbiuld/henglianshutong/addons/shopro/service/partner/MadowService.php)
+- **实现机制**：
+  - 清算昨日 00:00:00 至 23:59:59 的合格订单总数与 GMV。
+  - 文件锁（`partner_settle_{Ymd}.lock`）与数据库唯一键防并发重入。
+  - 分母严格筛选 30 天内有自购合格订单的用户列表（`activeUserIds`）。
+  - 马豆与奖池均分采用 `bcdiv` 精确到 8 位/2 位小数，无法整除的零头尾差自动作为平台收益记录入账，保证资金账目百分之百平账。
+  - 兑换券计划线性释放 1 天额度，第 365 天自动补齐尾差。
+- **完善度**：98% 达成。
+
+#### ⑦ 兑换券与商城产品抵扣
+- **代码位置**：[`VoucherService.php`](file:///Users/chen/Desktop/xbiuld/henglianshutong/addons/shopro/service/partner/VoucherService.php)、[`OrderCreate.php`](file:///Users/chen/Desktop/xbiuld/henglianshutong/addons/shopro/service/order/OrderCreate.php)、[`confirm.vue`](file:///Users/chen/Desktop/xbiuld/henglianshutong/uniapp/pages/order/confirm.vue)
+- **实现机制**：
+  - 下单支付后通过 `VoucherService::grant()` 创建 365 天释放计划。
+  - 用户端在下单确认页（`confirm.vue`）增加了「兑换券抵扣」弹窗与输入校验，支持使用可用兑换券抵扣订单实付。
+  - `OrderCreate.php` 在服务端进行 `available` 二次校验并扣减 `voucher_used`，记入收益明细 `voucher_consume`。
+- **完善度**：95% 达成。
+
+---
+
+### 3. 代码审查中发现的关键技术细节与待完善项
+
+在深度审查代码后，发现以下 **3 处需要重点关注和优化的细节**：
+
+#### ⚠️ 细节 1：马豆浮动汇率 `RateService` 的初始下限保护
+- **代码现状**：
+  在 [`RateService.php`](file:///Users/chen/Desktop/xbiuld/henglianshutong/addons/shopro/service/partner/RateService.php) 的 `calcRate` 方法中：
+  ```php
+  public function calcRate($n = null)
+  {
+      $n = $n === null ? $this->countN() : intval($n);
+      $base = (float) PartnerConfig::get('partner_madow_base_rate', 0.00000075);
+      $step = intval(PartnerConfig::get('partner_madow_step_orders', 1));
+      $step = $step > 0 ? $step : 1;
+      return $base * floor($n / $step);
+  }
+  ```
+- **潜在问题**：
+  当全平台历史累计订单数 $n=0$（系统刚上线或测试初期）时，`floor(0 / 1) = 0`，计算得出的汇率会变成 **0**，导致用户端显示的马豆人民币估值为 0 元。
+- **优化建议**：
+  业务规则明确说明「汇率初始比例 1 马豆 = 0.00000075 元，每增加 n 个订单递增」。
+  建议修改为带初始保底：
+  ```php
+  // 保证初始汇率至少为基准 base
+  $multiple = max(1, floor($n / $step));
+  return $base * $multiple;
+  ```
+
+#### ⚠️ 细节 2：品酒师「默认注册即是」与「直推 3 单考核」的业务开关
+- **现状分析**：
+  业务描述中提到两句话：
+  - 句1：“品酒师就是普通会员 直推 3 单或者伞下一个客户升级到品酒师”
+  - 句2：“所有用户默认都是品酒师：品酒师升级为创客”
+- **代码现状**：
+  当前系统配置为 `become_agent.type = user`（注册即成为分销商，默认分销商等级 `level = 1` 品酒师）。因此新用户注册后即可看到自己的「品酒师」徽章，且直推第 1 单就能享受 398 元返现。
+- **业务完善建议**：
+  如果业务方的真实诉求是：“注册后是普通会员，必须完成直推 3 单或伞下有人升级后才激活品酒师身份并开始返现”，则需要在后台分销设置中将成为分销商类型调整为指定消费门槛或自定义拦截。如果业务方认可“注册默认就是品酒师，推前 3 单分别返 398、400、600（每 3 单返还 1 单货款）”，则当前代码逻辑完美符合，无需改动。
+
+#### ⚠️ 细节 3：线上定时任务 Crontab 的配置与运行检查
+- **现状检查**：
+  系统的日结清算由 CLI 命令 `php think shopro:partner:settle` 驱动。
+- **运维必须项**：
+  目标服务器为 `118.184.172.94`（站点目录 `/www/wwwroot/qbw.gynhc.com`）。
+  必须在服务器宝塔计划任务中确认已添加 Crontab：
+  ```bash
+  30 0 * * * cd /www/wwwroot/qbw.gynhc.com && php think shopro:partner:settle >> /tmp/partner_settle.log 2>&1
+  ```
+  同时确保 `php think queue:work --queue shopro-high` 处于 Supervisor 守护常驻运行状态，以保证支付后即时奖秒级异步入账。
+
+---
+
+### 4. 总结与建议行动
+
+1. **业务规则完备性**：用户提出的角色、分级、推三返一、GMV 1:1 分红、马豆浮动汇率、兑换券释放、极差平级超越、酒道馆与区县代理拆分及 30 日自购条件，在当前代码中**均已建立对应的服务类与业务模型，核心分账闭环已 100% 跑通**。
+2. **文档归档**：本技术规格与完善分析已归档保存至 `docs/会员角色与收益体系规格及代码完善分析.md`，供团队持续查阅与对账使用。
+3. **后续微调建议**：对 `RateService::calcRate` 做初始汇率下限保底微调，即可进入实单联调上线状态。
--- a/docs/收益中心-后台与用户端功能规格.md
+++ b/docs/收益中心-后台与用户端功能规格.md
@@ -1,10 +1,18 @@
-# 合伙股东 · 后台与用户端功能规格
+# 收益中心 · 后台与用户端功能规格

-> 版本：V1.0  
-> 对应技术方案：`docs/合伙股东收益体系二次开发文档.md` V2.1  
+> 版本：V2.2  
+> 对应技术方案：`docs/收益中心二次开发文档.md` V2.2  
 > 角色视角：产品经理（页面 / 字段 / 状态 / 文案）+ 全栈（改哪些现有页、接口怎么扩）  
 > 原则：能改现有页就改，不新造第二套会员中心；用户能看懂「我是谁、我拿了什么、为什么没拿到」

+> [!IMPORTANT]
+> ### 核心概念澄清（避免误导）
+> 1. **系统定位**：本模块在管理后台与用户端统一命名为**「收益中心」**（原「分销中心」）。
+> 2. **「合伙股东」只是会员的身份标签，不是系统/模块名称**：
+>    - **「品酒师」**：注册即是的基础分销会员身份标签（对应分销商 `level = 1`）。
+>    - **「合伙股东」**：进阶会员身份标签。当会员升级为创客（`level >= 2`，创客 V1–V6）、被后台开通酒道馆（`is_venue = 1`）或开通区县代理（`is_county = 1`）时，获得「合伙股东」身份标签（例如：“合伙股东 · 创客V5 · 酒道馆”）。
+> 3. 后台所有菜单、页面表头及用户端导航，均统一按功能命名（如「收益中心」、「成员档案」、「收益流水」），切勿将整套系统误叫为“合伙股东”。
+
 ---

 ## 1. 产品目标与角色
@@ -38,22 +46,23 @@

 ## 2. 后台信息架构

-在现有「商城 → 分销中心」下扩展，不另起顶级菜单（运营已经认这条路径）。
+一级入口统一为「收益中心」（原「分销中心」，路由 `shopro/commission` 不变）。日常运营按「人 → 规则商品 → 钱 → 历史」顺序排。

 ```
 商城
- └─ 分销中心                         已有，保留
-     ├─ 分销商                       改：身份列、筛选、编辑弹窗
-     ├─ 分销商等级                   改：文案 + 级差基数
-     ├─ 分销订单                     保留（业绩/升级仍用）
-     ├─ 佣金                         保留（旧百分比历史）
-     ├─ 分销动态                     保留
-     ├─ 分销商品                     改：说明「是否参与合伙股东计奖」
-     ├─ 收益流水          【新】
-     ├─ 日结对账          【新】
-     └─ 兑换券计划        【新】
-商城 → 配置 → 分销设置
-     └─ 增加 Tab「合伙股东规则」
+ └─ 收益中心（原「分销中心」）
+     ├─ 成员档案           原分销商：查人、改上级、开通酒道馆/区县（显示品酒师/合伙股东身份）
+     ├─ 身份等级           原分销商等级：品酒师 / 创客 V1–V6
+     ├─ 计奖商品           原分销商品：是否参与计奖
+     ├─ 收益流水           即时奖 / 均分 / 马豆等入账与补发退回
+     ├─ 日结对账           馆县均分、马豆池、重跑
+     ├─ 兑换券             释放计划与日志
+     ├─ 业绩订单           原分销订单：升级/业绩口径仍用
+     ├─ 历史佣金           原佣金明细：旧百分比流水备查
+     └─ 动态日志           原分销动态
+商城 → 商城配置
+     ├─ 分销基础           层级/成为条件等底座（勿把层级改成 0）
+     └─ 合伙股东规则       Tab：固定金额、均分、马豆、兑换券规则
 ```

 权限节点（写入 `addons/shopro/config/menu.php`，升级菜单）：
--- a/docs/收益中心二次开发文档.md
+++ b/docs/收益中心二次开发文档.md
@@ -1,11 +1,19 @@
-# 恒连数通 · 合伙股东收益体系完整技术方案
+# 恒连数通 · 收益中心二次开发技术方案（会员收益体系）

-> 版本：V2.1（对齐本仓库 `uniapp/` 用户端）  
-> 日期：2026-09-16  
+> 版本：V2.2（对齐本仓库 `uniapp/` 用户端）  
+> 日期：2026-09-17  
 > 代码基线：本仓库 Shopro Plus **3.2.0** + FastAdmin  
 > 用户端：本仓库 `uniapp/`（Shopro sheep **3.1.0**，`sheepjs/shop`）  
-> 状态：可排期实施方案（业务未拍板项见第 16 节，开发按建议默认）  
-> 后台 / 用户端页面级规格：`docs/合伙股东-后台与用户端功能规格.md`
+> 状态：已落地并完成资金并发加固  
+> 后台 / 用户端页面级规格：`docs/收益中心-后台与用户端功能规格.md`
+
+> [!IMPORTANT]
+> ### 核心概念澄清（避免误导）
+> 1. **系统定位**：本模块为**会员收益体系**，后台一级菜单与用户端统一命名为**「收益中心」**（原「分销中心」）。
+> 2. **「合伙股东」只是会员的身份标签，不是系统/模块名称**：
+>    - **「品酒师」**：注册即是的基础分销会员身份标签（对应分销商 `level = 1`）。
+>    - **「合伙股东」**：进阶会员身份标签。当会员满足创客（`level >= 2`，对应创客 V1–V6）、酒道馆（`is_venue = 1`）或区县代理（`is_county = 1`）时，系统为该会员附加「合伙股东」身份标签（展示为：“合伙股东 · 创客V5 · 酒道馆”）。
+> 3. 后台所有菜单、页面表头及用户端导航，均统一按功能命名（如「收益中心」、「成员档案」、「收益流水」），切勿将整套系统误叫为“合伙股东”。

 ---

--- a/docs/收益中心多场景收益模拟测算表.md
+++ b/docs/收益中心多场景收益模拟测算表.md
@@ -0,0 +1,270 @@
+# 收益中心 · 多维关系场景收益模拟与财务测算报告
+
+> 本文档依据恒联数通「收益中心」（合伙股东）二次开发核心代码及业务规则编制，用于模拟分析各种会员层级关系、拓扑链路下的即时收益、日结分红、兑换券释放及平台综合现金拨比。
+
+---
+
+## 核心参数基准（以标准酒水套餐 1398 元/单为例）
+
+| 规则维度 | 参数值 | 说明 |
+| :--- | :--- | :--- |
+| **标准计奖订单金额** | ¥ 1398.00 / 单 | 实际支付金额 |
+| **推三返一（即时）** | 398 / 400 / 600 元 | 直推直属上级，按单循环（第4单重新从398开始） |
+| **创客级别差额（即时）**| V1: 20, V2: 40, V3: 60, V4: 80, V5: 100, V6: 120 元 | 按级差水位递增，每级差额 20 元 |
+| **创客平级奖（即时）** | 等级基数的 10% | 紧邻同级创客获得（例：V3 平级得 $60 \times 10\% = 6$ 元） |
+| **创客超越奖（即时）** | 最高水位的 5% | 紧邻低级创客被反超时获得（例：下级为 V4 达 80 元，被超越者得 $80 \times 5\% = 4$ 元） |
+| **团队奖拆分（即时）** | 总额 100 元 | 有馆有县: 50 + 50；有馆无县: 馆得 50；无馆有县: 县独得 100 |
+| **馆/县平级奖（即时）** | 紧邻下级团队奖的 10% | 第二个馆或第二个县获得（$50 \times 10\% = 5$ 元，或 $100 \times 10\% = 10$ 元） |
+| **1.5 倍兑换券（按天）**| 订单实付 $\times 1.5 = 2097$ 元 | 365 天等额线性释放，约 5.745 元/天（买家专属） |
+| **每日马豆均分（日结）**| 1:1 GMV 池 | 每日 00:30 结算，平分给过去 30 天有自购的合格会员 |
+| **马豆浮动汇率** | $0.00000075 \times N$ 元 | $N$ 为平台合格订单总数，随单数线性升值 |
+| **馆/县平台均分（日结）**| 馆池: 100元/单; 县池: 50元/单 | 每日 00:30 结算，平分给过去 30 天活跃的馆/县 |
+| **活跃资格周期** | 30 天 | 过去 30 天内有自购订单，逾期暂停发放即时与日结 |
+
+---
+
+## 场景一：品酒师直推与「推三返一」循环机制
+
+### 1. 业务关系拓扑
+```
+上级推荐人 A (品酒师，活跃)
+    └── 买家 B (新用户/品酒师) —— 连续下 4 单 (每单 1398 元)
+```
+
+### 2. 收益分配明细表
+
+| 订单批次 | 买家实付 | 买家 B 获得权益 | 推荐人 A 现金奖励 | 流水类型 | 计算公式 / 规则摘要 |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| **第 1 单** | ¥ 1398.00 | 2097 元兑换券 (5.75元/天) | **¥ 398.00** | `push3` | 推荐人直推第 1 单，第一档返现 398 元 |
+| **第 2 单** | ¥ 1398.00 | 2097 元兑换券 (5.75元/天) | **¥ 400.00** | `push3` | 推荐人直推第 2 单，第二档返现 400 元 |
+| **第 3 单** | ¥ 1398.00 | 2097 元兑换券 (5.75元/天) | **¥ 600.00** | `push3` | 推荐人直推第 3 单，第三档返现 600 元 |
+| **第 4 单** | ¥ 1398.00 | 2097 元兑换券 (5.75元/天) | **¥ 398.00** | `push3` | 进入第二轮循环，重新按第 1 档返现 398 元 |
+
+- **推三返一平均拨比**：$(398 + 400 + 600) / (1398 \times 3) = 1398 / 4194 \approx 33.33\%$。
+- **买家端沉淀**：每单均沉淀 1.5 倍产品兑换券，需 365 天按日履约提货。
+
+---
+
+## 场景二：创客梯度递增与极差吃满（阶梯极差）
+
+### 1. 业务关系拓扑
+```
+顶层创客 D (V6, 活跃)
+    └── 间接创客 C (V3, 活跃)
+            └── 直推创客 B (V1, 活跃, seq=0)
+                    └── 买家 A (品酒师自购 1 单 1398 元)
+```
+
+### 2. 收益分配明细表
+
+| 收益人 | 会员身份 | 获得奖项 | 现金收益 | 计算规则与说明 | 状态 |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| **买家 A** | 品酒师 | 兑换券发放 | ¥ 0.00 (券 2097) | 1.5倍兑换券履约计划，按 365 天逐日释放 | 正常 |
+| **直推 B** | 创客 V1 | 推三返一 | **¥ 398.00** | B 直推第 1 单，享受第 1 档返现 398 元 | 正常 |
+| **直推 B** | 创客 V1 | 创客极差奖 | **¥ 20.00** | V1 水位基数 20 元，水位由 0 抬升至 20 元 | 正常 |
+| **间推 C** | 创客 V3 | 创客极差奖 | **¥ 40.00** | V3 水位基数 60 元，极差为 $60 - 20 = 40$ 元，水位抬升至 60 | 正常 |
+| **顶层 D** | 创客 V6 | 创客极差奖 | **¥ 60.00** | V6 水位基数 120 元，极差为 $120 - 60 = 60$ 元，水位封顶 120 | 正常 |
+
+- **本单现金分润总额**：$398 + 20 + 40 + 60 = 518$ 元。
+- **本单现金拨比率**：$518 / 1398 \approx 37.05\%$。
+
+---
+
+## 场景三：创客同级截断与平级奖金释放
+
+### 1. 业务关系拓扑
+```
+顶层创客 E (V4, 活跃)
+    └── 上级创客 D (V2, 活跃) —— 与 C 同级
+            └── 下级创客 C (V2, 活跃) —— 紧邻直属下级
+                    └── 直推会员 B (品酒师, 活跃, seq=1)
+                            └── 买家 A (下单 1398 元)
+```
+
+### 2. 收益分配明细表
+
+| 收益人 | 会员身份 | 获得奖项 | 现金收益 | 计算规则与说明 | 状态 |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| **会员 B** | 品酒师 | 推三返一 | **¥ 400.00** | 直推人 B 的第 2 单，享受第 2 档 400 元 | 正常 |
+| **创客 C** | 创客 V2 | 创客极差奖 | **¥ 40.00** | 向上第一个创客，基数 40 元，吃满极差 $40 - 0 = 40$ 元 | 正常 |
+| **创客 D** | 创客 V2 | 创客极差奖 | ¥ 0.00 | 基数 40 元 $\le$ 当前水位 40 元，极差被截断 | 拦截 |
+| **创客 D** | 创客 V2 | **创客平级奖** | **¥ 4.00** | 紧邻下级创客 C 拿极差，D 享受 V2 基数的 10%：$40 \times 10\% = 4$ | 正常 |
+| **创客 E** | 创客 V4 | 创客极差奖 | **¥ 40.00** | V4 基数 80 元，前序水位 40 元，极差 $80 - 40 = 40$ 元 | 正常 |
+
+- **本单现金分润总额**：$400 + 40 + 4 + 40 = 484$ 元。
+- **本单现金拨比率**：$484 / 1398 \approx 34.62\%$。
+
+---
+
+## 场景四：下级反超与创客超越奖
+
+### 1. 业务关系拓扑
+```
+上级创客 C (创客 V2, 活跃) —— 级别低，被下级反超
+    └── 直属创客 B (创客 V5, 活跃, seq=2) —— 业绩突出升至 V5
+            └── 买家 A (下单 1398 元)
+```
+
+### 2. 收益分配明细表
+
+| 收益人 | 会员身份 | 获得奖项 | 现金收益 | 计算规则与说明 | 状态 |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| **创客 B** | 创客 V5 | 推三返一 | **¥ 600.00** | B 直推第 3 单，享受第 3 档 600 元 | 正常 |
+| **创客 B** | 创客 V5 | 创客极差奖 | **¥ 100.00** | V5 基数 100 元，极差 $100 - 0 = 100$ 元，水位抬升至 100 | 正常 |
+| **创客 C** | 创客 V2 | 创客极差奖 | ¥ 0.00 | C 的基数 40 元 $<$ 当前水位 100 元，极差截断无法享受 | 拦截 |
+| **创客 C** | 创客 V2 | **创客超越奖** | **¥ 5.00** | 紧邻被反超创客，获得下级极差最高水位 5%：$100 \times 5\% = 5$ | 正常 |
+
+- **本单现金分润总额**：$600 + 100 + 5 = 705$ 元。
+- **本单现金拨比率**：$705 / 1398 \approx 50.43\%$（第 3 单返 600 元波峰）。
+
+---
+
+## 场景五：合伙股东完整大链条（创客 + 酒道馆 + 区县代理 + 双平级）
+
+### 1. 业务关系拓扑
+```
+区县代理 2 (乙区县, 活跃)
+    └── 区县代理 1 (甲区县, 活跃) —— 紧邻下级区县
+            └── 酒道馆 2 (馆 B, 活跃)
+                    └── 酒道馆 1 (馆 A, 活跃) —— 紧邻下级馆
+                            └── 创客 C (创客 V4, 活跃)
+                                    └── 推荐人 B (品酒师, 活跃, seq=0)
+                                            └── 买家 A (下单 1398 元)
+```
+
+### 2. 收益分配明细表
+
+| 收益人 | 会员身份 / 标签 | 获得奖项 | 现金收益 | 计算公式与说明 |
+| :--- | :--- | :--- | :--- | :--- |
+| **买家 A** | 品酒师 | 兑换券发放 | ¥ 0.00 | 获 2097 元兑换券，按 365 天释放 |
+| **推荐人 B**| 品酒师 | 推三返一 | **¥ 398.00** | 直推第 1 单，返现 398 元 |
+| **创客 C** | 合伙股东·创客 V4 | 创客极差奖 | **¥ 80.00** | 链上首位创客，独享 V4 极差 80 元 |
+| **酒道馆 1**| 合伙股东·酒道馆 A| **酒道馆团队奖** | **¥ 50.00** | 链上有馆有县，团队奖拆分获得 50 元 |
+| **酒道馆 2**| 合伙股东·酒道馆 B| **酒道馆平级奖** | **¥ 5.00** | 第二个酒道馆，获下级馆团队奖的 10%：$50 \times 10\% = 5$ 元 |
+| **区县代理1**| 合伙股东·区县甲 | **区县团队奖** | **¥ 50.00** | 链上有馆有县，团队奖拆分获得 50 元 |
+| **区县代理2**| 合伙股东·区县乙 | **区县平级奖** | **¥ 5.00** | 第二个区县代理，获下级县团队奖的 10%：$50 \times 10\% = 5$ 元 |
+
+### 3. 财务穿透与拨比测算
+- **本单即时现金总支出**：$398 + 80 + 50 + 5 + 50 + 5 = 588.00$ 元。
+- **本单现金综合拨比**：$588 / 1398 \approx 42.06\%$。
+- **平台毛利留存（即时）**：$1398 - 588 = 810.00$ 元（毛利率 57.94%）。
+
+---
+
+## 场景六：无酒道馆、直属区县代理独享团队奖
+
+### 1. 业务关系拓扑
+```
+区县代理甲 (活跃)
+    └── 推荐人 B (品酒师, 活跃, seq=1)
+            └── 买家 A (下单 1398 元)
+```
+
+### 2. 收益分配明细表
+
+| 收益人 | 会员身份 / 标签 | 获得奖项 | 现金收益 | 计算规则与说明 |
+| :--- | :--- | :--- | :--- | :--- |
+| **推荐人 B** | 品酒师 | 推三返一 | **¥ 400.00** | 第 2 单享受 400 元 |
+| **区县代理甲** | 合伙股东·区县 | **区县团队奖** | **¥ 100.00** | **链上无酒道馆，区县代理独享全额 100 元团队奖** |
+
+- **本单现金分润总额**：$400 + 100 = 500$ 元。
+- **本单现金拨比率**：$500 / 1398 \approx 35.77\%$。
+
+---
+
+## 场景七：酒道馆主本人自购场景
+
+### 1. 业务关系拓扑
+```
+上级酒道馆 B (活跃)
+    └── 酒道馆主 A (买家本人自购 1398 元)
+```
+
+### 2. 收益分配明细表
+
+| 收益人 | 身份 | 获得奖项 | 现金收益 | 计算规则与说明 |
+| :--- | :--- | :--- | :--- | :--- |
+| **馆主 A (买家)** | 合伙股东·酒道馆 | 推三返一 | ¥ 0.00 | 自购不产生推三返一（记录 skip） |
+| **馆主 A (买家)** | 合伙股东·酒道馆 | **酒道馆团队奖** | **¥ 50.00** | **自购计入团队链头，自购自得馆团队奖 50 元** |
+| **馆主 A (买家)** | 合伙股东·酒道馆 | 兑换券计划 | ¥ 0.00 (券 2097) | 自身获得 2097 元产品兑换券，分 365 天释放 |
+| **上级馆 B** | 合伙股东·酒道馆 | **酒道馆平级奖** | **¥ 5.00** | 获得馆主 A 自购团队奖的 10%：$50 \times 10\% = 5$ 元 |
+
+- **财务特征**：合伙股东自购能享受到对应身份的团队奖返点，增强会员自购粘性。
+
+---
+
+## 场景八：30 天无自购（不活跃）的水位穿透与保护机制
+
+### 1. 业务关系拓扑
+```
+顶层创客 D (创客 V5, 活跃)
+    └── 中间创客 C (创客 V3, ❌ 过去 30 天无自购，不活跃)
+            └── 推荐人 B (品酒师, ❌ 过去 30 天无自购，不活跃)
+                    └── 买家 A (下单 1398 元)
+```
+
+### 2. 收益分配明细表
+
+| 收益人 | 会员身份 | 获得奖项 | 实发收益 | 审计记录 / 系统处理机制 |
+| :--- | :--- | :--- | :--- | :--- |
+| **推荐人 B** | 品酒师 | 推三返一 | **¥ 0.00** | 拦截：`inactive_30d`（30日无自购），398元不发放 |
+| **创客 C** | 创客 V3 | 创客极差奖 | **¥ 0.00** | 拦截：`inactive_30d`，**且不抬升水位（水位保持为 0）** |
+| **创客 D** | 创客 V5 | 创客极差奖 | **¥ 100.00** | **穿透受益**：因 C 不占水位，D 直接获得 $100 - 0 = 100$ 元全额极差！ |
+
+- **沉淀效应**：推三返一因 B 不活跃直接沉淀在平台（节约资金 398 元）；创客极差则由上位合格活跃创客完全继承，激励团队向上活跃。
+
+---
+
+## 场景九：次日凌晨 00:30 全网日结分红模拟（GMV 1:1 与平台池）
+
+### 1. 运行假设
+- **全网昨日订单量**：100 单合格订单（每单 1398 元），GMV 为 **¥ 139,800.00**。
+- **全网累计历史单数 N**：达到 10,000 单。
+- **合格参与人数**：
+  - 30 天内有自购的合格品酒师：500 人
+  - 30 天内活跃的酒道馆：20 家
+  - 30 天内活跃的区县代理：5 家
+
+### 2. 日结分配明细测算表
+
+| 分红奖项 | 资金池规模 | 合格人数 | 人均分配额 | 结算资金归属 | 财务说明 |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| **马豆分红池** | 139,800.00 豆 (1:1 GMV) | 500 人 | **279.60000000 豆/人** | 发放至会员马豆账户 | 不发生实际现金支出，随汇率承载资产价值 |
+| **酒道馆平台均分池** | **¥ 10,000.00** (100元 $\times$ 100单) | 20 馆 | **¥ 500.00 / 馆** | 直接入账佣金钱包 | 当日实际现金支出 10,000 元 |
+| **区县代理平台均分池**| **¥ 5,000.00** (50元 $\times$ 100单) | 5 县 | **¥ 1,000.00 / 县** | 直接入账佣金钱包 | 当日实际现金支出 5,000 元 |
+| **兑换券当日释放** | 存量活跃计划约 1000 人 | 1000 人 | 约 5.75 元/人 | 发放至可用兑换券 | 预计释放 5,750 元货权兑换券（非现金） |
+
+### 3. 马豆即时汇率与资产价值模拟
+- **即时汇率公式**：$\text{Rate} = 0.00000075 \times 10,000 = \mathbf{0.0075\text{ 元/马豆}}$。
+- **每人当日分得 279.6 豆的实际法币估值**：$279.6 \times 0.0075 \approx \mathbf{2.10\text{ 元}}$。
+- **当历史单数达到 100,000 单时**：汇率升至 $0.075$ 元/豆，279.6 豆估值达到 **20.97 元**。
+
+---
+
+## 场景十：全平台综合现金拨比极限压测（财务红线）
+
+为确保资金链绝对安全，对**极端最长利益链路**（同时触发：推三返一第3档600元 + 创客V6极差120元 + 创客V6平级12元 + 酒道馆50元 + 馆平级5元 + 区县50元 + 县平级5元 + 日结馆均分100元 + 日结县均分50元）进行综合拨比测算：
+
+| 费用构成项 | 峰值支出金额 | 占单笔 1398 元比例 | 财务控制与对冲手段 |
+| :--- | :--- | :--- | :--- |
+| **推三返一（波峰第3单）** | ¥ 600.00 | 42.92% | 第1、2单分别返398、400，三单均值 466 元（33.3%） |
+| **创客极差（V6封顶）** | ¥ 120.00 | 8.58% | 水位差截断，全链路创客极差合计封顶 120 元 |
+| **创客平级奖** | ¥ 12.00 | 0.86% | 仅紧邻同级一层享受 10% |
+| **酒道馆团队奖** | ¥ 50.00 | 3.58% | 团队拆分制，固定 50 元 |
+| **酒道馆平级奖** | ¥ 5.00 | 0.36% | 仅紧邻一层享受 10% |
+| **区县代理团队奖** | ¥ 50.00 | 3.58% | 团队拆分制，固定 50 元 |
+| **区县代理平级奖** | ¥ 5.00 | 0.36% | 仅紧邻一层享受 10% |
+| **即时现金总支出（极限波峰）** | **¥ 842.00** | **60.23%** | 极端全满链路即时现金支出上限 |
+| **日结酒道馆池预提** | ¥ 100.00 | 7.15% | 无达标人员时 100% 留存沉淀平台 |
+| **日结区县代理池预提** | ¥ 50.00 | 3.58% | 无达标人员时 100% 留存沉淀平台 |
+| **理论全现金支出极限峰值** | **¥ 992.00** | **70.96%** | 极端单笔综合拨比峰值（触发系统 70% 财务预警线） |
+| **平均日常稳定综合拨比** | **¥ 680 ~ 750 元**| **48.6% ~ 53.6%** | 日常经营状态下的实际资金拨比均值 |
+| **平台基础商品毛利安全线** | **¥ 406 ~ 718 元**| **29.04% ~ 51.4%** | 平台留存毛利空间充沛，资金模型健壮安全 |
+
+---
+
+## 结论与运营建议
+
+1. **推三返一平滑性良好**：以 398/400/600 三单为一周期，平均拨比稳定在 33.33%，波峰最高 42.92%，不会造成资金穿透。
+2. **极差与平级严格控顶**：极差奖最高水位 120 元封顶，平级奖与超越奖均为紧邻单层 10%/5%，彻底消除了传统分销“多层平级连环套”导致的资金暴击风险。
+3. **沉淀效应明显**：严格执行 30 天自购活跃机制后，不活跃用户的推三返一和均分资金自动留存沉淀为平台利润，实际经营拨比通常保持在 **48% ~ 52%** 黄金区间。