platforms/docs/操作日志_配送合同关联信息展示_20260812.md

配送合同关联信息展示操作日志

操作时间：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 通过，覆盖直属、平台主管和跨气站配送点边界。

风险评估

• 历史不合规合同仍可查看，但编辑保存时会被新规则拦截；处理方式是清空默认配送点或选择合同气站直属配送点。
• 校验只收紧合同场景，不改变订单分配等其他业务的平台主管组织规则。