- 功能: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 - 部署说明
84 lines
2.0 KiB
Markdown
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 设置页面
|
|
- [ ] 可以查看凭证列表
|
|
- [ ] 可以添加新凭证
|
|
- [ ] 可以编辑凭证
|
|
- [ ] 可以删除凭证
|
|
- [ ] 可以测试凭证连接
|
|
- [ ] 可以批量测试凭证
|