优化合同气瓶设备名称显示

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

@@ -206,7 +206,7 @@
 
 创建订单页面必须先选择配送合同，收货地址下拉仅展示该合同签约用户的地址。地址选项以完整地址为主文案并标记默认地址；存在默认地址时自动选中，切换合同时清空原地址。若合同用户没有可用地址，页面应明确引导先维护用户地址并禁止提交。
 
-合同气瓶下拉仅展示所选合同中尚未解绑的气瓶，按气瓶类型和气瓶编码排序，并支持按气瓶编码或类型搜索。选项以气瓶类型名称展示；切换合同时清空原选择。若合同没有可用气瓶，页面应引导先为合同绑定气瓶并禁止提交。合同气瓶管理列表仍保留完整绑定和解绑历史。
+合同气瓶下拉仅展示所选合同中尚未解绑的具体智能气阀，按绑定时的设备类型和设备编码排序，并支持按当前智能气阀名称、设备类型或设备编码搜索。选项显示“智能气阀名称（设备类型）”；同一合同候选中名称和类型均相同时追加设备编码。当前名称缺失时降级显示“设备编码（设备类型）”，再降级为唯一标识。切换合同时清空原选择。合同详情和订单详情均展示当前智能气阀名称，同时保留绑定或下单时的类型、编码快照；设备改名后名称随当前档案变化，历史类型和编码不变。若合同没有可用气瓶，页面应引导先为合同绑定气瓶并禁止提交。合同气瓶管理列表仍保留完整绑定和解绑历史。
 
 订单合同候选必须同时满足“生效中、已到生效时间、尚未到期且到期时间有效”。草稿、未到生效时间、已到期和已终止合同不得进入订单候选；没有可履约合同时应引导管理员先启用或续签合同并禁止提交。
 

docs/项目文档_配送订单合同气瓶名称显示_v1.1.md

@@ -0,0 +1,60 @@
+# 项目文档_配送订单合同气瓶名称显示_v1.1
+
+## 1. 项目概述
+
+本次修复平台总后台配送订单中合同气瓶难以识别的问题。合同绑定对象始终是具体智能气阀，不是整个设备类型；原页面只显示类型快照，导致同类型的多台设备看起来完全相同。
+
+## 2. 业务规则
+
+- 合同气瓶候选显示“智能气阀名称（设备类型）”。
+- 同一合同候选中名称和类型均相同时，为全部重复项追加设备编码。
+- 名称取当前智能气阀档案；类型和编码使用合同绑定或订单创建时的历史快照。
+- 当前名称缺失或设备已归档时，降级显示“设备编码（设备类型）”；仍无可读字段时显示唯一标识。
+- 支持按当前名称、历史类型和历史编码搜索。
+- 创建订单下拉、已选标签、合同详情和订单详情使用一致的设备识别信息。
+- 不修改数据库表结构，也不回填或覆盖历史数据。
+
+## 3. 接口说明
+
+平台合同气瓶和订单明细只读响应增加派生字段：
+
+```json
+{
+  "product_name": "当前智能气阀名称",
+  "product_code": "绑定或下单时设备编码快照",
+  "product_type_name": "绑定或下单时设备类型快照"
+}
+```
+
+`product_name` 通过关联当前 `product_info` 批量查询得到，不写入合同气瓶表或订单明细表。候选接口的 `keyword` 同时匹配名称、类型和编码。
+
+## 4. 核心文件
+
+- `backend/api/internal/logic/platform/gasorder/product_display.go`：派生当前设备名称，提供组合搜索和只读响应。
+- `backend/api/internal/logic/platform/gasorder/gasorder.go`：合同、订单详情接入名称派生查询。
+- `backend/api/internal/logic/platform/gasorder/product_display_test.go`：验证名称关联和三字段搜索。
+- `frontend/platform_admin/src/api/resources.ts`：配置合同气瓶组合标签和搜索提示。
+- `frontend/platform_admin/src/api/resource-display.ts`：生成名称、类型与同名编码消歧标签。
+- `frontend/platform_admin/src/views/resource/ResourceDetailContent.vue`：保证合同和订单详情优先展示名称、编码与类型。
+
+## 5. 维护指南
+
+- 设备改名只影响当前操作界面的名称，不得覆盖合同和订单历史快照。
+- 后续如需保留“绑定当时名称”，必须单独设计名称快照字段和历史迁移方案，不能复用当前派生名称冒充历史名称。
+- 服务端仍须按合同和未解绑状态过滤候选，订单创建时的最终归属校验不可删除。
+
+## 6. 变更记录
+
+操作时间：2026-08-14
+
+操作类型：修改、扩展
+
+影响模块：平台总后台、配送合同、配送订单、合同气瓶
+
+操作前状态：合同绑定具体智能气阀，但订单候选只显示设备类型，同类型设备无法区分。
+
+具体操作：服务端增加当前设备名称派生和名称、类型、编码组合搜索；前端统一显示名称与类型，同名同类型时追加编码；合同和订单详情增加名称列。
+
+操作后状态：业务人员可识别具体智能气阀，同时继续查看合同和订单保存的类型、编码快照。
+
+风险评估：设备改名后派生名称会变化，但历史类型和编码不变；数据库无变更；合同过滤和订单最终校验保持不变。