wkc
e0ce344d09
## 新增文件 ### 测试脚本 (Task 11) - doc/scripts/test-intermediary-api.sh: 完整的API自动化测试脚本 * 获取Token * 测试查询列表(含条件查询) * 测试新增个人/实体中介 * 测试查询详情 * 测试修改操作 * 测试唯一性校验 * 支持彩色输出和错误处理 - doc/scripts/cleanup-intermediary-test-data.sh: 测试数据清理脚本 * 查询测试数据 * 删除测试数据 * 验证删除结果 - doc/scripts/run-test.bat: Windows测试脚本启动器 - doc/scripts/run-cleanup.bat: Windows清理脚本启动器 ### API文档 (Task 12) - doc/api/中介黑名单管理API文档-v2.0.md: 完整的v2.0 API接口文档 * 14个API接口详细说明 * 请求参数、响应格式、错误码 * 字典数据说明 * 业务错误信息 * v2.0主要变更说明 ### 菜单配置 (Task 13) - sql/menu-intermediary.sql: 菜单和权限配置SQL * 主菜单: 中介黑名单(目录) * 子菜单: 中介管理(页面) * 按钮权限: 查询、列表、新增、修改、删除、导出、导入 * 包含详细的注释和使用说明 ### 测试报告模板 (Task 14) - doc/test/intermediary-blacklist-test-report.md: 测试报告模板 * 44个测试用例(列表查询、个人/实体中介、唯一性校验、删除、导入导出、权限) * 测试结果统计表格 * 缺陷统计表格 * 测试结论模板 * 签名确认 ### 文档 (Task 10) - doc/README-中介黑名单测试部署.md: 测试与部署指南 * 快速开始指南 * API接口列表 * 菜单权限说明 * 数据字典说明 * 常见问题解答 * 版本历史 ## 功能特性 1. **自动化测试** - 支持Linux/Windows环境 - 完整的API覆盖 - 彩色输出,易于阅读 - 错误处理和提示 2. **完整的文档** - 详细的API文档 - 清晰的测试报告模板 - 便于复现的测试用例 3. **菜单配置** - 一键SQL执行 - 完整的权限体系 - 支持角色分配 4. **测试支持** - 测试数据清理 - 测试结果验证 - 批处理支持 ## 技术亮点 - 使用jq进行JSON解析 - 支持Token自动获取 - 完整的错误处理 - 跨平台支持(Linux/Windows) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
中介黑名单弹窗优化功能测试
测试概述
本测试套件用于验证中介黑名单弹窗优化后的功能正确性，主要包括：
- 新增模式交互：验证类型选择卡片的用户体验
- 表单验证：验证个人/机构类型的字段验证规则
- 数据同步：验证机构类型证件号与统一社会信用代码的同步
- 修改模式锁定：验证修改时类型不可更改
- 边界情况处理：验证各种异常输入的处理
运行测试
前置条件
- 后端服务已启动（默认
http://localhost:8080） - 测试账号可用（
admin/admin123） - 已安装 Node.js
安装依赖
cd doc/scripts
npm install
执行测试
# 直接运行测试（输出到控制台）
npm test
# 运行测试并生成报告文件
npm run test:report
# 或者直接使用 Node.js
node test_intermediary_dialog.js
测试用例说明
| 测试编号 | 测试名称 | 测试目标 | 预期结果 |
|---|---|---|---|
| 1 | 登录系统 | 获取认证Token | 成功获取Token |
| 2 | 新增个人中介-必填字段 | 验证姓名和证件号必填 | 缺少必填项时被拒绝 |
| 3 | 新增个人中介-字段长度 | 验证字段长度限制 | 超长时被拒绝 |
| 4 | 新增机构中介-证件号同步 | 验证证件号同步到统一社会信用代码 | 两字段值一致 |
| 5 | 新增机构中介-信用代码长度 | 验证统一社会信用代码长度 | 前端限制18位 |
| 6 | 修改个人中介-类型锁定 | 验证修改时类型不可更改 | 类型字段保持不变 |
| 7 | 修改机构中介-类型锁定 | 验证修改时类型不可更改 | 类型字段保持不变 |
| 8 | 新增无类型 | 验证未选择类型无法提交 | 后端拒绝请求 |
| 9 | 查询列表 | 验证数据正确性 | 返回正确的类型分布 |
测试报告示例
==============================================================
测试1：登录系统
==============================================================
✓ 通过 - 登录成功
Token: eyJhbGciOiJIUzUxMiJ9...
==============================================================
测试2：新增个人中介 - 验证必填字段
==============================================================
✓ 通过 - 空姓名
应该被拒绝
✓ 通过 - 空证件号
应该被拒绝
✓ 通过 - 完整必填字段
成功创建，ID: 123
...
功能验证清单
前端交互验证
- 点击新增后显示类型选择卡片
- 卡片有 hover 效果
- 点击卡片后表单展开带淡入动画
- 点击卡片后表单不立即显示验证错误
- 未选择类型时确定按钮被禁用
- 个人类型表单显示正确的字段
- 机构类型表单显示正确的字段
- 个人类型证件号字段显示正确的占位符："请输入证件号码"
- 机构类型证件号字段显示正确的占位符："统一社会信用代码（18位）"
- 证件号输入框后无提示图标
表单验证验证
- 个人类型姓名必填验证
- 个人类型证件号必填验证
- 机构类型名称必填验证
- 机构类型证件号必填验证
- 机构类型证件号长度限制18位
- 备注字段长度限制500字符
数据同步验证
- 机构类型输入证件号后自动同步到统一社会信用代码
- 提交时两个字段值一致
修改模式验证
- 修改时直接显示对应类型表单
- 修改时不显示类型选择器
- 修改时类型字段不可更改
故障排查
测试失败常见原因
-
后端服务未启动
- 检查
http://localhost:8080是否可访问 - 检查后端日志是否有错误
- 检查
-
认证失败
- 确认测试账号密码正确
- 检查后端是否启用了认证
-
端口冲突
- 修改
CONFIG.baseURL为实际后端地址
- 修改
-
依赖缺失
- 运行
npm install安装依赖
- 运行
注意事项
- 测试会创建真实数据，测试结束后会自动清理
- 请勿在生产环境运行测试
- 如需修改测试数据，编辑
CONFIG对象 - 测试报告会保存在
test_report.txt文件中