5.6 KiB
当前页面说明
页面定位
当前系统只有一个实际业务页面，即“设备激活”页面。
页面对应代码：
frontend/src/views/activate/index.vuefrontend/src/views/activate/ActiveForm.vue
该页面同时承担两类职责：
- 激活码生成
- 激活记录管理
也就是说，它不是单纯的录入页，而是把“生成新激活码”和“查询历史激活记录”放在一个界面中完成。
页面结构
从界面结构上看，当前页面可以分成 3 个区域：
- 激活记录查询区
- 激活记录列表区
- 设备激活弹窗区
1. 激活记录查询区
页面顶部是激活记录查询区，用于筛选本地数据库中的历史记录。
包含以下控件：
-
macAddress输入框- 用于按设备 MAC 地址筛选记录
-
激活模块多选框
- 用于按模块筛选记录
- 支持多选
- 当前可选模块：
simulatedigitalcontrast
-
查询按钮
- 按当前条件查询本地 SQLite 中的激活记录
-
重置按钮
- 清空查询条件
- 清空后重新查询全部记录
该区域的作用是帮助用户快速定位某台设备、某类模块，或直接查看全部历史记录。
2. 激活记录列表区
查询区下方是激活记录列表区，用于展示本地数据库中的激活历史。
当前列表字段如下：
-
applicant- 申请方
-
macAddress- 设备 MAC 地址
-
applicationCode- 设备申请码
- 长内容以省略形式展示
-
module- 当前记录对应的激活模块
- 界面中会拆分为标签显示
-
activationCode- 最终生成的激活码
- 长内容以省略形式展示
-
createTime- 记录生成时间
-
remark- 备注信息
-
action- 当前提供“复制激活码”和“删除”操作
列表区支持的功能：
- 展示本地全部或筛选后的激活记录
- 分页显示，当前每页 10 条
- 无数据时显示空状态
- 直接复制某条历史记录中的激活码
- 删除单条历史记录
列表上方工具区还提供 3 个批量操作：
-
备份数据
- 将当前本地激活记录导出为 JSON 备份文件
-
导入备份
- 选择之前导出的 JSON 备份文件
- 导入时会先清空当前数据，再恢复备份内容
-
清空数据
- 一次性删除本地全部激活记录
该区域主要用于“查历史”和“复用历史结果”，避免重复生成。
3. 设备激活弹窗区
列表区上方提供“设备激活”按钮，点击后打开激活弹窗。
这个弹窗是当前页面的核心操作区，用于生成新的激活码并保存到本地数据库。
3.1 RSA 密钥配置区
该区域是否显示，由环境变量 VITE_RSA_CAN_EDIT 控制。
如果开启，则会显示：
- RSA 公钥文本框
- RSA 私钥文本框
- 复制公钥按钮
- 复制私钥按钮
当前默认配置为不显示该区域。
3.2 激活模块选择区
用户可以通过 3 个开关选择需要激活的模块：
- 模拟模式模块
simulate - 数字模式模块
digital - 对比模式模块
contrast
生成激活码前，至少要选择一个模块，否则页面会提示错误。
3.3 申请方输入区
用户可以录入本次激活记录的申请方。
该字段当前用于：
- 标识该条激活记录属于谁
- 辅助后续在历史列表中识别记录来源
申请方不是生成激活码的必要条件，但会和激活记录一起保存到本地数据库。
3.4 设备申请码输入区
用户在这里输入或粘贴设备申请码。
这是生成激活码的前提条件，当前规则包括：
- 不能为空
- 必须能被当前 RSA 私钥正确解密
- 解密结果中必须包含
macAddress
如果申请码无效，页面会提示错误并终止生成。
3.5 设备激活码展示区
当模块选择和申请码校验通过后，用户可以点击“生成激活码”。
生成成功后：
- 激活码显示在只读文本框中
- 用户可以点击“复制激活码”直接复制结果
这里展示的是最终输出内容，也是后续保存到数据库中的核心字段。
3.6 备注区
用户可以输入备注信息。
当前限制：
- 最长 120 个字符
备注会随激活记录一起保存，方便后续查询和识别用途。
3.7 弹窗底部操作区
弹窗底部有两个按钮：
-
保存
- 前提是必须已经生成激活码
- 点击后将本次数据写入本地 SQLite
- 保存成功后关闭弹窗，并刷新主页面列表
-
关闭
- 直接关闭弹窗
- 不保存当前内容
页面操作流程
从用户视角，当前页面的典型使用流程如下：
- 进入“设备激活”页面。
- 点击“设备激活”按钮，打开激活弹窗。
- 选择一个或多个需要激活的模块。
- 录入申请方。
- 输入设备申请码。
- 点击“生成激活码”。
- 生成成功后查看或复制激活码。
- 如有需要，填写备注。
- 点击“保存”，将数据写入本地数据库。
- 返回主页面后，在历史列表中查看新记录。
- 后续如需再次使用，可直接从列表复制历史激活码。
- 如有需要，可手动备份当前数据，或在清空后通过备份文件恢复。
页面价值总结
当前页面虽然只有一个，但已经覆盖完整核心业务流程：
- 录入申请方
- 输入申请码
- 选择激活模块
- 生成激活码
- 保存激活记录
- 查询历史记录
- 复制历史激活码
- 删除历史记录
- 备份本地数据
- 导入备份恢复数据
因此，这个页面本质上是一个“激活工具 + 本地记录管理工具”的组合界面。