# MultiPay Admin 

**Repository Path**: CodingKeep/MultiPay-Admin

## Basic Information

- **Project Name**: MultiPay Admin 
- **Description**: 一个基于 Spring Boot 3.0.5 + Vue 3 + Naive UI 的多商户支付系统后台管理平台，支持微信支付和支付宝扫码支付。
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-30
- **Last Updated**: 2026-02-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="https://img.shields.io/badge/Spring%20Boot-3.0.5-brightgreen" alt="Spring Boot">
  <img src="https://img.shields.io/badge/Vue-3.4-blue" alt="Vue">
  <img src="https://img.shields.io/badge/Naive%20UI-2.37-purple" alt="Naive UI">
  <img src="https://img.shields.io/badge/微信小程序-原生-07C160" alt="微信小程序">
  <img src="https://img.shields.io/badge/UniApp-Vue3-2B9939" alt="UniApp">
  <img src="https://img.shields.io/badge/uView--Plus-3.2-red" alt="uView-Plus">
  <img src="https://img.shields.io/badge/MyBatis--Plus-3.5.3-orange" alt="MyBatis-Plus">
  <img src="https://img.shields.io/badge/Redis-7.0-red" alt="Redis">
  <img src="https://img.shields.io/badge/License-MIT-yellow" alt="License">
</p>

<h1 align="center">多商户支付系统</h1>

<p align="center">
  <b>企业级多商户聚合支付后台管理系统</b><br>
  <b>微信支付 & 支付宝 | 微信小程序商城 | 多端跨平台 | 多租户SaaS | 分布式部署</b>
</p>

---

## 功能特性

**后台管理：** 认证授权 · 控制台 · 商户管理 · 支付配置 · 订单管理 · 退款管理 · 结算管理 · 对账管理 · 数据统计

**微信小程序（原生版 + UniApp 跨端版）：** 首页轮播 · 商品搜索 · 商品详情 · 我的订单 · 退换售后 · 收货地址 · 优惠券 · 我的收藏 · 浏览记录 · 个人中心 · 意见反馈 · 帮助中心

**企业级功能：** 操作日志 · AES 数据加密 · 接口限流 · 多租户隔离 · 分布式锁 · 系统监控 · 告警管理（钉钉/企微/飞书 Webhook） · RBAC 权限 · 邮件通知 · 短信服务 · API 文档

**支付能力：** 微信 Native 扫码支付 · 微信小程序支付 · 支付宝当面付 · 支付回调 · 退款回调 · 在线退款

---

## 技术栈

| 层 | 技术 |
|------|------|
| **后端** | Spring Boot 3.0 · Spring Security · MyBatis-Plus · MySQL · Redis · Redisson · JWT |
| **前端** | Vue 3.4 · Vite · Naive UI · Pinia · ECharts |
| **小程序** | 原生小程序 / UniApp + Vue3 + uView-Plus 3.2 |
| **支付** | 微信支付 SDK · 支付宝 SDK |
| **监控** | Actuator · Prometheus · SpringDoc OpenAPI |

---

## 项目截图

### 管理后台

| 登录页面 | 控制台首页 |
|:---:|:---:|
| ![登录页面](docs/images/login.png) | ![控制台](docs/images/dashboard.png) |

| 商户管理 | 订单管理 |
|:---:|:---:|
| ![商户管理](docs/images/merchant.png) | ![订单管理](docs/images/order.png) |

| 支付配置 | 数据统计 |
|:---:|:---:|
| ![支付配置](docs/images/pay-config.png) | ![数据统计](docs/images/statistics.png) |

| 租户管理 | 系统监控 |
|:---:|:---:|
| ![租户管理](docs/images/tenant.png) | ![系统监控](docs/images/monitor.png) |

### 微信小程序

| 首页 | 商品详情 | 个人中心 | 我的订单 |
|:---:|:---:|:---:|:---:|
| ![首页](docs/images/mini-home.png) | ![商品详情](docs/images/mini-detail.png) | ![个人中心](docs/images/mini-user.png) | ![我的订单](docs/images/mini-order.png) |

| 商品搜索 | 退换售后 | 收货地址 | 优惠券 |
|:---:|:---:|:---:|:---:|
| ![商品搜索](docs/images/mini-search.png) | ![退换售后](docs/images/mini-aftersale.png) | ![收货地址](docs/images/mini-address.png) | ![优惠券](docs/images/mini-coupon.png) |

> 将截图放入 `docs/images/` 目录即可显示

---

## 快速开始

### 环境要求

JDK 17+ · Node.js 18+ · MySQL 8.0+ · Redis 7.0+（可选）· Maven 3.8+

### 1. 克隆 & 初始化数据库

```bash
git clone https://gitee.com/zhongshichaosss/MultiPay-Admin.git
cd MultiPay-Admin
mysql -u root -p < backend/src/main/resources/db/init.sql
```

### 2. 修改配置

```yaml
# backend/src/main/resources/application.yml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/multi_merchant_payment
    username: root
    password: your_password

spring.data.redis:
  host: localhost
  port: 6379
  password: your_redis_password

# 微信小程序（可选）
wechat:
  miniapp:
    appid: your_appid
    secret: your_secret
    mchid: your_mchid
    apikey: your_apikey
    notify-url: https://your-domain.com/api/miniapp/pay/notify
```

### 3. 启动

```bash
# 后端
cd backend && mvn spring-boot:run

# 前端
cd frontend && npm install && npm run dev
```

### 4. 访问

| 地址 | 说明 |
|------|------|
| http://localhost:3000 | 前端 |
| http://localhost:8080/api/swagger-ui.html | API 文档 |

**默认账号：** `admin` / `123456`

---

## 微信小程序

### 原生版

导入 `miniapp/` 到微信开发者工具，修改 `app.js` 中的 `baseUrl`。

### UniApp 跨端版

```bash
cd uniapp && npm install && npm run dev:mp-weixin
```

导入 `uniapp/dist/dev/mp-weixin` 到微信开发者工具。

修改后端地址：`uniapp/src/utils/request.js` 中的 `BASE_URL`

支持发布到：微信 · 支付宝 · 抖音 · H5 · App

---

## 支付接入

### 微信支付

1. [微信商户平台](https://pay.weixin.qq.com/) 获取 AppID、商户号、APIv3 密钥、证书
2. 后台「支付配置」填入参数
3. 回调地址：`https://your-domain.com/api/pay/notify/wechat/{merchantId}`

### 支付宝

1. [支付宝开放平台](https://open.alipay.com/) 签约「当面付」，获取 AppID、私钥、公钥
2. 后台「支付配置」填入参数
3. 回调地址：`https://your-domain.com/api/pay/notify/alipay/{merchantId}`

---

## 项目结构

```
MultiPay-Admin/
├── backend/          # Spring Boot 后端
│   ├── controller/   # 控制器（支付、商户、订单、小程序等）
│   ├── service/      # 业务逻辑（微信支付、支付宝、告警Webhook、短信等）
│   ├── entity/       # 实体类（含小程序用户/订单/地址）
│   ├── mapper/       # MyBatis Mapper
│   ├── config/       # 配置（安全、Redis、多租户）
│   └── resources/db/ # 数据库脚本
├── frontend/         # Vue3 管理后台
├── miniapp/          # 微信小程序（原生版）
├── uniapp/           # 微信小程序（UniApp 跨端版）
└── docs/images/      # 项目截图
```

---

## API 接口

启动后访问 http://localhost:8080/api/swagger-ui.html 查看完整文档。

| 接口 | 说明 |
|------|------|
| `POST /api/pay/create` | 创建支付订单 |
| `GET /api/pay/status/{orderNo}` | 查询订单状态 |
| `POST /api/refund` | 发起退款 |
| `POST /api/miniapp/login` | 小程序登录 |
| `POST /api/miniapp/pay/create` | 小程序支付 |
| `GET /api/miniapp/order/list` | 小程序订单列表 |
| `GET /api/miniapp/order/counts` | 订单数量统计 |
| `POST /api/miniapp/user/save` | 保存用户信息 |
| `POST /api/miniapp/address/save` | 保存收货地址 |

<details>
<summary>查看全部接口</summary>

**认证** `POST /api/auth/login` · `/logout` · `GET /info`
**商户** `GET /api/merchant/list` · `POST` · `PUT /{id}` · `DELETE /{id}`
**订单** `GET /api/order/list` · `/{id}`
**结算** `GET /api/settlement/list` · `POST /generate` · `/{id}/audit` · `/{id}/payment`
**对账** `GET /api/reconciliation/list` · `POST /start`
**统计** `GET /api/statistics/dashboard` · `/date-range` · `/pay-type`
**监控** `GET /api/monitor/system` · `/dashboard`
**租户** `GET /api/tenant/list` · `POST` · `PUT /{id}`
**告警** `GET /api/alert/rule/list` · `POST /rule` · `GET /record/list`

</details>

---

## SaaS 多租户

系统通过 `tenant_id` + MyBatis-Plus 拦截器实现数据隔离。

| 角色 | 权限 |
|-----|------|
| 超级管理员 | 租户管理、系统配置、监控告警 |
| 租户管理员 | 商户管理、支付配置、订单退款 |
| 普通管理员 | 按分配权限操作 |

安全特性：数据隔离 · AES 加密 · 操作审计 · 接口限流 · 自动备份

---

## 开源协议

[MIT License](LICENSE) - 可免费商用

## 致谢

[Spring Boot](https://spring.io/projects/spring-boot) · [Vue.js](https://vuejs.org/) · [Naive UI](https://www.naiveui.com/) · [UniApp](https://uniapp.dcloud.net.cn/) · [uView-Plus](https://uiadmin.net/uview-plus/) · [MyBatis-Plus](https://baomidou.com/) · [微信支付 SDK](https://github.com/wechatpay-apiv3/wechatpay-java) · [支付宝 SDK](https://github.com/alipay/alipay-sdk-java-all)

## 联系方式

邮箱：3142277367@qq.com · 微信：Keep4212

---

<p align="center">
  <b>Made with ❤️ by 程序员⑩</b><br>
  如果觉得项目不错，请给个 ⭐ Star 鼓励一下！
</p>