# 员工亲属实体关联真实页面测试记录

## 测试时间

2026-04-24 13:32

## 测试范围

- 页面：员工亲属实体关联
- 实际访问地址：`http://localhost:8080/maintain/staffEnterpriseRelation`
- 后端接口代理：`http://localhost:8080/dev-api`
- 登录账号：`admin`

## 环境信息

- 后端：本地 `62318` 端口已启动
- 前端：`ruoyi-ui` 使用 `.nvmrc` 指定的 Node `14.21.3`，执行 `npm run dev -- --port 8080 --open false`
- 浏览器：Playwright 启动本机 Google Chrome，访问真实业务页面

## 测试数据

- 选择的有效亲属：`320101199201010051 LSFX低收入亲属 / 导入验证员工20260317`
- 测试统一社会信用代码：`91756899ABCDEFGH12`
- 测试企业名称：`自动化测试亲属实体企业56899`
- 测试职务：`自动化测试职务`
- 编辑后职务：`自动化测试职务-已编辑`

## 测试步骤与结果

1. 打开真实业务页面，确认员工亲属实体关联列表加载成功。
2. 点击“新增”，通过亲属身份证号下拉选择有效员工亲属，确认亲属姓名与关联员工自动带出。
3. 填写统一社会信用代码、企业名称、职务、补充说明并提交，页面提示“新增成功”。
4. 按企业名称搜索，确认新增记录展示在列表中，并包含企业名称、职务和关联员工信息。
5. 打开“详情”，确认详情弹窗展示亲属身份证号、亲属姓名、关联员工、统一社会信用代码、企业名称、职务、状态、数据来源和补充说明。
6. 点击“编辑”，修改职务后提交，页面提示“修改成功”，列表展示编辑后的职务。
7. 再次新增同一亲属身份证号与同一统一社会信用代码组合，确认页面拦截并提示“该亲属身份证号和统一社会信用代码组合已存在”。
8. 删除本轮新增记录，页面提示“删除成功”，完成测试数据清理。
9. 测试结束后通过后端列表接口按测试企业名称复核，返回 `total = 0`，确认本轮测试数据已清理。

## 验证结论

- 员工亲属实体关联主链路通过。
- 有效亲属下拉搜索、自动带出关联员工、新增、查询、详情、编辑、重复组合校验、删除清理均符合预期。
- 测试过程中未发现浏览器控制台错误。
- 测试过程中未发现失败请求。

## 测试产物

- 页面截图位于 `output/playwright/`，文件名前缀为 `staff-family-enterprise-*2026-04-24T05-32-31-510Z.png`。
- 临时 Playwright 脚本位于 `output/playwright/staff-family-enterprise-relation-browser-test.js`，该目录为测试输出目录，不纳入 Git 提交范围。
