5.6 KiB
5.6 KiB
运输计划 · 保存并安排运输(设计)
日期: 2026-07-19
状态: 已实现
范围: web-admin 运输计划新增/编辑弹窗快捷入口;运输计划归档页隐藏编辑
背景
运输计划新增/编辑弹窗(PlPlanFormDialog)当前底栏仅有「取消」与「创建/保存」。创建计划与安排运输是两步:保存后需回列表再点「安排运输」。
当计划产品不含易制毒/易制爆(或证书已齐备)时,用户希望保存后立刻进入安排运输,减少往返。
后端 create-full 明确「不自动安排运输」;安排运输仍由独立弹窗与 API 完成。本需求不改变该边界,仅做前端串联。
目标
- 在新增/编辑弹窗增加「创建/保存并安排运输」主按钮,保存成功后自动打开现有「安排运输」弹窗。
- 保留原「创建/保存」,供需补证书或稍后安排的场景。
- 运输计划归档页不再提供编辑运输计划入口。
非目标
- 不新增后端「创建并安排」合并接口
- 不把安排运输表单内嵌进计划表单
- 不提供「保存并调整运输」入口(已安排后不显示该快捷按钮)
- 不修改安排运输弹窗内部逻辑、危化品证上传页逻辑
决策摘要
| 编号 | 决策 | 说明 |
|---|---|---|
| D1 | 底栏方案 A | 取消 · 创建/保存(描边)· 创建/保存并安排运输(主色) |
| D2 | 实现路径 1 | 前端串联:保存 → 可选打开现有安排弹窗;无新 API |
| D3 | 证书未齐备 | 仍保存计划,提示无法安排的原因,不打开安排弹窗 |
| D4 | 显隐 | 新增始终显示「并安排」;编辑仅 transportStatus === 'pending' 时显示 |
| D5 | 取消安排 | 计划已保存,状态仍为「待安排」,可稍后在列表再安排 |
| D6 | 归档页 | 隐藏所有「编辑」入口,不打开计划表单弹窗 |
交互设计
底栏
| 场景 | 底栏按钮 |
|---|---|
| 新增 | 取消 · 创建(描边)· 创建并安排运输(主色) |
| 编辑且未安排 | 取消 · 保存(描边)· 保存并安排运输(主色) |
| 编辑且已安排 | 取消 · 保存(主色);不显示「并安排」 |
规则:
- 有「并安排」按钮时,它是唯一
type="primary";「创建/保存」为中性描边。 - 无「并安排」时,「保存」恢复为主色(与现网一致)。
- 按钮须带 Element Plus 图标(与 OpenSpec UI 约定一致)。
「创建/保存并安排运输」流程
- 校验:与现有创建/保存相同(基础表单校验、已选合同、至少一条产品)。
- 保存:调用现有
POST /transport/plan/create-full或PUT /transport/plan/{id},取得planId。 - 危化品门禁(前端):复用
shouldBlockTransportForHazardCert/buildMissingHazardCertReadyMessage(与安排弹窗一致)。- 需拦截:成功提示保存完成 + 说明无法安排的原因 → 关闭表单 → 不打开安排弹窗。
- 可通过:关闭表单 → 打开现有「安排运输」弹窗(
planId)。
- 安排弹窗:用户照常填写并提交;若取消,计划保留为「待安排」(D5)。
「创建/保存」
行为与现网一致:仅保存,关闭弹窗,不打开安排运输。
运输计划归档页
- 隐藏工具栏「编辑」与查看弹窗 hero「编辑」。
- 可移除或闲置
PlPlanFormDialog挂载(以实现时最小改动为准;至少保证无 UI 入口)。 - 归档/查看流程不变。
组件与数据流
PlPlanFormDialog
handleSubmit(mode: 'save' | 'saveAndArrange')
→ createFull / update
→ emit('success', { planId, openArrange: boolean })
plan/index.vue
handlePlanMutationSuccess(payload)
→ 刷新列表
→ if openArrange: 打开 PlPlanArrangeDialog(planId)
事件约定:
- 仅保存:
{ planId, openArrange: false }(或等价兼容:无 payload 时视为仅刷新)。 - 保存并安排且通过门禁:
{ planId, openArrange: true }。 - 保存并安排但被门禁拦截:
{ planId, openArrange: false }(计划已保存)。
planId 来源:新建取接口返回的 id;编辑用当前 planId。
错误处理
| 情况 | 行为 |
|---|---|
| 表单校验失败 | 不提交,与现网一致 |
| 保存 API 失败 | 不关闭弹窗、不打开安排,展示错误 |
| 证书未齐备 | 保存成功后提示原因,不打开安排 |
| 安排弹窗内提交失败 | 由安排弹窗自行处理;计划仍为待安排或按安排 API 结果更新 |
验收要点
- V1:新增弹窗可见「创建」+「创建并安排运输」,主色在后者。
- V2:编辑未安排计划可见「保存并安排运输」;已安排则不可见。
- V3:普通品点「并安排」→ 保存成功 → 自动打开安排运输弹窗。
- V4:含危化品且证书未齐备 → 计划已保存 → 提示原因 → 不打开安排。
- V5:安排弹窗取消 → 列表中计划存在且为待安排。
- V6:运输计划归档页无编辑入口。
参考代码
- 表单:
web-admin/src/components/business/pl-plan-form-dialog/index.vue - 列表:
web-admin/src/views/pl/plan/index.vue - 安排弹窗:
web-admin/src/components/business/pl-plan-arrange-dialog/index.vue - 证书门禁:
web-admin/src/composables/usePlToxicProductCertCheck.ts - 归档页:
web-admin/src/views/pl/plan-archive/index.vue - 计划冻结(入库/出库已安排不可编辑):
isIoPlanFrozen(列表既有逻辑,本需求不扩展调整运输)