285 lines
6.2 KiB
Markdown
285 lines
6.2 KiB
Markdown
|
# 积分充值系统 - 快速启动
|
|||
|
|
|
|||
|
|
## 🚀 5分钟快速上手
|
|||
|
|
|
|||
|
|
### 1️⃣ 执行数据库迁移
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
mysql -u root -p 1818ai < V6__add_points_recharge_system.sql
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**验证**：
|
|||
|
|
```sql
|
|||
|
|
-- 检查套餐数据
|
|||
|
|
SELECT name, points, bonus_points, total_points, price FROM points_package;
|
|||
|
|
-- 应该看到6个套餐
|
|||
|
|
|
|||
|
|
-- 检查order表新字段
|
|||
|
|
DESC `order`;
|
|||
|
|
-- 应该包含 order_type, points_package_id, points_amount
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2️⃣ 启动应用
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
mvn spring-boot:run
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
或者
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
mvn clean package
|
|||
|
|
java -jar target/1818_user_server-0.0.1-SNAPSHOT.jar
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3️⃣ 测试接口
|
|||
|
|
|
|||
|
|
#### 步骤1：获取套餐列表（无需登录）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
curl -X GET "http://localhost:8080/user/points/packages"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**预期响应**：
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": [
|
|||
|
|
{
|
|||
|
|
"id": 1,
|
|||
|
|
"name": "体验包",
|
|||
|
|
"points": 100,
|
|||
|
|
"price": 10.00,
|
|||
|
|
...
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
#### 步骤2：用户登录获取Token
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
curl -X POST "http://localhost:8080/user/auth/login" \
|
|||
|
|
-H "Content-Type: application/json" \
|
|||
|
|
-d '{"phone":"13800138000","password":"123456"}'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**获取token**：
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
#### 步骤3：创建充值订单（需要登录）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
curl -X POST "http://localhost:8080/user/points/recharge" \
|
|||
|
|
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
|
|||
|
|
-H "Content-Type: application/json" \
|
|||
|
|
-d '{"packageId":2,"paymentMethod":2}'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**预期响应**：
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"orderNo": "ORD20251021123456",
|
|||
|
|
"amount": 48.00,
|
|||
|
|
"pointsAmount": 605,
|
|||
|
|
"paymentMethod": 2
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**注意**：
|
|||
|
|
- `pointsAmount` 可能是 605（500基础+50赠送+55首充奖励）
|
|||
|
|
- 如果是首次充值，会有10%的额外奖励
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
#### 步骤4：模拟支付成功（测试用）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
curl -X POST "http://localhost:8080/payment/callback/test?orderNo=ORD20251021123456"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**预期响应**：`success`
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
#### 步骤5：查看用户积分
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
curl -X GET "http://localhost:8080/user/info" \
|
|||
|
|
-H "Authorization: Bearer YOUR_TOKEN_HERE"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**验证积分是否到账**：
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 200,
|
|||
|
|
"data": {
|
|||
|
|
"points": 605,
|
|||
|
|
"pointsExpiresAt": "2026-10-21T12:35:10"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
#### 步骤6：查看充值记录
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
curl -X GET "http://localhost:8080/user/points/recharge/records?page=1&size=10" \
|
|||
|
|
-H "Authorization: Bearer YOUR_TOKEN_HERE"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📝 前端快速集成
|
|||
|
|
|
|||
|
|
### HTML示例
|
|||
|
|
|
|||
|
|
```html
|
|||
|
|
<!DOCTYPE html>
|
|||
|
|
<html>
|
|||
|
|
<head>
|
|||
|
|
<title>积分充值</title>
|
|||
|
|
</head>
|
|||
|
|
<body>
|
|||
|
|
<h1>积分充值</h1>
|
|||
|
|
|
|||
|
|
<!-- 套餐列表 -->
|
|||
|
|
<div id="packages"></div>
|
|||
|
|
|
|||
|
|
<script>
|
|||
|
|
const API_BASE = 'http://localhost:8080';
|
|||
|
|
const token = localStorage.getItem('token'); // 从登录获取
|
|||
|
|
|
|||
|
|
// 1. 加载套餐列表
|
|||
|
|
async function loadPackages() {
|
|||
|
|
const res = await fetch(`${API_BASE}/user/points/packages`);
|
|||
|
|
const result = await res.json();
|
|||
|
|
|
|||
|
|
if (result.code === 200) {
|
|||
|
|
const html = result.data.map(pkg => `
|
|||
|
|
<div class="package">
|
|||
|
|
<h3>${pkg.name}</h3>
|
|||
|
|
<p>${pkg.description}</p>
|
|||
|
|
<p>基础积分：${pkg.points}</p>
|
|||
|
|
<p>赠送积分：${pkg.bonusPoints}</p>
|
|||
|
|
<p>总计：${pkg.totalPoints}积分</p>
|
|||
|
|
<p class="price">¥${pkg.price}</p>
|
|||
|
|
<button onclick="recharge(${pkg.id}, 2)">
|
|||
|
|
微信支付
|
|||
|
|
</button>
|
|||
|
|
</div>
|
|||
|
|
`).join('');
|
|||
|
|
|
|||
|
|
document.getElementById('packages').innerHTML = html;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 2. 创建充值订单
|
|||
|
|
async function recharge(packageId, paymentMethod) {
|
|||
|
|
const res = await fetch(`${API_BASE}/user/points/recharge`, {
|
|||
|
|
method: 'POST',
|
|||
|
|
headers: {
|
|||
|
|
'Content-Type': 'application/json',
|
|||
|
|
'Authorization': `Bearer ${token}`
|
|||
|
|
},
|
|||
|
|
body: JSON.stringify({
|
|||
|
|
packageId: packageId,
|
|||
|
|
paymentMethod: paymentMethod
|
|||
|
|
})
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
const result = await res.json();
|
|||
|
|
|
|||
|
|
if (result.code === 200) {
|
|||
|
|
const { orderNo, paymentParams } = result.data;
|
|||
|
|
console.log('订单创建成功：', orderNo);
|
|||
|
|
|
|||
|
|
// TODO: 调起真实支付
|
|||
|
|
// 这里暂时调用测试回调
|
|||
|
|
testPay(orderNo);
|
|||
|
|
} else {
|
|||
|
|
alert(result.message);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 3. 测试支付（仅开发环境）
|
|||
|
|
async function testPay(orderNo) {
|
|||
|
|
const res = await fetch(
|
|||
|
|
`${API_BASE}/payment/callback/test?orderNo=${orderNo}`,
|
|||
|
|
{ method: 'POST' }
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
if (await res.text() === 'success') {
|
|||
|
|
alert('充值成功！');
|
|||
|
|
location.reload();
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 页面加载时获取套餐
|
|||
|
|
loadPackages();
|
|||
|
|
</script>
|
|||
|
|
</body>
|
|||
|
|
</html>
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🔐 Swagger测试
|
|||
|
|
|
|||
|
|
访问：`http://localhost:8080/doc.html`
|
|||
|
|
|
|||
|
|
### 测试步骤：
|
|||
|
|
|
|||
|
|
1. **获取套餐** → `GET /user/points/packages`
|
|||
|
|
2. **用户登录** → `POST /user/auth/login` → 获取token
|
|||
|
|
3. **点击右上角🔑图标** → 输入 `Bearer YOUR_TOKEN`
|
|||
|
|
4. **创建充值订单** → `POST /user/points/recharge`
|
|||
|
|
5. **测试支付回调** → `POST /payment/callback/test`
|
|||
|
|
6. **查看充值记录** → `GET /user/points/recharge/records`
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## ✅ 完成检查清单
|
|||
|
|
|
|||
|
|
- [ ] 数据库迁移成功（6个套餐）
|
|||
|
|
- [ ] 能够获取套餐列表
|
|||
|
|
- [ ] 能够创建充值订单
|
|||
|
|
- [ ] 测试支付回调成功
|
|||
|
|
- [ ] 用户积分正确到账
|
|||
|
|
- [ ] 充值记录正常显示
|
|||
|
|
- [ ] 首充奖励正确计算
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🎉 成功！
|
|||
|
|
|
|||
|
|
现在用户可以：
|
|||
|
|
- ✅ 浏览积分套餐
|
|||
|
|
- ✅ 选择支付方式充值
|
|||
|
|
- ✅ 查看充值历史
|
|||
|
|
- ✅ 享受首充奖励
|
|||
|
|
|
|||
|
|
**下一步**：对接真实的支付宝/微信支付接口
|
|||
|
|
|
|||
|
|
详细文档请查看：`POINTS_RECHARGE_GUIDE.md`
|
|||
|
|
|