Files

Made-with: Cursor

2026-03-07 22:58:43 +08:00

6.6 KiB

Raw Permalink Blame History

新分销逻辑 - 宝塔面板操作清单

✅ 已完成的准备工作

✅ 数据库字段已添加（last_purchase_date, purchase_count, total_commission）
✅ 代码已部署到服务器（/www/wwwroot/soul/dist）
✅ 索引已创建

🔧 宝塔面板操作步骤

Step 1: 重启 Node.js 服务

登录宝塔面板：http://你的服务器IP:8888
左侧菜单 → 网站 → 找到 soul.quwanzhi.com
点击设置 → Node项目 标签
找到项目 soul
点击重启按钮
等待状态变为"运行中"

或者使用命令行（如果有SSH权限）：

# 使用宝塔的pm2完整路径
/www/server/nodejs/v16.20.2/bin/pm2 restart soul

# 查看状态
/www/server/nodejs/v16.20.2/bin/pm2 status

# 查看日志
/www/server/nodejs/v16.20.2/bin/pm2 logs soul --lines 50

Step 2: 验证服务是否正常

2.1 检查网站访问

在浏览器打开：https://soul.quwanzhi.com

预期：

✅ 网站正常加载
✅ 无404错误
✅ 可以正常登录

2.2 检查新API是否生效

打开浏览器控制台，访问：

https://soul.quwanzhi.com/api/db/config?key=referral_config

预期返回：

{
  "success": true,
  "config": {
    "distributorShare": 90,
    "minWithdrawAmount": 10,
    "bindingDays": 30,
    "userDiscount": 5,
    "enableAutoWithdraw": false
  }
}

2.3 检查推广设置页面

访问：https://soul.quwanzhi.com/admin/referral-settings

预期：

✅ 页面正常加载
✅ 显示当前配置
✅ 可以修改并保存

Step 3: 配置自动解绑定时任务

宝塔面板 → 左侧菜单 → 计划任务
点击 添加计划任务
填写以下信息：

任务配置：

任务类型：Shell脚本
任务名称：自动解绑过期推荐关系
执行周期：每天 02:00（凌晨2点）
脚本内容：
cd /www/wwwroot/soul/dist && /www/server/nodejs/v16.20.2/bin/node scripts/auto-unbind-expired-simple.js >> /www/wwwroot/soul/logs/auto-unbind.log 2>&1

点击添加
任务创建后，点击执行按钮测试一次

预期日志（如果没有过期记录）：

============================================================
自动解绑定时任务
执行时间: 2026/2/5 14:30:00
============================================================
✅ 已连接到数据库: soul_miniprogram
✅ 无需解绑的记录
============================================================
任务完成
============================================================

Step 4: 查看定时任务日志

# 方式1：SSH命令
cat /www/wwwroot/soul/logs/auto-unbind.log

# 方式2：宝塔面板
计划任务 → 找到"自动解绑"任务 → 点击"日志"

🧪 功能测试（小程序端）

测试1：立即切换绑定

准备两个测试账号：
- 账号A：作为推荐人A（获取推荐码 SOULA001）
- 账号C：作为推荐人C（获取推荐码 SOULC001）
- 账号B：作为购买者

测试步骤：

Step 1: A 分享文章链接给 B
Step 2: B 点击链接进入小程序（会自动绑定A）
Step 3: 查数据库验证绑定
Step 4: C 分享文章链接给 B
Step 5: B 点击C的链接（应该立即切换）
Step 6: 再次查数据库验证

数据库验证SQL：

-- 查看B当前的绑定状态
SELECT 
  referee_id, 
  referrer_id, 
  status, 
  binding_date, 
  expiry_date
FROM referral_bindings
WHERE referee_id = 'B的用户ID'
ORDER BY binding_date DESC;

预期结果：

最新一条：referrer_id = C的ID, status = active
上一条：referrer_id = A的ID, status = cancelled

测试2：购买分佣

B 购买一篇文章（1元）

查看分佣结果：

SELECT 
  rb.referrer_id,
  rb.purchase_count,
  rb.total_commission,
  rb.last_purchase_date,
  u.pending_earnings
FROM referral_bindings rb
JOIN users u ON rb.referrer_id = u.id
WHERE rb.referee_id = 'B的用户ID' AND rb.status = 'active';

预期结果（假设90%分成）：

referrer_id: C的ID
purchase_count: 1
total_commission: 0.90
pending_earnings: 0.90

B 再次购买：

-- 查询应显示
purchase_count: 2
total_commission: 1.80
pending_earnings: 1.80

测试3：好友优惠（新功能）

后台设置好友优惠为 10%
- 访问：https://soul.quwanzhi.com/admin/referral-settings
- 修改"好友优惠"为 10
- 保存
B 通过推荐链接购买
- 原价 1.00 元的文章
- 支付时应显示 0.90 元（10% off）
验证佣金计算：
- C 应获得佣金 = 0.90 × 90% = 0.81 元
- 而不是 1.00 × 90% = 0.90 元

📊 后台监控

查看绑定切换记录

SQL查询：

-- 查看最近的绑定切换
SELECT 
  rb.referee_id,
  rb.referrer_id,
  rb.status,
  rb.binding_date,
  rb.purchase_count,
  rb.total_commission
FROM referral_bindings rb
WHERE rb.status IN ('active', 'cancelled')
ORDER BY rb.binding_date DESC
LIMIT 20;

查看即将过期的绑定

-- 7天内即将过期且无购买的绑定
SELECT 
  rb.referee_id,
  rb.referrer_id,
  rb.binding_date,
  rb.expiry_date,
  DATEDIFF(rb.expiry_date, NOW()) as days_left,
  rb.purchase_count
FROM referral_bindings rb
WHERE rb.status = 'active'
  AND rb.expiry_date > NOW()
  AND DATEDIFF(rb.expiry_date, NOW()) <= 7
  AND rb.purchase_count = 0
ORDER BY days_left ASC;

⚠️ 常见问题

Q1: 点击新链接后没有切换？

检查：

宝塔面板 → Node项目 → 查看日志
搜索 [Referral Bind] 关键词
确认是否有报错

Q2: 购买后 purchase_count 还是 0？

检查：

查看支付回调日志：pm2 logs soul | grep PayNotify
确认字段 purchase_count 是否存在
执行SQL验证：SHOW COLUMNS FROM referral_bindings;

Q3: 定时任务没有执行？

检查：

宝塔面板 → 计划任务 → 找到任务 → 点击"执行"测试
查看日志：cat /www/wwwroot/soul/logs/auto-unbind.log
确认脚本路径正确：ls -la /www/wwwroot/soul/dist/scripts/auto-unbind-expired-simple.js

📝 部署后清理

部署成功后，删除临时文件：

# 本地清理
rm .env.migration

✅ 完成检查清单

数据库字段已添加
代码已部署
PM2服务运行正常
网站可以访问
推广设置页面正常
定时任务已配置
功能测试通过

下一步：执行上述测试验证，或告诉我遇到的任何问题！

6.6 KiB Raw Permalink Blame History Unescape Escape