- ca_announcements 表 + 管理端公告推送页 - 公开接口 GET /api/public/announcements (list/popup) - 支持置顶/弹窗/定时/对象筛选/关联项目 - 仅 admin/project_admin 可发布
91 lines
4.2 KiB
Markdown
91 lines
4.2 KiB
Markdown
# 更新日志
|
||
|
||
## 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 转换为北京时间
|
||
- 接口返回与后台页面展示均为北京时间
|
||
|
||
---
|
||
|
||
## 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 部署。
|