完善配送合同关联信息展示与归属校验
三端合同页面改为优先显示用户、气站和配送点业务名称,并保留标识与合同编号复制能力。 平台端增加气站与直属配送点联动,后端禁止平台主管及跨气站配送点绑定合同,同时补充测试和中文文档。
This commit is contained in:
47
docs/操作日志_配送合同关联信息展示_20260812.md
Normal file
47
docs/操作日志_配送合同关联信息展示_20260812.md
Normal file
@@ -0,0 +1,47 @@
|
||||
# 配送合同关联信息展示操作日志
|
||||
|
||||
操作时间:2026-08-12
|
||||
|
||||
操作类型:修改、扩展
|
||||
|
||||
影响模块:平台总后台、气站后台、配送点后台、配送合同后端逻辑
|
||||
|
||||
## 操作前状态
|
||||
|
||||
合同列表直接展示用户、气站和配送点唯一标识,业务人员难以辨认;平台合同后端允许将平台主管配送点绑定到必填气站,与气站需求中的直属配送点规则不一致。
|
||||
|
||||
## 具体操作
|
||||
|
||||
- 三端合同资源定义增加业务名称列表标签、关系名称展示、标识复制及空值文案。
|
||||
- 平台端为气站与默认配送点增加父子联动,按所选气站查询直属配送点。
|
||||
- 合同编号使用可复制紧凑文本,悬浮可查看完整值。
|
||||
- 气站端和配送点端详情复用关系名称组件展示关联对象。
|
||||
- 后端新增合同配送点直属归属判定,排除平台主管配送点和跨气站配送点。
|
||||
- 增加后端边界测试,并更新前端联动配置检查数量。
|
||||
|
||||
## 行为变化
|
||||
|
||||
- 变更前:关联列主显唯一标识;平台 API 接受平台主管配送点。
|
||||
- 变更后:关联列主显业务名称并可复制标识;平台 API 仅接受合同气站直属配送点或空配送点。
|
||||
|
||||
## 代码变更
|
||||
|
||||
- `frontend/platform_admin/src/api/resources.ts`:合同字段展示及配送点联动配置。
|
||||
- `frontend/platform_admin/src/views/shared/CrudListPage.vue`:普通字段可复制列表展示。
|
||||
- `frontend/gas_admin/src/api/resources.ts`、`frontend/delivery_admin/src/api/resources.ts`:各自可见合同关联字段配置。
|
||||
- `frontend/gas_admin/src/views/shared/CrudListPage.vue`、`frontend/delivery_admin/src/views/shared/CrudListPage.vue`:详情关系名称展示。
|
||||
- `backend/api/internal/logic/platform/gasorder/gasorder.go`:合同配送点直属归属校验。
|
||||
- `backend/api/internal/logic/platform/gasorder/gasorder_test.go`:直属、平台主管和跨气站边界测试。
|
||||
|
||||
## 验证结果
|
||||
|
||||
- 平台、气站、配送点前端 `type:check` 均通过。
|
||||
- 三个 Web 前端生产构建均通过。
|
||||
- 平台工作人员/服务关系/合同组织联动检查通过。
|
||||
- 平台标准资源独立页面检查通过:详情 46 类、新建 25 类、编辑 23 类。
|
||||
- 后端 `go test ./internal/logic/platform/gasorder` 通过,覆盖直属、平台主管和跨气站配送点边界。
|
||||
|
||||
## 风险评估
|
||||
|
||||
- 历史不合规合同仍可查看,但编辑保存时会被新规则拦截;处理方式是清空默认配送点或选择合同气站直属配送点。
|
||||
- 校验只收紧合同场景,不改变订单分配等其他业务的平台主管组织规则。
|
||||
41
docs/项目文档_配送合同关联信息展示_v1.0.md
Normal file
41
docs/项目文档_配送合同关联信息展示_v1.0.md
Normal file
@@ -0,0 +1,41 @@
|
||||
# 配送合同关联信息展示项目文档 v1.0
|
||||
|
||||
## 项目概述
|
||||
|
||||
本次调整统一平台总后台、气站后台和配送点后台的配送合同关联信息展示。用户、气站和配送点以业务名称为主,唯一标识保留为悬浮查看与点击复制能力。平台总后台创建或编辑合同时,默认配送点只能选择合同气站的直属配送点。
|
||||
|
||||
## 主要功能
|
||||
|
||||
- 合同列表、详情、新建及编辑场景优先展示用户、气站、配送点业务名称。
|
||||
- 合同唯一标识继续保留;合同编号支持悬浮查看完整值并点击复制。
|
||||
- 平台端“所属气站”联动筛选“所属配送点”,配送点允许留空并显示“暂未指定”。
|
||||
- 用户和气站作为合同不可变归属,编辑页以只读名称展示并保留标识复制。
|
||||
- 平台直属配送点和其他气站配送点不能绑定到气站合同。
|
||||
|
||||
## 目录与核心文件
|
||||
|
||||
```text
|
||||
platforms/
|
||||
├── frontend/platform_admin/src/api/resources.ts # 平台合同字段展示与组织联动配置
|
||||
├── frontend/gas_admin/src/api/resources.ts # 气站合同可见关联字段配置
|
||||
├── frontend/delivery_admin/src/api/resources.ts # 配送点合同用户字段配置
|
||||
├── backend/api/internal/logic/platform/gasorder/ # 合同配送点归属校验及测试
|
||||
└── docs/ # 项目文档与操作日志
|
||||
```
|
||||
|
||||
## 行为规则
|
||||
|
||||
1. 平台合同必须选择用户和气站,默认配送点可留空。
|
||||
2. 选择默认配送点时,该配送点的 `gas_basic_id` 必须等于合同气站 ID。
|
||||
3. `gas_basic_id = 0` 的平台主管配送点不属于具体气站,因此不能用于气站合同。
|
||||
4. 历史记录仍可查看;若历史合同保存了不合规配送点,再次编辑保存前必须清空或改选直属配送点。
|
||||
|
||||
## 维护与验证
|
||||
|
||||
- 修改关联展示时优先复用 `RelationNameText` 和资源字段配置,避免为单一页面硬编码。
|
||||
- 修改组织归属规则时同步运行平台前端联动检查、三端构建和后端 `gasorder` 单元测试。
|
||||
- 后端仍接受空配送点,保持原有“默认配送点可选”接口兼容性。
|
||||
|
||||
## 变更记录
|
||||
|
||||
- v1.0(2026-08-12):完成三端合同名称展示、标识复制、平台组织联动及后端直属归属校验。
|
||||
Reference in New Issue
Block a user