v1.1.0: 新增安装统计与版本推送

功能说明:
- 安装统计: 每次安装独立计数(含已删除), 存活/已删除, 最后上线时间
- 版本推送: 上传安装包并推送客户端下载, 支持强制更新提示(不阻断授权)
- 客户端接口: check-update / heartbeat, verify 成功附带更新字段
- 管理端: 安装统计页 + 版本推送页; agent 不可发布版本(仅只读)
- 文档: README API 说明 + /docs 功能介绍与使用方法 + CHANGELOG

数据库:
- 新表 ca_installations / ca_project_versions
- 增量升级: backend/database/migrations/20261008_add_installations_and_versions.sql
This commit is contained in:
root committed 2026-10-08 18:19:36 +08:00
1 parent af98618810
commit e809b7a903
22 files changed
+3153 -32

No files matched your search

+29
View File
@@ -16,6 +16,8 @@ use App\Controllers\AuthorizationController;
use App\Controllers\CouponController;
use App\Controllers\BlacklistController;
use App\Controllers\NotificationController;
use App\Controllers\InstallationController;
use App\Controllers\ProjectVersionController;
use App\Middleware\AuthMiddleware;
use App\Middleware\RateLimitMiddleware;
use App\Middleware\ApiKeyMiddleware;
@@ -41,6 +43,9 @@ $router->group('api/public', function ($router) {
// 卡密查询
$router->get('cards/query', [PublicController::class, 'queryCard']);
// 支付方式(前台展示用)
$router->get('payment/options', [PublicController::class, 'paymentOptions']);
// 支付回调
$router->get('payment/notify', [PublicController::class, 'paymentNotify']);
$router->post('payment/notify', [PublicController::class, 'paymentNotify']);
@@ -65,6 +70,12 @@ $router->group('api/public/verify', function ($router) {
$router->post('', [PublicController::class, 'verify']);
}, [new ApiKeyMiddleware(), new RateLimitMiddleware(60, 60, 'verify')]);
// 安装上报/检查更新 (API Key认证)
$router->group('api/public/installations', function ($router) {
$router->post('check-update', [PublicController::class, 'checkUpdate']);
$router->post('heartbeat', [PublicController::class, 'heartbeat']);
}, [new ApiKeyMiddleware(), new RateLimitMiddleware(60, 60, 'install')]);
// ============================================
// 认证接口 (无需JWT)
// ============================================
@@ -175,6 +186,24 @@ $router->group('api', function ($router) {
$router->put('coupons/{id}', [CouponController::class, 'update']);
$router->delete('coupons/{id}', [CouponController::class, 'delete']);
// 安装统计管理 (admin / project_admin / agent)
$router->get('installations', [InstallationController::class, 'list']);
$router->get('installations/stats', [InstallationController::class, 'stats']);
$router->get('installations/export', [InstallationController::class, 'export']);
$router->get('installations/{id}', [InstallationController::class, 'detail']);
$router->delete('installations/{id}', [InstallationController::class, 'delete']);
$router->post('installations/{id}/restore', [InstallationController::class, 'restore']);
$router->post('installations/batch-delete', [InstallationController::class, 'batchDelete']);
// 项目版本/安装包管理 (发布仅 admin/project_admin; agent 只读)
$router->get('projects/{projectId}/versions', [ProjectVersionController::class, 'list']);
$router->get('projects/{projectId}/versions/{id}', [ProjectVersionController::class, 'detail']);
$router->post('projects/{projectId}/versions', [ProjectVersionController::class, 'create']);
$router->put('versions/{id}', [ProjectVersionController::class, 'update']);
$router->put('versions/{id}/force', [ProjectVersionController::class, 'toggleForce']);
$router->put('versions/{id}/latest', [ProjectVersionController::class, 'setLatest']);
$router->delete('versions/{id}', [ProjectVersionController::class, 'delete']);
// 黑名单管理(仅管理员)
$router->group('blacklists', function ($router) {
$router->get('', [BlacklistController::class, 'list']);