# 工作人员资质关联修复操作日志 操作时间：2026-08-11 18:28:22 操作类型：修改、扩展 影响模块：平台总后台工作人员资质、订单分配、用户服务关系、平台工作人员列表接口 ## 操作前状态 - 平台前端只要加载 `/staff_account` 关联选项，就会无条件附加 `role_code=delivery`。 - 从安装人员或运维人员页面进入资质新建页时，预填 UUID 无法在配送人员选项中匹配，选择器只能显示裸 UUID。 - 资质新建页仍允许更换工作人员，可能破坏“指定人员下的资质管理”上下文。 - `owner_name` 来自 URL，缺少服务端人员详情校验；直接访问、角色变化和归档人员没有统一阻断规则。 - 工作人员列表接口只支持单一 `role_code`，不能表达“全部角色中的启用人员”或“启用且在岗的配送人员”。 ## 具体操作 - 新增工作人员关系策略： - 人员资质按来源菜单角色查询，并锁定已预填人员。 - 订单分配只查询启用且在岗的配送人员。 - 用户服务关系查询安装、配送、运维三类启用人员。 - 未声明策略的工作人员关联立即报错，不再继承隐含默认值。 - 新增资质来源校验： - 显式传递 `staff_type`，并允许从安全站内 `return_to` 回退解析。 - 始终按 UUID 查询服务端人员详情，不信任 `owner_name`。 - 人员缺失、归档、无权访问或真实角色与来源冲突时阻止创建。 - 优化人员展示：主值显示“姓名（角色）”，资质页 UUID 作为次要可复制信息；详情与表单都会按当前值补载关系记录，避免分页筛选后退化成裸标识。 - 扩展工作人员列表接口：新增可选 `role_codes`、`status`、`work_status` 参数；保留原 `role_code` 和无过滤查询兼容性。 - 扩展平台访问控制：多角色查询要求调用账号拥有每一种目标角色对应的菜单权限；订单菜单仍仅可查询配送人员。 - 增加前后端回归测试和前端策略检查命令。 ## 操作后状态 - 安装人员资质新建页能够稳定显示“曹（安装人员）”，人员控件不可修改。 - 页面只显示可复制的唯一标识尾号，不再把完整 UUID 当作人员名称候选项。 - 无人员/角色来源的直接新建地址显示“无法执行此操作”，不渲染可保存表单。 - 角色冲突不会静默改绑；用户需要从工作人员当前角色菜单重新进入。 - 三个工作人员关联场景各自拥有明确的角色、启用状态和在岗状态契约。 - 后端仍以真实工作人员记录和菜单权限作为最终鉴权依据，前端查询参数不能扩大权限。 ## 代码变更 - `frontend/platform_admin/src/api/resource-staff-relation.ts`：新增角色闭集、字段过滤、返回路径解析和资质所有者校验。 - `frontend/platform_admin/src/api/resources.ts`：为三种工作人员关联字段声明独立策略，并兼容扩展关系字段构造函数。 - `frontend/platform_admin/src/views/resource/use-resource-relations.ts`：删除全局配送人员特例，按字段加载/搜索并补载当前关系值。 - `frontend/platform_admin/src/views/resource/ResourceRecordPage.vue`：接入资质人员服务端校验、锁定和异常阻断。 - `frontend/platform_admin/src/views/resource/use-staff-credential-owner-guard.ts`：拆分资质所有者回查、角色校验与错误结果。 - `frontend/platform_admin/src/views/resource/load-resource-record-relations.ts`：拆分关系补载与动态平台角色加载，控制主页面文件规模。 - `frontend/platform_admin/src/views/resource/ResourceFieldForm.vue`、`ResourceDetailContent.vue`、`resource-display.ts`：展示人员姓名、角色和可复制标识。 - `frontend/platform_admin/src/views/shared/CrudListPage.vue`：在工作人员、资质列表及记录页面之间传递 `staff_type`。 - `backend/api/internal/logic/platform/staff/staff.go`：解析并应用角色、状态和工作状态过滤。 - `backend/api/internal/logic/platform/platform/access.go`：校验单角色和多角色工作人员查询权限。 - `backend/api/internal/logic/platform/staff/staff_test.go`、`platform/access_test.go`：覆盖过滤闭集和访问控制。 - `frontend/platform_admin/scripts/check-staff-relation-policy.mjs`、`package.json`：新增前端关系策略回归检查。 ## 验证结果 - `npm.cmd run type:check`：通过。 - `npm.cmd run staff-relations:check`：通过。 - `npm.cmd run build`：通过，Vite 生产构建完成。 - `go test ./internal/logic/platform/staff ./internal/logic/platform/platform`：通过。 - `go test ./internal/logic/platform/...`：通过。 - 本地浏览器只读验证：安装人员名称和角色正确回显，人员控件禁用，唯一标识可复制；直接访问缺少上下文时正确阻断；未提交测试数据。 - `git diff --check`：通过。 ## 风险评估 - 多角色工作人员查询采用严格权限交集：调用账号必须同时拥有安装、配送和运维人员菜单权限；权限不足时服务端拒绝整次查询，避免返回部分结果造成误解。 - 关系下拉仍以每次最多 100 条加载并支持关键字搜索；已保存或预填人员会按 UUID 独立补载。 - 资质编辑和详情按工作人员当前角色鉴权；角色变更不会删除历史资质，但旧角色来源的新建上下文会被阻断。 - 本次不修改数据库结构、资质归属关系或工作人员角色变更规则，不触碰现有运行日志和 `runtime/` 数据。 - `ResourceRecordPage.vue` 原本已超过 500 行；本次把新增校验和关系加载职责拆到两个独立文件，将主文件由实施中峰值 588 行降至 522 行，未继续重构既有保存和状态流程以控制改动范围。