platforms/docs/操作日志_合同气瓶空状态引导_20260814.md

操作日志：合同气瓶空状态引导

操作时间：2026-08-14

操作类型：修改、扩展

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

操作前状态

草稿合同没有可绑定设备时，智能气阀下拉仅显示“暂无数据”。管理员无法得知设备必须先归属合同用户并处于启用、未报废状态；启用合同失败提示也没有完整说明处理顺序。

具体操作

• 将合同气瓶绑定表单字段标题从“智能气阀唯一标识”改为“智能气阀”。
• 空候选明确提示设备归属、启用状态和报废状态要求。
• 增加“前往智能气阀管理”站内入口。
• 启用合同失败时提示先绑定智能气阀；无候选时引导先变更设备归属。
• 保留服务端“设备必须属于合同用户”的最终校验，不允许跨用户绑定。

操作后状态

管理员可以从空状态直接进入智能气阀管理，完成“变更智能气阀归属”，返回合同列表绑定设备后再启用合同。

代码变更

• backend/api/internal/logic/platform/gasorder/gasorder.go：完善合同无有效智能气阀时的业务提示。
• backend/api/internal/logic/platform/gasorder/contract_change_error_test.go：固定中文错误信息。
• frontend/platform_admin/src/api/resources.ts：配置业务字段名、空状态说明和跳转入口。
• frontend/platform_admin/src/views/resource/ResourceFieldForm.vue：支持关系空状态站内操作按钮。
• frontend/platform_admin/scripts/check-contract-product-entry.mjs：增加字段名、说明和入口回归检查。

验证与风险

本次不修改数据库结构和数据，不放宽候选筛选及绑定校验。新增空状态操作为通用可选配置，未配置的其他关系字段保持原有行为。