wikiboss/Henglianshutong
1
0
派生 0
代码 工单 合并请求 Actions 软件包 项目 版本发布 百科 动态

feat(dmepa): 全局统一规范DMEPA命名并优化游客与品酒师身份显示

浏览代码
这个提交包含在：
chen
2026-09-19 15:41:39 +08:00
父节点 3868becc63
当前提交 fd8c1d09cc
共有 65 个文件被更改，包括 1068 次插入 和 390 次删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件

2
docs/partner-api-contract.md
查看文件

@@ -59,7 +59,7 @@ team 列表里每个 user.agent 同样带 is_venue / is_county / level_info
|---|---|---|
| GET | partner.index | overview |
| GET | partner.index/rewards | 分页流水 tab=all\|push3\|maker\|venue\|county\|share |
| GET | partner.index/madow | 马豆+汇率+日流水 |
| GET | partner.index/madow | dmepa+汇率+日流水 |
| GET | partner.index/voucher | 券账户+计划列表 |
overview:

14
docs/sql/clean_order_and_partner_data.sql
查看文件

@@ -1,7 +1,7 @@
-- ==============================================================================
-- 恒联数通 · 收益中心交易数据清理与马豆汇率回归初始值 SQL 归档脚本
-- 恒联数通 · 收益中心交易数据清理与dmepa汇率回归初始值 SQL 归档脚本
-- 适用场景：测试环境/上线前数据重置，清空全部历史订单、分销分润与日结记录，
-- 分销商持仓马豆归零，大盘汇率完全重置为初始值 0.00000075 元/豆。
-- 分销商持仓dmepa归零，大盘汇率完全重置为初始值 0.00000075 元/豆。
--
-- 【安全保留数据（绝对不清理）】:
-- 1. 用户账号体系 (fa_user)：账号、密码、手机号、推荐上下级关系树完整保留
@@ -29,23 +29,23 @@ TRUNCATE TABLE `fa_shopro_order_invoice`;
-- ------------------------------------------------------------------------------
-- 2. 清理分销与合伙人收益流水数据 (TRUNCATE)
-- ------------------------------------------------------------------------------
TRUNCATE TABLE `fa_shopro_partner_reward`; -- 二开合伙人推三返一/极差/均分/马豆流水
TRUNCATE TABLE `fa_shopro_partner_reward`; -- 二开合伙人推三返一/极差/均分/dmepa流水
TRUNCATE TABLE `fa_shopro_commission_order`; -- 分销订单表
TRUNCATE TABLE `fa_shopro_commission_reward`; -- 分销分佣表
TRUNCATE TABLE `fa_shopro_commission_log`; -- 分销日志表
-- ------------------------------------------------------------------------------
-- 3. 清理日结对账、马豆汇率快照与兑换券释放计划 (TRUNCATE)
-- 3. 清理日结对账、dmepa汇率快照与兑换券释放计划 (TRUNCATE)
-- 清空后，因历史合格单数 N = 0 且快照为空，RateService 自动回到基准汇率 0.00000075
-- ------------------------------------------------------------------------------
TRUNCATE TABLE `fa_shopro_partner_rate_log`; -- 马豆汇率历史快照日志
TRUNCATE TABLE `fa_shopro_partner_rate_log`; -- dmepa汇率历史快照日志
TRUNCATE TABLE `fa_shopro_partner_daily_report`; -- 每日日结对账报表
TRUNCATE TABLE `fa_shopro_partner_voucher_plan`; -- 消费兑换券释放计划表
TRUNCATE TABLE `fa_shopro_partner_voucher_log`; -- 消费兑换券释放日志明细
-- ------------------------------------------------------------------------------
-- 4. 重置分销商 (Agent) 资产与进度指标 (UPDATE)
-- 保留身份(is_venue/is_county/level/parent)，将持仓马豆、序号、券资产归零
-- 保留身份(is_venue/is_county/level/parent)，将持仓dmepa、序号、券资产归零
-- ------------------------------------------------------------------------------
UPDATE `fa_shopro_commission_agent` SET
`madow` = 0.00000000,
@@ -88,5 +88,5 @@ SET FOREIGN_KEY_CHECKS = 1;
-- 执行后提示：
-- 1. 请在服务器端执行清空缓存命令: php think clear
-- 2. 或进入 FastAdmin 后台 -> 右上角 -> 清除缓存
-- 3. 此时打开后台【控制台仪表盘】及移动端【我的马豆】，汇率将显示为 0.00000075，持豆量与市值归零。
-- 3. 此时打开后台【控制台仪表盘】及移动端【我的dmepa】，汇率将显示为 0.00000075，持豆量与市值归零。
-- ==============================================================================

28
docs/会员角色与收益体系规格及代码完善分析.md
查看文件

@@ -10,7 +10,7 @@
| 角色身份名称 | 身份性质 | 准入/获得条件 | 互斥与共存规则 | 核心定位与业务权益 |
| :--- | :--- | :--- | :--- | :--- |
| **品酒师** | 基础会员身份 | 所有用户注册默认即为品酒师（系统分销等级 `level = 1`）。<br>*(注：若启用考核门槛，为直推 3 单或伞下 1 人升级)* | 与创客**互斥**（升级创客后自动覆盖品酒师身份） | **基础消费与推广**：推三返一（398/400/600 循环返现）、每日 GMV 1:1 马豆分红、1.5 倍兑换券释放 |
| **品酒师** | 基础会员身份 | 所有用户注册默认即为品酒师（系统分销等级 `level = 1`）。<br>*(注：若启用考核门槛，为直推 3 单或伞下 1 人升级)* | 与创客**互斥**（升级创客后自动覆盖品酒师身份） | **基础消费与推广**：推三返一（398/400/600 循环返现）、每日 GMV 1:1 dmepa分红、1.5 倍兑换券释放 |
| **创客** | 进阶层级身份 | 由品酒师升级而来，细分为 **V1 ~ V6** 六个等级（对应系统 `level = 2 ~ 7`），后台可灵活设置升级门槛 | 与品酒师**互斥**；可与酒道馆、区县代理、合伙股东**独立叠加** | **团队核心骨干**：继承品酒师权益，享创客极差奖（20~120元阶梯）、同级平级奖（10%）、被超越奖（5%） |
| **酒道馆** | 实体枢纽身份 | 后台独立审核开通/授权（系统标识 `is_venue = 1`） | 独立身份，可与创客、区县代理、合伙股东**独立叠加** | **实体/线下业务枢纽**：享团队订单收益（50元/单）、酒道馆平级奖（10%）、全网每单 100 元平台均分奖池 |
| **区县代理** | 区域代理身份 | 后台独立开通/绑定特定行政区划（系统标识 `is_county = 1`） | 独立身份，可与创客、酒道馆、合伙股东**独立叠加** | **区域渠道领头人**：享团队拆分奖（独享100元或与馆各50元）、区县平级奖（10%）、全网每单 50 元平台均分奖池 |
@@ -29,11 +29,11 @@
- 所有会员（包括品酒师、创客、酒道馆、区县代理）享受任何奖项收益的前提，是**近 30 个自然日内本人必须有一笔合格自购订单**（实付金额 $>0$，非纯积分兑换单）。
- **未达标惩罚**：
- 即时奖（推三返一、极差奖、平级奖、团队拆分奖）：直接跳过，奖金**不发放、不顺延**给上级；极差奖**不占用水位**。
- 日结均分奖（酒道馆均分、区县均分、马豆 1:1 分红）：**不计入分母人数**，不享受当日池子分配。
- 日结均分奖（酒道馆均分、区县均分、dmepa 1:1 分红）：**不计入分母人数**，不享受当日池子分配。
2. **退款与回滚机制**：
- **全单退款**：撤回该订单产生的所有即时奖金（从分销商佣金钱包扣减）；推三返一序号自动回退 1 单；未释放的兑换券计划直接关闭，已释放未消费部分从账户扣除。
- **部分退款**：按退款商品金额等比例缩减兑换券额度，不粗暴剥夺分销商奖励。
- **日结保护**：每日 00:30 已完成清算的平台均分、马豆分红及历史汇率 N 计数**不逆向追溯**，确保账目不可逆稳定性。
- **日结保护**：每日 00:30 已完成清算的平台均分、dmepa分红及历史汇率 N 计数**不逆向追溯**，确保账目不可逆稳定性。
---
@@ -48,16 +48,16 @@
- **梯度循环**：第 1 单返 **398 元**，第 2 单返 **400 元**，第 3 单返 **600 元**；第 4 单起重新从 398 元开始，按每 3 单一个周期无限循环。
- **业务逻辑**：每推满 3 单累计返现 $398 + 400 + 600 = 1398$ 元，相当于推 3 单返还 1 单的完整货款。
- **限制**：仅限直推下级订单有效，自购不计入返还；直推人须满足 30 天自购活跃。
2. **每日 1:1 下单金额均分（马豆分红）**：
2. **每日 1:1 下单金额均分（dmepa分红）**：
- **规则**：每日全平台合格订单总金额（GMV）按 1:1 等价额度，平均分配给全平台近 30 天内有自购下单记录的有效会员。
- **发放形式**：以「分红积分（马豆）」形式发放至会员马豆账户（非直接发提现现金，防范资金穿透风险）。
- **发放形式**：以「分红积分（dmepa）」形式发放至会员dmepa账户（非直接发提现现金，防范资金穿透风险）。
- **结算时间**：每日凌晨 **00:30** 执行定时清算任务，结算昨日数据。
- **尾差处理**：除不尽的微小尾差自动归集入平台沉淀账户。
3. **分红积分（马豆）浮动汇率与价值折算**：
- **初始汇率**：$1\text{ 马豆} = 0.00000075\text{ 元}$。
3. **分红积分（dmepa）浮动汇率与价值折算**：
- **初始汇率**：$1\text{ dmepa} = 0.00000075\text{ 元}$。
- **浮动递增规则**：全平台每增加 $n$ 个合格订单，汇率按步长向上跃迁，实时汇率公式为：
$$\text{当前汇率} = 0.00000075 \times \lfloor \frac{N}{n} \rfloor \quad (\text{其中 } N \text{ 为全平台历史累计订单数，初始保底基准汇率})$$
- **资产价值呈现**：用户端个人中心与收益中心根据最新汇率，实时折算展示马豆对应的人民币估值（$\text{持有马豆} \times \text{当前汇率}$）。
- **资产价值呈现**：用户端个人中心与收益中心根据最新汇率，实时折算展示dmepa对应的人民币估值（$\text{持有dmepa} \times \text{当前汇率}$）。
4. **下单用户 1.5 倍兑换券（365天线性释放）**：
- **规则**：任何用户下单，均可获得其实付订单金额 **1.5 倍** 的商城兑换券（例：一单实付 1398 元 $\times 1.5 =$ **2097 元** 兑换券）。
- **释放周期**：兑换券按 **365 天** 逐日等额释放（每天释放 $2097 / 365 = 5.74$ 元，第 365 天补齐尾差）。
@@ -138,7 +138,7 @@
| **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，推进马豆汇率浮动 |
| **全平台奖池** | 待清算资产 | **dmepa + 平台奖池** | ① 1398元等额dmepa计入今日dmepa分红池<br>② 100元计入酒道馆平台均分池<br>③ 50元计入区县平台均分池<br>④ 累计订单数 $N$ 增加 1，推进dmepa汇率浮动 |
---
@@ -216,7 +216,7 @@
- 清算昨日 00:00:00 至 23:59:59 的合格订单总数与 GMV。
- 文件锁（`partner_settle_{Ymd}.lock`）与数据库唯一键防并发重入。
- 分母严格筛选 30 天内有自购合格订单的用户列表（`activeUserIds`）。
- 马豆与奖池均分采用 `bcdiv` 精确到 8 位/2 位小数，无法整除的零头尾差自动作为平台收益记录入账，保证资金账目百分之百平账。
- dmepa与奖池均分采用 `bcdiv` 精确到 8 位/2 位小数，无法整除的零头尾差自动作为平台收益记录入账，保证资金账目百分之百平账。
- 兑换券计划线性释放 1 天额度，第 365 天自动补齐尾差。
- **完善度**：98% 达成。
@@ -234,7 +234,7 @@
在深度审查代码后，发现以下 **3 处需要重点关注和优化的细节**：
#### ⚠️ 细节 1：马豆浮动汇率 `RateService` 的初始下限保护
#### ⚠️ 细节 1：dmepa浮动汇率 `RateService` 的初始下限保护
- **代码现状**：
在 [`RateService.php`](file:///Users/chen/Desktop/xbiuld/henglianshutong/addons/shopro/service/partner/RateService.php) 的 `calcRate` 方法中：
```php
@@ -248,9 +248,9 @@
}
```
- **潜在问题**：
当全平台历史累计订单数 $n=0$（系统刚上线或测试初期）时，`floor(0 / 1) = 0`，计算得出的汇率会变成 **0**，导致用户端显示的马豆人民币估值为 0 元。
当全平台历史累计订单数 $n=0$（系统刚上线或测试初期）时，`floor(0 / 1) = 0`，计算得出的汇率会变成 **0**，导致用户端显示的dmepa人民币估值为 0 元。
- **优化建议**：
业务规则明确说明「汇率初始比例 1 马豆 = 0.00000075 元，每增加 n 个订单递增」。
业务规则明确说明「汇率初始比例 1 dmepa = 0.00000075 元，每增加 n 个订单递增」。
建议修改为带初始保底：
```php
// 保证初始汇率至少为基准 base
@@ -283,6 +283,6 @@
### 4. 总结与建议行动
1. **业务规则完备性**：用户提出的角色、分级、推三返一、GMV 1:1 分红、马豆浮动汇率、兑换券释放、极差平级超越、酒道馆与区县代理拆分及 30 日自购条件，在当前代码中**均已建立对应的服务类与业务模型，核心分账闭环已 100% 跑通**。
1. **业务规则完备性**：用户提出的角色、分级、推三返一、GMV 1:1 分红、dmepa浮动汇率、兑换券释放、极差平级超越、酒道馆与区县代理拆分及 30 日自购条件，在当前代码中**均已建立对应的服务类与业务模型，核心分账闭环已 100% 跑通**。
2. **文档归档**：本技术规格与完善分析已归档保存至 `docs/会员角色与收益体系规格及代码完善分析.md`，供团队持续查阅与对账使用。
3. **后续微调建议**：对 `RateService::calcRate` 做初始汇率下限保底微调，即可进入实单联调上线状态。

68
docs/收益中心-后台与用户端功能规格.md
查看文件

@@ -23,7 +23,7 @@
| 角色 | 他要完成的事 |
|---|---|
| 运营 | 开通酒道馆/区县/合伙股东、改创客等级、查一笔订单钱分给了谁 |
| 财务 | 按日对账：GMV、发放合计、均分、马豆、兑换券；导出 |
| 财务 | 按日对账：GMV、发放合计、均分、dmepa、兑换券；导出 |
| 客服 | 用户说「我没收到钱」时，3 分钟内看到原因（不活跃 / 无上级 / 已退款） |
| 超管 | 改规则数字（级差 20、均分 100），改完只影响新单 |
@@ -40,7 +40,7 @@
### 1.3 本期不做（避免范围膨胀）
- 不重做装修编辑器，个人中心继续走现有 `userCard` / `walletCard` 组件。
- 不把马豆做成可交易市场。
- 不把dmepa做成可交易市场。
- 不给用户自助申请酒道馆/区县（先后台开通）。
- 不改原生三级分销订单的百分比展示逻辑到「完全删除」，只停发新百分比。
@@ -56,15 +56,15 @@
├─ 成员档案 原分销商：查人、改上级、开通酒道馆/区县/合伙股东（显示品酒师/创客/酒道馆/区县/合伙股东身份）
├─ 身份等级 原分销商等级：品酒师 / 创客 V1–V6
├─ 计奖商品 原分销商品：是否参与计奖
├─ 收益流水 即时奖 / 均分 / 马豆等入账与补发退回
├─ 日结对账 馆县均分、马豆池、重跑
├─ 收益流水 即时奖 / 均分 / dmepa等入账与补发退回
├─ 日结对账 馆县均分、dmepa池、重跑
├─ 兑换券 释放计划与日志
├─ 业绩订单 原分销订单：升级/业绩口径仍用
├─ 历史佣金 原佣金明细：旧百分比流水备查
└─ 动态日志 原分销动态
商城 → 商城配置
├─ 分销基础 层级/成为条件等底座（勿把层级改成 0）
└─ 收益中心规则 Tab：固定金额、均分、马豆、兑换券规则
└─ 收益中心规则 Tab：固定金额、均分、dmepa、兑换券规则
```
权限节点（写入 `addons/shopro/config/menu.php`，升级菜单）：
@@ -93,9 +93,9 @@
| 计单 | 合格订单口径 | 单选 | 订单头 | 选项：订单头 / 商品件数 |
| 活跃 | 领取窗口天数 | 数字 | 30 | ≥1 |
| 推三返一 | 循环金额 | 三个数字框 | 398 / 400 / 600 | 旁注：三者之和建议等于主售价 |
| 马豆 | 发放模式 | 单选 | 马豆 | 马豆 / 现金（现金需二次确认弹窗：将发放当日 GMV） |
| 马豆 | 基础汇率 | 数字 | 0.00000075 | 最多 10 位小数 |
| 马豆 | 步进订单数 n | 数字 | 1 | 每增加 n 单，汇率 = 基数 × floor(N/n) |
| dmepa | 发放模式 | 单选 | dmepa | dmepa / 现金（现金需二次确认弹窗：将发放当日 GMV） |
| dmepa | 基础汇率 | 数字 | 0.00000075 | 最多 10 位小数 |
| dmepa | 步进订单数 n | 数字 | 1 | 每增加 n 单，汇率 = 基数 × floor(N/n) |
| 兑换券 | 倍数 | 数字 | 1.5 | |
| 兑换券 | 释放天数 | 数字 | 365 | |
| 创客 | V1–V6 单笔基数 | 6 个数字 | 20…120 | 必须递增 |
@@ -123,7 +123,7 @@
|---|---|
| 身份 | `品酒师` 或 `创客V5`；后面小标签 `酒道馆` `区县`（可多个） |
| 30 日活跃 | 绿点「有自购」/ 灰点「已暂停」 |
| 马豆 | 数量，副文案约合 ¥xx（按最新汇率） |
| dmepa | 数量，副文案约合 ¥xx（按最新汇率） |
| 可用兑换券 | `released - used` |
**要加的筛选（现有 filter drawer）：**
@@ -155,7 +155,7 @@
| 最近自购时间 | 2026-09-10 12:00 / 从未下单 |
| 活跃状态 | 正常领取 / 已暂停（距今天数） |
| 直推计奖序号 | 第 14 单，下一单将返 400 |
| 马豆 / 约合 | |
| dmepa / 约合 | |
| 兑换券 总额 / 已释放 / 已使用 / 可用 | |
| 累计现金收益 | 从 `partner_reward` 已入账求和 |
@@ -200,12 +200,12 @@
**现有：** 是否参与分销。
**改文案：** 「参与分销 / 收益中心计奖」。
关闭的商品：不计入推三返一、极差、拆分、均分、马豆 N、兑换券。
关闭的商品：不计入推三返一、极差、拆分、均分、dmepa N、兑换券。
不改表结构。
### 3.7 会员详情（`shopro/user/user`）
用户详情若已展示 `commission` 钱包，加三个只读：马豆、可用兑换券、身份文本。
用户详情若已展示 `commission` 钱包，加三个只读：dmepa、可用兑换券、身份文本。
入口：从用户跳到分销商详情（已有 agent 关联则跳，没有则提示「尚未生成分销身份」）。
---
@@ -227,11 +227,11 @@
- 角色（品酒师/创客/酒道馆/区县）
- 状态：待入账 / 已入账 / 已取消 / 已退回
- 时间范围
- 日结日期（查均分/马豆）
- 日结日期（查均分/dmepa）
**表列：**
ID、入账时间、受益人、买家、订单、奖项、角色、金额、马豆、基数、状态、公式摘要（`ext.formula`）、操作
ID、入账时间、受益人、买家、订单、奖项、角色、金额、dmepa、基数、状态、公式摘要（`ext.formula`）、操作
**奖项中文：**
@@ -247,7 +247,7 @@ ID、入账时间、受益人、买家、订单、奖项、角色、金额、马
| county_peer | 区县平级奖 |
| venue_share | 酒道馆平台均分 |
| county_share | 区县平台均分 |
| madow_share | 每日分红马豆 |
| madow_share | 每日分红dmepa |
| voucher_grant | 兑换券发放 |
| voucher_release | 兑换券释放 |
@@ -263,7 +263,7 @@ ID、入账时间、受益人、买家、订单、奖项、角色、金额、马
- `reward_type` 用 `manual_*`，写入流水，进佣金钱包。
- 必填备注，导出打标「手工」。
**导出：** 与现有佣金导出同一套 `sheepFilter + export`，最后一行合计金额、马豆。
**导出：** 与现有佣金导出同一套 `sheepFilter + export`，最后一行合计金额、dmepa。
**空态：** 「没有符合条件的流水」。
**客服标准问法对应筛法：** 用户手机号 + 昨天 → 看有没有 `push3` 以及 `ext.skip_reason`。
@@ -288,7 +288,7 @@ ID、入账时间、受益人、买家、订单、奖项、角色、金额、马
**一行 = 一个自然日。**
列：日期、合格单数、GMV、汇率 N、汇率、马豆池、马豆人数、酒道馆奖池、酒道馆人数、区县奖池、区县人数、兑换券释放总额、状态（成功/失败/重跑中）、操作。
列：日期、合格单数、GMV、汇率 N、汇率、dmepa池、dmepa人数、酒道馆奖池、酒道馆人数、区县奖池、区县人数、兑换券释放总额、状态（成功/失败/重跑中）、操作。
操作：
@@ -296,7 +296,7 @@ ID、入账时间、受益人、买家、订单、奖项、角色、金额、马
- 重跑：权限 `rerun`，二次确认「将删除当天日结流水后重算」。即时奖（推三返一等）不重跑。
- 失败行红字，展示 `error_msg`（锁冲突、分母为 0 已进平台账户 不算失败）。
页顶 KPI 卡（今日/昨日）：单数、GMV、现金发放合计、马豆发放、暂停领取人数。
页顶 KPI 卡（今日/昨日）：单数、GMV、现金发放合计、dmepa发放、暂停领取人数。
### 4.3 兑换券计划 `shopro/partner/voucher`
@@ -337,11 +337,11 @@ ID、入账时间、受益人、买家、订单、奖项、角色、金额、马
```
我的（装修页，改两个组件即可全站生效）
├─ 用户卡片 身份徽章
└─ 钱包卡片 余额 / 佣金 / 马豆 / 兑换券
└─ 钱包卡片 余额 / 佣金 / dmepa / 兑换券
收益中心（原分销中心改名）
├─ 身份条
├─ 资产四宫格（佣金、马豆价值、可用券、本月是否可领）
├─ 功能：团队、佣金明细、收益明细、马豆、兑换券、分享、（资料按配置藏）
├─ 资产四宫格（佣金、dmepa价值、可用券、本月是否可领）
├─ 功能：团队、佣金明细、收益明细、dmepa、兑换券、分享、（资料按配置藏）
└─ 实时动态（沿用 commission.log，补新文案）
佣金钱包（已有） 只承载现金，含新 event 中文
确认订单（后期） 加兑换券抵扣
@@ -394,7 +394,7 @@ ID、入账时间、受益人、买家、订单、奖项、角色、金额、马
|---|---|---|
| 余额 | `userInfo.money` | 已有 `/pages/user/wallet/money` |
| 收益 | `userInfo.commission` | `/pages/user/wallet/commission` |
| 马豆 | `userInfo.madow` 副文案约 ¥ | `/pages/commission/madow` |
| dmepa | `userInfo.madow` 副文案约 ¥ | `/pages/commission/madow` |
| 兑换券 | `userInfo.voucher_available` 元 | `/pages/commission/voucher` |
| 优惠券 | `numData.coupons_num` 张 | 已有领券（Shopro 券，保留） |
@@ -447,7 +447,7 @@ ID、入账时间、受益人、买家、订单、奖项、角色、金额、马
|---|---|---|
| 累计收益 | `agentInfo.total_income` | 佣金钱包 |
| 可提现 | `userInfo.commission` | 佣金钱包 |
| 马豆价值 | `agentInfo.madow_value` | 马豆页 |
| dmepa价值 | `agentInfo.madow_value` | dmepa页 |
| 可用兑换券 | `agentInfo.voucher_available` | 兑换券页 |
「查看明细」继续去佣金钱包。
@@ -462,7 +462,7 @@ ID、入账时间、受益人、买家、订单、奖项、角色、金额、马
| 我的团队 | `/pages/commission/team` | 始终 |
| 收益明细 | `/pages/commission/rewards` | 始终 |
| 我的收益 | `/pages/user/wallet/commission` | 始终（原「佣金明细」改名） |
| 我的马豆 | `/pages/commission/madow` | 始终 |
| 我的dmepa | `/pages/commission/madow` | 始终 |
| 兑换券 | `/pages/commission/voucher` | 始终 |
| 推广订单 | `/pages/commission/order` | 始终（原分销订单，看团队单数） |
| 邀请海报 | `action:showShareModal` | 始终 |
@@ -490,7 +490,7 @@ ID、入账时间、受益人、买家、订单、奖项、角色、金额、马
- 卡片「我的佣金」改为「可提现收益」。
- 流水 `event_text` 由后端 WalletLog 新枚举提供，前端不用映射表。
- 提现、转余额流程不动。
- 页底加一句：「马豆与兑换券不在本页，请到收益中心查看。」避免用户以为没到账。
- 页底加一句：「dmepa与兑换券不在本页，请到收益中心查看。」避免用户以为没到账。
### 7.9 推广订单 `order.vue`
@@ -525,15 +525,15 @@ ID、入账时间、受益人、买家、订单、奖项、角色、金额、马
接口：`GET partner.index/rewards?tab=&page=`
### 8.2 我的马豆 `/pages/commission/madow`
### 8.2 我的dmepa `/pages/commission/madow`
**顶卡：**
- 大号：马豆数量
- 副文案：当前汇率 `1 马豆 = 0.00000075 元`；约合 ¥x.xx
- 大号：dmepa数量
- 副文案：当前汇率 `1 dmepa = 0.00000075 元`；约合 ¥x.xx
- 说明折叠：「汇率随全平台订单增加而上浮，仅作价值展示，不可提现。」
**列表：** 每日 `madow_share`（日期、获得马豆、当日人数、当日 GMV）。
**列表：** 每日 `madow_share`（日期、获得dmepa、当日人数、当日 GMV）。
**空态：** 「完成一笔订单后，次日 00:30 起参与分红。」
接口：`GET partner.index/madow`
@@ -605,7 +605,7 @@ ID、入账时间、受益人、买家、订单、奖项、角色、金额、马
复用 Shopro 通知，钱包变动已有 `user_wallet_change`。
新 event 进 WalletLog 后，若已订阅佣金到账模板，会自动带「推三返一」文案。
马豆、兑换券释放默认不推送（避免每天 00:30 骚扰），收益中心自己看。
dmepa、兑换券释放默认不推送（避免每天 00:30 骚扰），收益中心自己看。
---
@@ -685,12 +685,12 @@ export default {
|---|---|---|---|
| U1 | store + api | `user.js` `api/partner.js` `api/index.js` | profile 有徽章字段不报错 |
| U2 | 用户卡片徽章 | `s-user-card.vue` | 我的页能正确显示各独立身份徽章（品酒师/创客/酒道馆/区县/合伙股东） |
| U3 | 钱包五项 | `s-wallet-card.vue` | 能进收益/马豆/券 |
| U3 | 钱包五项 | `s-wallet-card.vue` | 能进收益/dmepa/券 |
| U4 | 收益中心改名与警示 | `commission/index.vue` `pages.json` | 30 日无单有黄条 |
| U5 | 身份条/账户卡/菜单 | 三个 components | 馆/县标、四指标、新菜单 |
| U6 | 团队标 | `team.vue` | 直推能看出身份 |
| U7 | 收益明细页 | `rewards.vue` + pages.json | 分页、skip 文案 |
| U8 | 马豆页 | `madow.vue` | 汇率+约合 |
| U8 | dmepa页 | `madow.vue` | 汇率+约合 |
| U9 | 兑换券页 | `voucher.vue` | 进度条 |
| U10 | 佣金钱包文案 | `wallet/commission.vue` | 标题「我的收益」 |
| U11 | 推广订单附带本单收益 | `order.vue` + 后端 order 列表 | 停百分比后不是处处 0 |
@@ -714,7 +714,7 @@ export default {
| 5 开通 D 酒道馆、E 区县 | 拆分 50+50 | D/E 多标，明细有团队奖 |
| 6 把 A 的自购时间改到 31 天前（测） | A 灰点；新单 A 一条 skip | A 顶栏黄条；明细「未发放」 |
| 7 退款第 2 步订单 | 流水退回，序号回退 | 钱包减少；券计划关闭 |
| 8 跑日结 | 日结页一行成功 | 马豆页多一条；券释放天数 +1 |
| 8 跑日结 | 日结页一行成功 | dmepa页多一条；券释放天数 +1 |
| 9 日结再跑一次 | 不加倍 | 数字不变 |
---
@@ -725,7 +725,7 @@ export default {
1. 用户默认都是品酒师，不用申请。
2. 创客/酒道馆/区县/合伙股东在后台独立开通管理，用户端平行展示。
3. 钱进「收益」可提现；马豆只能看值；兑换券只能兑货，365 天慢慢出来。
3. 钱进「收益」可提现；dmepa只能看值；兑换券只能兑货，365 天慢慢出来。
4. 30 天自己不买，推广费停发，不是封号。
5. 改规则只影响以后的单。
6. 客服查账：分销商详情 → 收益流水，勾选「显示未发放原因」。

60
docs/收益中心二次开发文档.md
查看文件

@@ -25,7 +25,7 @@
| 商城后端 | `addons/shopro`、`application/admin` | 完整，Shopro Plus 3.2.0 |
| 管理后台前端 | `application/admin/view/shopro` + `public/assets/js/backend/shopro` | 完整，Element Plus + RequireJS |
| 用户端 | **`uniapp/`** | Shopro sheep 3.1.0，接口前缀 `/addons/shopro/`，与后端完全对齐 |
| 现有分销 UI | `uniapp/pages/commission/*` | 只有等级名徽章 + 百分比分销中心，没有品酒师/创客/酒道馆/区县/合伙股东等新身份/马豆/释放券 |
| 现有分销 UI | `uniapp/pages/commission/*` | 只有等级名徽章 + 百分比分销中心，没有品酒师/创客/酒道馆/区县/合伙股东等新身份/dmepa/释放券 |
用户端请求：
@@ -99,7 +99,7 @@ PayOper 支付成功
现有佣金事件：`reward_income` / `reward_back` / `withdraw` / `withdraw_error` / `transfer_to_money`。
**现金类新收益全部进 `commission`，加新 event，不要新开第四种可提现钱包。**
马豆、兑换券不能塞进这三种，否则流水和提现会乱。
dmepa、兑换券不能塞进这三种，否则流水和提现会乱。
### 1.5 分销商与升级
@@ -174,11 +174,11 @@ PayOper 支付成功
新增
身份扩展（酒道馆 / 区县）
固定金额结算器 PartnerReward
马豆账户 + 汇率
dmepa账户 + 汇率
兑换券释放计划
00:30 日结命令
后台规则页 + 流水页
sheep 徽章 / 马豆 / 兑换券页
sheep 徽章 / dmepa / 兑换券页
```
原则：
@@ -227,7 +227,7 @@ ALTER TABLE `fa_shopro_commission_agent`
ADD COLUMN `is_county` tinyint(1) NOT NULL DEFAULT 0 COMMENT '区县代理' AFTER `is_venue`,
ADD COLUMN `county_code` varchar(20) NOT NULL DEFAULT '' COMMENT '区县编码' AFTER `is_county`,
ADD COLUMN `direct_order_seq` int(11) NOT NULL DEFAULT 0 COMMENT '直推合格单累计(推三返一)' AFTER `county_code`,
ADD COLUMN `madow` decimal(20,8) NOT NULL DEFAULT 0.00000000 COMMENT '马豆' AFTER `direct_order_seq`,
ADD COLUMN `madow` decimal(20,8) NOT NULL DEFAULT 0.00000000 COMMENT 'dmepa' AFTER `direct_order_seq`,
ADD COLUMN `voucher_total` decimal(12,2) NOT NULL DEFAULT 0.00 AFTER `madow`,
ADD COLUMN `voucher_released` decimal(12,2) NOT NULL DEFAULT 0.00 AFTER `voucher_total`,
ADD COLUMN `voucher_used` decimal(12,2) NOT NULL DEFAULT 0.00 AFTER `voucher_released`,
@@ -303,7 +303,7 @@ active = 存在本人合格订单
| 奖项 | 不活跃时 |
|---|---|
| 推三返一 / 极差 / 平级 / 团队拆分 | 该受益人跳过，**不顺延**给再上一级；极差**不占用水位** |
| 平台均分（酒道馆 100、区县 50、马豆） | 不进分母 |
| 平台均分（酒道馆 100、区县 50、dmepa） | 不进分母 |
| 买家兑换券 | 本次下单即活跃，照发 |
### 4.3 关系链遍历
@@ -323,7 +323,7 @@ active = 存在本人合格订单
## 5. 收益规则（算法冻结稿）
现金一律进佣金钱包。马豆、兑换券进 agent 扩展字段。
现金一律进佣金钱包。dmepa、兑换券进 agent 扩展字段。
### 5.1 品酒师 · 推三返一
@@ -340,17 +340,17 @@ amount = [398, 400, 600][ (seq-1) % 3 ]
退款：金额 `reward_back`，`direct_order_seq -= 1`（≥0），下一单顶原序号。
### 5.2 品酒师 · 每日 1:1 + 马豆汇率
### 5.2 品酒师 · 每日 1:1 + dmepa汇率
原文若按现金 1:1 发当天 GMV，毛利为负。
**默认：发马豆，只展示人民币价值，不能提现。**
**默认：发dmepa，只展示人民币价值，不能提现。**
日结（昨天 00:00:00–23:59:59）：
```
G = 昨日合格订单 pay_fee 合计
users = last_self_order_time 落在 [昨天-29天, 昨天] 的品酒师/创客（level>=1, status 可用）
每人马豆 = G / count(users) // 8 位小数，尾差进平台账户 user_id=0
每人dmepa = G / count(users) // 8 位小数，尾差进平台账户 user_id=0
```
汇率：
@@ -457,7 +457,7 @@ U1 直推本单是第 1 单，全部活跃。实付 1398。
| U5 的上级区县 | 5 | 区县平级 |
U0：兑换券额度 2097。
日结另计：酒道馆均分、区县均分、马豆。
日结另计：酒道馆均分、区县均分、dmepa。
---
@@ -480,7 +480,7 @@ addons/shopro/service/partner/VoucherService.php
addons/shopro/service/partner/RateService.php
addons/shopro/job/PartnerSettle.php // 队列：单笔订单
addons/shopro/console/PartnerSettle.php // php think shopro:partner:settle
addons/shopro/controller/partner/Index.php // 用户端：概览/马豆/兑换券/流水
addons/shopro/controller/partner/Index.php // 用户端：概览/dmepa/兑换券/流水
application/admin/controller/shopro/partner/Reward.php
application/admin/controller/shopro/partner/Daily.php
application/admin/controller/shopro/partner/Voucher.php
@@ -536,7 +536,7 @@ order_item_refund_after
回滚该 order_id 下 status=1 的即时奖
推三返一序号 -1
关闭兑换券计划并扣未使用已释放
日结均分 / 马豆 / 汇率 N 不回溯
日结均分 / dmepa / 汇率 N 不回溯
```
---
@@ -670,12 +670,12 @@ CREATE TABLE `fa_shopro_partner_voucher_plan` (
|---|---|---|
| index | `GET partner.index` | 今日预估、累计、按奖项汇总 |
| rewards | `GET partner.index/rewards` | 分页流水，`reward_type` 筛选 |
| madow | `GET partner.index/madow` | 马豆、汇率历史 |
| madow | `GET partner.index/madow` | dmepa、汇率历史 |
| voucher | `GET partner.index/voucher` | 计划列表 + 释放日历 |
| daily | `GET partner.index/daily` | 最近日结（均分/马豆） |
| daily | `GET partner.index/daily` | 最近日结（均分/dmepa） |
钱包页继续 `user.wallet_log?type=commission`，新 event 会出现中文。
收益分类明细走 `partner.index/rewards`，因为均分/马豆/券不是 wallet 三种类型能表达的。
收益分类明细走 `partner.index/rewards`，因为均分/dmepa/券不是 wallet 三种类型能表达的。
---
@@ -712,11 +712,11 @@ CREATE TABLE `fa_shopro_partner_voucher_plan` (
|---|---|---|---|
| 个人中心 | `pages/index/user.vue` | 装修驱动，只渲染 `template.user` | 不直接改这页；改装修组件 |
| 用户卡片 | `sheep/components/s-user-card/s-user-card.vue` | 头像+昵称，**无等级徽章** | 昵称下加身份徽章 |
| 钱包卡片 | `sheep/components/s-wallet-card/s-wallet-card.vue` | 余额/积分/优惠券；**佣金入口被注释掉** | 加佣金、马豆、可用兑换券 |
| 钱包卡片 | `sheep/components/s-wallet-card/s-wallet-card.vue` | 余额/积分/优惠券；**佣金入口被注释掉** | 加佣金、dmepa、可用兑换券 |
| 分销中心 | `pages/commission/index.vue` | 标题「分销中心」，依赖 agent 接口 | 改标题「收益中心」 |
| 身份条 | `pages/commission/components/commission-info.vue` | 只显示 `agentInfo.level_info.name` | 多徽章：等级 + 酒道馆 + 区县 |
| 账户卡 | `pages/commission/components/account-info.vue` | 总收益 / 佣金 / 消费 | 加马豆价值、可用兑换券 |
| 功能菜单 | `pages/commission/components/commission-menu.vue` | 团队/佣金明细/订单/推广/资料/海报/分享 | 加收益明细、马豆、兑换券 |
| 账户卡 | `pages/commission/components/account-info.vue` | 总收益 / 佣金 / 消费 | 加dmepa价值、可用兑换券 |
| 功能菜单 | `pages/commission/components/commission-menu.vue` | 团队/佣金明细/订单/推广/资料/海报/分享 | 加收益明细、dmepa、兑换券 |
| 未成为分销商 | `commission-condition.vue` | code=100 弹出买货/消费条件 | 注册即品酒师后这条不再出现 |
| 审核/冻结 | `commission-auth.vue` | 101–107 弹窗 | 保持；`level=0` 会 101，所以不能关分销 |
| 我的团队 | `pages/commission/team.vue` | 只列直推，右侧 `level_info` | 加酒道馆/区县小标 |
@@ -741,10 +741,10 @@ CREATE TABLE `fa_shopro_partner_voucher_plan` (
| `uniapp/sheep/store/user.js` | `defaultUserInfo` 增加 `identities` `identity_text` `madow` `madow_value` `voucher_available`；`getInfo()` 后即可画徽章，不必等 agent |
| `uniapp/sheep/api/partner.js` | **新建**，见 9.3；在 `sheep/api/index.js` 注册 `partner` |
| `uniapp/sheep/components/s-user-card/s-user-card.vue` | 昵称下方：`品酒师` 或 `创客Vx`，可独立叠加酒道馆/区县/合伙股东等身份徽章 |
| `uniapp/sheep/components/s-wallet-card/s-wallet-card.vue` | 恢复佣金入口；加「马豆」「兑换券」两项（点进新页） |
| `uniapp/sheep/components/s-wallet-card/s-wallet-card.vue` | 恢复佣金入口；加「dmepa」「兑换券」两项（点进新页） |
| `uniapp/pages/commission/index.vue` | `title` 改为「收益中心」 |
| `uniapp/pages/commission/components/commission-info.vue` | `level_info` 一枚 + `is_venue`/`is_county` 两枚 |
| `uniapp/pages/commission/components/account-info.vue` | 四列：总收益 / 佣金 / 马豆价值 / 可用兑换券 |
| `uniapp/pages/commission/components/account-info.vue` | 四列：总收益 / 佣金 / dmepa价值 / 可用兑换券 |
| `uniapp/pages/commission/components/commission-menu.vue` | `menuList` 增加三项，路径见下表；「我的资料」在关闭申请表单后去掉 |
| `uniapp/pages/commission/team.vue` | 列表右侧除 `level_info.name` 外显示酒道馆/区县 |
| `uniapp/pages.json` | `pages/commission` 分包增加 rewards/madow/voucher；或新建 `pages/partner` 分包 |
@@ -754,7 +754,7 @@ CREATE TABLE `fa_shopro_partner_voucher_plan` (
| 路径 | 文件 | 内容 | 接口 |
|---|---|---|---|
| `/pages/commission/rewards` | `pages/commission/rewards.vue` | 按奖项筛选流水 | `GET partner.index/rewards` |
| `/pages/commission/madow` | `pages/commission/madow.vue` | 马豆数、当前汇率、约合人民币、汇率说明 | `GET partner.index/madow` |
| `/pages/commission/madow` | `pages/commission/madow.vue` | dmepa数、当前汇率、约合人民币、汇率说明 | `GET partner.index/madow` |
| `/pages/commission/voucher` | `pages/commission/voucher.vue` | 总额/已释放/可用、365 进度条 | `GET partner.index/voucher` |
样式对齐 `pages/user/wallet/commission.vue` 和 `pages/commission/components/commission-log.vue`，不要新视觉体系。
@@ -763,7 +763,7 @@ CREATE TABLE `fa_shopro_partner_voucher_plan` (
```js
{ title: '收益明细', path: '/pages/commission/rewards', img: '.../commission_icon2.png' },
{ title: '我的马豆', path: '/pages/commission/madow', img: '.../commission_icon3.png' },
{ title: '我的dmepa', path: '/pages/commission/madow', img: '.../commission_icon3.png' },
{ title: '兑换券', path: '/pages/commission/voucher', img: '.../commission_icon4.png' },
```
@@ -829,7 +829,7 @@ php think queue:work --queue shopro
1. 文件锁 `runtime/lock/partner_settle_{Ymd}`
2. 统计昨日合格单数、GMV
3. 写汇率快照
4. 酒道馆均分、区县均分、马豆均分
4. 酒道馆均分、区县均分、dmepa均分
5. 释放兑换券一天
6. 写 daily_report
@@ -865,15 +865,15 @@ php think queue:work --queue shopro
- 两种角色平级
- 日结两份均分
### P3 · 马豆（约 2 天）
### P3 · dmepa（约 2 天）
- 日结分马豆
- 日结分dmepa
- 汇率快照
- agent 接口带价值
### P4 · 用户端 `uniapp/`（约 4 天，依赖 P0 的 profile / agent 字段）
- `s-user-card` 身份徽章、`s-wallet-card` 恢复佣金并加马豆/兑换券
- `s-user-card` 身份徽章、`s-wallet-card` 恢复佣金并加dmepa/兑换券
- 收益中心改标题、菜单三项、团队身份标
- 新建 rewards / madow / voucher 三页
- 确认订单兑换券抵扣（可压到 P4 后半）
@@ -910,7 +910,7 @@ php think queue:work --queue shopro
| 关 `commission.level=0` | Agent 基类直接 101，sheep 分销中心全挂 | 用 `partner_mode` 跳过百分比 |
| become=user 丢掉分享关系 | `getInviteLockEvent()` 强制 `agent` | partner 模式改回尊重 `invite_lock` |
| 按 item 计奖翻倍 | `orderPaidAfter` 循环 items | 即时奖按 `order_id` 幂等一次 |
| 现金 1:1 GMV | 会把当日销售额再发一遍 | 默认马豆 |
| 现金 1:1 GMV | 会把当日销售额再发一遍 | 默认dmepa |
| 无 cron | 项目里没有日结命令 | 必须配 crontab，上线检查清单写死 |
| 个人中心看不到身份 | `user.vue` 只调 profile，不调 agent | 身份字段必须挂在 profile + `s-user-card` |
| 旧分销数据 | 已有百分比佣金 | 只影响新单；旧单不重算 |
@@ -921,9 +921,9 @@ php think queue:work --queue shopro
## 16. 仍需业务确认（不回则按括号内默认）
1. 品酒师：注册即是（默认）还是直推 3 单才是
2. 1:1：马豆（默认）还是现金
2. 1:1：dmepa（默认）还是现金
3. 汇率 n：默认 1；N=全平台累计；退款不减 N
4. 马豆只展示（默认）还是可兑余额
4. dmepa只展示（默认）还是可兑余额
5. 创客/酒道馆/区县：先全后台开通（默认）
6. 极差：水位差；不活跃不占水位（默认）
7. 平级基数：等级标准佣金；只发一层（默认）

24
docs/收益中心全场景关系链收益模拟与测算文档.md
查看文件

@@ -18,7 +18,7 @@
9. [场景八：渠道身份自购场景（酒道馆/区县自购与返利）](#场景八渠道身份自购场景酒道馆区县自购与返利)
10. [场景九：30天未自购（不活跃）的跳过与极差穿透机制](#场景九30天未自购不活跃的跳过与极差穿透机制)
11. [场景十：全复合10级超级商业大矩阵综合穿透模拟](#场景十全复合10级超级商业大矩阵综合穿透模拟)
12. [场景十一：次日凌晨00:30全网日结三大奖池与马豆资产模型](#场景十一次日凌晨0030全网日结三大奖池与马豆资产模型)
12. [场景十一：次日凌晨00:30全网日结三大奖池与dmepa资产模型](#场景十一次日凌晨0030全网日结三大奖池与dmepa资产模型)
13. [场景十二：退款逆向冲销与防刷风控机制](#场景十二退款逆向冲销与防刷风控机制)
14. [全景财务现金拨比与安全边际精算表](#全景财务现金拨比与安全边际精算表)
@@ -40,11 +40,11 @@
| **即时奖** | 区县代理统筹奖 | `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 定时任务 |
| **日结奖** | 全网dmepa均分池 | `madow_share` | 当日 GMV $1:1$ 转换为dmepa，均分给合格会员（对外统一显示为整数） | 过去 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$ 为全网累计完成单数） | 随全网单数单向递增，支持现金兑换 | 实时动态变动 |
| **显示规范**| 马豆数量展示规范 | `madow_display`| 统一显示为纯整数（四舍五入或向下取整），底层高精度运算防尾差 | 全平台仪表盘、列表、个人中心一致 | 全端强制规范 |
| **资产增值**| dmepa浮动定价汇率 | `madow_rate` | $\text{Rate} = 0.00000075 \times N$（$N$ 为全网累计完成单数） | 随全网单数单向递增，支持现金兑换 | 实时动态变动 |
| **显示规范**| dmepa数量展示规范 | `madow_display`| 统一显示为纯整数（四舍五入或向下取整），底层高精度运算防尾差 | 全平台仪表盘、列表、个人中心一致 | 全端强制规范 |
| **保活约束**| 业务活跃周期 | `active_days` | 30 天（720 小时） | 自购订单付款即刷新保活时间，未保活跳过并沉淀 | 系统级前置过滤 |
---
@@ -362,7 +362,7 @@
---
## 场景十一：次日凌晨00:30全网日结三大奖池与马豆资产模型
## 场景十一：次日凌晨00:30全网日结三大奖池与dmepa资产模型
日结奖励不占用单笔即时分润，由每日定时脚本（`DailySettleService`）在次日凌晨 00:30 从平台当日总营业额（GMV）与平台预提池中加权结算。
@@ -379,20 +379,20 @@
| 日结奖项 | 资金池形成规则 | 当日总池规模 | 参评达标人数 | 人均实际分配 | 结算账户与流向 | 财务属性 |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| **全网马豆均分池** | 当日 GMV $1:1$ 转换为马豆 | **279,600 豆** | 800 人 | **350 豆/人 (按整数显示)** | 会员马豆账户 | 平台记账资产凭证，无即时法币支出 |
| **全网dmepa均分池** | 当日 GMV $1:1$ 转换为dmepa | **279,600 dmepa** | 800 人 | **350 dmepa/人 (按整数显示)** | 会员dmepa账户 | 平台记账资产凭证，无即时法币支出 |
| **酒道馆平台均分池** | 当日单数 $\times 100$ 元/单 | **¥ 20,000.00** | 40 家 | **¥ 500.00 / 馆** | 佣金钱包 | 平台实发现金支出 |
| **区县代理平台均分池**| 当日单数 $\times 50$ 元/单 | **¥ 10,000.00** | 10 家 | **¥ 1,000.00 / 县** | 佣金钱包 | 平台实发现金支出 |
### 11.3 马豆即时汇率与资产价值精算
马豆单价由全网累计成交单数 $N$ 严格线性决定：
### 11.3 dmepa即时汇率与资产价值精算
dmepa单价由全网累计成交单数 $N$ 严格线性决定：
$$\text{Rate} = 0.00000075 \times N$$
1. **当前状态（$N = 50,000$ 单）**：
- 即时汇率：$\text{Rate} = 0.00000075 \times 50,000 = \mathbf{0.0375\text{ 元/豆}}$。
- 会员当日获得约 350 豆（精算值 349.5 豆）的理论资产价值：$349.5 \times 0.0375 \approx \mathbf{13.11\text{ 元}}$。
- 即时汇率：$\text{Rate} = 0.00000075 \times 50,000 = \mathbf{0.0375\text{ 元/dmepa}}$。
- 会员当日获得约 350 dmepa（精算值 349.5 dmepa）的理论资产价值：$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 倍）。
- 即时汇率：$\text{Rate} = 0.00000075 \times 200,000 = \mathbf{0.1500\text{ 元/dmepa}}$。
- 会员早期持有的 10,000 dmepa 价值：$10,000 \times 0.15 = \mathbf{1,500.00\text{ 元}}$（资产升值 4 倍）。
3. **汇率特征**：单向增值、永不跌落，以平台实际生态成交量作为底层价值背书。
---

14
docs/收益中心多场景收益模拟测算表.md
查看文件

@@ -16,8 +16,8 @@
| **团队奖拆分（即时）** | 总额 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$ 为平台合格订单总数，随单数线性升值 |
| **每日dmepa均分（日结）**| 1:1 GMV 池 | 每日 00:30 结算，平分给过去 30 天有自购的合格会员 |
| **dmepa浮动汇率** | $0.00000075 \times N$ 元 | $N$ 为平台合格订单总数，随单数线性升值 |
| **馆/县平台均分（日结）**| 馆池: 100元/单; 县池: 50元/单 | 每日 00:30 结算，平分给过去 30 天活跃的馆/县 |
| **活跃资格周期** | 30 天 | 过去 30 天内有自购订单，逾期暂停发放即时与日结 |
@@ -229,15 +229,15 @@
| 分红奖项 | 资金池规模 | 合格人数 | 人均分配额 | 结算资金归属 | 财务说明 |
| :--- | :--- | :--- | :--- | :--- | :--- |
| **马豆分红池** | 139,800.00 豆 (1:1 GMV) | 500 人 | **279.60000000 豆/人** | 发放至会员马豆账户 | 不发生实际现金支出，随汇率承载资产价值 |
| **dmepa分红池** | 139,800.00 dmepa (1:1 GMV) | 500 人 | **279.60000000 dmepa/人** | 发放至会员dmepa账户 | 不发生实际现金支出，随汇率承载资产价值 |
| **酒道馆平台均分池** | **¥ 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. dmepa即时汇率与资产价值模拟
- **即时汇率公式**：$\text{Rate} = 0.00000075 \times 10,000 = \mathbf{0.0075\text{ 元/dmepa}}$。
- **每人当日分得 279.6 dmepa的实际法币估值**：$279.6 \times 0.0075 \approx \mathbf{2.10\text{ 元}}$。
- **当历史单数达到 100,000 单时**：汇率升至 $0.075$ 元/dmepa，279.6 dmepa估值达到 **20.97 元**。
---