# 闪聚支付

**Repository Path**: itxinfei/shanjupay

## Basic Information

- **Project Name**: 闪聚支付
- **Description**: 闪聚支付是以Spring Cloud Alibaba技术栈开发的聚合支付平台，它将目前主流的第三方支付进行整合，形成第三方支付的聚合通道。为线上商户提供聚合收银，为线下商户提供C2B一码多付、B2C商家扫码功能，并以SaaS服务形式提供给各商户订单管理等基础服务。闪聚支付是一个提供聚合支付的平台，聚合支付目前主要的做法就是线上聚合收银台(开放API)，线下C2B一码多付、线下B2C商家扫码。平台应以SaaS服务形式提供给各商户订单管理、门店管理、财务数据统计等基础服务，闪聚支付还以支付为入口，通过广告、营销、金融等服务，构建一个移动支付的全生态系统。平台主要包括三个模块，官网&开放平台、商户平台、运营平台。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: http://shanjupay-admin-java.itheima.net/#/operationLogin
- **GVP Project**: No

## Statistics

- **Stars**: 161
- **Forks**: 189
- **Created**: 2020-07-01
- **Last Updated**: 2025-10-16

## Categories & Tags

**Categories**: payment-dev

**Tags**: None

## README

<div align="center">  
  <h1 style="font-size: 36px;">🚀 闪聚支付</h1>  
  <p><strong>聚合支付平台 | 提供线上收银台、线下扫码支付、SaaS服务及全生态金融解决方案</strong></p>  

  <!-- 技术栈分组徽章 -->  
  <p align="center">  
  <img alt="JDK" src="https://img.shields.io/badge/JDK-1.8%2B-brightgreen">
  <img alt="Maven" src="https://img.shields.io/badge/Maven-3.x%2B-yellowgreen">
  <img alt="Spring Boot" src="https://img.shields.io/badge/Spring%20Boot-2.1.3.RELEASE-blueviolet">
  <img alt="Spring Cloud" src="https://img.shields.io/badge/Spring%20Cloud-Greenwich.RELEASE-orange">
  <img alt="MyBatis Plus" src="https://img.shields.io/badge/MyBatis%20Plus-3.1.0-green">
  <img alt="MySQL" src="https://img.shields.io/badge/MySQL-8.0.11-red">
  <img alt="Druid" src="https://img.shields.io/badge/Druid-1.1.16-lightgrey">
  <img alt="Lombok" src="https://img.shields.io/badge/Lombok-1.18.0-yellow">
  <img alt="Swagger" src="https://img.shields.io/badge/Swagger-2.9.2-blue">
  <img alt="JWT" src="https://img.shields.io/badge/JWT-1.0.9.RELEASE-purple">
  <img alt="OAuth2" src="https://img.shields.io/badge/OAuth2-2.1.3.RELEASE-teal">
  <img alt="MapStruct" src="https://img.shields.io/badge/MapStruct-1.3.0.Final-yellowgreen">
  <img alt="Fastjson" src="https://img.shields.io/badge/Fastjson-1.2.47-orange">
  <img alt="Gson" src="https://img.shields.io/badge/Gson-2.8.2-blue">
  <img alt="Guava" src="https://img.shields.io/badge/Guava-25.0--jre-lightblue">
  <img alt="Commons Lang" src="https://img.shields.io/badge/Commons%20Lang-2.6-brown">
  <img alt="ShardingSphere" src="https://img.shields.io/badge/ShardingSphere-4.0.0--RC1-blue">
  <img alt="Alipay SDK" src="https://img.shields.io/badge/Alipay%20SDK-3.7.73.ALL-green">
  <img alt="WeChat Pay SDK" src="https://img.shields.io/badge/WeChat%20Pay%20SDK-3.4.0-purple">
  <img alt="Qiniu SDK" src="https://img.shields.io/badge/Qiniu%20SDK-7.2.25-yellow">
  <img alt="RocketMQ" src="https://img.shields.io/badge/RocketMQ-2.0.2-orange">
  <img alt="OkHttp" src="https://img.shields.io/badge/OkHttp-3.9.1-red">
  <img alt="Redis" src="https://img.shields.io/badge/Redis-2.1.3.RELEASE-green">
  <img alt="前端" src="https://img.shields.io/badge/前端-Vue%20+%20React%20+%20Weex-blueviolet">  
</div>  

## 📌 项目简介  
**闪聚支付** 是基于 **Spring Cloud Alibaba** 技术栈开发的聚合支付平台，为商户提供一站式支付解决方案。  
**核心功能**：  
✅ **线上聚合收银台**：整合支付宝、微信等第三方支付渠道，提供统一API接入  
✅ **线下C2B/B2C支付**：支持一码多付、商家扫码等场景  
✅ **SaaS服务**：订单管理、门店管理、财务统计等基础服务  
✅ **生态扩展**：集成广告、营销、金融服务，构建移动支付全生态  

## 🌐 演示地址  
- **后台管理**：[运营平台](http://shanjupay-admin-java.itheima.net/#/operationLogin)  
- **商户平台**：[商户登录](http://shanjupay-main-java.itheima.net/#/login?redirect=%2F)  


### 🎯 核心价值  
- **高可用性**：微服务架构支持水平扩展与熔断容错  
- **灵活集成**：开放API适配不同行业商户需求  
- **数据驱动**：实时交易监控与多维度报表分析  

---

## 🧩 用户端口  
| 端口类型       | 功能描述                                                                 | 技术实现                  |  
|----------------|--------------------------------------------------------------------------|---------------------------|  
| **运营平台**   | 商户审核、权限配置、数据监控                                              | Vue + Spring Boot Admin   |  
| **商户平台**   | 订单管理、门店设置、支付配置                                                | React + Ant Design        |  
| **用户端App**  | 支付、账单查询、优惠券使用                                                  | Weex + WebSocket实时通知  |  

---

## 📐 软件架构  
### 技术栈全景  
| 层级         | 技术选型                                                                 |  
|--------------|--------------------------------------------------------------------------|  
| **前端**     | Vue + React + Weex + ECharts                                           |  
| **网关层**   | Spring Cloud Gateway + Sentinel                                         |  
| **服务层**   | Spring Boot 2.7 + Dubbo 3.0 + MyBatis Plus                              |  
| **消息队列** | RocketMQ 4.9                                                            |  
| **数据层**   | MySQL 8.0 + Redis 6.2 + Sharding-JDBC                                  |  
| **中间件**   | Nacos 2.1 + XXL-JOB                                                     |  
| **监控**     | Prometheus + Grafana + SkyWalking                                       |  

### 微服务架构详解  
![项目功能架构图](docs/项目功能架构.png)  
**服务划分**：  
1. **用户中心**：商户注册、权限管理（RBAC模型）  
2. **交易服务**：支付订单生成、状态同步、对账处理  
3. **网关服务**：API路由、限流熔断、安全校验  
4. **配置中心**：Nacos动态配置管理  
5. **日志服务**：统一日志采集与异常监控  

---

## 🧱 数据库设计  
| 数据库名              | 数据量级     | 核心表设计                                                                 |  
|-----------------------|--------------|----------------------------------------------------------------------------|  
| `shanjupay_merchant_service` | 500万+       | 商户表（含资质审核、结算周期、费率配置）                                    |  
| `shanjupay_transaction`      | 1亿+         | 订单表（按时间分表，Sharding-JDBC实现）                                     |  

---

## 📁 项目结构  
### 核心模块说明  
#### 1. **商户平台应用** (`shanjupay-merchant-application`)  
- 前端界面：React实现商户后台管理  
- 接口调用：通过OpenFeign消费商户服务API  

#### 2. **商户服务API** (`shanjupay-merchant-api`)  
- 定义接口：`MerchantService`、`StoreService`  
- 依赖项：Swagger生成API文档，MyBatis Plus简化DAO操作  

#### 3. **商户服务实现** (`shanjupay-merchant-service`)  
- 核心逻辑：商户注册审核、门店管理、权限分配  
- 数据缓存：Redis存储商户配置（如支付渠道、费率）  

---

## 📊 整体业务流程  
1. **商户入驻**：提交资质 → 审核通过 → 分配API密钥  
2. **支付流程**：调用聚合收银台 → 选择支付方式 → 异步回调通知  
3. **对账机制**：每日定时任务对比三方支付与本地订单数据  
4. **分润计算**：基于交易金额与费率自动结算佣金  

---

## 📦 部署与依赖  
### 快速部署指南  
```bash
# 1. 安装依赖中间件
docker-compose up -d

# 2. 初始化数据库
mysql -u root -p shanjupay_merchant < sql/init_merchant.sql

# 3. 启动微服务
mvn clean install && java -jar shanjupay-gateway.jar
```

---

## 📱 联系方式  
🚀 项目地址：[https://gitee.com/itxinfei](https://gitee.com/itxinfei)  
👥 QQ交流群：[661543188](https://qm.qq.com/cgi-bin/qm/qr?k=5iR4ej_YaZqZqCIRXwtN_-uF1JzBgw6v&jump_from=webapi)  
📧 邮箱支持：[747011882@qq.com](http://mail.qq.com/cgi-bin/qm_share?t=qm_mailme&email=f0hLSE9OTkdHTT8ODlEcEBI)  
📱 微信公众号： 

![心飞为你飞公众号二维码](docs/心飞为你飞.jpg?width=200)