本项目为支付收单行业的渠道代理商管理平台从PHP迁移至Java SaaS架构。原系统随着代理商规模扩大，在多租户隔离、分润计算精度、系统扩展性方面遇到瓶颈，分润规则配置依赖开发人员手工改代码，业务人员无法自主管理。本次迁移构建了完整的渠道代理SaaS平台，解决多级代理商层级管理、6级用户体系、5种分润场景的自动化配置与计算问题。业务场景为：平台通过多级代理商拓展商户门店，每笔交易按预设规则自动向上级代理分配分润，涵盖交易分润、服务费分润、设备服务费分润、商城订单分润、半年结算等场景，支持级差、比例、固定金额等多种计算模式，服务于支付收单行业的渠道精细化运营。
1、代理商管理：支持6级用户层级体系（联盟会员、联盟店长、联盟店主、供应链服务中心、联合创始人、平台运营），代理商树形结构可视化展示，层级关系绑定，每个代理商独立配置收益比例、扣税比例、提现费率。
2、终端门店管理：以门店编号为唯一标识，支持终端增删改查、门店编号查重、终端绑定代理，终端列表展示绑定用户名和手机号。
3、分润规则引擎：5种分润场景（交易/服务费/设备服务费/商城订单/半年结算），4种计算类型（比例/级差/固定/费率+固定），规则配置含层级费率、平级奖、冻结天数、最低分润、交易过期等11个参数，支持动态计算示例预览。
4、规则绑定管理：按场景分页签，终端直接绑定规则（交易/服务费/半年结算）、终端+第三方订单号绑定（设备服务费）、商品绑定（商城订单），支持多选标签式搜索绑定。
5、系统配置：提现配置、收益开关、APP通用配置、通用配置、云开薪配置5个分类页签。
6、计算示例：根据规则真实层级费率和场景动态生成分润分配表，每个层级作为下单人生成场景，展示计算过程。
技术栈采用Java 21 + Spring Boot 4.0.6 + MyBatis-Plus 3.5.16 + Sa-Token v1.45.0，Maven多模块架构，多租户动态数据源实现租户隔离。前端Vue3 + Naive UI + Vite + pnpm。
数据库核心表：ch_user（代理商，含6级层级）、ch_terminal（终端门店，以store_no唯一标识）、profit_rule（分润规则，含11个配置参数）、profit_rule_tier（规则层级费率）、profit_rule_binding（规则绑定关系，按scene区分场景）、ch_config（系统配置，5个分类）。
参数三层设计：用户级参数存ch_user表、规则级参数存profit_rule表、系统级参数存ch_config表。
分润链路：门店绑定代理 → 交易产生时通过门店编号找代理 → 按代理层级关系向上分配 → 根据规则绑定匹配场景规则 → 按计算类型算每级分润金额。
数据迁移：旧系统yzs_sns→ch_terminal（39条终端）、yzs_income_rules→profit_rule（交易分润）、yzs_pos_goods_rules→profit_rule（服务费/商城/半年结算）、yzs_device_service_fee_rule→profit_rule（设备服务费），用户ID迁移时保持一致确保关联完整。计算示例为computed属性，规则变化时实时重新计算，不同计算类型展示不同计算公式
评论