# 中介库管理导入功能浏览器测试实施记录

## 本次操作

- 使用真实浏览器进入 `中介库管理` 页面。
- 分别下载两类导入模板：
  - 中介和亲属信息导入模板
  - 中介实体关联关系导入模板
- 基于下载模板生成浏览器回传测试文件，并在页面上传验证。

## 测试文件

- `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`

## 验证结果

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

- 第一轮导入结果：总数 `13`，成功 `4`，失败 `9`
- 第二轮导入结果：总数 `2`，成功 `0`，失败 `2`
- 成功数据已在页面列表可见：
  - `自动化中介本人A`
  - `自动化中介A配偶`
  - `文件内重复本人1`
  - `文件内重复亲属1`
- 页面失败记录已确认命中：
  - 本人行关联字段错误
  - 亲属缺少关联本人
  - 姓名为空
  - 人员子类型为空
  - 证件号非法
  - 文件内本人重复
  - 关联本人不存在
  - 文件内亲属重复
  - 库内本人重复
  - 库内亲属重复

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

- 第一轮导入结果：总数 `11`，成功 `3`，失败 `8`
- 第二轮导入结果：总数 `1`，成功 `0`，失败 `1`
- 成功数据已在页面列表可见：
  - `成都市资产企业 / 自动化中介本人A / 董事`
  - `上海市资产企业 / 自动化中介本人A / 监事`
  - `杭州市不动产合伙企业 / 自动化中介本人A / 法人`
- 页面失败记录已确认命中：
  - 中介本人为空
  - 中介本人证件号非法
  - 中介本人不存在
  - 统一社会信用代码为空
  - 统一社会信用代码不存在
  - 关联人职务超长
  - 备注超长
  - 文件内关系重复
  - 库内关系重复

## 影响范围

- 页面：`ruoyi-ui/src/views/ccdiIntermediary/`
- 后端接口：
  - `/ccdi/intermediary/importPersonTemplate`
  - `/ccdi/intermediary/importPersonData`
  - `/ccdi/intermediary/importPersonStatus/{taskId}`
  - `/ccdi/intermediary/importPersonFailures/{taskId}`
  - `/ccdi/intermediary/importEnterpriseRelationTemplate`
  - `/ccdi/intermediary/importEnterpriseRelationData`
  - `/ccdi/intermediary/importEnterpriseRelationStatus/{taskId}`
  - `/ccdi/intermediary/importEnterpriseRelationFailures/{taskId}`

## 说明

- `docs/tests/records/2026-04-21-intermediary-import-browser-test-record.md` 也已生成更完整测试记录，但该目录受当前仓库 `.gitignore` 规则影响，不进入版本管理。
- 测试结束后，已关闭本次启动的前端开发进程和 Playwright 浏览器；后端沿用原有 `62318` 进程，未做重启或停止。
