72 lines
5.7 KiB
Markdown
72 lines
5.7 KiB
Markdown
# 工作人员资质关联修复操作日志
|
||
|
||
操作时间：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 行，未继续重构既有保存和状态流程以控制改动范围。
|