本项目为云值守渠道代理商管理系统的Java SaaS平台迁移升级。原系统基于PHP开发，随着业务规模扩大，旧系统在多租户隔离、分润计算精度、系统扩展性等方面存在瓶颈。本次迁移将渠道代理体系（含6级用户层级、5种分润场景、级差分润算法）完整迁移至Java Spring Boot微服务架构，支持多租户动态数据源，实现代理商层级管理、终端门店绑定、分润规则配置、交易分润自动计算等核心业务能力。服务于支付收单行业的渠道代理商拓展与管理场景，帮助平台高效管理多级代理商体系，自动化处理交易分润、服务费分润、设备服务费分润、商城订单分润及半年结算等多种分润业务。
系统包含以下核心功能模块：
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 + elegant-router。
数据库：MySQL，核心表包括ch_user（代理商）、ch_terminal（终端门店）、profit_rule（分润规则）、profit_rule_tier（规则层级参数）、profit_rule_binding（规则绑定关系）、ch_config（系统配置）等。
参数三层设计：用户级参数（income_rate/income_percent/withdraw_rate存储于ch_user表）、规则级参数（11个分润配置字段存储于profit_rule表）、系统级参数（each_withdraw_fee等存储于ch_config表）。
分润链路：门店（store_no）绑定代理（ch_user）→ 交易产生时通过门店编号找到绑定代理 → 按代理层级关系向上分配分润 → 根据规则绑定关系匹配对应场景的规则 → 按计算类型（级差/固定/比例/费率+固定）计算每级分润金额。
数据迁移：旧系统yzs_sns→ch_terminal（终端，39条真实数据）、yzs_income_rules→profit_rule（交易分润规则）、yzs_pos_goods_rules→profit_rule（服务费/商城/半年结算规则）、yzs_device_service_fee_rule→profit_rule（设备服务费规则），用户ID在迁移时保持一致以确保关联关系完整。
评论