```

chore(brand): 统一将品牌名从雄戈小酒更改为橙虎小酒

- 更新alisms插件配置中的签名值
- 修改shopro插件中所有SQL脚本的品牌名称引用
- 更新商城配置、商品分类、演示数据中的品牌名称
- 替换后台登录页面的品牌标识
- 更新汇付分账配置中的媒介名称
- 修改登录预览生成脚本中的品牌显示
```

addons/shopro/docs/后台使用手册-分销与区域公司.md

@@ -0,0 +1,304 @@
+# 橙虎小酒商城 · 后台使用手册（分销 & 区域公司）
+
+> 面向店铺运营人员，无需技术背景。按步骤操作即可。  
+> 后台路径：**Shopro 商城管理** → 左侧菜单 **分销中心** / **区域公司**。
+
+---
+
+## 一、先搞懂两件事
+
+| 功能 | 一句话说明 | 钱给谁 |
+|------|------------|--------|
+| **分销中心** | 用户分享商品，发展下级，按「推荐关系」拿推广差价 | 分销商（推广人） |
+| **区域公司** | 按订单**收货地址**的省 / 市 / 区县，给当地代理公司拿区域差价 | 区域公司负责人 |
+
+两者**可以同时开启**：同一笔订单，既可能给推荐链上的分销商算差价，也可能给收货地址对应区域的区域公司算差价（商品需允许参与，见下文）。
+
+**区域公司怎么匹配订单？**  
+系统看买家订单里的**收货省、市、区县**，去查您是否已为该区域配置了「正式区域公司」。没有配置的区域，不会产生区域差价。
+
+---
+
+## 二、分销中心 · 推荐配置顺序（首次上线）
+
+按下面顺序做，不容易漏项：
+
+1. **分销设置** — 打开分销、定规则（层级、怎么成为分销商、什么时候结算等）  
+2. **分销等级** — 每个等级填好差价比例（及可选的级差档位、管理奖）  
+3. **分销商品** — 哪些商品参与分销，必要时单独改差价  
+4. **分销商** — 审核申请、调整等级、处理待升级  
+5. 日常看 **分销订单**、**佣金明细**、**分销动态**
+
+---
+
+## 三、分销中心 · 各菜单怎么用
+
+### 1. 分销设置
+
+**路径：** 分销中心 → 分销设置 → 点右下角 **保存**。
+
+#### （1）基础设置
+
+| 设置项 | 建议怎么选 | 通俗解释 |
+|--------|------------|----------|
+| **分销层级** | 按业务选一级 / 二级 / 三级；不用分销选「关闭」 | 最多向上几层上级能拿推广差价 |
+| **分销内购** | 需要则「开启」 | 分销商自己买也能给自己返差价 |
+| **分销商锁定下线条件** | 常用「点击分享链接」或「首次支付」 | 客户什么时候算「绑在这个分销商名下」 |
+| **分销商审核** | 要控质量选「需要」 | 用户申请后是否必须后台通过 |
+| **越级升级** | 一般「不允许」 | 能否跳过中间等级直接升到高等级 |
+| **升级审核** | 看是否需要人工把关 | 达标后是否还要您点通过才升级 |
+
+> **默认差价比例**不在本页填，请到 **分销等级** 里按等级设置。
+
+#### （2）默认分销商设置
+
+| 成为分销商条件 | 适用场景 |
+|----------------|----------|
+| **自助申请** | 用户在小程序里填表申请（需配合「完善资料」） |
+| **购买任意商品** | 买过指定商品自动成为分销商 |
+| **消费累计** | 累计消费满 X 元自动成为 |
+
+- **完善资料**：申请时要填的字段（姓名、手机号、上传图片等），可自定义。  
+- **申请协议**：可挂一篇富文本协议，用户勾选同意。
+
+#### （3）级差与管理奖（高级，可按需开）
+
+| 开关 | 含义（简版） |
+|------|----------------|
+| **推广分佣** | 按一级 / 二级 / 三级「百分比」在推荐链上分差价 |
+| **级差奖** | 按各等级「固定档位（元）」算差额；**商品上要勾选「参与级差奖」** |
+| **管理奖** | 链上各级按「管理奖比例」再拿一份；**商品上要勾选「参与管理奖」** |
+| **复购推荐人分佣** | 老客户再次购买，上级是否还能拿推广差价 |
+| **本人复购立减** | 老客户再买指定商品，付款时直接减价（不是事后返现）；需在商品上勾选「参与复购立减」 |
+
+#### （4）结算条件
+
+| 设置项 | 说明 |
+|--------|------|
+| **商品结算方式** | 按「商品标价」还是「用户实际支付价（不含运费）」算差价 |
+| **差价结算方式** | 支付后 / 确认收货 / 订单完成 / 手动打款 — 决定差价何时进入可提现状态 |
+| **退款扣除差价** | 退款后是否扣回已发或待发差价 |
+| **退款扣除分销业绩** | 退款后是否扣回计入升级、统计的业绩 |
+
+---
+
+### 2. 分销等级
+
+**路径：** 分销中心 → 分销等级 → 添加 / 编辑。
+
+每个等级单独保存一次，主要填：
+
+- **等级权重**：数字越大等级越高（一级是基础等级）。  
+- **等级名称、徽章**：小程序里展示用。  
+- **一级 / 二级 / 三级差价比例**：该等级的人处在对应推荐位置时，按订单金额 × 比例拿差价。  
+- **级差档位金额**（若开了级差奖）：填本等级的「档位」，和订单金额无关，按档位差额计算。  
+- **管理奖比例**（若开了管理奖）：本等级拿 订单金额 × 比例。
+
+**二级及以上**可设 **升级条件**（消费金额、团队人数、分销订单金额/单数、下级分销商人数等），选「满足任意一条」或「全部满足」。
+
+> 改完等级后，请到 **分销商品** 检查是否要用「独立规则」覆盖某个商品的差价。
+
+---
+
+### 3. 分销商品
+
+**路径：** 分销中心 → 分销商品。
+
+| 操作 | 说明 |
+|------|------|
+| 列表点 **参与 / 不参与** | 快速开关某商品是否走分销 |
+| 点 **编辑** | 详细设置 |
+
+编辑页重点：
+
+| 项 | 说明 |
+|----|------|
+| **是否参与** | 关 = 该商品不产生任何分销差价 |
+| **差价规则** | 默认（跟等级走）/ 独立 / 批量 — 多数商品用「默认规则」即可 |
+| **分销商业绩** | 「计入」才会算进升级、团队业绩统计 |
+| **参与级差奖 / 管理奖 / 复购立减** | 与「分销设置」里总开关配合使用 |
+| **参与区域公司** | 关 = 该商品订单**不给区域公司**分区域差价（默认开） |
+
+---
+
+### 4. 分销商
+
+**路径：** 分销中心 → 分销商。
+
+| 标签页 | 您要做什么 |
+|--------|------------|
+| **分销商** | 查所有人、改等级、禁用、看团队 |
+| **待审核** | 通过 / 拒绝新申请 |
+| **待升级** | 用户已达标，等您确认升级（若开了升级审核） |
+
+常用：搜索手机号 / 昵称 → 点详情 → 改等级或审核。
+
+---
+
+### 5. 分销订单、佣金明细、分销动态
+
+| 菜单 | 用途 |
+|------|------|
+| **分销订单** | 哪些订单产生了分销业绩 |
+| **佣金明细** | 每一笔差价记录；可按规则 **结算 / 退回**（若设置为手动打款或需人工处理） |
+| **分销动态** | 绑定关系、升级、团队变化等日志，便于核对纠纷 |
+
+---
+
+## 四、区域公司 · 推荐配置顺序（首次上线）
+
+1. **公司设置** — 打开功能、选分佣模式、结算时机、申请表单  
+2. **公司等级** — 省 / 市 / 区县各档差价（比例或固定金额）  
+3. **区域公司** — 给用户绑定「负责哪块区域」；同一区域同一层级只能有一个正式公司  
+4. **分销商品** — 确认商品「参与区域公司」为开启（在分销商品里）  
+5. 日常看 **业绩看板**、**公司订单**、**差价明细**
+
+---
+
+## 五、区域公司 · 各菜单怎么用
+
+### 1. 公司设置
+
+**路径：** 区域公司 → 公司设置 → **保存设置**。
+
+| 设置项 | 说明 |
+|--------|------|
+| **区域公司开关** | 关 = 整个区域差价功能停用 |
+| **申请需审核** | 用户在小程序申请后，是否必须后台通过 |
+| **差价结算时机** | 支付后 / 确认收货 / 订单完成（与分销结算相互独立，各管各的） |
+| **分佣模式** | 见下表 |
+| **申请表单字段** | 用户申请区域公司时要填的内容（如姓名、手机号、身份证图） |
+
+**分佣模式（三选一，请和业务方定好再改）：**
+
+| 模式 | 通俗理解 |
+|------|----------|
+| **叠加模式** | 同一单：省、市、区县公司**各拿各的**全额（若都已配置） |
+| **独占模式** | 只给**最细一级**：有区县只给区县；没有区县才给市；再没有才给省 |
+| **级差模式** | 省 / 市 / 区都配置时，按档位**差额**分，避免重复发满额 |
+
+**差价怎么算：**
+
+- **比例**：按该订单商品**实付金额** × 百分比。  
+- **固定金额**：按**每个订单商品一行**计一次固定钱（**不乘购买数量**）。
+
+**各级差价配置**表格来自 **公司等级**；本页可点「编辑」或「管理公司等级」跳转维护。
+
+---
+
+### 2. 公司等级
+
+**路径：** 区域公司 → 公司等级 → 添加 / 编辑。
+
+| 字段 | 填写提示 |
+|------|----------|
+| **等级权重** | 数字越大等级越高；建议与省 / 市 / 区层级对应 |
+| **等级名称** | 如「省级公司」「贵阳市级公司」 |
+| **区域层级** | 省级 / 市级 / 区县级 — 决定这类等级管哪一层地理范围 |
+| **差价类型** | 实付比例 **或** 固定金额（元/单） |
+
+---
+
+### 3. 区域公司（人员与区域绑定）
+
+**路径：** 区域公司 → 区域公司 → **添加** / 编辑 / 审核。
+
+**后台添加时：**
+
+1. 搜索并选择**小程序用户**（须已注册）。  
+2. 选 **区域层级**（省 / 市 / 区县）。  
+3. 选 **公司区域**（省市区 cascader）。  
+4. 选 **公司等级**（决定默认差价规则）。  
+5. **差价设置**：一般用「等级通用配置」；个别代理可「单独设置差价」。
+
+**注意：** 同一 **区域 + 同一层级** 只能有一个**正式**区域公司；重复添加会提示「该区域已有正式公司」。
+
+| 标签 | 操作 |
+|------|------|
+| **待审核** | 通过 / 拒绝小程序申请 |
+| **正常 / 已禁用** | 禁用后该区域不再给该用户发区域差价 |
+
+---
+
+### 4. 业绩看板
+
+**路径：** 区域公司 → 业绩看板。
+
+按日期查看：正式公司数、待审核数、区域订单数、销售额、差价总额、待结算差价，以及区域销售 TOP 榜。用于日常汇报，无需改数据。
+
+---
+
+### 5. 公司订单、差价明细
+
+| 菜单 | 用途 |
+|------|------|
+| **公司订单** | 哪些订单触发了区域差价 |
+| **差价明细** | 每笔区域差价；支持导出、结算、退回（按权限） |
+
+---
+
+## 六、小程序端用户会看到什么（便于您答疑）
+
+**分销：** 个人中心 → 分销中心（推广商品、团队、佣金、申请分销商等，以您装修为准）。
+
+**区域公司：** 用户可在小程序申请成为区域公司；若开启审核，提交后状态为「待审核」，通过后在对应收货区域订单上产生区域差价。
+
+---
+
+## 七、常见问题
+
+**Q1：开了分销，为什么没差价？**  
+- 分销设置里 **分销层级** 是否为「关闭」；  
+- **分销商品** 是否「参与」；  
+- 买家是否通过分销商链接绑定（看「锁定下线条件」）；  
+- 是否还没到 **结算时机**（确认收货前可能只显示「待结算」）。
+
+**Q2：区域公司没差价？**  
+- **公司设置** 开关是否打开；  
+- 该 **省 / 市 / 区县** 是否已添加正式区域公司；  
+- 订单 **收货地址** 是否填写完整；  
+- **分销商品** 里是否关闭了「参与区域公司」。
+
+**Q3：同一区域能否设两个市级公司？**  
+- 不能。同一区域、同一层级只能一个正式公司。
+
+**Q4：分销和区域公司会不会重复？**  
+- 会同时存在两套规则：一套给推荐链上的分销商，一套给收货地区域公司。是否都给、给多少，由各自开关和商品上的「参与」项决定。
+
+**Q5：改设置后旧订单会变吗？**  
+- 一般 **已生成的订单** 按下单时的规则；**新订单** 按保存后的新规则。大改规则前建议先小范围试一单。
+
+**Q6：用户分享绑不上下级？**  
+- 到 **分销设置** 看「分销商锁定下线条件」，常用「点击分享链接」；改完后让分销商重新分享新链接测试。
+
+---
+
+## 八、日常运营检查清单（可打印）
+
+**每周建议看一眼：**
+
+- [ ] 分销 → 待审核、待升级是否积压  
+- [ ] 区域公司 → 待审核是否处理  
+- [ ] 佣金明细 / 差价明细 → 待结算是否异常偏多  
+- [ ] 新上架商品 → 是否已在「分销商品」里设为参与（如需分销或区域差价）
+
+**每月建议核对：**
+
+- [ ] 分销等级、区域公司等级 与 当前政策是否一致  
+- [ ] 业绩看板 / 分销订单 与 财务对账  
+
+---
+
+## 九、需要技术同事协助时怎么说
+
+把下面信息发给服务商即可：
+
+1. 问题订单号、买家手机号、下单时间  
+2. 当时收货省市区  
+3. 相关分销商手机号（如有）  
+4. 区域公司名称或负责人手机号（如有）  
+5. 截图：分销设置、该商品分销编辑页、区域公司列表  
+
+---
+
+*文档版本：与当前 Shopro 后台「分销中心」「区域公司」菜单一致。若您后台菜单名称略有不同，以实际显示为准。*