61 lines
3.3 KiB
Markdown
61 lines
3.3 KiB
Markdown
# 项目文档_配送订单合同气瓶名称显示_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
|
||
|
||
操作类型：修改、扩展
|
||
|
||
影响模块：平台总后台、配送合同、配送订单、合同气瓶
|
||
|
||
操作前状态：合同绑定具体智能气阀，但订单候选只显示设备类型，同类型设备无法区分。
|
||
|
||
具体操作：服务端增加当前设备名称派生和名称、类型、编码组合搜索；前端统一显示名称与类型，同名同类型时追加编码；合同和订单详情增加名称列。
|
||
|
||
操作后状态：业务人员可识别具体智能气阀，同时继续查看合同和订单保存的类型、编码快照。
|
||
|
||
风险评估：设备改名后派生名称会变化，但历史类型和编码不变；数据库无变更；合同过滤和订单最终校验保持不变。
|