【AgenticCPS】AgenticCPS- 企业级智能 CPS 联盟返利与导购平台

🐯 平台简介

AgenticCPS是一款企业级智能 CPS 联盟返利与导购平台，深度融合AI 自主编程、多平台 CPS 联盟接入与智能返利决策三大核心能力。平台以"多平台商品聚合 + 智能比价决策 + 返利自动结算 + AI 驱动运营 + 自主编程扩展"为核心理念，提供一站式 CPS 返利查询、跨平台智能比价、AI 驱动商品推荐、返利自动结算、MCP 自主编程接口等核心能力，打造可搜索、可比价、可追踪、可决策、可自主扩展的新一代 CPS 智能返利解决方案。

gitee: AgenticCPS

gitcode: AgenticCPS

github: AgenticCPS

有任何问题，或者想要的功能，可以在Issues中提给我们。

😜 给项目点点 Star 吧，这对我们真的很重要！

• Java 后端：master分支为 JDK 8 + Spring Boot 2.7，master-jdk17分支为 JDK 17/21 + Spring Boot 3.2
• 管理后台的电脑端：Vue3 提供element-plus、vben(ant-design-vue)两个版本，Vue2 提供element-ui版本
• 管理后台的移动端：采用uni-app方案，一份代码多终端适配，同时支持 APP、小程序、H5！
• 后端采用 Spring Boot 多模块架构、MySQL + MyBatis Plus、Redis + Redisson
• 数据库可使用 MySQL、Oracle、PostgreSQL、SQL Server、MariaDB、国产达梦 DM、TiDB 等
• 消息队列可使用 Event、Redis、RabbitMQ、Kafka、RocketMQ 等
• 权限认证使用 Spring Security & Token & Redis，支持多终端、多种用户的认证系统，支持 SSO 单点登录
• 支持加载动态权限菜单，按钮级别权限控制，Redis 缓存提升性能
• 支持 SaaS 多租户，可自定义每个租户的权限，提供透明化的多租户底层封装
• 工作流使用 Flowable，支持动态表单、在线设计流程、会签 / 或签、多种任务分配方式
• 高效率开发，使用代码生成器可以一键生成 Java、Vue 前后端代码、SQL 脚本、接口文档，支持单表、树表、主子表
• 实时通信，采用 Spring WebSocket 实现，内置 Token 身份校验，支持 WebSocket 集群
• 集成微信小程序、微信公众号、企业微信、钉钉等三方登陆，集成支付宝、微信等支付与退款
• 集成阿里云、腾讯云等短信渠道，集成 MinIO、阿里云、腾讯云、七牛云等云存储服务
• 集成报表设计器、大屏设计器，通过拖拽即可生成酷炫的报表与大屏

😎 开源协议

为什么推荐使用本项目？

① 本项目采用比 Apache 2.0 更宽松的 MIT License 开源协议，个人与企业可 100% 免费使用，不用保留类作者、Copyright 信息。

③ 代码整洁、架构整洁，遵循《阿里巴巴 Java 开发手册》规范，代码注释详细，113770 行 Java 代码，42462 行代码注释。

Qoder 自主编码

平台集成Qoder AI 编码助手，实现 AI 驱动的自主开发能力：

基于 Specs/Plans 的规范化 AI 编程

平台创新性地引入规范化 AI 编程工作流，通过.qoder目录下的规范文件实现高质量自主编码：

标准化 AI 编程流程

1. 需求对齐阶段

   • AI 自动读取 Specs 规范，理解技术栈、编码标准、架构模式
   • AI 解析 Plans 计划，明确需求范围、功能边界、验收标准
   • 生成实施方案，与用户确认后再执行

2. 方案设计阶段

   • AI 根据规范自动设计技术方案（类图、流程图、数据模型）
   • 生成详细的实施计划（任务分解、依赖关系、优先级）
   • 输出验收标准（功能测试、性能指标、代码质量要求）

3. 自主编码阶段

   • 无手写代码：AI 根据方案自主生成完整代码
   • 纯 AI 编程：从业务逻辑到单元测试，全部由 AI 生成
   • 规范遵循：自动遵循 Specs 定义的编码规范和架构约束
   • 质量保障：自动生成单元测试、集成测试、性能测试

4. 验收交付阶段

   • AI 自动执行测试用例，验证功能是否符合 Plans 中的验收标准
   • 生成验收报告（测试覆盖率、性能指标、代码质量评分）
   • 输出完整文档（API 文档、使用说明、部署指南）

核心优势

CPS联盟返利系统

CPS联盟返利系统是基于 ruoyi-vue-pro 框架构建的一站式多平台CPS返利查询与导购系统，为消费者提供返利查询、跨平台比价、推广链接生成和返利提现等服务。

核心功能

技术架构

yudao-module-cps/ ├── yudao-module-cps-api/ # CPS模块API定义 │ ├── enums/ # 枚举定义（平台编码、订单状态等） │ └── api/ # 远程服务接口 │ └── yudao-module-cps-biz/ # CPS模块业务实现 ├── controller/ │ ├── admin/ # 管理后台接口（平台管理、订单、返利、提现、统计、MCP） │ └── app/ # C端会员接口（商品、比价、转链、订单、返利、提现） │ ├── service/ │ ├── platform/ # CPS平台适配层（策略模式，支持快速扩展） │ ├── goods/ # 商品查询服务（搜索、比价、解析） │ ├── link/ # 推广链接服务（转链、归因） │ ├── order/ # 订单服务（同步、归因、管理） │ ├── commission/ # 佣金结算服务（计算、返利、结算） │ ├── rebate/ # 返利配置服务（规则管理） │ └── withdraw/ # 提现服务（申请、审核、转账） │ ├── client/ # CPS平台适配器（策略模式） │ ├── CpsPlatformClient.java # 统一接口定义 │ ├── taobao/ # 淘宝联盟适配器 │ ├── jingdong/ # 京东联盟适配器 │ ├── pinduoduo/ # 拼多多联盟适配器 │ └── douyin/ # 抖音联盟适配器（扩展） │ ├── dal/ │ ├── dataobject/ # 数据库实体（9张业务表） │ └── mysql/ # Mapper接口 ├── convert/ # DTO转换（MapStruct） ├── job/ # 定时任务（订单同步、状态更新） └── mcp/ # MCP（Model Context Protocol）AI接口层 ├── server/ # MCP Server主入口与配置 ├── transport/ # 传输层（HTTP/STDIO） ├── tool/ # MCP Tools（商品搜索/比价/转链/订单/返利） ├── resource/ # MCP Resources（平台/规则/画像/统计/热词） └── prompt/ # MCP Prompts（找最优价/比价分析/省钱策略）

接口概览

会员端接口（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 # 热门搜索

管理端接口（15个）：

POST/PUT/DELETE/GET /admin-api/cps/platform/* # 平台配置管理 POST/PUT/DELETE/GET /admin-api/cps/adzone/* # 推广位管理 POST/PUT/GET /admin-api/cps/platform/test # 平台连通测试 GET/POST /admin-api/cps/order/* # 订单管理（查询/同步/绑定） POST/PUT/DELETE/GET /admin-api/cps/rebate-config/* # 返利配置（等级/个人） GET /admin-api/cps/rebate-record/page # 返利记录查询 POST/PUT/GET /admin-api/cps/withdraw/* # 提现审核（列表/通过/驳回） GET /admin-api/cps/statistics/dashboard # 运营数据看板 GET /admin-api/cps/statistics/platform # 平台统计 GET /admin-api/cps/statistics/trend # 趋势统计 GET/POST /admin-api/cps/mcp/api-key/* # MCP API Key管理 GET /admin-api/cps/mcp/access-log # MCP访问日志 GET /admin-api/cps/mcp/statistics # MCP统计分析

MCP AI 接口

本模块基于MCP（Model Context Protocol）协议标准，为 CPS 系统构建一套可供 AI Agent 直接调用的接口层。

核心 Tools：

传输层支持：

数据库表

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访问日志表

性能要求

使用说明

1. 接入CPS平台

   • 在管理后台配置平台AppKey、AppSecret、API地址
   • 配置推广位（PID）
   • 测试平台连通性

2. 配置返利规则

   • 设置会员等级返利比例
   • 为特定会员设置个人专属返利
   • 配置返利展示规则

3. 配置提现规则

   • 设置最低/最高提现金额
   • 设置每日提现次数
   • 设置审核方式（自动/人工）

4. 配置MCP AI接口

   • 启用MCP Server
   • 创建API Key（配置权限级别）
   • 配置限流规则

技术依赖

复用现有模块：

• yudao-module-member- 复用会员体系（用户、等级、积分）
• yudao-module-pay- 复用支付模块（钱包、提现转账）
• yudao-module-system- 复用系统模块（权限、字典、通知）
• yudao-module-infra- 复用基础设施（定时任务、文件存储）

技术栈：

• 后端：Spring Boot 3.x + MyBatis Plus
• 数据库：MySQL 8.0+
• 缓存：Redis 6.0+
• 定时任务：yudao-spring-boot-starter-job
• MCP协议：基于JSON-RPC 2.0

项目进展

• ✅ Phase 1: 基础框架搭建（已完成）
• ✅ Phase 2: 核心功能开发（已完成）
• ✅ Phase 3: 订单与结算（已完成）
• ✅ Phase 4: 会员与提现（已完成）
• ✅ Phase 5: 数据统计（已完成）
• ✅ Phase 6: MCP AI接口（已完成）
• 🚀 Phase 7: 文档与优化（进行中）

系统功能

支付系统

基础设施

数据报表

微信公众号

商城系统

演示地址：https://doc.iocoder.cn/mall-preview/

会员中心

AI 大模型

演示地址：https://doc.iocoder.cn/ai-preview/

🐨 技术栈

模块

框架

开源协议

本项目采用GNU Affero General Public License v3.0 (AGPL-3.0)开源协议。

协议要点

使用场景说明

• ✅允许：个人学习、研究、商业二次开发（需开源）
• ✅允许：内部企业使用（无需开源，除非对外提供服务）
• ⚠️需开源：基于本项目提供 SaaS 服务或对外网络服务
• ❌禁止：闭源商业化分发、移除版权声明

完整协议文本

详见 LICENSE 文件或访问 GNU AGPL-3.0 官方协议文本

💝 赞助与支持

开源项目的发展离不开社区的支持。如果您觉得本项目对您有帮助，欢迎赞助支持持续开发！

为什么需要赞助？

赞助方式

微信支付 / 支付宝

💡 请在备注中留下您的 GitHub ID 或联系方式，我们将列在赞助者名单中（如愿意公开）

企业赞助

欢迎企业用户进行商业赞助，我们将提供以下回报：

🎁 功能悬赏

为了加速项目功能开发，我们推出功能悬赏计划。您可以悬赏特定功能的开发，开发者完成后可获得赏金。

当前悬赏列表

悬赏规则

1. 认领任务：在 Issue 中评论认领，确认后开始开发
2. 开发周期：根据功能复杂度协商，一般 2-4 周
3. 代码审核：提交 PR 后进行代码审核，通过后合并
4. 发放赏金：合并后 3 个工作日内发放至指定账户

如何发起悬赏？

如果您需要特定功能但不在列表中，可以：

1. 在 Issues 中创建功能请求，标注💰 悬赏标签
2. 说明功能需求和悬赏金额
3. 等待开发者认领或我们评估后添加到悬赏列表

🙏 感谢所有赞助者

感谢以下赞助者的慷慨支持（按时间排序）：

成为第一个赞助者，让开源走得更远！