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

@@ -0,0 +1,56 @@
-- 安装记录表 + 项目版本/安装包表
-- 适用于已有数据库的增量升级;新库直接使用 schema.sql
-- ============================================
-- 安装记录表
-- ============================================
CREATE TABLE IF NOT EXISTS `ca_installations` (
`id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
`project_id` BIGINT UNSIGNED NOT NULL COMMENT '所属项目ID',
`card_id` BIGINT UNSIGNED DEFAULT NULL COMMENT '关联卡密ID(可空)',
`card_key` VARCHAR(64) DEFAULT '' COMMENT '卡密(冗余,便于查询)',
`machine_id` VARCHAR(128) NOT NULL COMMENT '机器指纹',
`ip` VARCHAR(45) DEFAULT '' COMMENT '最后IP',
`device_info` TEXT DEFAULT NULL COMMENT '设备信息',
`client_version` VARCHAR(50) DEFAULT '' COMMENT '客户端版本',
`status` ENUM('active','deleted') NOT NULL DEFAULT 'active' COMMENT '状态: active=存活, deleted=已删除',
`install_count` INT UNSIGNED NOT NULL DEFAULT 1 COMMENT '该机器累计激活次数',
`last_online_at` DATETIME DEFAULT NULL COMMENT '最后上线时间',
`installed_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '安装时间',
`deleted_at` DATETIME DEFAULT NULL COMMENT '删除时间',
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
`updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (`id`),
KEY `idx_project_id` (`project_id`),
KEY `idx_status` (`status`),
KEY `idx_project_machine` (`project_id`,`machine_id`,`status`),
KEY `idx_card_id` (`card_id`),
KEY `idx_last_online` (`last_online_at`),
KEY `idx_deleted_at` (`deleted_at`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='安装记录表';
-- ============================================
-- 项目版本/安装包表
-- ============================================
CREATE TABLE IF NOT EXISTS `ca_project_versions` (
`id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
`project_id` BIGINT UNSIGNED NOT NULL COMMENT '所属项目ID',
`version` VARCHAR(50) NOT NULL COMMENT '版本号(如 1.2.0)',
`file_name` VARCHAR(255) NOT NULL COMMENT '原始文件名',
`file_path` VARCHAR(500) NOT NULL COMMENT '存储路径(相对public)',
`file_size` BIGINT UNSIGNED NOT NULL DEFAULT 0 COMMENT '文件大小(字节)',
`checksum` VARCHAR(64) DEFAULT '' COMMENT 'SHA256',
`changelog` TEXT DEFAULT NULL COMMENT '更新说明',
`min_client_version` VARCHAR(50) DEFAULT '' COMMENT '强制更新最低版本(可空)',
`is_force` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '是否强制推送: 0=否, 1=是',
`is_latest` TINYINT(1) NOT NULL DEFAULT 1 COMMENT '是否最新版本',
`download_count` INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '下载次数',
`status` TINYINT(1) NOT NULL DEFAULT 1 COMMENT '状态: 0=禁用, 1=正常',
`created_by` BIGINT UNSIGNED NOT NULL DEFAULT 0 COMMENT '发布人ID',
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
`updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (`id`),
UNIQUE KEY `uk_project_version` (`project_id`,`version`),
KEY `idx_project_id` (`project_id`),
KEY `idx_is_latest` (`project_id`,`is_latest`,`status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='项目版本/安装包表';
+60 -2
View File
@@ -5,6 +5,8 @@
-- 字符集: utf8mb4
-- ============================================
SET NAMES utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE DATABASE IF NOT EXISTS `card_auth` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE `card_auth`;
@@ -279,7 +281,7 @@ CREATE TABLE `ca_coupons` (
-- 初始化超级管理员 (密码: admin123456)
INSERT INTO `ca_users` (`username`, `password`, `nickname`, `role`, `status`) VALUES
('admin', '$2y$12$LJ3m4ys3OoMJ8zKR0gVNNe5hHOqFh0VhJmKqxXkGgFMfGZqXsQHqK', '超级管理员', 'admin', 1);
('admin', '$2y$10$5IZyJdCtuVQ0O7fIzeXgbOa8rOi2kkHBYmEiA4Z/UyKxK.dgBXZLO', '超级管理员', 'admin', 1);
-- 初始化演示项目
INSERT INTO `ca_projects` (`name`, `description`, `api_key`, `status`) VALUES
@@ -328,4 +330,60 @@ INSERT INTO `ca_configs` (`key`, `value`, `description`) VALUES
('smtp_from_email', '', '发件人邮箱'),
('smtp_from_name', 'CardAuth', '发件人名称'),
('smtp_enabled', '0', '是否启用邮件通知(1=启用,0=禁用)'),
('smtp_expire_days', '7', '到期前N天发送提醒邮件');
('smtp_expire_days', '7', '到期前N天发送提醒邮件');
-- ============================================
-- 12. 安装记录表
-- ============================================
DROP TABLE IF EXISTS `ca_installations`;
CREATE TABLE `ca_installations` (
`id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
`project_id` BIGINT UNSIGNED NOT NULL COMMENT '所属项目ID',
`card_id` BIGINT UNSIGNED DEFAULT NULL COMMENT '关联卡密ID(可空)',
`card_key` VARCHAR(64) DEFAULT '' COMMENT '卡密(冗余,便于查询)',
`machine_id` VARCHAR(128) NOT NULL COMMENT '机器指纹',
`ip` VARCHAR(45) DEFAULT '' COMMENT '最后IP',
`device_info` TEXT DEFAULT NULL COMMENT '设备信息',
`client_version` VARCHAR(50) DEFAULT '' COMMENT '客户端版本',
`status` ENUM('active','deleted') NOT NULL DEFAULT 'active' COMMENT '状态: active=存活, deleted=已删除',
`install_count` INT UNSIGNED NOT NULL DEFAULT 1 COMMENT '该机器累计激活次数',
`last_online_at` DATETIME DEFAULT NULL COMMENT '最后上线时间',
`installed_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '安装时间',
`deleted_at` DATETIME DEFAULT NULL COMMENT '删除时间',
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
`updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (`id`),
KEY `idx_project_id` (`project_id`),
KEY `idx_status` (`status`),
KEY `idx_project_machine` (`project_id`,`machine_id`,`status`),
KEY `idx_card_id` (`card_id`),
KEY `idx_last_online` (`last_online_at`),
KEY `idx_deleted_at` (`deleted_at`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='安装记录表';
-- ============================================
-- 13. 项目版本/安装包表
-- ============================================
DROP TABLE IF EXISTS `ca_project_versions`;
CREATE TABLE `ca_project_versions` (
`id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
`project_id` BIGINT UNSIGNED NOT NULL COMMENT '所属项目ID',
`version` VARCHAR(50) NOT NULL COMMENT '版本号(如 1.2.0)',
`file_name` VARCHAR(255) NOT NULL COMMENT '原始文件名',
`file_path` VARCHAR(500) NOT NULL COMMENT '存储路径(相对public)',
`file_size` BIGINT UNSIGNED NOT NULL DEFAULT 0 COMMENT '文件大小(字节)',
`checksum` VARCHAR(64) DEFAULT '' COMMENT 'SHA256',
`changelog` TEXT DEFAULT NULL COMMENT '更新说明',
`min_client_version` VARCHAR(50) DEFAULT '' COMMENT '强制更新最低版本(可空)',
`is_force` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '是否强制推送: 0=否, 1=是',
`is_latest` TINYINT(1) NOT NULL DEFAULT 1 COMMENT '是否最新版本',
`download_count` INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '下载次数',
`status` TINYINT(1) NOT NULL DEFAULT 1 COMMENT '状态: 0=禁用, 1=正常',
`created_by` BIGINT UNSIGNED NOT NULL DEFAULT 0 COMMENT '发布人ID',
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
`updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (`id`),
UNIQUE KEY `uk_project_version` (`project_id`,`version`),
KEY `idx_project_id` (`project_id`),
KEY `idx_is_latest` (`project_id`,`is_latest`,`status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='项目版本/安装包表';