# 工作人员列表自动加载修复操作日志

操作时间：2026-08-11 22:34:45
操作类型：修改
影响模块：平台总后台工作人员列表

## 操作前状态

安装人员、配送人员和运维人员共用 `/staff_account` 列表资源，只通过路由中的 `staffType` 区分角色。共享列表仅监听资源路径变化；三个菜单之间切换时资源路径不变，因此在组件被复用的场景下不会主动重新查询，必须点击刷新按钮才显示已有数据。

## 具体操作

1. 将共享列表的变更监听范围从单一资源路径扩展为资源路径与工作人员类型。
2. 工作人员类型变化后，清空原列表的模糊搜索条件、回到第 1 页，并重新预加载关联项和查询当前角色数据。
3. 在资源页面静态检查中增加工作人员角色菜单切换的回归门禁。
4. 补全列表搜索状态重置条件，同时清理 URL 中遗留的关键字和页码。
5. 修正工作人员关联检查脚本的扫描位置，使其继续验证已拆分的列表查询参数同步逻辑。
6. 更新平台总后台现状基线，记录首次进入、菜单切换与手动刷新的交互规则。

## 操作后状态

首次进入安装人员、配送人员或运维人员列表时继续自动加载；三个角色菜单相互切换时也会主动查询当前角色数据，无需额外点击刷新。刷新按钮和其他标准资源列表行为保持不变。

## 代码变更

- `frontend/platform_admin/src/views/shared/CrudListPage.vue`：扩展列表变更监听条件并补充中文业务注释。
- `frontend/platform_admin/scripts/check-resource-pages.mjs`：新增角色切换自动加载静态回归检查。
- `frontend/platform_admin/scripts/check-staff-relation-policy.mjs`：修正列表查询参数同步逻辑的检查位置。
- `frontend/platform_admin/src/views/shared/use-resource-list-search.ts`：切换列表时同步清理遗留页码。
- `frontend/platform_admin/scripts/check-resource-search.mjs`：增加列表切换页码清理回归检查。
- `docs/05-平台总后台需求.md`：补充工作人员列表加载规则。
- `docs/操作日志_工作人员列表自动加载修复_20260811.md`：记录本次修复及验证情况。

## 验证结果

- `pnpm.cmd resource-pages:check`：通过，角色菜单切换自动加载回归门禁生效。
- `pnpm.cmd staff-relations:check`：通过，工作人员关联与资质上下文契约正常。
- `pnpm.cmd resource-search:check`：通过，搜索状态清理与 URL 同步规则正常。
- `pnpm.cmd type:check`：通过。
- `pnpm.cmd contract:check`：通过，共 48 个资源。
- `pnpm.cmd build`：通过，Vite 完成生产构建。
- 定向 Biome 检查：本次修改的 Vue 文件无错误；存在模板符号识别产生的既有告警。
- 全仓 `pnpm.cmd lint`：未通过，仓库基线中未修改的 Vite 配置和旧组件仍有 2 个错误、158 个告警及 12 个提示；本次未扩大范围处理。
- 浏览器手动验证：当前本机没有前端 `5173` 或后端 `12426` 服务监听，无法在现有数据环境执行点击验收。

## 风险评估

- 影响范围仅限共享列表在资源路径或工作人员类型变化时的重载逻辑。
- 同一资源的普通分页、搜索、手动刷新和记录操作接口保持兼容。
- 当前源码已有按路由名称重建列表组件的保护；新增监听属于防御性补强，可避免外层缓存或组件复用策略变化后问题复发。
- 截图环境若仍加载旧静态资源，需要部署本次生产构建并清理浏览器或代理缓存后再验收。