admin/DEPLOY_AMT_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

84 lines
2.0 KiB
Markdown

# AMT 凭证功能部署说明
## 问题修复
修复了 404 错误,主要问题:
1. ✅ 控制器返回格式不统一 - 已改用 `Result`
2. ✅ 返回代码不匹配 - 已改为 `"0000"`
3. ✅ API 路径前缀问题 - 已移除 `/api` 前缀
## 部署步骤
### 1. 初始化数据库表
```bash
init_amt_credential_table.bat
```
### 2. 重启后端服务
停止当前后端服务,然后重新启动:
```bash
cd backend
mvn spring-boot:run
```
或使用批处理脚本:
```bash
start_backend.bat
```
### 3. 清除浏览器缓存
`Ctrl + Shift + Delete` 清除浏览器缓存
### 4. 访问页面
登录系统后,访问:**系统设置 > AMT设置**
## API 端点
所有 API 端点(无需 `/api` 前缀):
- `GET /amt/credential/list` - 分页查询凭证列表
- `GET /amt/credential/all` - 获取所有启用的凭证
- `GET /amt/credential/{id}` - 根据ID获取凭证
- `POST /amt/credential` - 创建凭证
- `PUT /amt/credential/{id}` - 更新凭证
- `DELETE /amt/credential/{id}` - 删除凭证
- `PUT /amt/credential/{id}/default` - 设置默认凭证
- `POST /amt/credential/{id}/test` - 测试凭证连接
- `POST /amt/credential/batch-test` - 批量测试凭证
## 测试 API
运行测试脚本:
```bash
test_amt_api.bat
```
或手动测试:
```bash
curl -X GET "http://localhost:8080/amt/credential/list?page=1&size=10"
```
## 常见问题
### Q: 仍然显示 404 错误
A: 确保后端服务已重启,并且数据库表已创建
### Q: 返回数据格式错误
A: 检查后端是否使用了最新的代码(使用 Result 类)
### Q: 无法创建凭证
A: 检查数据库连接和表结构是否正确
## 验证清单
- [ ] 数据库表 `amt_credential` 已创建
- [ ] 后端服务已重启
- [ ] 浏览器缓存已清除
- [ ] 可以访问 AMT 设置页面
- [ ] 可以查看凭证列表
- [ ] 可以添加新凭证
- [ ] 可以编辑凭证
- [ ] 可以删除凭证
- [ ] 可以测试凭证连接
- [ ] 可以批量测试凭证