Files
CardAuth/CHANGELOG.md
T
root c64f46e2af v1.2.0: 新增公告推送
- ca_announcements 表 + 管理端公告推送页
- 公开接口 GET /api/public/announcements (list/popup)
- 支持置顶/弹窗/定时/对象筛选/关联项目
- 仅 admin/project_admin 可发布
2026-10-10 10:00:25 +08:00

91 lines
4.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 更新日志
## 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 部署。