优化配送订单合同气瓶候选显示

docs/05-平台总后台需求.md

@@ -204,6 +204,8 @@
 
 创建订单页面必须先选择配送合同，收货地址下拉仅展示该合同签约用户的地址。地址选项以完整地址为主文案并标记默认地址；存在默认地址时自动选中，切换合同时清空原地址。若合同用户没有可用地址，页面应明确引导先维护用户地址并禁止提交。
 
+合同气瓶下拉仅展示所选合同中尚未解绑的气瓶，按气瓶类型和气瓶编码排序，并支持按气瓶编码或类型搜索。选项以气瓶类型名称展示；切换合同时清空原选择。若合同没有可用气瓶，页面应引导先为合同绑定气瓶并禁止提交。合同气瓶管理列表仍保留完整绑定和解绑历史。
+
 订单合同候选必须同时满足“生效中、已到生效时间、尚未到期且到期时间有效”。草稿、未到生效时间、已到期和已终止合同不得进入订单候选；没有可履约合同时应引导管理员先启用或续签合同并禁止提交。
 
 订单状态机如下：

docs/项目文档_配送订单合同气瓶显示优化_v1.0.md

@@ -0,0 +1,59 @@
+# 项目文档_配送订单合同气瓶显示优化_v1.0
+
+## 1. 项目概述
+
+本次优化平台总后台创建配送订单时的合同气瓶选择体验。原下拉框使用绑定记录唯一标识作为主文案，业务人员无法直接识别气瓶；同时前端携带的合同筛选参数未被列表接口应用，可能混入其他合同或已经解绑的记录。
+
+## 2. 业务规则
+
+- 创建订单前必须先选择配送合同。
+- 合同气瓶候选仅包含所选合同中尚未解绑的绑定记录。
+- 候选按气瓶类型名称、气瓶编码升序排列。
+- 支持按气瓶编码和气瓶类型名称搜索。
+- 选项显示气瓶类型名称，类型名称缺失时才降级显示唯一标识。
+- 多选后完整展示全部已选气瓶标签，方便业务人员逐项核对。
+- 切换配送合同时清空已选气瓶，并重新加载当前合同候选。
+- 没有候选时提示先为合同绑定气瓶，并禁止提交。
+- 合同气瓶管理列表不带合同筛选参数时继续展示完整历史。
+- 不新增订单占用规则，不修改数据库结构和现有数据。
+
+## 3. 接口说明
+
+订单表单继续复用平台接口：
+
+```text
+GET /gasorder_contract_product?contract_identity=<配送合同唯一标识>&keyword=<可选搜索词>
+```
+
+传入 `contract_identity` 时，接口按合同内部主键和 `unbound_at IS NULL` 精确过滤。未传入时保持原管理列表行为，以兼容历史查询。
+
+## 4. 核心文件
+
+- `backend/api/internal/logic/platform/gasorder/gasorder.go`：合同气瓶候选过滤与排序。
+- `backend/api/internal/logic/platform/gasorder/gasorder_test.go`：候选 SQL 规则测试。
+- `frontend/platform_admin/src/api/resources.ts`：业务标签和空状态配置。
+- `frontend/platform_admin/src/api/resource-display.ts`：多字段关系标签组合。
+- `frontend/platform_admin/src/views/resource/ResourceFieldForm.vue`：父级选择顺序提示。
+- `frontend/platform_admin/scripts/check-gasorder-contract-product-display.mjs`：前端专项静态检查。
+
+## 5. 维护指南
+
+- 不得在订单候选中取消合同和未解绑条件，服务端最终创建校验仍需保留。
+- 若未来增加“订单占用气瓶”的排他规则，应先补充业务状态定义，再单独扩展候选和创建校验。
+- 新增组合关系标签时优先配置 `relationOptionLabelKeys`，不要在通用组件中硬编码资源名称。
+
+## 6. 变更记录
+
+操作时间：2026-08-13
+
+操作类型：修改、扩展
+
+影响模块：平台总后台、气体配送订单、合同气瓶
+
+操作前状态：下拉选项显示绑定记录唯一标识，合同筛选参数未生效，可能出现跨合同或已解绑候选。
+
+具体操作：增加服务端候选过滤与排序，扩展前端气瓶类型名称标签、完整多选展示、搜索提示和空候选引导。
+
+操作后状态：业务人员可通过气瓶类型名称识别候选，订单页面只展示当前合同尚未解绑的气瓶。
+
+风险评估：管理列表不带筛选参数时保持原行为；数据库无变更；订单创建最终校验保持不变。