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