1

api/controller_front/version.js

@@ -0,0 +1,198 @@
+const Framework = require("../../framework/node-core-framework.js");
+const version_service = require('../services/version_service.js');
+const config = require('../../config/config.js');
+
+/**
+ * 版本管理控制器
+ * 提供版本检查、版本管理等功能
+ */
+module.exports = {
+  /**
+   * @swagger
+   * /api/version/check:
+   *   get:
+   *     summary: 检查是否有新版本
+   *     description: 根据当前版本号、平台和架构检查是否有可用更新
+   *     tags: [前端-版本管理]
+   *     parameters:
+   *       - in: query
+   *         name: current_version
+   *         required: true
+   *         schema:
+   *           type: string
+   *           pattern: '^\d+\.\d+\.\d+$'
+   *         description: 当前版本号（x.y.z 格式，如 1.0.0）
+   *         example: '1.0.0'
+   *       - in: query
+   *         name: platform
+   *         required: true
+   *         schema:
+   *           type: string
+   *           enum: [win32, darwin, linux]
+   *         description: 平台类型
+   *         example: 'win32'
+   *       - in: query
+   *         name: arch
+   *         required: true
+   *         schema:
+   *           type: string
+   *           enum: [x64, ia32, arm64]
+   *         description: 架构类型
+   *         example: 'x64'
+   *       - in: query
+   *         name: sn_code
+   *         required: false
+   *         schema:
+   *           type: string
+   *         description: 设备序列号（可选，用于权限控制）
+   *         example: 'GHJU'
+   *     responses:
+   *       200:
+   *         description: 检查成功
+   *         content:
+   *           application/json:
+   *             schema:
+   *               type: object
+   *               properties:
+   *                 code:
+   *                   type: integer
+   *                   description: 状态码，0表示成功
+   *                   example: 0
+   *                 message:
+   *                   type: string
+   *                   description: 响应消息
+   *                   example: 'success'
+   *                 data:
+   *                   type: object
+   *                   nullable: true
+   *                   description: 版本信息，null表示已是最新版本
+   *                   properties:
+   *                     version:
+   *                       type: string
+   *                       description: 最新版本号
+   *                       example: '1.1.0'
+   *                     download_url:
+   *                       type: string
+   *                       description: 下载地址
+   *                       example: 'http://work.light120.com/downloads/app-1.1.0.exe'
+   *                     release_notes:
+   *                       type: string
+   *                       description: 更新日志
+   *                       example: '修复了一些bug，新增了xxx功能'
+   *                     force_update:
+   *                       type: boolean
+   *                       description: 是否强制更新
+   *                       example: false
+   *                     file_size:
+   *                       type: integer
+   *                       description: 文件大小（字节）
+   *                       example: 52428800
+   *                     file_hash:
+   *                       type: string
+   *                       description: SHA256 哈希值
+   *                       example: 'abc123def456...'
+   *       400:
+   *         description: 参数错误
+   *         content:
+   *           application/json:
+   *             schema:
+   *               type: object
+   *               properties:
+   *                 code:
+   *                   type: integer
+   *                   example: 400
+   *                 message:
+   *                   type: string
+   *                   example: '缺少必要参数：current_version'
+   *       500:
+   *         description: 服务器错误
+   */
+  'GET /version/check': async (ctx) => {
+    try {
+      // 获取请求参数
+      const query = ctx.query || {};
+      const current_version = query.current_version;
+      const platform = query.platform;
+      const arch = query.arch;
+      const sn_code = query.sn_code; // 可选，用于权限控制
+
+      // 参数验证
+      if (!current_version) {
+        return ctx.fail('缺少必要参数：current_version', 400);
+      }
+      if (!platform) {
+        return ctx.fail('缺少必要参数：platform', 400);
+      }
+      if (!arch) {
+        return ctx.fail('缺少必要参数：arch', 400);
+      }
+
+      // 验证版本号格式
+      if (!version_service.is_valid_version(current_version)) {
+        return ctx.fail('版本号格式错误，应为 x.y.z 格式', 400);
+      }
+
+      // 验证平台类型
+      if (!version_service.is_valid_platform(platform)) {
+        return ctx.fail('平台类型错误，应为 win32/darwin/linux', 400);
+      }
+
+      // 验证架构类型
+      if (!version_service.is_valid_arch(arch)) {
+        return ctx.fail('架构类型错误，应为 x64/ia32/arm64', 400);
+      }
+
+      // 获取模型
+      const { version_info } = Framework.getModels();
+
+      // 查询所有启用状态的版本（按 platform + arch + status=1）
+      const all_versions = await version_info.findAll({
+        where: {
+          platform: platform,
+          arch: arch,
+          status: 1
+        }
+      });
+
+      // 如果没有找到版本信息
+      if (!all_versions || all_versions.length === 0) {
+        return ctx.success(null, '未找到该平台的版本信息');
+      }
+
+      // 按版本号排序（降序）
+      all_versions.sort((a, b) => {
+        return version_service.compare_version(b.version, a.version);
+      });
+
+      const latest = all_versions[0];
+      if (!latest) {
+        return ctx.success(null, '已是最新版本');
+      }
+
+      // 比较版本
+      const has_update = version_service.has_new_version(current_version, latest.version);
+
+      // 如果没有更新
+      if (!has_update) {
+        return ctx.success(null, '已是最新版本');
+      }
+
+      // 构建返回数据
+      const result = {
+        version: latest.version,
+        download_url: latest.download_url,
+        release_notes: latest.release_notes || '',
+        force_update: latest.force_update === 1,
+        file_size: latest.file_size || 0,
+        file_hash: latest.file_hash || ''
+      };
+
+      return ctx.success(result, 'success');
+
+    } catch (error) {
+      console.error('版本检查错误:', error);
+      return ctx.fail('服务器错误', 500);
+    }
+  }
+};
+