文档: 记录自动发卡补丁并补充界面截图
- README/CHANGELOG/docs 说明 IPTV/App 支付后自动取卡绑机器码 - contact_info 约定 MACHINE:TV-XXXX - 增加公开文档页/登录页截图(无敏感密钥)
This commit is contained in:
1 parent
d4ed9c3dcf
commit
74ccc193d2
8 files changed
+119
-8
No files matched your search
@@ -2,6 +2,13 @@
|
||||
|
||||
## v1.1.1 (2026-10-08)
|
||||
|
||||
### 新增说明:自动发卡补丁(IPTV/App 直购)
|
||||
- 支付成功后,若订单**不含** `bot_qq`(App/IPTV 直购场景),自动从同项目同套餐**未用卡池**取 1 张卡
|
||||
- 从 `contact_info` 解析机器码:`MACHINE:TV-XXXX`(未填则用 `AUTO-{订单号}`)
|
||||
- 自动绑定机器码并标记卡密为已使用,订单关联 `card_id`
|
||||
- 实现位置:`OrderController::processOrderPaid()`(约 L297–L332)
|
||||
- 卡池无卡时订单仍为已支付,需管理端补卡后处理
|
||||
|
||||
### 修复
|
||||
- **安装统计时间统一为北京时间(UTC+8)**
|
||||
- MySQL 默认时区改为 `+08:00`(docker-compose / 运行中实例)
|
||||
|
||||
@@ -4,6 +4,18 @@
|
||||
|
||||
> **当前版本:v1.1.1** · 更新日志见 [CHANGELOG.md](./CHANGELOG.md)
|
||||
|
||||
## 界面预览
|
||||
|
||||
> 截图为示例/公开页,敏感信息已打码或使用占位符。
|
||||
|
||||
| 登录页 | 系统文档(含自动发卡说明) |
|
||||
|--------|---------------------------|
|
||||
|  |  |
|
||||
|
||||
- 文档页:`/#/docs`(系统介绍、自动发卡、安装统计与版本推送、API 对接)
|
||||
- 登录页:`/#/login`
|
||||
- 购买中心:`/#/shop`
|
||||
|
||||
## 技术栈
|
||||
|
||||
| 层 | 技术 |
|
||||
@@ -27,6 +39,7 @@
|
||||
- 在线授权(直接创建授权,不依赖卡密;代理按代理价扣费)
|
||||
- 代理余额体系(充值记录、扣费追溯、额度查询)
|
||||
- 订单管理(代客手动完成 / 手动确认)
|
||||
- **自动发卡(IPTV/App 直购闭环)**:支付成功后自动从未用卡池取卡并绑定机器码(v1.1 补丁)
|
||||
- 在线购买商城(公开页面,支持 epay/codepay 支付回调)
|
||||
- **安装统计**:项目安装次数、存活/已删除、最后上线时间(v1.1.0)
|
||||
- **版本推送**:上传安装包并推送客户端下载,支持强制更新提示(v1.1.0)
|
||||
@@ -45,6 +58,29 @@
|
||||
- `/installations` 安装统计(v1.1.0)
|
||||
- `/project-versions` 版本推送(v1.1.0)
|
||||
|
||||
### 订单支付后如何发卡
|
||||
|
||||
支付成功(异步回调 / 同步完成 / 手动补单 / 免费商品)统一走 `OrderController::processOrderPaid`:
|
||||
|
||||
| 场景 | 行为 |
|
||||
|------|------|
|
||||
| 订单含 `bot_qq` + `contact_qq` | 创建或续费 QQ 授权记录(`ca_authorizations`) |
|
||||
| 订单**不含** `bot_qq`(App/IPTV 直购) | **自动发卡**:从同项目同套餐的未用卡池取 1 张,绑定机器码后标记为已使用 |
|
||||
| 卡池无未用卡 | 订单仍标记为已支付,`card_id` 为空,请在卡密管理补卡后手动处理 |
|
||||
|
||||
**自动发卡机器码约定:** 下单时把电视/App 机器码写入 `contact_info`,格式:
|
||||
|
||||
```text
|
||||
MACHINE:TV-XXXXXX
|
||||
```
|
||||
|
||||
示例:`MACHINE:TV-E2E-TEST`。系统用正则 `MACHINE:([A-Za-z0-9\-_]+)` 解析;未填写时使用 `AUTO-{订单号}` 占位并仍完成绑定。
|
||||
|
||||
发卡结果:
|
||||
- 卡密 `status=used`,`bind_info` 含 `machine_id / order_no / device_info=auto-delivery / first_bind_at`
|
||||
- 订单写入 `card_id`,可在订单详情、导出中查看卡密
|
||||
- 支付成功接口 / `GET /api/public/orders/query` 可返回关联卡密
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 方式一:Docker 部署(推荐)
|
||||
@@ -388,12 +424,18 @@ Content-Type: application/json
|
||||
"card_type_id": 1,
|
||||
"amount": 29.90,
|
||||
"pay_type": "wxpay",
|
||||
"contact_qq": "987654321",
|
||||
"bot_qq": "123456789",
|
||||
"coupon_code": "" // 可选,优惠码
|
||||
"contact_qq": "987654321", // QQ授权场景选填
|
||||
"bot_qq": "123456789", // QQ授权场景选填;填写则走授权续费/新建
|
||||
"contact_info": "MACHINE:TV-123456", // App/IPTV 自动发卡:写入机器码
|
||||
"coupon_code": "" // 可选,优惠码
|
||||
}
|
||||
```
|
||||
|
||||
**自动发卡说明(App/IPTV 直购):**
|
||||
- 订单**不填** `bot_qq`,且支付成功时,系统从同项目同套餐未用卡池自动取 1 张卡
|
||||
- `contact_info` 中 `MACHINE:TV-XXXX` 会被解析为绑定机器码;未填则用 `AUTO-{订单号}`
|
||||
- 自动发卡后,`GET /api/public/orders/query` 返回中可包含 `card_key`、到期时间等
|
||||
|
||||
**响应示例:**
|
||||
```json
|
||||
{
|
||||
|
||||
@@ -294,6 +294,41 @@ class OrderController extends Controller
|
||||
]
|
||||
);
|
||||
}
|
||||
} else {
|
||||
// ===== 无 bot_qq 订单:自动发卡并绑定机器码(IPTV App 直购闭环)=====
|
||||
// contact_info 约定格式: "MACHINE:TV-XXXX" (App下单时带上电视机器码)
|
||||
$machineId = '';
|
||||
if (preg_match('/MACHINE:([A-Za-z0-9\-_]+)/', $order['contact_info'] ?? '', $mm)) {
|
||||
$machineId = $mm[1];
|
||||
}
|
||||
// 从同项目同卡类型的未用卡池取一张
|
||||
$card = $db->fetch(
|
||||
"SELECT * FROM {$db->table('cards')} WHERE project_id = ? AND card_type_id = ? AND status = 'unused' ORDER BY id ASC LIMIT 1",
|
||||
[$order['project_id'], $order['card_type_id']]
|
||||
);
|
||||
if ($card) {
|
||||
$expireTime = null;
|
||||
if ($durationDays > 0) {
|
||||
$expireTime = date('Y-m-d H:i:s', strtotime("+{$durationDays} days"));
|
||||
}
|
||||
$bindInfo = json_encode([
|
||||
'machine_id' => $machineId ?: 'AUTO-' . $order['order_no'],
|
||||
'ip' => '',
|
||||
'device_info' => 'auto-delivery',
|
||||
'first_bind_at' => date('Y-m-d H:i:s'),
|
||||
'order_no' => $order['order_no'],
|
||||
], JSON_UNESCAPED_UNICODE);
|
||||
$db->execute(
|
||||
"UPDATE {$db->table('cards')} SET status = 'used', bind_info = ?, bound_at = NOW(), expire_time = ? WHERE id = ?",
|
||||
[$bindInfo, $expireTime, $card['id']]
|
||||
);
|
||||
// 订单关联该卡,查询接口可显示
|
||||
$db->execute(
|
||||
"UPDATE {$db->table('orders')} SET card_id = ? WHERE id = ?",
|
||||
[$card['id'], $orderId]
|
||||
);
|
||||
}
|
||||
// 无未用卡池时订单仍标 paid(余卡告警交给管理端)
|
||||
}
|
||||
|
||||
// 更新订单状态
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 781 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 905 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 420 KiB |
@@ -39,6 +39,7 @@
|
||||
<li><b>授权验证</b>:REST API 实时校验卡密与机器码绑定状态</li>
|
||||
<li><b>安装统计</b>:记录安装次数、存活/已删除、最后上线时间</li>
|
||||
<li><b>版本推送</b>:上传安装包并推送客户端下载,支持强制更新提示</li>
|
||||
<li><b>自动发卡</b>:App/IPTV 支付成功后从未用卡池自动取卡并绑定机器码</li>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
@@ -53,6 +54,28 @@
|
||||
<p class="docs-tip">卡密未使用前不限期有效;一旦绑定,有效期自激活时开始计算。请妥善保管卡密,谨防泄露。</p>
|
||||
</div>
|
||||
|
||||
<div class="docs-card">
|
||||
<div class="docs-card-head"><span>自动发卡(App/IPTV 直购)</span></div>
|
||||
<p>支付成功后系统自动完成发卡,适合电视端 / App 内直接购买、无需人工发卡的场景。</p>
|
||||
<ol>
|
||||
<li>客户端下单时,在 <code>contact_info</code> 中带上机器码:<br><code>MACHINE:TV-XXXXXX</code></li>
|
||||
<li>支付成功(回调 / 同步完成 / 管理端补单)触发自动发卡</li>
|
||||
<li>系统从同项目、同套餐的<b>未用卡池</b>取出 1 张卡</li>
|
||||
<li>自动绑定机器码(<code>status=used</code>),订单关联该卡密</li>
|
||||
<li>App 用订单号调用 <code>/api/public/orders/query</code> 即可拿到卡密与到期信息</li>
|
||||
</ol>
|
||||
<div class="docs-code">
|
||||
<div class="docs-code-title">contact_info 约定</div>
|
||||
<pre>MACHINE:TV-123456
|
||||
// 未填写 MACHINE 时,系统使用 AUTO-订单号 占位并仍完成绑定</pre>
|
||||
</div>
|
||||
<ul>
|
||||
<li>订单若填写了 <code>bot_qq</code> + <code>contact_qq</code>,则走 QQ 授权续费/新建,不会自动发卡</li>
|
||||
<li>卡池无未用卡时:订单仍标记已支付,管理端需补卡后手动处理</li>
|
||||
<li>发卡结果:卡密 <code>bind_info.device_info=auto-delivery</code>,并记录 <code>order_no</code></li>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
<div class="docs-card">
|
||||
<div class="docs-card-head"><span>安装统计与版本推送</span></div>
|
||||
<p>系统支持统计项目被安装次数、区分存活/已删除、记录最后上线时间,并可向客户端推送最新安装包(支持强制更新提示)。</p>
|
||||
@@ -220,14 +243,16 @@ POST /api/public/orders — 创建订单(在服务器内支付,返回支付
|
||||
{
|
||||
"project_id": 1, "card_type_id": 1,
|
||||
"amount": 29.90, "pay_type": "wxpay", // wxpay | alipay | qqpay
|
||||
"contact_qq": "987654321", "bot_qq": "123456789",
|
||||
"contact_qq": "987654321", "bot_qq": "123456789", // QQ授权场景选填
|
||||
"contact_info": "MACHINE:TV-123456", // App自动发卡:机器码
|
||||
"coupon_code": "" // 选填:优惠码
|
||||
}
|
||||
响应 data: { "order_no":"2026062317530410859", "pay_url":"https://…", "is_renew":false }
|
||||
|
||||
GET /api/public/orders/query?order_no=2026062317530410859 — 订单查询
|
||||
GET /api/public/orders/query?order_no=2026062317530410859 — 订单查询(已自动发卡时含 card_key / expire_time)
|
||||
GET /api/public/cards/query?card_key=CA-XXXX — 卡密查询</pre>
|
||||
</div>
|
||||
<p class="doc-note">App 下单时在 <code>contact_info</code> 写 <code>MACHINE:TV-XXXX</code>,支付成功后自动从未用卡池取卡并绑定机器码(详见上方「自动发卡」)。</p>
|
||||
|
||||
<h4 class="docs-sub">8. 调用示例(CURL)</h4>
|
||||
<div class="docs-code">
|
||||
@@ -258,7 +283,7 @@ curl -X POST https://你的域名/api/public/installations/heartbeat \
|
||||
<div class="docs-card">
|
||||
<div class="docs-card-head"><span>常见问题</span></div>
|
||||
<ul>
|
||||
<li><b>付款后没有收到卡密?</b>在购买中心用订单号查询;超过 15 分钟未支付订单自动作废。</li>
|
||||
<li><b>付款后没有收到卡密?</b>在购买中心用订单号查询;App/IPTV 订单支付成功后会自动发卡(见「自动发卡」);超过 15 分钟未支付订单自动作废。</li>
|
||||
<li><b>卡密提示已被使用?</b>卡密一次性绑定,若需更换设备请联系管理员重置绑定。</li>
|
||||
<li><b>支持退款吗?</b>卡密一经绑定激活不支持退款,购买前请确认商品信息。</li>
|
||||
<li><b>忘记绑定的机器码?</b>用卡密在「授权查询」中即可反查。</li>
|
||||
|
||||
@@ -250,6 +250,7 @@
|
||||
<li><b>授权验证</b>:REST API 实时校验卡密与机器码绑定状态</li>
|
||||
<li><b>安装统计</b>:安装次数、存活/已删除、最后上线时间</li>
|
||||
<li><b>版本推送</b>:推送最新安装包下载,支持强制更新提示</li>
|
||||
<li><b>自动发卡</b>:支付成功后自动取卡并绑定机器码(App/IPTV)</li>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
@@ -287,7 +288,8 @@
|
||||
<pre>GET /api/public/projects 项目/商品列表
|
||||
GET /api/public/projects/{id}/card-types 项目套餐
|
||||
POST /api/public/orders 创建订单 → 返回 pay_url
|
||||
GET /api/public/orders/query?order_no=… 订单查询
|
||||
(contact_info 可写 MACHINE:TV-XXXX,支付后自动发卡绑定)
|
||||
GET /api/public/orders/query?order_no=… 订单查询(自动发卡后含卡密)
|
||||
POST /api/public/authorizations/verify QQ授权验证 { bot_qq }
|
||||
GET /api/public/authorizations/query?bot_qq=… QQ授权状态查询</pre>
|
||||
</div>
|
||||
@@ -297,7 +299,7 @@ GET /api/public/authorizations/query?bot_qq=… QQ授权状态查询</pre>
|
||||
<div class="docs-card">
|
||||
<div class="docs-card-head"><IconActivate /><span>常见问题</span></div>
|
||||
<ul>
|
||||
<li><b>付款后没有收到卡密?</b>在「授权查询」用订单号查询;超过 15 分钟未支付订单自动作废。</li>
|
||||
<li><b>付款后没有收到卡密?</b>在「授权查询」用订单号查询;App/IPTV 订单支付成功会自动发卡(contact_info 含 MACHINE: 时绑定机器码);超过 15 分钟未支付订单自动作废。</li>
|
||||
<li><b>卡密提示已被使用?</b>卡密一次性绑定,若需更换设备请联系管理员重置绑定。</li>
|
||||
<li><b>支持退款吗?</b>卡密一经绑定激活不支持退款,购买前请确认商品信息。</li>
|
||||
<li><b>忘记绑定的机器码?</b>用卡密在「授权查询」中即可反查。</li>
|
||||
|
||||
Reference in new issue
Block a user