# 承销商管理 — 测试用例

> 依据：`承销商管理功能需求.md`、`承销商管理技术方案.md`  
> **接口 Base Path（示例）**：`/tradeMarket/distributor`；鉴权与若依一致（Cookie / Token）。

**通用前置（无特殊说明）**：具备本模块按钮权限的账号已登录（`tradeMarket:distributor:list|query|add|edit|remove`）。库表 `biz_distributor` 中宜预置（`del_flag=0`）：

| 样本 | 编号 | 名称 | 类型 | 销售去向 | 要点 |
| --- | --- | --- | --- | --- | --- |
| **D1** | `01` | 扎西承销服务点 | 个体户(1) | 本市(1) | 身份证 |
| **D2** | `02` | 雪域贸易有限公司 | 企业(2) | 本省(2) | USCC |
| **D3** | `03` | 高原外向商行 | 企业(2) | 外省(3) | 经营地点有值 |

**合法身份证**：`110101199001011234`。**合法 USCC**：`91510000MA62K0260E`。

**合法新增 Body 示例**：`distributorName=测试承销商甲`，`distributorType=1`，`identityNo=110101199001011234`，`contactPhone=13800138000`，`salesDestination=1`。

**界面（UI）测试**：**Playwright** + **Chromium**（`channel: 'chrome'` 使用本机 **Google Chrome**）。

---

## 一、单元测试用例

| 用例编号 | 测试模块 | 测试项 | 测试类型 | 测试工具 | 测试目的 | 前置条件 | 测试步骤 | 预期结果 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| ZCZX-CXSGL-UT-001 | 编号生成 | 首条编号 | 单元测试 | JUnit5 | §2.4 | 库无编号 | `DistributorCodeGenerator.next()` | 返回 `01` |
| ZCZX-CXSGL-UT-002 | 编号生成 | 递增补零 | 单元测试 | JUnit5 | §2.4 | 最大号 `08` | `next()` | 返回 `09` |
| ZCZX-CXSGL-UT-003 | 编号生成 | 上限拒绝 | 单元测试 | JUnit5 | §2.4 | 最大号 `99` | `next()` | 抛异常；含编号上限 |
| ZCZX-CXSGL-UT-004 | 参数校验 | 承销商名称 | 单元测试 | JUnit5 | 1～20 字 | 无 | 空、21 字、合法 trim | 空/超长失败；通过 |
| ZCZX-CXSGL-UT-005 | 参数校验 | 个体户身份证 | 单元测试 | JUnit5 | §3.4 | `type=1` | 非法、合法 18 位 | 非法失败；通过 |
| ZCZX-CXSGL-UT-006 | 参数校验 | 企业识别号 | 单元测试 | JUnit5 | §3.4 | `type=2` | 非 18 位、合法 USCC | 非法失败；通过 |
| ZCZX-CXSGL-UT-007 | 参数校验 | 手机号 | 单元测试 | JUnit5 | 全局 | 无 | 10 位、11 位合法 | 非法失败；通过 |
| ZCZX-CXSGL-UT-008 | 参数校验 | 销售去向 | 单元测试 | JUnit5 | §2.3 | 无 | 空、0、4、1/2/3 | 非法失败；1～3 通过 |
| ZCZX-CXSGL-UT-009 | 参数校验 | 经营地点长度 | 单元测试 | JUnit5 | ≤50 | 无 | 51 字、50 字 | 51 失败；50 通过 |
| ZCZX-CXSGL-UT-010 | 唯一性 | 名称重复 | 单元测试 | JUnit5+Mockito | §3.4 | 同名未删 | `validateUniqueName` | 失败 |
| ZCZX-CXSGL-UT-011 | 唯一性 | 身份号重复 | 单元测试 | JUnit5+Mockito | §3.4 | 同号未删 | `validateUniqueIdentity` | 失败 |
| ZCZX-CXSGL-UT-012 | Service | 新增落库 | 单元测试 | JUnit5+Mockito | 正常 | Mock Mapper | `insert` 合法行 | `del_flag=0`；`distributor_code` 非空 |
| ZCZX-CXSGL-UT-013 | Service | 修改禁改编号 | 单元测试 | JUnit5 | §3.3.1 | 记录 `01` | Body `distributorCode=99` | 库仍为 `01` |
| ZCZX-CXSGL-UT-014 | Service | 逻辑删除 | 单元测试 | JUnit5+Mockito | §3.5 | Mock | `remove(id)` | `del_flag=2` |
| ZCZX-CXSGL-UT-015 | Service | 删除有关联 | 单元测试 | JUnit5+Mockito | §3.5 | `hasReference=true` | `remove` | 抛异常 |
| ZCZX-CXSGL-UT-016 | Mapper | 模糊筛选 SQL | 单元测试 | JUnit5 | §3.6 | 无 | 检查 XML | `LIKE CONCAT('%',…,'%')`；`del_flag=0` |
| ZCZX-CXSGL-UT-017 | Mapper | 排序 | 单元测试 | JUnit5 | §3.1.1 | 无 | 检查 XML | `distributor_code ASC, id ASC` |

---

## 二、接口测试用例

| 用例编号 | 测试模块 | 测试项 | 测试类型 | 测试工具 | 测试目的 | 前置条件 | 测试步骤 | 预期结果 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| ZCZX-CXSGL-API-001 | 列表 | 默认分页排序 | 接口测试 | Postman | §3.1.1 | 有 D1～D3 | `GET .../list` | `rows`≤20；含 `salesDestinationName`；编号升序 |
| ZCZX-CXSGL-API-002 | 列表 | 编号模糊 | 接口测试 | Postman | §2.7 | 有 D1 `01` | `distributorCode=1` | 含 D1；全名 `01` 仍命中 |
| ZCZX-CXSGL-API-003 | 列表 | 名称模糊 | 接口测试 | Postman | §2.7 | 有 D2 | `distributorName=雪域` | 含 D2；与全名不等亦可 |
| ZCZX-CXSGL-API-004 | 列表 | 模糊无匹配 | 接口测试 | Postman | §2.7 | 已登录 | `distributorName=不存在xyz` | 空列表 |
| ZCZX-CXSGL-API-005 | 列表 | 精确不匹配反例 | 接口测试 | Postman | 对比供应商 | 有 D2 全名 | 名称少一字片段错误 | 仍可模糊命中或按输入为空不过滤 |
| ZCZX-CXSGL-API-006 | 列表 | 组合筛选 | 接口测试 | Postman | 多条件 | 已登录 | `distributorCode=0`+`distributorName=公司` | 同时满足行 |
| ZCZX-CXSGL-API-007 | 列表 | 不含已删除 | 接口测试 | Postman | 逻辑删除 | id 已删 | `GET list` | 无该 id |
| ZCZX-CXSGL-API-008 | 新增 | 个体户本市 | 接口测试 | Postman | §5.1 | 已登录 | `POST` 合法 Body `salesDestination=1` | `code=200`；`distributorCode` 2 位 |
| ZCZX-CXSGL-API-009 | 新增 | 企业本省 | 接口测试 | Postman | §2.3 | 已登录 | `type=2`+USCC+`salesDestination=2` | 成功 |
| ZCZX-CXSGL-API-010 | 新增 | 外省 | 接口测试 | Postman | §2.3 | 已登录 | `salesDestination=3` | 成功；详情销售去向为外省 |
| ZCZX-CXSGL-API-011 | 新增 | 缺销售去向 | 接口测试 | Postman | §3.4 | 已登录 | 无 `salesDestination` | 失败 |
| ZCZX-CXSGL-API-012 | 新增 | 销售去向非法 | 接口测试 | Postman | §3.4 | 已登录 | `salesDestination=9` | 失败 |
| ZCZX-CXSGL-API-013 | 新增 | 名称重复 | 接口测试 | Postman | §5.1.4 | 已有 D1 名 | `POST` 同名 | 失败 |
| ZCZX-CXSGL-API-014 | 新增 | 身份号重复 | 接口测试 | Postman | §5.1.4 | 已有 D1 证号 | 同 `identityNo` | 失败 |
| ZCZX-CXSGL-API-015 | 新增 | 手机号非法 | 接口测试 | Postman | §2.5 | 已登录 | `contactPhone=123` | 失败 |
| ZCZX-CXSGL-API-016 | 新增 | 企业错用身份证 | 接口测试 | Postman | §2.5 | 已登录 | `type=2`+身份证 | 失败 |
| ZCZX-CXSGL-API-017 | 详情 | 有效 id | 接口测试 | Postman | §3.2.1 | 已登录 | `GET /{id}` | 含销售去向、审计 |
| ZCZX-CXSGL-API-018 | 详情 | 无效/已删 id | 接口测试 | Postman | 异常 | 已登录 | 不存在/已删 | 失败或空 `data` |
| ZCZX-CXSGL-API-019 | 修改 | 改经营地点 | 接口测试 | Postman | §5.3 | 有 D1 | `PUT` 改 `businessLocation` | 成功；编号不变 |
| ZCZX-CXSGL-API-020 | 修改 | 改销售去向 | 接口测试 | Postman | §5.3 | D1 本市 | `PUT` `salesDestination=3` | 成功；详情为外省 |
| ZCZX-CXSGL-API-021 | 修改 | 传编号无效 | 接口测试 | Postman | §3.3.1 | 有 D1 | `PUT` `distributorCode=99` | 仍为 `01` |
| ZCZX-CXSGL-API-022 | 修改 | 不存在 id | 接口测试 | Postman | 异常 | 已登录 | 伪造 id `PUT` | 失败 |
| ZCZX-CXSGL-API-023 | 删除 | 单条逻辑删 | 接口测试 | Postman | §5.5 | 无关联新行 | `DELETE /{id}` | 成功；列表无 |
| ZCZX-CXSGL-API-024 | 删除 | 有关联拒绝 | 接口测试 | Postman | §5.5 | 预置有关联 | `DELETE` | 失败 |
| ZCZX-CXSGL-API-025 | 删除 | 重复删除 | 接口测试 | Postman | 幂等 | 已删 id | 再次 `DELETE` | 失败或不存在 |
| ZCZX-CXSGL-API-026 | 端到端 | CRUD 串联 | 接口测试 | Postman | §4 | 已登录 | `POST`→`list`→`GET`→`PUT`→`DELETE` | 每步成功 |
| ZCZX-CXSGL-API-027 | 鉴权 | 未登录 | 接口测试 | curl | 安全 | 无 Token | `GET list` | 401 或统一未登录 |
| ZCZX-CXSGL-API-028 | 权限 | 无新增权限 | 接口测试 | Postman | §6 | 仅 list | `POST` | 无权限失败 |
| ZCZX-CXSGL-API-029 | 权限 | 无删除权限 | 接口测试 | Postman | §6 | 无 remove | `DELETE` | 无权限失败 |
| ZCZX-CXSGL-API-030 | 响应 | 失败可读 | 接口测试 | Postman | 草稿 §8 | 已登录 | 触发缺去向、重复名、手机号错 | `msg` 可区分 |

---

## 三、界面测试用例（UI）

**测试工具**：**Playwright** + **Chromium**（`channel: 'chrome'` 使用本机 **Google Chrome**）。

| 用例编号 | 测试模块 | 测试项 | 测试类型 | 测试工具 | 测试目的 | 前置条件 | 测试步骤 | 预期结果 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| ZCZX-CXSGL-UI-001 | 列表 | 默认展示 | UI 测试 | Playwright+Chrome | §5.2.3 | 已登录；有数据 | 进入「承销商管理」 | 含编号、名称、类型、识别号、电话、地点、销售去向、操作 |
| ZCZX-CXSGL-UI-002 | 列表 | 编号模糊筛选 | UI 测试 | Playwright+Chrome | §2.7 | 有 D1 `01` | 编号输入 `1`→搜索 | 含 D1 |
| ZCZX-CXSGL-UI-003 | 列表 | 名称模糊筛选 | UI 测试 | Playwright+Chrome | §2.7 | 有 D2 | 名称输入「雪域」→搜索 | 含 D2 |
| ZCZX-CXSGL-UI-004 | 列表 | 无结果 | UI 测试 | Playwright+Chrome | §2.7 | 已登录 | 输入不存在关键字→搜索 | 空列表或空状态 |
| ZCZX-CXSGL-UI-005 | 列表 | 重置 | UI 测试 | Playwright+Chrome | §5.2 | 已筛选 | 搜索→重置 | 条件清空 |
| ZCZX-CXSGL-UI-006 | 新增 | 个体户本市 | UI 测试 | Playwright+Chrome | §5.1 | 已登录 | 新增→个体户→本市→填必填→确定 | 成功；列表新行 |
| ZCZX-CXSGL-UI-007 | 新增 | 企业本省 | UI 测试 | Playwright+Chrome | §5.1 | 已登录 | 企业+主体识别号+本省→确定 | 成功 |
| ZCZX-CXSGL-UI-008 | 新增 | 销售去向必选 | UI 测试 | Playwright+Chrome | §5.1.4 | 新增 | 不选销售去向→确定 | 校验失败 |
| ZCZX-CXSGL-UI-009 | 新增 | 类型切换标签 | UI 测试 | Playwright+Chrome | §5.1.2 | 新增 | 个体户↔企业 | 标签在身份证/主体识别号间切换 |
| ZCZX-CXSGL-UI-010 | 新增 | 编号只读 | UI 测试 | Playwright+Chrome | §2.4 | 打开新增 | 查看编号控件 | 只读或保存后自动生成 |
| ZCZX-CXSGL-UI-011 | 新增 | 缺必填 | UI 测试 | Playwright+Chrome | §5.1.4 | 新增 | 留空名称或手机→确定 | 校验失败 |
| ZCZX-CXSGL-UI-012 | 新增 | 名称 20 字 | UI 测试 | Playwright+Chrome | §5.1.1 | 新增 | 超 20 字 | 无法输入或保存失败 |
| ZCZX-CXSGL-UI-013 | 新增 | 取消 | UI 测试 | Playwright+Chrome | §5.1.3 | 新增 | 填一半→取消 | 无新行 |
| ZCZX-CXSGL-UI-014 | 详情 | 只读含去向 | UI 测试 | Playwright+Chrome | §5.4 | 有 D3 | 查看 | 只读；销售去向为外省；含审计 |
| ZCZX-CXSGL-UI-015 | 编辑 | 修改地点 | UI 测试 | Playwright+Chrome | §5.3 | 有 D1 | 编辑→改经营地点→确定 | 列表已更新；编号不变 |
| ZCZX-CXSGL-UI-016 | 编辑 | 编号不可改 | UI 测试 | Playwright+Chrome | §5.3 | 编辑 D1 | 查看编号 | 只读 |
| ZCZX-CXSGL-UI-017 | 编辑 | 改销售去向 | UI 测试 | Playwright+Chrome | §5.3 | D1 本市 | 改外省→保存 | 列表/详情为外省 |
| ZCZX-CXSGL-UI-018 | 删除 | 确认删除 | UI 测试 | Playwright+Chrome | §5.5 | 无关联行 | 删除→确认 | 行消失 |
| ZCZX-CXSGL-UI-019 | 删除 | 取消删除 | UI 测试 | Playwright+Chrome | §5.5 | 任意行 | 删除→取消 | 行仍在 |
| ZCZX-CXSGL-UI-020 | 端到端 | 全流程 | UI 集成 | Playwright+Chrome | §4 | 权限齐备 | 新增→模糊查→看→改→删 | 无报错 |
| ZCZX-CXSGL-UI-021 | 权限 | 只读角色 | UI 测试 | Playwright+Chrome | §6 | 无写权限 | 进入模块 | 无新增/编辑/删除 |
| ZCZX-CXSGL-UI-022 | 详情 | 从详情编辑 | UI 测试 | Playwright+Chrome | §5.4 | 查看 D1 | 点「编辑」 | 进入编辑弹窗 |

---

## Playwright 与谷歌浏览器（实施提示）

- 安装：`npm i -D @playwright/test`；`npx playwright install chrome`。  
- 配置：`use: { channel: 'chrome', locale: 'zh-CN', baseURL: 'http://localhost:80' }`；`storageState` 复用登录态。  
- 路由：`page.goto('/tradeMarket/distributor')`（以菜单 `component` 为准）。  
- 模糊搜索：`page.getByLabel('承销商编号').fill('1')` 后点击「搜索」。  
- 销售去向：`page.getByLabel('销售去向').click()` 后选「本市」等选项。

---

## 覆盖对照

| 类别 | 单元 UT | 接口 API | 界面 UI |
| --- | --- | --- | --- |
| 正常流程 | UT-012 | API-008～010、017、019～020、026 | UI-006～007、014～017、020 |
| 异常流程 | UT-003 | API-011～016、022、024～025 | UI-008、011、018～019 |
| 业务约束 | UT-001～011 | API-002～004、013～016、021 | UI-002～004、009～010、016 |
| 模糊筛选 | UT-016 | API-002～006 | UI-002～004 |
| 销售去向 | UT-008 | API-011～012、020 | UI-006～008、017 |
| 逻辑删除 | UT-014 | API-007、023～025 | UI-018 |
| 权限/鉴权 | — | API-027～029 | UI-021 |

---

## 功能需求追溯（自查）

| 需求章节 | 要点 | 主要对应用例 |
| --- | --- | --- |
| §5.1 新增 | 字段、销售去向 | UT-004～009、012；API-008～016；UI-006～013 |
| §5.2 列表 | **模糊**筛选 | UT-016；API-002～006；UI-002～005 |
| §5.3 修改 | 编号不可改 | UT-013；API-019～021；UI-015～017 |
| §5.4 详情 | 只读 | API-017；UI-014、022 |
| §5.5 删除 | 逻辑删 | UT-014～015；API-023～025；UI-018～019 |
| §2.3 销售去向 | 三档 | UT-008；API-008～012、021；UI-006～008、018 |
| §2.4 编号 | 01～99 | UT-001～003；API-008；UI-010 |
| §6 权限 | 按钮级 | API-028～029；UI-021 |

---

## 修订记录

| 版本 | 说明 |
| --- | --- |
| 1.0 | 初版：单元 18、接口 31、UI 23；覆盖 CRUD、模糊筛选、销售去向、编号；Playwright+Chrome；前缀 **ZCZX-CXSGL** |
| 1.1 | 移除车辆号牌相关用例；章节引用 §2.7；用例编号重排（单元 17、接口 30、UI 22） |
