diff --git a/CHANGELOG.md b/CHANGELOG.md index 7546389..dfa106b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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 / 运行中实例) diff --git a/README.md b/README.md index 86a2868..218d5e3 100644 --- a/README.md +++ b/README.md @@ -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 { diff --git a/backend/app/Controllers/OrderController.php b/backend/app/Controllers/OrderController.php index f576b7a..a905605 100644 --- a/backend/app/Controllers/OrderController.php +++ b/backend/app/Controllers/OrderController.php @@ -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(余卡告警交给管理端) } // 更新订单状态 diff --git a/docs/screenshots/docs-hero.png b/docs/screenshots/docs-hero.png new file mode 100644 index 0000000..00f2607 Binary files /dev/null and b/docs/screenshots/docs-hero.png differ diff --git a/docs/screenshots/docs.png b/docs/screenshots/docs.png new file mode 100644 index 0000000..215d39b Binary files /dev/null and b/docs/screenshots/docs.png differ diff --git a/docs/screenshots/login.png b/docs/screenshots/login.png new file mode 100644 index 0000000..7306ede Binary files /dev/null and b/docs/screenshots/login.png differ diff --git a/frontend/src/views/public/Docs.vue b/frontend/src/views/public/Docs.vue index f911691..4623509 100644 --- a/frontend/src/views/public/Docs.vue +++ b/frontend/src/views/public/Docs.vue @@ -39,6 +39,7 @@
  • 授权验证:REST API 实时校验卡密与机器码绑定状态
  • 安装统计:记录安装次数、存活/已删除、最后上线时间
  • 版本推送:上传安装包并推送客户端下载,支持强制更新提示
  • +
  • 自动发卡:App/IPTV 支付成功后从未用卡池自动取卡并绑定机器码
  • @@ -53,6 +54,28 @@

    卡密未使用前不限期有效;一旦绑定,有效期自激活时开始计算。请妥善保管卡密,谨防泄露。

    +
    +
    自动发卡(App/IPTV 直购)
    +

    支付成功后系统自动完成发卡,适合电视端 / App 内直接购买、无需人工发卡的场景。

    +
      +
    1. 客户端下单时,在 contact_info 中带上机器码:
      MACHINE:TV-XXXXXX
    2. +
    3. 支付成功(回调 / 同步完成 / 管理端补单)触发自动发卡
    4. +
    5. 系统从同项目、同套餐的未用卡池取出 1 张卡
    6. +
    7. 自动绑定机器码(status=used),订单关联该卡密
    8. +
    9. App 用订单号调用 /api/public/orders/query 即可拿到卡密与到期信息
    10. +
    +
    +
    contact_info 约定
    +
    MACHINE:TV-123456
    +// 未填写 MACHINE 时,系统使用 AUTO-订单号 占位并仍完成绑定
    +
    + +
    +
    安装统计与版本推送

    系统支持统计项目被安装次数、区分存活/已删除、记录最后上线时间,并可向客户端推送最新安装包(支持强制更新提示)。

    @@ -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 — 卡密查询
    +

    App 下单时在 contact_info 写 MACHINE:TV-XXXX,支付成功后自动从未用卡池取卡并绑定机器码(详见上方「自动发卡」)。

    8. 调用示例(CURL)

    @@ -258,7 +283,7 @@ curl -X POST https://你的域名/api/public/installations/heartbeat \
    常见问题
    @@ -287,7 +288,8 @@
    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授权状态查询
    @@ -297,7 +299,7 @@ GET /api/public/authorizations/query?bot_qq=… QQ授权状态查询
    常见问题