Files
CardAuth/CHANGELOG.md
T

124 lines
6.9 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.3.0 (2026-10-21)
### 新增:支付结果页展示卡密
- 支付成功页 `/#/result` 增加卡密展示区:绿色高亮大框、22px 大字、**一键复制**、提示语(购买中心可用订单号随时查询)
- 显示商品与套餐名(`项目名 · 套餐名`)
- `POST /api/public/payment/complete` 新增返回 `card_key`、`card_type_name`(自动发卡订单),并回读 `orders.card_id` 关联信息
- 复制兼容 http 环境(`navigator.clipboard` 不可用时降级 `execCommand`)
### 新增:代理端图形数字验证码(替代 Turnstile)
- 新接口 `GET /api/public/captcha`:输出 SVG 图形,**4 位数字、无 GD 依赖**、干扰线/噪点/逐字随机旋转
- 验证码存 Session:**5 分钟有效、一次性**(校验后立即失效)
- 新组件 `frontend/src/components/ImageCaptcha.vue`(点击图片刷新,校验失败自动换图)
- 代理登录 `POST /api/auth/agent-login`、代理注册 `POST /api/auth/agent-register` 改为校验 `captcha_code`
- 管理员登录**仍保留** Cloudflare Turnstile(不受影响)
- `stores/user.js` 的 `login()` 第 4 个参数改为对象:`{turnstile_token}` / `{captcha_code}`
### 优化
- **后台内容区全屏铺满**:移除列表页统一 `max-width:1600px` 与系统设置 900px / 支付配置 800px 限宽,`common.css` 统一覆盖各页面 scoped 限宽规则
- 支付回调地址统一走域名:`APP_URL=https://auth.88531.cn`(`notify_url` / `return_url` 不再使用 `IP:8881`)
### 修复
- **支付同步回调「签名验证失败」**:签名改用网关原始回调串 `sign_params`(原前端回传字段丢失 `name` 等导致重算不一致),并按网关规则跳过空值;同步补单失败时自动查 `orders/query` 兜底显示卡密
- SMTP 邮件主题 UTF-8 编码乱码
- 清理旧构建产物残留(`backend/public/assets` 历史版本文件)
### 部署环境联动改动(不在本仓库)
- **易支付 wxpay 插件**:微信返回 `ORDERPAID(该订单已支付)` 时不再显示错误页,改为带签名直接跳回商户 `/#/result`(覆盖 qrcode / jspay / wap / h5 / apppay),修复「刷新支付页后永不跳回」
- **易支付支付页轮询主动查单**:`getshop.php` 发现订单未入账时调用微信订单查询 API(同单 10 秒节流),入账走与异步回调同一套 `processNotify`(幂等),微信回调延迟也能1-2秒内跳回
- 补丁位置:`/home/docker/epay/plugins/wxpay/wxpay_plugin.php`(bind mount)、`/home/docker/epay/patches/getshop.php`(已加 compose 挂载)
- **宝塔反代改回环**:`auth/xboard/bts` 三个站点 `proxy_pass` 由公网 IP 改为 `127.0.0.1`,修复本机回环访问自身公网 IP 不通导致外部请求全部超时/499
---
## 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 部署。