3cad8fd0ba
三端合同页面改为优先显示用户、气站和配送点业务名称，并保留标识与合同编号复制能力。 平台端增加气站与直属配送点联动，后端禁止平台主管及跨气站配送点绑定合同，同时补充测试和中文文档。
42 lines
2.3 KiB
Markdown
42 lines
2.3 KiB
Markdown
# 配送合同关联信息展示项目文档 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）：完成三端合同名称展示、标识复制、平台组织联动及后端直属归属校验。
|