3.3 KiB
3.3 KiB
项目文档_配送订单合同气瓶名称显示_v1.1
1. 项目概述
本次修复平台总后台配送订单中合同气瓶难以识别的问题。合同绑定对象始终是具体智能气阀，不是整个设备类型；原页面只显示类型快照，导致同类型的多台设备看起来完全相同。
2. 业务规则
- 合同气瓶候选显示“智能气阀名称（设备类型）”。
- 同一合同候选中名称和类型均相同时，为全部重复项追加设备编码。
- 名称取当前智能气阀档案；类型和编码使用合同绑定或订单创建时的历史快照。
- 当前名称缺失或设备已归档时，降级显示“设备编码（设备类型）”；仍无可读字段时显示唯一标识。
- 支持按当前名称、历史类型和历史编码搜索。
- 创建订单下拉、已选标签、合同详情和订单详情使用一致的设备识别信息。
- 不修改数据库表结构，也不回填或覆盖历史数据。
3. 接口说明
平台合同气瓶和订单明细只读响应增加派生字段：
{
"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
操作类型：修改、扩展
影响模块：平台总后台、配送合同、配送订单、合同气瓶
操作前状态：合同绑定具体智能气阀，但订单候选只显示设备类型，同类型设备无法区分。
具体操作：服务端增加当前设备名称派生和名称、类型、编码组合搜索；前端统一显示名称与类型，同名同类型时追加编码；合同和订单详情增加名称列。
操作后状态：业务人员可识别具体智能气阀，同时继续查看合同和订单保存的类型、编码快照。
风险评估：设备改名后派生名称会变化，但历史类型和编码不变；数据库无变更；合同过滤和订单最终校验保持不变。