CPS联盟返利系统 - 实施计划背景说明为什么需要本项目CPSCost Per Sale按销售付费是电商联盟推广的核心模式。当前项目基于 ruoyi-vue-pro 框架需要新增一个完整的yudao-module-cps模块用于构建一站式多平台CPS返利查询与导购系统。该模块将aggregate淘宝联盟、京东联盟、拼多多联盟等主流CPS平台能力为会员提供返利查询、跨平台比价、推广链接生成和返利提现等服务。本项目要解决什么问题多平台聚合统一接入多个CPS平台提供一致的商品查询和返利查询能力会员返利体系基于现有会员等级体系支持差异化的返利比例配置多平台比价支持跨平台搜索比价帮助用户找到最优价格和最高返利订单全链路追踪实现从商品查询→链接生成→用户下单→佣金结算→返利入账的完整业务闭环MCP AI接口提供基于MCP协议的AI Agent接口层支持AI驱动的商品查询、比价、推荐等功能期望 outcomes完善的项目架构设计文档清晰的模块划分和依赖关系MCP AI接口的标准规范完善的README文档包含代码简介和功能介绍实施方案1. 模块划分与架构设计基于 ruoyi-vue-pro 的模块化设计新增yudao-module-cps模块yudao-module-cps/ ├── yudao-module-cps-api/ # CPS模块API定义供其他模块调用 │ ├── enums/ # 枚举定义平台编码、订单状态等 │ └── api/ # 远程服务接口 │ └── yudao-module-cps-biz/ # CPS模块业务实现 ├── controller/ │ ├── admin/ # 管理后台接口 │ │ ├── CpsPlatformController # 平台配置管理 │ │ ├── CpsAdzoneController # 推广位管理 │ │ ├── CpsOrderController # 订单管理 │ │ ├── CpsRebateConfigController # 返利配置管理 │ │ ├── CpsWithdrawController # 提现审核管理 │ │ └── CpsStatisticsController # 数据统计 │ │ │ └── app/ # C端会员接口 │ ├── AppCpsGoodsController # 商品搜索与比价 │ ├── AppCpsLinkController # 转链/口令生成 │ ├── AppCpsOrderController # 我的订单 │ ├── AppCpsRebateController # 我的返利 │ └── AppCpsWithdrawController # 提现 │ ├── service/ │ ├── platform/ # CPS平台适配层 │ │ ├── CpsPlatformClientFactory # 平台客户端工厂 │ │ └── CpsPlatformConfigService # 平台配置服务 │ ├── goods/ # 商品查询服务 │ │ ├── CpsGoodsSearchService # 搜索与比价 │ │ └── CpsGoodsParseService # 链接/口令解析 │ ├── link/ # 推广链接服务 │ │ └── CpsPromotionLinkService # 转链与归因 │ ├── order/ # 订单服务 │ │ ├── CpsOrderSyncService # 订单同步 │ │ └── CpsOrderService # 订单管理 │ ├── commission/ # 佣金结算服务 │ │ ├── CpsCommissionCalcService # 佣金计算 │ │ └── CpsRebateSettleService # 返利结算 │ ├── rebate/ # 返利配置服务 │ │ └── CpsRebateConfigService # 返利规则管理 │ └── withdraw/ # 提现服务 │ └── CpsWithdrawService # 提现管理 │ ├── client/ # CPS平台适配器策略模式 │ ├── CpsPlatformClient.java # 统一接口定义 │ ├── taobao/ # 淘宝联盟适配器 │ ├── jingdong/ # 京东联盟适配器 │ ├── pinduoduo/ # 拼多多联盟适配器 │ └── douyin/ # 抖音联盟适配器扩展 │ ├── dal/ │ ├── dataobject/ # 数据库实体 │ └── mysql/ # Mapper接口 ├── convert/ # DTO转换MapStruct ├── job/ # 定时任务 └── mcp/ # MCPModel Context ProtocolAI接口层 ├── server/ │ ├── CpsMcpServer.java # MCP Server主入口 │ └── CpsMcpServerConfig.java # MCP Server配置类 ├── transport/ │ ├── CpsMcpHttpTransport.java # Streamable HTTP传输层 │ └── CpsMcpStdioTransport.java # STDIO传输层 ├── tool/ # MCP Tools定义 │ ├── CpsSearchGoodsTool.java # 商品搜索工具 │ ├── CpsComparePricesTool.java # 多平台比价工具 │ └── ... ├── resource/ # MCP Resources定义 │ ├── CpsPlatformResource.java # 平台列表及状态 │ ├── CpsRebateRuleResource.java # 返利规则配置 │ └── ... └── prompt/ # MCP Prompts定义 ├── CpsFindBestDealPrompt.java # 找最优惠商品 ├── CpsComparePrompt.java # 跨平台比价 └── ...2. 与现有模块依赖关系yudao-module-cps-biz ├── 依赖 yudao-module-member # 复用会员体系用户、等级、积分 ├── 依赖 yudao-module-pay # 复用支付模块钱包、提现转账 ├── 依赖 yudao-module-system # 复用系统模块权限、字典、通知 └── 依赖 yudao-module-infra # 复用基础设施定时任务、文件存储3. 核心功能设计3.1 MCP AI接口模块P3优先级本模块基于MCPModel Context Protocol协议标准为CPS系统构建一套可供AI Agent直接调用的接口层。MCP三类原语原语说明在CPS系统中的作用ToolsAI可调用的可执行函数商品搜索、比价、转链、订单查询等操作ResourcesAI可读取的数据源只读平台配置、返利规则、会员画像、统计数据等Prompts预定义的交互模板找最优价、比价分析、省钱策略等场景化提示核心Tools定义cps_search_goods商品搜索参数keyword, platform_code, price_min, price_max, sort_type, member_id返回统一商品列表含 platformCode, title, price, finalPrice, estimateRebate 等字段cps_compare_prices多平台比价参数keyword, member_id返回跨平台比价表格推荐最优方案cps_generate_link推广链接生成参数itemId, platformCode, memberId返回推广链接/口令含归因参数cps_get_order_status订单状态查询参数memberId返回用户订单列表及返利进度cps_rebate_summary返利汇总参数memberId返回可提现余额、待结算金额、累计收入传输层支持传输方式适用场景端点说明Streamable HTTP远程AI Agent接入/mcp/cps支持SSE流式响应适合生产环境STDIO本地开发调试标准输入输出适合本地AI开发工具集成配置项application.yamlyudao:cps:mcp:enabled:true# 是否启用MCP Servertransport:http# 传输方式: http / stdiohttp:endpoint:/mcp/cps# HTTP端点路径sse-enabled:true# 是否启用SSE流式推送auth:enabled:true# 是否启用鉴权type:bearer# 鉴权方式: bearer / api-keyrate-limit:enabled:true# 是否启用限流max-requests-per-minute:60# 每分钟最大请求数4. 数据库设计核心表yudao_cps_platform # CPS平台配置表 yudao_cps_adzone # 推广位PID管理表 yudao_cps_order # CPS订单表 yudao_cps_rebate_config # 返利配置表 yudao_cps_rebate_record # 返利记录表 yudao_cps_withdraw # 提现申请表 yudao_cps_statistics # 统计数据表 yudao_cps_mcp_api_key # MCP API Key管理表 yudao_cps_mcp_access_log # MCP访问日志表5. 接口规范5.1 会员端接口约13个POST /app-api/cps/goods/search # 商品搜索 POST /app-api/cps/goods/compare # 多平台比价 GET /app-api/cps/goods/detail # 商品详情 GET /app-api/cps/goods/recommend # 商品推荐 POST /app-api/cps/link/generate # 生成推广链接 GET /app-api/cps/order/page # 我的订单列表 GET /app-api/cps/order/get # 订单详情 GET /app-api/cps/rebate/summary # 返利汇总 GET /app-api/cps/rebate/page # 返利明细 POST /app-api/cps/withdraw/create # 发起提现 GET /app-api/cps/withdraw/page # 提现记录 GET /app-api/cps/search/history # 搜索历史 GET /app-api/cps/search/hot # 热门搜索5.2 管理端接口约15个admin-api/cps/platform/* # 平台配置管理 admin-api/cps/adzone/* # 推广位管理 admin-api/cps/order/* # 订单管理 admin-api/cps/rebate-config/* # 返利配置 admin-api/cps/withdraw/* # 提现审核 admin-api/cps/statistics/* # 数据统计 admin-api/cps/mcp/* # MCP管理6. 技术要求6.1 性能要求指标要求单平台搜索 2秒P99多平台比价 5秒P99转链生成 1秒订单同步延迟 30分钟返利入账延迟平台结算后 24小时内6.2 数据安全CPS平台密钥 AES-256 加密存储会员数据隔离只能查看自己的数据敏感操作记录审计日志提现金额二次校验验证方式单元测试CPS平台适配器单元测试每个平台至少10个测试用例返利计算逻辑测试覆盖5种不同优先级场景订单同步与归因测试MCP Tools功能测试集成测试淘宝联盟全流程测试京东联盟全流程测试拼多多联盟全流程测试多平台比价性能测试性能测试并发搜索测试500并发响应时间5秒订单同步压力测试1000订单无异常MCP接口压测100 QPS成功率99%验收标准P0功能验收必须上线✅ 淘宝联盟接入 - 搜索/转链/订单同步正常返利计算准确✅ 京东联盟接入 - 搜索/转链/订单同步正常返利计算准确✅ 拼多多联盟接入 - 搜索/转链/订单同步正常返利计算准确✅ 多平台比价 - 并发查询3个平台5秒内返回结果✅ 返利比例配置 - 多维度配置生效优先级逻辑正确✅ 订单同步 - 5分钟内同步新订单归因成功率 95%✅ 返利结算 - 平台结算后24小时内入账金额精确到分✅ 提现功能 - 提现申请/审核/打款流程通畅✅ 数据看板 - 核心指标展示正确✅ 异常处理 - 单平台故障不影响其他平台文件修改计划README文档更新在README.md中新增CPS联盟返利系统章节包含CPS系统简介一站式多平台CPS返利查询与导购系统核心功能多平台CPS联盟接入淘宝/京东/拼多多商品搜索与比价会员返利体系提现管理MCP AI接口技术架构采用策略模式实现平台可扩展接口概览会员端13个接口管理端15个接口演示截图搜索页面、比价页面、返利页面、数据看板使用说明如何接入CPS平台、配置返利规则文档位置README.md新增CPS联盟返利系统章节docs/CPS系统需求文档.md详细功能需求docs/CPS系统PRD文档.md产品需求文档实施顺序Phase 1: 基础框架搭建第1周✅ 已完成创建 yudao-module-cps 模块结构定义数据库表结构实现CPS平台适配器接口搭建MCP Server基础框架Phase 2: 核心功能开发第2-3周✅ 已完成实现淘宝联盟适配器实现京东联盟适配器实现拼多多联盟适配器实现商品搜索与比价功能实现推广链接生成功能Phase 3: 订单与结算第4周✅ 已完成实现订单同步定时任务实现订单归因匹配实现返利计算引擎实现返利入账逻辑Phase 4: 会员与提现第5周✅ 已完成实现会员返利账户管理实现提现申请与审核实现钱包集成实现提现转账对接Phase 5: 数据统计第6周✅ 已完成实现运营数据看板实现平台统计实现会员统计实现收益报表Phase 6: MCP AI接口第7周✅ 已完成实现MCP Server实现5个MCP Tools实现3个MCP Resources实现2个MCP Prompts集成AI Agent测试Phase 7: 文档与优化第8周 进行中完善README文档编写接口文档性能优化单元测试备注本项目复用 ruoyi-vue-pro 现有模块无需重复造轮子采用策略模式实现平台适配器确保可扩展性MCP AI接口模块为P3优先级可后续迭代所有代码需遵循《阿里巴巴 Java 开发手册》规范核心逻辑必须包含单元测试
【AgenticCPS 】CPS联盟返利系统 - 实施计划
CPS联盟返利系统 - 实施计划背景说明为什么需要本项目CPSCost Per Sale按销售付费是电商联盟推广的核心模式。当前项目基于 ruoyi-vue-pro 框架需要新增一个完整的yudao-module-cps模块用于构建一站式多平台CPS返利查询与导购系统。该模块将aggregate淘宝联盟、京东联盟、拼多多联盟等主流CPS平台能力为会员提供返利查询、跨平台比价、推广链接生成和返利提现等服务。本项目要解决什么问题多平台聚合统一接入多个CPS平台提供一致的商品查询和返利查询能力会员返利体系基于现有会员等级体系支持差异化的返利比例配置多平台比价支持跨平台搜索比价帮助用户找到最优价格和最高返利订单全链路追踪实现从商品查询→链接生成→用户下单→佣金结算→返利入账的完整业务闭环MCP AI接口提供基于MCP协议的AI Agent接口层支持AI驱动的商品查询、比价、推荐等功能期望 outcomes完善的项目架构设计文档清晰的模块划分和依赖关系MCP AI接口的标准规范完善的README文档包含代码简介和功能介绍实施方案1. 模块划分与架构设计基于 ruoyi-vue-pro 的模块化设计新增yudao-module-cps模块yudao-module-cps/ ├── yudao-module-cps-api/ # CPS模块API定义供其他模块调用 │ ├── enums/ # 枚举定义平台编码、订单状态等 │ └── api/ # 远程服务接口 │ └── yudao-module-cps-biz/ # CPS模块业务实现 ├── controller/ │ ├── admin/ # 管理后台接口 │ │ ├── CpsPlatformController # 平台配置管理 │ │ ├── CpsAdzoneController # 推广位管理 │ │ ├── CpsOrderController # 订单管理 │ │ ├── CpsRebateConfigController # 返利配置管理 │ │ ├── CpsWithdrawController # 提现审核管理 │ │ └── CpsStatisticsController # 数据统计 │ │ │ └── app/ # C端会员接口 │ ├── AppCpsGoodsController # 商品搜索与比价 │ ├── AppCpsLinkController # 转链/口令生成 │ ├── AppCpsOrderController # 我的订单 │ ├── AppCpsRebateController # 我的返利 │ └── AppCpsWithdrawController # 提现 │ ├── service/ │ ├── platform/ # CPS平台适配层 │ │ ├── CpsPlatformClientFactory # 平台客户端工厂 │ │ └── CpsPlatformConfigService # 平台配置服务 │ ├── goods/ # 商品查询服务 │ │ ├── CpsGoodsSearchService # 搜索与比价 │ │ └── CpsGoodsParseService # 链接/口令解析 │ ├── link/ # 推广链接服务 │ │ └── CpsPromotionLinkService # 转链与归因 │ ├── order/ # 订单服务 │ │ ├── CpsOrderSyncService # 订单同步 │ │ └── CpsOrderService # 订单管理 │ ├── commission/ # 佣金结算服务 │ │ ├── CpsCommissionCalcService # 佣金计算 │ │ └── CpsRebateSettleService # 返利结算 │ ├── rebate/ # 返利配置服务 │ │ └── CpsRebateConfigService # 返利规则管理 │ └── withdraw/ # 提现服务 │ └── CpsWithdrawService # 提现管理 │ ├── client/ # CPS平台适配器策略模式 │ ├── CpsPlatformClient.java # 统一接口定义 │ ├── taobao/ # 淘宝联盟适配器 │ ├── jingdong/ # 京东联盟适配器 │ ├── pinduoduo/ # 拼多多联盟适配器 │ └── douyin/ # 抖音联盟适配器扩展 │ ├── dal/ │ ├── dataobject/ # 数据库实体 │ └── mysql/ # Mapper接口 ├── convert/ # DTO转换MapStruct ├── job/ # 定时任务 └── mcp/ # MCPModel Context ProtocolAI接口层 ├── server/ │ ├── CpsMcpServer.java # MCP Server主入口 │ └── CpsMcpServerConfig.java # MCP Server配置类 ├── transport/ │ ├── CpsMcpHttpTransport.java # Streamable HTTP传输层 │ └── CpsMcpStdioTransport.java # STDIO传输层 ├── tool/ # MCP Tools定义 │ ├── CpsSearchGoodsTool.java # 商品搜索工具 │ ├── CpsComparePricesTool.java # 多平台比价工具 │ └── ... ├── resource/ # MCP Resources定义 │ ├── CpsPlatformResource.java # 平台列表及状态 │ ├── CpsRebateRuleResource.java # 返利规则配置 │ └── ... └── prompt/ # MCP Prompts定义 ├── CpsFindBestDealPrompt.java # 找最优惠商品 ├── CpsComparePrompt.java # 跨平台比价 └── ...2. 与现有模块依赖关系yudao-module-cps-biz ├── 依赖 yudao-module-member # 复用会员体系用户、等级、积分 ├── 依赖 yudao-module-pay # 复用支付模块钱包、提现转账 ├── 依赖 yudao-module-system # 复用系统模块权限、字典、通知 └── 依赖 yudao-module-infra # 复用基础设施定时任务、文件存储3. 核心功能设计3.1 MCP AI接口模块P3优先级本模块基于MCPModel Context Protocol协议标准为CPS系统构建一套可供AI Agent直接调用的接口层。MCP三类原语原语说明在CPS系统中的作用ToolsAI可调用的可执行函数商品搜索、比价、转链、订单查询等操作ResourcesAI可读取的数据源只读平台配置、返利规则、会员画像、统计数据等Prompts预定义的交互模板找最优价、比价分析、省钱策略等场景化提示核心Tools定义cps_search_goods商品搜索参数keyword, platform_code, price_min, price_max, sort_type, member_id返回统一商品列表含 platformCode, title, price, finalPrice, estimateRebate 等字段cps_compare_prices多平台比价参数keyword, member_id返回跨平台比价表格推荐最优方案cps_generate_link推广链接生成参数itemId, platformCode, memberId返回推广链接/口令含归因参数cps_get_order_status订单状态查询参数memberId返回用户订单列表及返利进度cps_rebate_summary返利汇总参数memberId返回可提现余额、待结算金额、累计收入传输层支持传输方式适用场景端点说明Streamable HTTP远程AI Agent接入/mcp/cps支持SSE流式响应适合生产环境STDIO本地开发调试标准输入输出适合本地AI开发工具集成配置项application.yamlyudao:cps:mcp:enabled:true# 是否启用MCP Servertransport:http# 传输方式: http / stdiohttp:endpoint:/mcp/cps# HTTP端点路径sse-enabled:true# 是否启用SSE流式推送auth:enabled:true# 是否启用鉴权type:bearer# 鉴权方式: bearer / api-keyrate-limit:enabled:true# 是否启用限流max-requests-per-minute:60# 每分钟最大请求数4. 数据库设计核心表yudao_cps_platform # CPS平台配置表 yudao_cps_adzone # 推广位PID管理表 yudao_cps_order # CPS订单表 yudao_cps_rebate_config # 返利配置表 yudao_cps_rebate_record # 返利记录表 yudao_cps_withdraw # 提现申请表 yudao_cps_statistics # 统计数据表 yudao_cps_mcp_api_key # MCP API Key管理表 yudao_cps_mcp_access_log # MCP访问日志表5. 接口规范5.1 会员端接口约13个POST /app-api/cps/goods/search # 商品搜索 POST /app-api/cps/goods/compare # 多平台比价 GET /app-api/cps/goods/detail # 商品详情 GET /app-api/cps/goods/recommend # 商品推荐 POST /app-api/cps/link/generate # 生成推广链接 GET /app-api/cps/order/page # 我的订单列表 GET /app-api/cps/order/get # 订单详情 GET /app-api/cps/rebate/summary # 返利汇总 GET /app-api/cps/rebate/page # 返利明细 POST /app-api/cps/withdraw/create # 发起提现 GET /app-api/cps/withdraw/page # 提现记录 GET /app-api/cps/search/history # 搜索历史 GET /app-api/cps/search/hot # 热门搜索5.2 管理端接口约15个admin-api/cps/platform/* # 平台配置管理 admin-api/cps/adzone/* # 推广位管理 admin-api/cps/order/* # 订单管理 admin-api/cps/rebate-config/* # 返利配置 admin-api/cps/withdraw/* # 提现审核 admin-api/cps/statistics/* # 数据统计 admin-api/cps/mcp/* # MCP管理6. 技术要求6.1 性能要求指标要求单平台搜索 2秒P99多平台比价 5秒P99转链生成 1秒订单同步延迟 30分钟返利入账延迟平台结算后 24小时内6.2 数据安全CPS平台密钥 AES-256 加密存储会员数据隔离只能查看自己的数据敏感操作记录审计日志提现金额二次校验验证方式单元测试CPS平台适配器单元测试每个平台至少10个测试用例返利计算逻辑测试覆盖5种不同优先级场景订单同步与归因测试MCP Tools功能测试集成测试淘宝联盟全流程测试京东联盟全流程测试拼多多联盟全流程测试多平台比价性能测试性能测试并发搜索测试500并发响应时间5秒订单同步压力测试1000订单无异常MCP接口压测100 QPS成功率99%验收标准P0功能验收必须上线✅ 淘宝联盟接入 - 搜索/转链/订单同步正常返利计算准确✅ 京东联盟接入 - 搜索/转链/订单同步正常返利计算准确✅ 拼多多联盟接入 - 搜索/转链/订单同步正常返利计算准确✅ 多平台比价 - 并发查询3个平台5秒内返回结果✅ 返利比例配置 - 多维度配置生效优先级逻辑正确✅ 订单同步 - 5分钟内同步新订单归因成功率 95%✅ 返利结算 - 平台结算后24小时内入账金额精确到分✅ 提现功能 - 提现申请/审核/打款流程通畅✅ 数据看板 - 核心指标展示正确✅ 异常处理 - 单平台故障不影响其他平台文件修改计划README文档更新在README.md中新增CPS联盟返利系统章节包含CPS系统简介一站式多平台CPS返利查询与导购系统核心功能多平台CPS联盟接入淘宝/京东/拼多多商品搜索与比价会员返利体系提现管理MCP AI接口技术架构采用策略模式实现平台可扩展接口概览会员端13个接口管理端15个接口演示截图搜索页面、比价页面、返利页面、数据看板使用说明如何接入CPS平台、配置返利规则文档位置README.md新增CPS联盟返利系统章节docs/CPS系统需求文档.md详细功能需求docs/CPS系统PRD文档.md产品需求文档实施顺序Phase 1: 基础框架搭建第1周✅ 已完成创建 yudao-module-cps 模块结构定义数据库表结构实现CPS平台适配器接口搭建MCP Server基础框架Phase 2: 核心功能开发第2-3周✅ 已完成实现淘宝联盟适配器实现京东联盟适配器实现拼多多联盟适配器实现商品搜索与比价功能实现推广链接生成功能Phase 3: 订单与结算第4周✅ 已完成实现订单同步定时任务实现订单归因匹配实现返利计算引擎实现返利入账逻辑Phase 4: 会员与提现第5周✅ 已完成实现会员返利账户管理实现提现申请与审核实现钱包集成实现提现转账对接Phase 5: 数据统计第6周✅ 已完成实现运营数据看板实现平台统计实现会员统计实现收益报表Phase 6: MCP AI接口第7周✅ 已完成实现MCP Server实现5个MCP Tools实现3个MCP Resources实现2个MCP Prompts集成AI Agent测试Phase 7: 文档与优化第8周 进行中完善README文档编写接口文档性能优化单元测试备注本项目复用 ruoyi-vue-pro 现有模块无需重复造轮子采用策略模式实现平台适配器确保可扩展性MCP AI接口模块为P3优先级可后续迭代所有代码需遵循《阿里巴巴 Java 开发手册》规范核心逻辑必须包含单元测试
