admin/AMT_CREDENTIAL_FEATURE.md
lvfengfree fd124d1017 feat: 添加AMT批量管理凭证功能
- 功能:AMT凭证的增删改查管理
- 支持设置默认凭证
- 支持单个和批量测试凭证连接
- 数据库表:amt_credential
- 后端:
  * AmtCredential实体类
  * AmtCredentialMapper
  * AmtCredentialService业务逻辑
  * AmtCredentialController控制器
  * 使用Result统一返回格式
- 前端:
  * AMT设置页面重构
  * 凭证列表展示(分页、搜索)
  * 添加/编辑凭证弹窗
  * 批量测试功能
  * API接口封装
- 部署脚本:
  * init_amt_credential_table.bat - 初始化数据库
  * test_amt_api.bat - 测试API接口
  * rebuild_and_start_backend.bat - 重新编译后端
- 文档:
  * AMT_CREDENTIAL_FEATURE.md - 功能说明
  * DEPLOY_AMT_FEATURE.md - 部署说明
2026-03-01 10:55:11 +08:00

172 lines
4.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# AMT 批量管理凭证功能
## 功能概述
在"系统设置 > AMT设置"页面添加了 AMT 批量管理凭证功能,用于管理 Intel AMT 设备的登录凭证。
## 主要功能
### 1. 凭证管理
- ✅ 添加凭证:创建新的 AMT 登录凭证
- ✅ 编辑凭证:修改现有凭证信息
- ✅ 删除凭证:删除不需要的凭证(默认凭证不可删除)
- ✅ 设为默认:将凭证设置为默认凭证(优先用于新设备)
### 2. 凭证测试
- ✅ 单个测试:测试单个凭证的连接状态
- ✅ 批量测试:批量测试多个凭证的连接状态
### 3. 凭证信息
- 凭证名称:便于识别的名称
- 用户名AMT 登录用户名
- 密码AMT 登录密码(加密存储)
- 描述:凭证的详细说明
- 默认标记:是否为默认凭证
- 状态:启用/禁用
## 技术实现
### 后端
#### 数据库表
- `amt_credential` - AMT 凭证管理表
- 字段credential_id, credential_name, username, password, description, is_default, status, created_by, created_time, updated_time
#### Java 类
- `AmtCredential.java` - 实体类
- `AmtCredentialMapper.java` - MyBatis Mapper
- `AmtCredentialDTO.java` - 数据传输对象
- `AmtCredentialService.java` - 业务逻辑层
- `AmtCredentialController.java` - 控制器层
#### API 接口
- `GET /api/amt/credential/list` - 分页查询凭证列表
- `GET /api/amt/credential/all` - 获取所有启用的凭证
- `GET /api/amt/credential/{id}` - 根据ID获取凭证
- `POST /api/amt/credential` - 创建凭证
- `PUT /api/amt/credential/{id}` - 更新凭证
- `DELETE /api/amt/credential/{id}` - 删除凭证
- `PUT /api/amt/credential/{id}/default` - 设置默认凭证
- `POST /api/amt/credential/{id}/test` - 测试凭证连接
- `POST /api/amt/credential/batch-test` - 批量测试凭证
### 前端
#### 文件
- `src/views/system/amt/index.vue` - AMT 设置页面
- `src/service/api/amt.ts` - AMT API 接口
#### 功能特性
- 数据表格展示凭证列表
- 分页、搜索、筛选
- 添加/编辑凭证弹窗
- 批量选择和批量测试
- 实时状态显示
## 安装步骤
### 1. 初始化数据库表
运行批处理脚本:
```bash
init_amt_credential_table.bat
```
或手动执行 SQL
```bash
mysql -uroot -proot -hlocalhost -P3306 < backend/src/main/resources/sql/create_amt_credential_table.sql
```
### 2. 重启后端服务
```bash
cd backend
mvn spring-boot:run
```
或使用批处理脚本:
```bash
restart_backend_and_test.bat
```
### 3. 访问页面
登录系统后,访问:系统设置 > AMT设置
## 使用说明
### 添加凭证
1. 点击"添加凭证"按钮
2. 填写凭证信息:
- 凭证名称(必填)
- 用户名(必填)
- 密码(必填)
- 描述(可选)
- 是否设为默认
- 状态(启用/禁用)
3. 点击"确定"保存
### 测试凭证
1. 单个测试:点击凭证行的"测试"按钮
2. 批量测试:
- 勾选要测试的凭证
- 点击"批量测试"按钮
- 查看测试结果
### 设置默认凭证
1. 点击凭证行的"设为默认"按钮
2. 系统会自动取消其他凭证的默认状态
3. 默认凭证将优先用于新设备
### 编辑凭证
1. 点击凭证行的"编辑"按钮
2. 修改凭证信息
3. 点击"确定"保存
### 删除凭证
1. 点击凭证行的"删除"按钮
2. 确认删除操作
3. 注意:默认凭证不能删除
## 注意事项
1. **密码安全**:密码在数据库中应该加密存储(当前为明文,建议后续加密)
2. **默认凭证**:系统只能有一个默认凭证
3. **凭证测试**:当前为模拟测试,实际使用时需要集成 AMT SDK
4. **权限控制**:建议只有管理员角色可以访问此功能
## 后续优化建议
1. **密码加密**:使用 AES 或 RSA 加密存储密码
2. **AMT SDK 集成**:集成真实的 AMT SDK 进行连接测试
3. **凭证应用**:将凭证应用到具体设备
4. **操作日志**:记录凭证的创建、修改、删除操作
5. **批量导入**:支持从 CSV/Excel 批量导入凭证
6. **凭证分组**:支持凭证分组管理
## 文件清单
### 后端文件
- `backend/src/main/resources/sql/create_amt_credential_table.sql`
- `backend/src/main/java/com/soybean/admin/entity/AmtCredential.java`
- `backend/src/main/java/com/soybean/admin/mapper/AmtCredentialMapper.java`
- `backend/src/main/java/com/soybean/admin/dto/AmtCredentialDTO.java`
- `backend/src/main/java/com/soybean/admin/service/AmtCredentialService.java`
- `backend/src/main/java/com/soybean/admin/controller/AmtCredentialController.java`
### 前端文件
- `src/views/system/amt/index.vue`
- `src/service/api/amt.ts`
- `src/service/api/index.ts` (更新)
### 脚本文件
- `init_amt_credential_table.bat`
## 测试建议
1. 测试添加凭证功能
2. 测试编辑凭证功能
3. 测试删除凭证功能
4. 测试设置默认凭证功能
5. 测试单个凭证连接
6. 测试批量凭证连接
7. 测试分页和搜索功能
8. 测试表单验证