enterprise-saa-s-dashboard-design/TEST_LICENSE.md

授权文件功能测试指南

前置准备

1. 确保已启动开发服务器：npm run dev
2. 确保数据库中已有以下数据：
   • 至少一个设备型号（如 GD-30 Supreme）
   • 至少一个配置文件
   • 至少一个设备（用于测试下载接口）

测试步骤

1. 创建授权记录

方式一：通过管理界面

1. 访问 http://localhost:3000/licenses
2. 点击"选择授权项"按钮
3. 选择设备型号、授权模块和到期时间
4. 点击保存，系统会自动生成授权文件JSON

方式二：通过API

curl -X POST http://localhost:3000/api/licenses \
  -H "Content-Type: application/json" \
  -d '{
    "model": "GD-30",
    "modules": "一维自电/电阻率/激电测试模块, 二维自电/电阻率/激电测试模块, 三维自电/电阻率/激电测试模块",
    "expiry": "2027-04-30",
    "status": "生效",
    "config_id": 1
  }'

2. 预览授权文件

1. 在授权管理页面找到刚创建的授权记录
2. 点击"预览"按钮
3. 查看生成的JSON格式授权文件
4. 可以点击下载JSON按钮保存到本地

3. 下载授权文件

1. 在授权管理页面点击"下载"按钮
2. 文件将以 license_GD-30_1.json 格式下载

4. 测试手机APP下载接口 ⭐

首先需要创建一个测试设备：

# 创建设备（如果还没有的话）
curl -X POST http://localhost:3000/api/devices \
  -H "Content-Type: application/json" \
  -d '{
    "sn": "GD30-TEST-001",
    "model": "GD-30 Supreme",
    "type": "电法仪",
    "status": "装配中",
    "production_date": "2026-04-30"
  }'

然后测试下载接口：

# 方式一：使用curl
curl "http://localhost:3000/api/licenses/download?sn=GD30-TEST-001"

# 方式二：使用浏览器直接访问
# 打开浏览器访问：http://localhost:3000/api/licenses/download?sn=GD30-TEST-001

# 方式三：使用JavaScript
fetch('http://localhost:3000/api/licenses/download?sn=GD30-TEST-001')
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err))

预期响应：

{
  "version": "1.0",
  "generatedAt": "2026-04-30T16:00:00.000Z",
  "deviceModel": "GD-30 Supreme",
  "deviceSN": "GD30-TEST-001",
  "validUntil": "2027-04-30",
  "status": "active",
  "authModules": [
    {
      "id": "1D",
      "name": "一维自电/电阻率/激电测试模块",
      "category": "一维",
      "enabled": true
    },
    ...
  ],
  "config": {
    "name": "...",
    "version": "...",
    "emissionParams": {...},
    "acquisitionParams": {...},
    "networkParams": {...}
  },
  "signature": {
    "algorithm": "SHA256",
    "value": "...",
    "publicKey": "platform-public-key-placeholder"
  }
}

5. 测试错误情况

测试设备不存在：

curl "http://localhost:3000/api/licenses/download?sn=NONEXIST-001"
# 应返回：{"error": "设备不存在"}

测试无授权的设备：

# 先创建一个没有授权的设备
curl -X POST http://localhost:3000/api/devices \
  -H "Content-Type: application/json" \
  -d '{
    "sn": "GD30-NO-LICENSE-001",
    "model": "GD-30 Supreme",
    "type": "电法仪",
    "status": "装配中",
    "production_date": "2026-04-30"
  }'

# 然后尝试获取授权
curl "http://localhost:3000/api/licenses/download?sn=GD30-NO-LICENSE-001"
# 应返回：{"error": "该设备暂无有效授权", ...}

6. 验证签名

可以使用以下Node.js脚本验证授权文件签名：

const crypto = require('crypto');

function verifyLicense(licenseJson) {
  const license = typeof licenseJson === 'string' ? JSON.parse(licenseJson) : licenseJson;
  const { signature, ...dataWithoutSig } = license;
  
  const jsonString = JSON.stringify(dataWithoutSig, null, 2);
  const calculatedHash = crypto.createHash('sha256').update(jsonString).digest('hex');
  
  return calculatedHash === signature.value;
}

// 测试
fetch('http://localhost:3000/api/licenses/download?sn=GD30-TEST-001')
  .then(res => res.json())
  .then(license => {
    const isValid = verifyLicense(license);
    console.log('签名验证结果:', isValid ? '✅ 通过' : '❌ 失败');
  });

7. 查看下载日志

# 可以直接查询数据库查看下载记录
sqlite3 data/app.db "SELECT * FROM license_download_logs ORDER BY id DESC LIMIT 10;"

或在SQLite浏览器中打开 data/app.db 查看 license_download_logs 表。

常见问题

Q1: 下载接口返回404？

• 检查设备SN是否正确
• 确认该设备型号有有效的授权记录
• 检查授权状态是否为"生效"且未过期

Q2: 授权文件中config为空？

• 确保已为该设备型号创建了配置文件
• 配置文件状态需要是"生效"

Q3: 如何区分设备级授权和型号级授权？

• 设备级授权：device_sn 字段有值
• 型号级授权：device_sn 字段为空
• 下载时优先匹配设备级授权

Q4: 授权文件何时重新生成？

• 创建新授权时自动生成
• 更新授权信息时自动重新生成
• 首次下载时如果license_file为空会生成并保存

性能优化建议

1. 缓存策略：授权文件生成后保存在数据库中，避免重复生成
2. 索引优化：为licenses表的device_sn、model、status字段添加索引
3. 日志清理：定期清理过期的下载日志
4. CDN加速：生产环境可以考虑将授权文件缓存到CDN

下一步开发建议

1. 前端增强：

   • 在设备详情页显示授权状态
   • 添加授权文件批量导出功能
   • 显示授权下载统计

2. 安全增强：

   • 实现真实的RSA签名（目前使用SHA256占位）
   • 添加授权文件加密
   • 实现授权文件版本控制

3. 功能扩展：

   • 支持授权模板批量应用
   • 添加授权到期提醒
   • 实现授权历史记录

4. 监控告警：

   • 监控授权下载次数
   • 异常下载行为检测
   • 授权即将到期预警