# 当前页面说明

## 页面定位

当前系统只有一个实际业务页面，即“设备激活”页面。

页面对应代码：

- `frontend/src/views/activate/index.vue`
- `frontend/src/views/activate/ActiveForm.vue`

该页面同时承担两类职责：

- 激活码生成
- 激活记录管理

也就是说，它不是单纯的录入页，而是把“生成新激活码”和“查询历史激活记录”放在一个界面中完成。

## 页面结构

从界面结构上看，当前页面可以分成 3 个区域：

1. 激活记录查询区
2. 激活记录列表区
3. 设备激活弹窗区

## 1. 激活记录查询区

页面顶部是激活记录查询区，用于筛选本地数据库中的历史记录。

包含以下控件：

- `macAddress` 输入框
  - 用于按设备 MAC 地址筛选记录

- 激活模块多选框
  - 用于按模块筛选记录
  - 支持多选
  - 当前可选模块：
  - `simulate`
  - `digital`
  - `contrast`

- 查询按钮
  - 按当前条件查询本地 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
  - 保存成功后关闭弹窗，并刷新主页面列表

- 关闭
  - 直接关闭弹窗
  - 不保存当前内容

## 页面操作流程

从用户视角，当前页面的典型使用流程如下：

1. 进入“设备激活”页面。
2. 点击“设备激活”按钮，打开激活弹窗。
3. 选择一个或多个需要激活的模块。
4. 录入申请方。
5. 输入设备申请码。
6. 点击“生成激活码”。
7. 生成成功后查看或复制激活码。
8. 如有需要，填写备注。
9. 点击“保存”，将数据写入本地数据库。
10. 返回主页面后，在历史列表中查看新记录。
11. 后续如需再次使用，可直接从列表复制历史激活码。
12. 如有需要，可手动备份当前数据，或在清空后通过备份文件恢复。

## 页面价值总结

当前页面虽然只有一个，但已经覆盖完整核心业务流程：

- 录入申请方
- 输入申请码
- 选择激活模块
- 生成激活码
- 保存激活记录
- 查询历史记录
- 复制历史激活码
- 删除历史记录
- 备份本地数据
- 导入备份恢复数据

因此，这个页面本质上是一个“激活工具 + 本地记录管理工具”的组合界面。