platforms/docs/项目文档_配送合同关联信息展示_v1.0.md

配送合同关联信息展示项目文档 v1.0

项目概述

本次调整统一平台总后台、气站后台和配送点后台的配送合同关联信息展示。用户、气站和配送点以业务名称为主，唯一标识保留为悬浮查看与点击复制能力。平台总后台创建或编辑合同时，默认配送点只能选择合同气站的直属配送点。

主要功能

• 合同列表、详情、新建及编辑场景优先展示用户、气站、配送点业务名称。
• 合同唯一标识继续保留；合同编号支持悬浮查看完整值并点击复制。
• 平台端“所属气站”联动筛选“所属配送点”，配送点允许留空并显示“暂未指定”。
• 用户和气站作为合同不可变归属，编辑页以只读名称展示并保留标识复制。
• 平台直属配送点和其他气站配送点不能绑定到气站合同。

目录与核心文件

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）：完成三端合同名称展示、标识复制、平台组织联动及后端直属归属校验。