platforms/docs/项目文档_配送订单创建方动态联动_v1.0.md

项目文档_配送订单创建方动态联动_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

操作类型：修复、扩展

影响模块：平台总后台、气体配送订单创建

操作前状态：创建方标识没有关系资源，选择创建方类型后仍显示“暂无数据”。

具体操作：增加父字段驱动的动态关系配置，接入候选加载、搜索、禁用和切换清理流程。

操作后状态：管理员选择创建方类型后可选择对应业务主体，切换类型会清空旧选择。

验证范围：前端专项检查、类型检查、生产构建和既有资源契约检查。

风险评估：后端接口和数据库不变；动态关系仅在显式配置字段启用，不影响既有固定关系字段。