奖励结算引擎插件（ShopXO 分销/奖金 · 9级判级 · 级差/平级/周分红 · 发放护栏）

产品信息

核心功能

• 制度驱动结算：级差奖、平级奖、周分红全部表驱动（销售利润表 / 周分红表 / 结算参数表），改制度即改数据，无需改代码。

• 多级判级 V1–V9：两条通道取大者、只升不降 —— ① 个人累计 PV 快路径（一次性购买即达级）② 网络条件（网络累计 PV + 直推人数 + 小部门 PV）。

• 三类奖金：推荐链逐级级差奖（查利润表）、平级奖按 10% 拿一级、周分红按周分红档位与基数周结周发。

• 业绩采集：商品业绩值可后台按规格配置，下单按「业绩值 × 数量」采集，支付后自动同步引擎。

• 发放四层护栏：安全窗口（隔离当天重写）→ 发放前复核（金额漂移即中止）→ 独立台账幂等（同明细只发一次）→ 批次人数上限；默认试算不写库。

• 调度与幂等：MySQL EVENT 每 15 分钟 + CLI 兜底，结算按日期幂等，重复调用不会重复发奖。

引擎资产清单

交付清单

• 插件完整源码（可二次开发）+ 安装/卸载事件

• 引擎 SQL 资产（表结构、存储过程与函数、示例制度数据）

• 部署手册、制度配置说明、发放操作规程

• 后台管理页（结算概览、同步、结算、等级重算、发放试算）

安装流程

1. 上传插件目录至 app/plugins/，静态资源至 public/static/plugins/。

2. 后台「应用中心」安装（自动建表、导入例程、灌制度种子、注册调度）。

3. 配置调度：MySQL EVENT（每 15 分钟）或 crontab 调用 crontab.php。

4. 在商品规格中维护「业绩值」，按客户制度调整三张制度/参数表。

5. 试算验证：php payout.php 核对金额后再正式发放。

服务包档位（可选）

常见问题

Q：制度变化需要二次开发吗？
A：不需要。利润表、周分红表、参数表均为数据驱动，修改表数据即生效。

Q：会不会重复发奖？
A：不会。结算按日期幂等，发放有独立台账（明细表+行ID唯一键）与发放前复核双重保障。

Q：服务器没有 MySQL EVENT 权限怎么办？
A：可用 crontab 调用插件自带的 crontab.php，效果一致且同样幂等。

Q：支持哪些 ShopXO 版本？
A：适配 ShopXO 6.x；其它版本可按需做兼容性改造（企业版含定制服务）。