功能:完善用户服务关系展示与组织联动
统一平台、气站和配送点后台的服务关系业务名称展示。 新增气站、配送点、服务人员三级联动及暂未分配语义。 后端补充组织归属、人员角色和启用状态的严格校验。 补充前后端测试、项目文档、操作日志及本机日志忽略规则。
This commit is contained in:
70
docs/操作日志_服务关系名称展示_20260811.md
Normal file
70
docs/操作日志_服务关系名称展示_20260811.md
Normal 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 后台生产构建通过。
|
||||
|
||||
## 风险评估
|
||||
|
||||
严格校验可能阻止历史异常记录原样保存,这是确认后的预期行为。工作人员列表新增过滤参数均为可选参数,旧调用保持原行为。
|
||||
60
docs/项目文档_服务关系名称展示_v1.0.md
Normal file
60
docs/项目文档_服务关系名称展示_v1.0.md
Normal 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. 风险评估
|
||||
|
||||
风险集中在历史异常数据:详情仍可查看,编辑保存会被严格校验阻止。未新增菜单、角色或写接口,现有权限边界不变;接口字段和数据库结构保持兼容。
|
||||
Reference in New Issue
Block a user