Files
ccdi/assets/implementation/scripts/README.md

136 lines
4.3 KiB
Markdown
Raw Normal View History

2026-01-29 22:03:42 +08:00
# 中介黑名单弹窗优化功能测试
## 测试概述
本测试套件用于验证中介黑名单弹窗优化后的功能正确性,主要包括:
1. **新增模式交互**:验证类型选择卡片的用户体验
2. **表单验证**:验证个人/机构类型的字段验证规则
3. **数据同步**:验证机构类型证件号与统一社会信用代码的同步
4. **修改模式锁定**:验证修改时类型不可更改
5. **边界情况处理**:验证各种异常输入的处理
## 运行测试
### 前置条件
1. 后端服务已启动(默认 `http://localhost:8080`
2. 测试账号可用(`admin/admin123`
3. 已安装 Node.js
### 安装依赖
```bash
cd doc/scripts
npm install
```
### 执行测试
```bash
# 直接运行测试(输出到控制台)
npm test
# 运行测试并生成报告文件
npm run test:report
# 或者直接使用 Node.js
node test_intermediary_dialog.js
```
## 测试用例说明
2026-03-03 16:14:16 +08:00
| 测试编号 | 测试名称 | 测试目标 | 预期结果 |
|------|---------------|------------------|-----------|
| 1 | 登录系统 | 获取认证Token | 成功获取Token |
| 2 | 新增个人中介-必填字段 | 验证姓名和证件号必填 | 缺少必填项时被拒绝 |
| 3 | 新增个人中介-字段长度 | 验证字段长度限制 | 超长时被拒绝 |
| 4 | 新增机构中介-证件号同步 | 验证证件号同步到统一社会信用代码 | 两字段值一致 |
| 5 | 新增机构中介-信用代码长度 | 验证统一社会信用代码长度 | 前端限制18位 |
| 6 | 修改个人中介-类型锁定 | 验证修改时类型不可更改 | 类型字段保持不变 |
| 7 | 修改机构中介-类型锁定 | 验证修改时类型不可更改 | 类型字段保持不变 |
| 8 | 新增无类型 | 验证未选择类型无法提交 | 后端拒绝请求 |
| 9 | 查询列表 | 验证数据正确性 | 返回正确的类型分布 |
2026-01-29 22:03:42 +08:00
## 测试报告示例
```
==============================================================
测试1登录系统
==============================================================
✓ 通过 - 登录成功
Token: eyJhbGciOiJIUzUxMiJ9...
==============================================================
测试2新增个人中介 - 验证必填字段
==============================================================
✓ 通过 - 空姓名
应该被拒绝
✓ 通过 - 空证件号
应该被拒绝
✓ 通过 - 完整必填字段
成功创建ID: 123
...
```
## 功能验证清单
### 前端交互验证
- [ ] 点击新增后显示类型选择卡片
- [ ] 卡片有 hover 效果
- [ ] 点击卡片后表单展开带淡入动画
- [ ] 点击卡片后表单不立即显示验证错误
- [ ] 未选择类型时确定按钮被禁用
- [ ] 个人类型表单显示正确的字段
- [ ] 机构类型表单显示正确的字段
- [ ] 个人类型证件号字段显示正确的占位符:"请输入证件号码"
- [ ] 机构类型证件号字段显示正确的占位符:"统一社会信用代码18位"
- [ ] 证件号输入框后无提示图标
### 表单验证验证
- [ ] 个人类型姓名必填验证
- [ ] 个人类型证件号必填验证
- [ ] 机构类型名称必填验证
- [ ] 机构类型证件号必填验证
- [ ] 机构类型证件号长度限制18位
- [ ] 备注字段长度限制500字符
### 数据同步验证
- [ ] 机构类型输入证件号后自动同步到统一社会信用代码
- [ ] 提交时两个字段值一致
### 修改模式验证
- [ ] 修改时直接显示对应类型表单
- [ ] 修改时不显示类型选择器
- [ ] 修改时类型字段不可更改
## 故障排查
### 测试失败常见原因
1. **后端服务未启动**
2026-03-03 16:14:16 +08:00
- 检查 `http://localhost:8080` 是否可访问
- 检查后端日志是否有错误
2026-01-29 22:03:42 +08:00
2. **认证失败**
2026-03-03 16:14:16 +08:00
- 确认测试账号密码正确
- 检查后端是否启用了认证
2026-01-29 22:03:42 +08:00
3. **端口冲突**
2026-03-03 16:14:16 +08:00
- 修改 `CONFIG.baseURL` 为实际后端地址
2026-01-29 22:03:42 +08:00
4. **依赖缺失**
2026-03-03 16:14:16 +08:00
- 运行 `npm install` 安装依赖
2026-01-29 22:03:42 +08:00
## 注意事项
1. 测试会创建真实数据,测试结束后会自动清理
2. 请勿在生产环境运行测试
3. 如需修改测试数据,编辑 `CONFIG` 对象
4. 测试报告会保存在 `test_report.txt` 文件中