- ca_announcements 表 + 管理端公告推送页 - 公开接口 GET /api/public/announcements (list/popup) - 支持置顶/弹窗/定时/对象筛选/关联项目 - 仅 admin/project_admin 可发布
4.2 KiB
4.2 KiB
更新日志
v1.2.0 (2026-10-10)
新增:公告推送
- 新表
ca_announcements:标题/内容/类型/推送对象/置顶/弹窗/起止时间/关联项目 - 管理端页面「公告推送」:发布、编辑、上线/下线、删除、批量删除
- 公开接口
GET /api/public/announcements:客户端/商城拉取,返回list+popup - 权限:admin / project_admin 可发布;project_admin 仅限绑定项目
- 类型:系统 / 更新 / 活动 / 通知;对象:全部 / 管理端 / 代理端 / 客户端
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 / 运行中实例) - PHP 时区设为
Asia/Shanghai(php.ini / Dockerfile / entrypoint) - 历史安装记录时间已由 UTC 转换为北京时间
- 接口返回与后台页面展示均为北京时间
- MySQL 默认时区改为
v1.1.0 (2026-10-08)
新增功能:安装统计与版本推送
安装统计
- 新增
ca_installations安装记录表:每次安装独立计数(含已删除) - 统计维度:总安装次数、存活安装、已删除、今日/本周新增、最后上线时间
- 支持按项目汇总查看安装情况
- 管理端页面:
安装统计(列表 / 筛选 / 详情 / 软删除 / 恢复 / 批量删除 / 导出 CSV) - 权限:超级管理员、项目管理员(限绑定项目)、代理(限本人卡密相关)
版本推送(安装包分发)
- 新增
ca_project_versions项目版本表 - 管理端上传安装包(zip/tar/gz/7z/exe/dmg/apk/msi/pkg/rar/bin,≤200MB)
- 支持更新说明、设为最新版本、禁用/启用、删除版本及文件
- 管理端页面:
版本推送 - 权限:发布/修改/删除仅超级管理员与项目管理员;代理仅只读
强制推送
- 版本可开启
is_force或设置min_client_version - 客户端检查更新时返回
update_required=true,提示强制更新 - 仅客户端提示,不阻断
verify授权结果
客户端接口(API Key)
| 接口 | 说明 |
|---|---|
POST /api/public/installations/check-update |
检查更新 + 登记安装/更新在线时间 |
POST /api/public/installations/heartbeat |
轻量心跳,更新 last_online_at |
POST /api/public/verify |
成功响应附带更新字段,并同步安装记录 |
check-update / verify 成功时返回:update_available、update_required、latest_version、download_url、file_size、checksum、changelog、is_force、install_id 等。
管理端接口(JWT)
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/installations |
安装列表 |
| GET | /api/installations/stats |
安装统计(含已删除) |
| GET | /api/installations/export |
导出 CSV |
| DELETE | /api/installations/{id} |
标记已删除 |
| POST | /api/installations/{id}/restore |
恢复安装 |
| GET | /api/projects/{projectId}/versions |
版本列表 |
| POST | /api/projects/{projectId}/versions |
发布版本(multipart) |
| PUT | /api/versions/{id}/force |
强制推送开关 |
| PUT | /api/versions/{id}/latest |
设为最新 |
| DELETE | /api/versions/{id} |
删除版本 |
文档
- README 补充安装统计与版本推送 API 文档
- 公开文档页
/docs增加功能介绍、后台使用方法、客户端对接说明与 CURL 示例
数据库升级
- 已有库执行:
backend/database/migrations/20261008_add_installations_and_versions.sql - 全新安装:
backend/database/schema.sql已包含新表
v1.0.0
初始版本:卡密授权、项目/套餐/卡密管理、代理分销、在线支付商城、授权验证 API、黑名单、SMTP 到期提醒、Docker 部署。