# 2026-04-21 中介库管理导入功能浏览器测试记录

## 1. 测试目标

- 在真实浏览器中验证“中介库管理”页面两类导入功能：
  - 导入中介和亲属信息
  - 导入中介实体关联关系
- 验证模板下载、模板改写、页面上传、异步导入结果展示、失败记录查看全链路可用。

## 2. 测试环境

- 前端地址：`http://localhost:62319`
- 后端地址：`http://127.0.0.1:62318`
- 登录方式：调用项目测试登录接口 `/login/test` 获取 token 后注入浏览器 Cookie
- 浏览器：Playwright headed 模式

## 3. 下载模板

- 中介和亲属信息模板：
  - 浏览器下载原始文件：`.playwright-cli/中介和亲属信息导入模板-1776735200748.xlsx`
- 中介实体关联关系模板：
  - 浏览器下载原始文件：`.playwright-cli/中介实体关联关系导入模板-1776735620019.xlsx`

## 4. 生成测试文件

- 中介和亲属信息首轮混合测试文件：
  - `output/spreadsheet/intermediary_person_import_browser_phase1.xlsx`
- 中介和亲属信息二轮库内重复测试文件：
  - `output/spreadsheet/intermediary_person_import_browser_phase2_existing_db_cases.xlsx`
- 中介实体关联关系首轮混合测试文件：
  - `output/spreadsheet/intermediary_enterprise_relation_import_browser_phase1.xlsx`
- 中介实体关联关系二轮库内重复测试文件：
  - `output/spreadsheet/intermediary_enterprise_relation_import_browser_phase2_db_duplicate.xlsx`

## 5. 页面测试过程与结果

### 5.1 导入中介和亲属信息

#### 第一轮：混合成功/失败场景

- 上传文件：`output/spreadsheet/intermediary_person_import_browser_phase1.xlsx`
- 页面导入结果：
  - 总数 `13` 条
  - 成功 `4` 条
  - 失败 `9` 条
- 页面列表确认新增成功数据：
  - `自动化中介本人A`
  - `自动化中介A配偶`
  - `文件内重复本人1`
  - `文件内重复亲属1`

#### 第一轮失败记录命中情况

- `本人行关联中介本人证件号码必须为空`
- `亲属行必须填写关联中介本人证件号码`
- `姓名不能为空`
- `人员子类型不能为空`
- `证件号码身份证号长度必须为18位`
- `中介本人证件号码[320101199503154560]在导入文件中重复`
- `关联中介本人证件号码[320101197704077654]不存在`
- `同一中介本人名下证件号码[320101199604102348]的亲属在导入文件中重复`

说明：

- 原计划用于命中“库内本人重复”的旧数据 `320101199904170833` 因系统内该历史证件号本身校验位不合法，页面实际先命中了证件号格式校验。

#### 第二轮：补齐库内重复分支

- 上传文件：`output/spreadsheet/intermediary_person_import_browser_phase2_existing_db_cases.xlsx`
- 页面导入结果：
  - 总数 `2` 条
  - 成功 `0` 条
  - 失败 `2` 条
- 页面失败记录确认命中：
  - `中介本人证件号码[46265019770816746X]已存在，请勿重复导入`
  - `同一中介本人名下证件号码[320101199902033213]的亲属已存在，请勿重复导入`

### 5.2 导入中介实体关联关系

#### 第一轮：混合成功/失败场景

- 上传文件：`output/spreadsheet/intermediary_enterprise_relation_import_browser_phase1.xlsx`
- 页面导入结果：
  - 总数 `11` 条
  - 成功 `3` 条
  - 失败 `8` 条
- 页面列表确认新增成功数据：
  - `成都市资产企业 / 自动化中介本人A / 董事`
  - `上海市资产企业 / 自动化中介本人A / 监事`
  - `杭州市不动产合伙企业 / 自动化中介本人A / 法人`

#### 第一轮失败记录命中情况

- `中介本人证件号码不能为空`
- `中介本人证件号码身份证号长度必须为18位`
- `中介本人不存在，请先导入或维护中介本人信息`
- `统一社会信用代码不能为空`
- `统一社会信用代码不存在于系统机构表`
- `关联人职务长度不能超过100个字符`
- `备注长度不能超过500个字符`
- `同一中介本人与统一社会信用代码组合在导入文件中重复`

#### 第二轮：补齐库内关系重复分支

- 上传文件：`output/spreadsheet/intermediary_enterprise_relation_import_browser_phase2_db_duplicate.xlsx`
- 页面导入结果：
  - 总数 `1` 条
  - 成功 `0` 条
  - 失败 `1` 条
- 页面失败记录确认命中：
  - `中介实体关联关系已存在，请勿重复导入`

## 6. 结论

- 两类导入功能的模板下载、模板改写、页面上传、异步轮询、失败记录弹窗均可正常工作。
- 中介和亲属信息导入已覆盖：
  - 成功导入
  - 本人行关联字段错误
  - 亲属缺少关联本人
  - 姓名为空
  - 人员子类型为空
  - 证件号非法
  - 文件内本人重复
  - 关联本人不存在
  - 文件内亲属重复
  - 库内本人重复
  - 库内亲属重复
- 中介实体关联关系导入已覆盖：
  - 成功导入
  - 中介本人为空
  - 中介本人证件号非法
  - 中介本人不存在
  - 统一社会信用代码为空
  - 统一社会信用代码不存在
  - 关联人职务超长
  - 备注超长
  - 文件内关系重复
  - 库内关系重复
