Files
platforms/docs/操作日志_合同气瓶绑定入口_20260812.md
czl231 9937e3a508 完善合同气瓶绑定约束与候选过滤
- 明确合同状态、气瓶归属、停用、报废和重复绑定失败原因
- 根据当前合同过滤可绑定气瓶,排除无效及重复候选项
- 从合同列表进入绑定页时锁定预填合同,防止切换上下文
- 切换通用新建页合同后清空旧气瓶并重新加载候选项
- 增加前后端回归检查并同步中文操作日志
2026-08-13 00:10:42 +08:00

43 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 操作日志:合同气瓶绑定入口
操作时间2026-08-12
操作类型:扩展
影响模块:平台总后台配送合同详情页
## 操作前状态
合同气瓶作为隐藏子资源复用合同管理权限,但配送合同详情页没有进入新建页的入口。业务人员只能手动输入隐藏路由,且需要再次选择当前合同。
## 具体操作
- 在配送合同列表的操作列增加“绑定气瓶”按钮,仅草稿状态(`contract_status=0`)显示。
- 合同已启用或处于其他非草稿状态时隐藏绑定按钮,详情页不再展示该入口。
- 跳转合同气瓶新建页时,通过既有关系预填协议带入当前合同唯一标识。
- 从合同列表行进入时锁定预填合同,以可读名称展示且禁止切换到其他合同;直接进入通用新建页时仍允许选择合同。
- 携带当前详情页返回地址,使创建完成后可回到原合同。
- 保留合同气瓶隐藏子路由、后端接口及权限模型,不改变现有公共接口。
- 增加静态回归检查,固定入口展示范围、目标路由、合同预填字段和返回路径。
## 操作后状态
业务人员可从草稿配送合同所在行直接发起气瓶绑定;新建表单自动选中该合同。合同启用后不再提供绑定入口。合同气瓶仍是合同管理下的隐藏子资源,不增加侧边栏菜单。
## 代码变更
- `frontend/platform_admin/src/views/shared/CrudListPage.vue`:在草稿合同操作列增加绑定按钮和跳转方法。
- `frontend/platform_admin/src/views/resource/ResourceRecordPage.vue`:移除详情页绑定入口。
- `frontend/platform_admin/scripts/check-contract-product-entry.mjs`:新增静态回归检查。
- `frontend/platform_admin/package.json`:注册回归检查命令。
## 验证结果
- `npm run contract-product-entry:check`:通过。
- `npm run type:check`:通过。
- `npm run build`通过Vite 成功构建 2620 个模块。
## 风险评估
- 影响仅限配送合同详情页顶部操作区。
- 继续使用既有隐藏新建路由和通用关系预填机制,风险较低。
- 后端仍会校验气瓶归属、状态和是否报废,前端入口不会绕过业务约束。