# 项目文档_配送订单合同气瓶名称显示_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

操作类型：修改、扩展

影响模块：平台总后台、配送合同、配送订单、合同气瓶

操作前状态：合同绑定具体智能气阀，但订单候选只显示设备类型，同类型设备无法区分。

具体操作：服务端增加当前设备名称派生和名称、类型、编码组合搜索；前端统一显示名称与类型，同名同类型时追加编码；合同和订单详情增加名称列。

操作后状态：业务人员可识别具体智能气阀，同时继续查看合同和订单保存的类型、编码快照。

风险评估：设备改名后派生名称会变化，但历史类型和编码不变；数据库无变更；合同过滤和订单最终校验保持不变。