36 lines
1.8 KiB
Markdown
36 lines
1.8 KiB
Markdown
# 操作日志：合同气瓶空状态引导
|
||
|
||
操作时间：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`：增加字段名、说明和入口回归检查。
|
||
|
||
## 验证与风险
|
||
|
||
本次不修改数据库结构和数据，不放宽候选筛选及绑定校验。新增空状态操作为通用可选配置，未配置的其他关系字段保持原有行为。
|