50 lines
2.4 KiB
Markdown
50 lines
2.4 KiB
Markdown
# 项目文档_配送订单创建方动态联动_v1.0
|
||
|
||
## 1. 项目概述
|
||
|
||
本次修复平台总后台创建配送订单时“创建方标识”始终显示“暂无数据”的问题。后端已经支持四种创建方，但前端字段只有关系控件类型，没有绑定数据资源，也没有根据创建方类型切换候选。
|
||
|
||
## 2. 业务规则
|
||
|
||
- 创建方类型支持用户、工作人员、配送站和气站。
|
||
- 未选择创建方类型时，创建方下拉框保持禁用并提示先选择类型。
|
||
- 用户对应 `/user_account`。
|
||
- 工作人员对应 `/staff_account`。
|
||
- 配送站对应 `/delivery_basic`。
|
||
- 气站对应 `/gas_basic`。
|
||
- 切换创建方类型时清空原创建方，防止跨类型提交旧标识。
|
||
- 候选显示用户名、人员显示名称或机构名称等现有业务字段。
|
||
- 后端继续校验创建方类型与唯一标识，不修改数据库。
|
||
|
||
## 3. 核心文件
|
||
|
||
- `frontend/platform_admin/src/api/resources.ts`：声明动态关系配置和四类资源映射。
|
||
- `frontend/platform_admin/src/views/resource/ResourceFieldForm.vue`：动态资源渲染、父类型禁用和选择事件。
|
||
- `frontend/platform_admin/src/views/resource/use-resource-relation-linkage.ts`：动态候选加载、搜索与类型切换清理。
|
||
- `frontend/platform_admin/scripts/check-gasorder-creator-linkage.mjs`：创建方动态联动专项检查。
|
||
|
||
## 4. 维护指南
|
||
|
||
- 新增创建方类型时必须同时更新后端 `gasorderCreatorModels` 和前端动态资源映射。
|
||
- 不得把不同模型的唯一标识混放在同一个静态候选列表中。
|
||
- 切换父类型必须先清空原值，再加载新类型候选。
|
||
- 动态关系能力是通用扩展，其他多类型主体字段可复用，避免页面级硬编码。
|
||
|
||
## 5. 变更记录
|
||
|
||
操作时间：2026-08-14
|
||
|
||
操作类型：修复、扩展
|
||
|
||
影响模块：平台总后台、气体配送订单创建
|
||
|
||
操作前状态：创建方标识没有关系资源，选择创建方类型后仍显示“暂无数据”。
|
||
|
||
具体操作：增加父字段驱动的动态关系配置，接入候选加载、搜索、禁用和切换清理流程。
|
||
|
||
操作后状态：管理员选择创建方类型后可选择对应业务主体，切换类型会清空旧选择。
|
||
|
||
验证范围：前端专项检查、类型检查、生产构建和既有资源契约检查。
|
||
|
||
风险评估：后端接口和数据库不变；动态关系仅在显式配置字段启用，不影响既有固定关系字段。
|