文档: 记录自动发卡补丁并补充界面截图

- README/CHANGELOG/docs 说明 IPTV/App 支付后自动取卡绑机器码
- contact_info 约定 MACHINE:TV-XXXX
- 增加公开文档页/登录页截图(无敏感密钥)
This commit is contained in:
root committed 2026-10-08 23:52:21 +08:00
1 parent d4ed9c3dcf
commit 74ccc193d2
8 files changed
+119 -8

No files matched your search

+7
View File
@@ -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 / 运行中实例)
+45 -3
View File
@@ -4,6 +4,18 @@
> **当前版本:v1.1.1** · 更新日志见 [CHANGELOG.md](./CHANGELOG.md)
## 界面预览
> 截图为示例/公开页,敏感信息已打码或使用占位符。
| 登录页 | 系统文档(含自动发卡说明) |
|--------|---------------------------|
| ![登录](docs/screenshots/login.png) | ![文档](docs/screenshots/docs.png) |
- 文档页:`/#/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

+28 -3
View File
@@ -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>
+4 -2
View File
@@ -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>