3cad8fd0ba
三端合同页面改为优先显示用户、气站和配送点业务名称，并保留标识与合同编号复制能力。 平台端增加气站与直属配送点联动，后端禁止平台主管及跨气站配送点绑定合同，同时补充测试和中文文档。
48 lines
2.6 KiB
Markdown
48 lines
2.6 KiB
Markdown
# 配送合同关联信息展示操作日志
|
||
|
||
操作时间：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` 通过，覆盖直属、平台主管和跨气站配送点边界。
|
||
|
||
## 风险评估
|
||
|
||
- 历史不合规合同仍可查看，但编辑保存时会被新规则拦截；处理方式是清空默认配送点或选择合同气站直属配送点。
|
||
- 校验只收紧合同场景，不改变订单分配等其他业务的平台主管组织规则。
|