功能:完善用户服务关系展示与组织联动

统一平台、气站和配送点后台的服务关系业务名称展示。
新增气站、配送点、服务人员三级联动及暂未分配语义。
后端补充组织归属、人员角色和启用状态的严格校验。
补充前后端测试、项目文档、操作日志及本机日志忽略规则。
This commit is contained in:
czl231
2026-08-12 00:37:58 +08:00
parent a37b147f5f
commit 6bcde94388
24 changed files with 682 additions and 27 deletions

View File

@@ -0,0 +1,70 @@
# 服务关系名称展示操作日志
操作时间2026-08-11
操作类型:扩展
影响模块:平台总后台、气站后台、配送点后台的服务关系列表
## 操作前状态
服务关系列表的用户、气站、配送点和工作人员字段仅显示唯一标识,普通用户难以直接识别关系归属;三个后台未统一采用既有的用户地址名称展示标准。
## 具体操作
1. 保持菜单、页面标题和面包屑中的“服务关系”名称不变。
2. 四列表头统一改为“用户账户、所属气站、所属配送点、服务人员”。
3. 列表主内容改为关联业务名称,悬停显示完整唯一标识,并提供复制按钮。
4. 名称缺失或关系加载失败时降级显示完整唯一标识。
5. 将相同规则同步到平台总后台、气站后台和配送点后台。
## 操作后状态
管理人员可以直接按业务名称识别服务归属,同时仍可查看和复制底层唯一标识。详情页和编辑流程保持原行为。
## 验证结果
- 三个后台的 `pnpm.cmd type:check` 均通过。
- 三个后台的 `pnpm.cmd build` 均通过。
- 未修改后端接口和数据库结构。
## 风险评估
影响范围限于列表渲染和字段文案。唯一标识保留为降级内容,可缓解关联数据暂未加载或名称缺失造成的识别问题。
---
操作时间2026-08-12
操作类型:扩展
影响模块:平台总后台服务关系记录页、服务人员筛选接口、服务关系写入校验
## 操作前状态
详情和编辑页仍显示“唯一标识”文案;气站、配送点、服务人员可以独立选择;后端不允许三项全部为空,且组织一致性规则比页面确认的规则宽松。
## 具体操作
1. 新建、详情、编辑页面统一使用“用户账户、所属气站、所属配送点、服务人员”。
2. 用户账户编辑时改为只读业务名称,并保留唯一标识复制能力。
3. 空组织统一显示“暂未分配”,允许三项全部为空。
4. 配送点按气站筛选并自动回填气站;服务人员按气站和配送点精确筛选。
5. 组织变化时清空不匹配的下级选项并提示。
6. 后端保存前严格校验配送点、服务人员归属、角色和启用状态。
7. 保持接口地址、请求字段、数据库结构及后台权限边界不变。
## 操作后状态
平台总后台的列表、详情、新建和编辑流程已统一采用业务名称。历史异常关系允许查看,但必须修正后才能保存;“暂未分配”关系可以正常创建和更新。
## 验证结果
- 平台、气站、配送点后台 TypeScript 类型检查通过。
- 平台资源页、工作人员策略和组织联动静态契约检查通过。
- 后端工作人员过滤与用户服务关系定向测试通过。
- 三套 Web 后台生产构建通过。
## 风险评估
严格校验可能阻止历史异常记录原样保存,这是确认后的预期行为。工作人员列表新增过滤参数均为可选参数,旧调用保持原行为。

View File

@@ -0,0 +1,60 @@
# 服务关系管理项目文档 v1.1
## 1. 项目概述
- 项目名称:服务关系名称展示统一。
- 主要功能:服务关系在列表、详情、新建和编辑页面统一展示业务名称,并对气站、配送点、服务人员执行前后端组织一致性校验。
- 实施范围:平台总后台、气站后台、配送点后台。
- 技术栈Vue 3、TypeScript、Arco Design。
## 2. 核心实现
三个后台的 `resources.ts` 已统一服务关系字段名称和空值语义。平台总后台是当前唯一暴露服务关系管理菜单和写接口的后台,因此新建、详情、编辑和联动交互在平台总后台实现;气站、配送点后台仅同步共享资源定义,不扩大原有权限范围。
平台总后台共享列表会补载当前页实际引用的关系记录,以业务名称渲染并保留唯一标识的悬停查看与复制能力。详情页展示业务名称和可复制标识;编辑页的用户账户以只读名称显示。
列表名称“服务关系”保持不变,四列表头统一为:
- 用户账户
- 所属气站
- 所属配送点
- 服务人员
新建和编辑页面的组织规则如下:
- 用户账户必选,编辑时不可变更。
- 气站、配送点、服务人员允许同时为空,表示“暂未分配”。
- 选择配送点后自动回填所属气站;切换气站会清理不匹配的配送点。
- 服务人员按当前气站、配送点、启用状态和业务角色精确过滤。
- 历史异常关系允许查看,但再次保存前必须修正。
接口地址、请求字段和数据库结构保持不变。工作人员列表接口新增可选组织过滤参数,旧调用不传参数时行为不变。
## 3. 目录结构
```text
frontend/
├── platform_admin/ # 平台总后台
│ └── src/views/shared/ # 通用列表与名称展示组件
├── gas_admin/ # 气站后台
│ └── src/views/shared/ # 通用列表与名称展示组件
└── delivery_admin/ # 配送点后台
└── src/views/shared/ # 通用列表与名称展示组件
backend/api/internal/logic/platform/
├── staff/ # 服务人员组织范围过滤
└── user/ # 服务关系写入一致性校验
```
## 4. 维护指南
新增类似关联名称列时,应通过字段级配置启用,不得按资源名称硬编码。新增组织关联必须同时提供前端联动和后端最终校验,不得只依赖下拉框过滤。
## 5. 验证记录
- 平台总后台:类型检查、资源页契约、组织联动契约和生产构建通过。
- 气站后台、配送点后台:类型检查及生产构建通过。
- 后端:平台工作人员与用户服务关系定向测试通过。
## 6. 风险评估
风险集中在历史异常数据:详情仍可查看,编辑保存会被严格校验阻止。未新增菜单、角色或写接口,现有权限边界不变;接口字段和数据库结构保持兼容。