diff --git a/.env.example b/.env.example index ff655d3..03b03fe 100644 --- a/.env.example +++ b/.env.example @@ -8,7 +8,7 @@ ADMIN_PASSWORD=admin123456 PAY_MASTER_KEY= # 本地联调业务回调时可设为 true;生产环境请保持 false,避免 SSRF。 ALLOW_PRIVATE_CALLBACKS=false -# 外部 PostgreSQL 用于读取 users,并在支付确认后由服务端原子增加 users.quota;Docker Compose 内可设 postgres +# 外部 PostgreSQL 用于读取 users;1 积分对应 5000 quota,支付确认后服务端按此比例原子更新 users.quota;Docker Compose 内可设 postgres EXTERNAL_POSTGRES_HOST=localhost EXTERNAL_POSTGRES_PORT=5432 EXTERNAL_POSTGRES_DATABASE=new-api diff --git a/README.md b/README.md index 842f345..fafc40c 100644 --- a/README.md +++ b/README.md @@ -70,7 +70,7 @@ sign = HMAC-SHA256(merchant_secret, content).hex() ## 支付成功业务回调 -支付页只轮询本平台订单状态,不直接修改业务数据。支付宝、微信等渠道经服务端查单或验签通知确认实付成功后,服务端先按订单绑定的用户 ID 原子增加 PostgreSQL `users.quota`;只有积分入账成功,订单才会变为 `paid` 并返回充值成功。业务入账使用独立的唯一订单流水表 `multipay_recharge_credits`,重复通知和重复轮询不会重复增加积分。 +支付页只轮询本平台订单状态,不直接修改业务数据。支付宝、微信等渠道经服务端查单或验签通知确认实付成功后,服务端先按订单绑定的用户 ID 原子增加 PostgreSQL `users.quota`;换算比例固定为 `1 积分 = 5000 quota`,页面积分按 `Math.ceil(quota / 5000)` 显示。只有积分入账成功,订单才会变为 `paid` 并返回充值成功。业务入账使用独立的唯一订单流水表 `multipay_recharge_credits`,重复通知和重复轮询不会重复增加积分。 平台向 `notify_url` 发送 JSON: @@ -103,7 +103,7 @@ sign = HMAC-SHA256(merchant_secret, content).hex() - 后台“用户管理”用于创建和停用本地用户,并查看积分余额、成功充值次数和累计金额。 - 后台“充值套餐”可配置套餐名称、显示金额、到账积分、启用状态和展示顺序。 -- 支付渠道确认成功后,服务端将套餐积分增加到 PostgreSQL `users.quota`;入账成功后才向支付页返回成功。 +- 支付渠道确认成功后,服务端按“套餐积分 × 5000”增加 PostgreSQL `users.quota`;入账成功后才向支付页返回成功。 - 每个支付订单只允许生成一条业务入账流水;支付平台重复通知和页面重复轮询不会重复增加积分。 - 收银台默认展示该用户最近六个月的成功充值记录。 - 初始演示用户为 `demo-user`,仅用于本地验收,正式使用时请创建业务用户并停用演示用户。 @@ -112,10 +112,18 @@ sign = HMAC-SHA256(merchant_secret, content).hex() - 充值记录中的已支付订单可以由管理员发起原路全额退款。 - 管理员可选择是否回退积分;默认回退该订单充值时到账的积分,也可以填写其他非负整数。 -- 支付渠道确认退款后,服务端按订单绑定的用户 ID 从 PostgreSQL `users.quota` 扣减积分,网页不会直接操作业务数据库。 +- 支付渠道确认退款后,服务端按“回退积分 × 5000”从订单用户的 PostgreSQL `users.quota` 扣减额度,网页不会直接操作业务数据库。 - 退款请求号与积分回退流水均按订单保持唯一;重复点击、网络重试或渠道重复响应不会重复退款、重复扣减积分。 - 微信退款处于处理中时,可在充值记录中点击“查询退款”继续确认状态。 +历史版本曾按 `1 积分 = 1 quota` 写入流水。升级后在 PostgreSQL 可连接时执行一次: + +```powershell +bun run migrate:quota-scale +``` + +脚本只修复能够通过本地订单明确验证的旧比例流水;已经符合 5000 倍比例的数据会跳过,其他不一致会停止并回滚。 + ## 官方支付配置 ### 支付宝 diff --git a/package.json b/package.json index 46d1618..fb9f5fa 100644 --- a/package.json +++ b/package.json @@ -6,7 +6,8 @@ "scripts": { "dev": "bun --watch src/server.ts", "start": "bun src/server.ts", - "test": "bun test" + "test": "bun test", + "migrate:quota-scale": "bun scripts/migrate-quota-scale.ts" }, "dependencies": { "pg": "^8.23.1", diff --git a/public/admin.html b/public/admin.html index 12389bf..2fec5f8 100644 --- a/public/admin.html +++ b/public/admin.html @@ -20,6 +20,6 @@
- +