361 lines
11 KiB
Markdown
361 lines
11 KiB
Markdown
# 运输计划 · 保存并安排运输 Implementation Plan
|
||
|
||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||
|
||
**Goal:** 在运输计划新增/编辑弹窗增加「创建/保存并安排运输」主按钮(前端串联打开安排弹窗),并在运输计划归档页隐藏编辑入口。
|
||
|
||
**Architecture:** 仅前端改动。`PlPlanFormDialog` 保存成功后通过 `success({ planId, openArrange })` 通知列表页;列表页刷新后按需打开现有 `PlPlanArrangeDialog`。危化品门禁复用 `buildMissingHazardCertReadyMessage`(保存后 `GET` 计划详情再判断)。无新后端 API。
|
||
|
||
**Tech Stack:** Vue 3 + Element Plus + TypeScript;`@/api/pl`、`@/utils/http/bx`(`pickBxData`)、`usePlToxicProductCertCheck`。
|
||
|
||
**Spec:** `docs/superpowers/specs/2026-07-19-pl-plan-save-and-arrange-design.md`
|
||
|
||
---
|
||
|
||
## File map
|
||
|
||
| 职责 | 路径 |
|
||
|------|------|
|
||
| 表单底栏 + 保存/保存并安排 | `web-admin/src/components/business/pl-plan-form-dialog/index.vue` |
|
||
| 列表接事件并打开安排弹窗 | `web-admin/src/views/pl/plan/index.vue` |
|
||
| 归档页隐藏编辑 | `web-admin/src/views/pl/plan-archive/index.vue` |
|
||
| 设计文档(已完成) | `docs/superpowers/specs/2026-07-19-pl-plan-save-and-arrange-design.md` |
|
||
|
||
---
|
||
|
||
### Task 1: PlPlanFormDialog — 底栏显隐与双提交
|
||
|
||
**Files:**
|
||
- Modify: `web-admin/src/components/business/pl-plan-form-dialog/index.vue`
|
||
|
||
- [ ] **Step 1: 扩展 emit 与编辑态运输状态**
|
||
|
||
在 `<script setup>` 中:
|
||
|
||
1. 将 `Van` 加入 `@element-plus/icons-vue` 的 import。
|
||
2. 增加 import:
|
||
|
||
```ts
|
||
import {
|
||
enrichPlanProductsHazardFromCrm,
|
||
buildMissingHazardCertReadyMessage
|
||
} from '@/composables/usePlToxicProductCertCheck'
|
||
import { pickBxData } from '@/utils/http/bx'
|
||
```
|
||
|
||
(注意:文件已 import `enrichPlanProductsHazardFromCrm`,合并进同一条 import,勿重复。)
|
||
|
||
3. 将 emit 改为:
|
||
|
||
```ts
|
||
const emit = defineEmits<{
|
||
'update:visible': [value: boolean]
|
||
success: [payload?: { planId: string; openArrange: boolean }]
|
||
}>()
|
||
```
|
||
|
||
4. 增加 ref,并在 `resetForm` 中清零;在 `loadPlanForEdit` 赋值:
|
||
|
||
```ts
|
||
const loadedTransportStatus = ref('pending')
|
||
const loadedHazardCertReady = ref(0)
|
||
|
||
// resetForm 内:
|
||
loadedTransportStatus.value = 'pending'
|
||
loadedHazardCertReady.value = 0
|
||
|
||
// loadPlanForEdit 在 Object.assign 之后:
|
||
loadedTransportStatus.value = data.transportStatus || 'pending'
|
||
loadedHazardCertReady.value = Number(data.hazardCertReady ?? 0)
|
||
```
|
||
|
||
5. 增加计算属性:
|
||
|
||
```ts
|
||
const showSaveAndArrange = computed(
|
||
() => !isEdit.value || loadedTransportStatus.value === 'pending'
|
||
)
|
||
|
||
const saveButtonLabel = computed(() => (isEdit.value ? '保存' : '创建'))
|
||
|
||
const saveAndArrangeLabel = computed(() =>
|
||
isEdit.value ? '保存并安排运输' : '创建并安排运输'
|
||
)
|
||
```
|
||
|
||
- [ ] **Step 2: 改 template footer**
|
||
|
||
将现有 `#footer` 替换为:
|
||
|
||
```vue
|
||
<template #footer>
|
||
<div class="dialog-footer">
|
||
<el-button @click="innerVisible = false">
|
||
<el-icon><Close /></el-icon>取消
|
||
</el-button>
|
||
<el-button
|
||
:type="showSaveAndArrange ? 'default' : 'primary'"
|
||
:class="showSaveAndArrange ? 'btn-ghost' : undefined"
|
||
:loading="submitLoading"
|
||
@click="handleSubmit('save')"
|
||
>
|
||
<el-icon><Check /></el-icon>{{ saveButtonLabel }}
|
||
</el-button>
|
||
<el-button
|
||
v-if="showSaveAndArrange"
|
||
type="primary"
|
||
:loading="submitLoading"
|
||
@click="handleSubmit('saveAndArrange')"
|
||
>
|
||
<el-icon><Van /></el-icon>{{ saveAndArrangeLabel }}
|
||
</el-button>
|
||
</div>
|
||
</template>
|
||
```
|
||
|
||
- [ ] **Step 3: 重写 `handleSubmit`**
|
||
|
||
用下列实现替换现有 `handleSubmit`(保留 `validateBusinessRules` 不变):
|
||
|
||
```ts
|
||
async function handleSubmit(mode: 'save' | 'saveAndArrange' = 'save') {
|
||
const valid = await basicFormRef.value?.validate().catch(() => false)
|
||
if (!valid || !validateBusinessRules()) return
|
||
|
||
submitLoading.value = true
|
||
try {
|
||
const commonPayload = buildPlanCommonPayload({ allowClearTransport: isEdit.value })
|
||
let planId = props.planId || ''
|
||
|
||
if (isEdit.value) {
|
||
if (!props.planId) return
|
||
await planApi.update(props.planId, commonPayload)
|
||
planId = props.planId
|
||
ElMessage.success('保存成功')
|
||
} else {
|
||
const res = await planApi.createFull({
|
||
...commonPayload,
|
||
contractId: formData.contractId
|
||
} as Parameters<typeof planApi.createFull>[0])
|
||
const created = pickBxData<Plan>(res)
|
||
planId = String(created?.id || '')
|
||
if (!planId) {
|
||
ElMessage.error('创建成功但未返回计划 ID')
|
||
return
|
||
}
|
||
ElMessage.success('创建成功')
|
||
}
|
||
|
||
let openArrange = false
|
||
if (mode === 'saveAndArrange' && planId) {
|
||
const detailRes = await planApi.get(planId)
|
||
const plan = pickBxData<Plan>(detailRes)
|
||
const rawProducts = Array.isArray(plan?.products) ? plan.products : []
|
||
const enrichedProducts = await enrichPlanProductsHazardFromCrm(rawProducts)
|
||
const certMessage = buildMissingHazardCertReadyMessage(plan, enrichedProducts)
|
||
if (certMessage) {
|
||
await ElMessageBox.alert(
|
||
`${certMessage},请至【危化品证上传】页面操作。`,
|
||
'无法安排运输',
|
||
{ type: 'warning' }
|
||
)
|
||
openArrange = false
|
||
} else {
|
||
openArrange = true
|
||
}
|
||
}
|
||
|
||
innerVisible.value = false
|
||
emit('success', { planId, openArrange })
|
||
} finally {
|
||
submitLoading.value = false
|
||
}
|
||
}
|
||
```
|
||
|
||
说明:拦截文案与 `pl-plan-arrange-dialog` 保持一致;`loadedHazardCertReady` 供后续扩展,门禁以 `GET` 详情为准。
|
||
|
||
- [ ] **Step 4: 本地目视确认**
|
||
|
||
Run: 打开 `http://localhost:3006/#/pl/plan-module/plan`,点「新增计划」,确认底栏为「取消 · 创建 · 创建并安排运输」(后者主色)。
|
||
|
||
Expected: 双按钮布局正确;未点提交即可。
|
||
|
||
- [ ] **Step 5: Commit(若用户要求提交时再执行)**
|
||
|
||
```bash
|
||
git add web-admin/src/components/business/pl-plan-form-dialog/index.vue
|
||
git commit -m "$(cat <<'EOF'
|
||
feat(pl): add save-and-arrange action on transport plan form dialog
|
||
|
||
EOF
|
||
)"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 2: 运输计划列表 — 串联安排弹窗
|
||
|
||
**Files:**
|
||
- Modify: `web-admin/src/views/pl/plan/index.vue`
|
||
|
||
- [ ] **Step 1: 扩展 `handlePlanMutationSuccess`**
|
||
|
||
将:
|
||
|
||
```ts
|
||
async function handlePlanMutationSuccess() {
|
||
await fetchData()
|
||
await refreshViewIfOpen()
|
||
}
|
||
```
|
||
|
||
替换为:
|
||
|
||
```ts
|
||
async function handlePlanMutationSuccess(payload?: { planId?: string; openArrange?: boolean }) {
|
||
await fetchData()
|
||
await refreshViewIfOpen()
|
||
if (payload?.openArrange && payload.planId) {
|
||
arrangePlanId.value = payload.planId
|
||
arrangeDialogVisible.value = true
|
||
}
|
||
}
|
||
```
|
||
|
||
说明:`PlPlanArrangeDialog` 的 `@success="handlePlanMutationSuccess"` 无 payload,行为仍为仅刷新,兼容不变。
|
||
|
||
- [ ] **Step 2: 手动验收(对照 spec V1–V5)**
|
||
|
||
| 用例 | 操作 | Expected |
|
||
|------|------|----------|
|
||
| V1 | 新增弹窗底栏 | 创建(描边)+ 创建并安排运输(主色) |
|
||
| V3 | 普通品「创建并安排运输」 | 保存后自动打开安排运输弹窗 |
|
||
| V5 | 安排弹窗点取消 | 列表有该计划,运输状态待安排 |
|
||
| V4 | 含危化品且证书未齐 | 计划已保存;Alert 说明原因;不打开安排 |
|
||
| V2 | 编辑已安排(直销若仍可编辑) | 无「保存并安排运输」,仅「保存」主色 |
|
||
|
||
- [ ] **Step 3: Commit(若用户要求提交时再执行)**
|
||
|
||
```bash
|
||
git add web-admin/src/views/pl/plan/index.vue
|
||
git commit -m "$(cat <<'EOF'
|
||
feat(pl): open arrange dialog after plan save-and-arrange
|
||
|
||
EOF
|
||
)"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 3: 运输计划归档 — 隐藏编辑
|
||
|
||
**Files:**
|
||
- Modify: `web-admin/src/views/pl/plan-archive/index.vue`
|
||
|
||
- [ ] **Step 1: 去掉工具栏编辑按钮**
|
||
|
||
删除模板中约 99–106 行的编辑按钮块:
|
||
|
||
```vue
|
||
<el-button
|
||
v-if="selectedPlan && selectedPlan.followStatus !== 'cancelled'"
|
||
class="btn-ghost"
|
||
:disabled="selectedRows.length !== 1"
|
||
@click="handleToolbarEdit"
|
||
>
|
||
<el-icon><Edit /></el-icon>编辑
|
||
</el-button>
|
||
```
|
||
|
||
- [ ] **Step 2: 去掉查看弹窗 hero「编辑」**
|
||
|
||
在 `PlPlanViewDialog` 的 `#hero-actions` 中删除编辑按钮(保留归档按钮),即删除:
|
||
|
||
```vue
|
||
<el-button
|
||
v-if="viewingPlan.followStatus !== 'cancelled'"
|
||
class="btn-main"
|
||
type="primary"
|
||
@click="handleEdit(viewingPlan)"
|
||
>
|
||
<el-icon><Edit /></el-icon>编辑
|
||
</el-button>
|
||
```
|
||
|
||
若删除后 hero 仅剩归档按钮,将归档按钮改为 `type="primary"` / `class="btn-main"`(保持一行一个主色)。
|
||
|
||
- [ ] **Step 3: 移除闲置表单弹窗与相关代码**
|
||
|
||
删除:
|
||
|
||
1. 模板中的 `<PlPlanFormDialog ... />`
|
||
2. `import PlPlanFormDialog ...`
|
||
3. `import { Edit } from ...`(若已无其它引用)
|
||
4. `formDialogVisible`、`editingPlanId`
|
||
5. `handleEdit`、`handleToolbarEdit`
|
||
6. `handlePlanMutationSuccess` 中若仅服务于表单,可改为只服务归档弹窗的 refresh(保留对 archive dialog `@success` 的刷新逻辑)
|
||
|
||
核对:归档弹窗、查看弹窗仍正常工作。
|
||
|
||
- [ ] **Step 4: 手动验收 V6**
|
||
|
||
Run: 打开 `http://localhost:3006/#/pl/plan-module/plan-archive`
|
||
|
||
Expected: 工具栏与查看弹窗均无「编辑」;归档/调整归档仍可用。
|
||
|
||
- [ ] **Step 5: Commit(若用户要求提交时再执行)**
|
||
|
||
```bash
|
||
git add web-admin/src/views/pl/plan-archive/index.vue
|
||
git commit -m "$(cat <<'EOF'
|
||
fix(pl): hide edit transport plan on archive list page
|
||
|
||
EOF
|
||
)"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 4: 收尾
|
||
|
||
**Files:**
|
||
- 无新文件;按需更新知识图谱
|
||
|
||
- [ ] **Step 1: 对照 spec 勾选覆盖**
|
||
|
||
| Spec | Task |
|
||
|------|------|
|
||
| D1 底栏方案 A | Task 1 |
|
||
| D2 前端串联 | Task 1–2 |
|
||
| D3 证书未齐备仍保存 | Task 1 Step 3 |
|
||
| D4 显隐 pending | Task 1 Step 1 |
|
||
| D5 取消安排保留待安排 | Task 2(行为天然满足) |
|
||
| D6 归档隐藏编辑 | Task 3 |
|
||
| V1–V6 | Task 2 Step 2 + Task 3 Step 4 |
|
||
|
||
- [ ] **Step 2: 更新 graphify(仅改了 web-admin)**
|
||
|
||
```bash
|
||
./scripts/update-graph.sh frontend
|
||
```
|
||
|
||
Expected: 脚本成功结束,无报错。
|
||
|
||
- [ ] **Step 3: 将 design 状态改为已实现(实现完成后)**
|
||
|
||
在 `docs/superpowers/specs/2026-07-19-pl-plan-save-and-arrange-design.md` 将 `**状态:** 待实现` 改为 `**状态:** 已实现`。
|
||
|
||
---
|
||
|
||
## Spec coverage self-check
|
||
|
||
- D1–D6、V1–V6 均有对应 Task/步骤。
|
||
- 无 TBD /「类似 Task N」占位。
|
||
- `success` payload 形状在 Task 1 与 Task 2 一致:`{ planId, openArrange }`。
|
||
- 归档页不再挂载表单,故无需处理归档页 `openArrange`。
|
||
|
||
## Out of scope(勿做)
|
||
|
||
- 后端合并接口、表单内嵌安排区、「保存并调整运输」、修改安排弹窗内部逻辑。
|