docs: add implementation plan for transport plan copy.
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
zlwuandCursor committed
1 parent
7ca8ad29fa
commit
13115c8afd
1 file changed
+285
@@ -0,0 +1,285 @@
|
||||
# 运输计划「复制」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:** 在运输计划列表支持「复制」：打开新增弹窗并预填可复制字段，用户保存后走现有 `createFull` 建新单。
|
||||
|
||||
**Architecture:** 纯前端。列表传入 `copyFromPlanId`（`planId` 为空）；`PlPlanFormDialog` 打开时 `planApi.get` → `loadPlanForCopy`（裁剪车辆/承运商/运费/执行态）；保存路径与普通新增相同。
|
||||
|
||||
**Tech Stack:** Vue 3 + Element Plus + 现有 `planApi`
|
||||
|
||||
**Spec:** `docs/superpowers/specs/2026-08-06-pl-plan-copy-design.md`
|
||||
|
||||
---
|
||||
|
||||
## 文件结构
|
||||
|
||||
| 操作 | 文件 | 职责 |
|
||||
|------|------|------|
|
||||
| Modify | `web-admin/src/components/business/pl-plan-form-dialog/index.vue` | `copyFromPlanId`、`loadPlanForCopy`、复制态禁用日期联动、产品映射去证书/源 id |
|
||||
| Modify | `web-admin/src/views/pl/plan/index.vue` | 工具栏 + 查看弹窗「复制」入口 |
|
||||
| Modify | `docs/superpowers/specs/2026-08-06-pl-plan-copy-design.md` | 状态改为已实现 |
|
||||
|
||||
无后端改动。web-admin 无组件单测基建，验收以浏览器走查为准。
|
||||
|
||||
---
|
||||
|
||||
### Task 1: 表单弹窗支持按源计划预填（复制模式）
|
||||
|
||||
**Files:**
|
||||
- Modify: `web-admin/src/components/business/pl-plan-form-dialog/index.vue`
|
||||
|
||||
- [ ] **Step 1: 扩展 props 与复制态计算属性**
|
||||
|
||||
在现有 props 上增加 `copyFromPlanId`：
|
||||
|
||||
```ts
|
||||
const props = defineProps<{
|
||||
visible: boolean
|
||||
planId?: string
|
||||
/** 有值且无 planId 时：新增模式 + 从该计划预填（复制） */
|
||||
copyFromPlanId?: string
|
||||
}>()
|
||||
|
||||
const isEdit = computed(() => !!props.planId)
|
||||
const isCopy = computed(() => !props.planId && !!props.copyFromPlanId)
|
||||
```
|
||||
|
||||
`dialogTitle` / `saveButtonLabel` / `showSaveAndArrange` 继续按 `isEdit` 判断（复制视为新增，标题「新增运输计划」）。
|
||||
|
||||
- [ ] **Step 2: 复制专用产品行映射**
|
||||
|
||||
在 `mapPlanProductToFormRow` 旁新增（或改其调用方），保证复制行：
|
||||
|
||||
- 不带源 `plan_product.id`（`id` 省略）
|
||||
- `actualQty: 0`
|
||||
- 不带 `purchaseCertUrl` / `transportCertUrl` / `legalUseCertUrl`
|
||||
- `quantity` 仍用计划数量（与现有 `mapPlanProductToFormRow` 的 quantity 逻辑一致）
|
||||
|
||||
```ts
|
||||
function mapPlanProductToCopyFormRow(item: PlanProduct, index: number): PlanFormProductRow {
|
||||
const row = mapPlanProductToFormRow(item, index)
|
||||
return {
|
||||
...row,
|
||||
id: undefined,
|
||||
actualQty: 0,
|
||||
purchaseCertUrl: undefined,
|
||||
transportCertUrl: undefined,
|
||||
legalUseCertUrl: undefined
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
- [ ] **Step 3: 实现 `loadPlanForCopy`**
|
||||
|
||||
以 `loadPlanForEdit` 为模板，差异如下：
|
||||
|
||||
1. `resetForm()` 后 `planApi.get(planId)`
|
||||
2. `Object.assign` 时：
|
||||
- `createDate: todayYmd()`（不用源创建日期）
|
||||
- `followUserId` / `followUserName`：`resolveCurrentUserId()` / `resolveCurrentUserName()`
|
||||
- `planDate`、取送货字段、备注、合同相关字段：同编辑（时间用现有 `formatDate`）
|
||||
- **不要**写入 `vehicleId`
|
||||
- `products: (data.products || []).map(mapPlanProductToCopyFormRow)`
|
||||
3. `loadedTransportStatus.value = 'pending'`（新建态）
|
||||
4. 合同快照加载逻辑同编辑（`getContract` 失败则 `buildContractSnapshotFromPlan`）
|
||||
5. 产品 enrich 同编辑：`enrichProductsFromContract` → `enrichPlanProductsHazardFromCrm` → `enrichPlanProductLinesAlias` → `refreshContractProductRows`
|
||||
6. **不要**调用 `ensureSelectedVehicleOption` / `handleVehicleChange` / `restoreFreightFromTransport` / `ensureSelectedCarrierOption`
|
||||
7. 显式保持：`formData.vehicleId = ''`、`formData.carrierId = ''`、`selectedDriverId = ''`、`vehicleBundle = null`，并 `freightCalc.resetFreightCalc()`
|
||||
|
||||
失败处理：
|
||||
|
||||
```ts
|
||||
} catch (e) {
|
||||
const message = e instanceof Error ? e.message : '加载源计划失败'
|
||||
ElMessage.error(message.includes('加载') ? message : `加载源计划失败：${message}`)
|
||||
emit('update:visible', false)
|
||||
} finally {
|
||||
detailLoading.value = false
|
||||
}
|
||||
```
|
||||
|
||||
- [ ] **Step 4: 接入 `handleOpened` 与日期 watch**
|
||||
|
||||
`handleOpened`：
|
||||
|
||||
```ts
|
||||
function handleOpened() {
|
||||
loadMasterData().then(async () => {
|
||||
if (props.planId) {
|
||||
await loadPlanForEdit(props.planId)
|
||||
} else if (props.copyFromPlanId) {
|
||||
await loadPlanForCopy(props.copyFromPlanId)
|
||||
} else {
|
||||
resetForm()
|
||||
}
|
||||
})
|
||||
}
|
||||
```
|
||||
|
||||
计划日期联动 watch 开头增加复制跳过：
|
||||
|
||||
```ts
|
||||
watch(
|
||||
() => formData.planDate,
|
||||
(next, prev) => {
|
||||
if (isEdit.value || isCopy.value) return
|
||||
// ...现有联动逻辑
|
||||
}
|
||||
)
|
||||
```
|
||||
|
||||
- [ ] **Step 5: 自测表单组件逻辑（代码审查清单）**
|
||||
|
||||
确认：
|
||||
|
||||
- `isCopy` 时提交仍走 `!props.planId` → `createFull`
|
||||
- `buildTransportBlock` 在无车辆时不带 transport（同新增）
|
||||
- `handleClosed` 仍 `resetForm()` 即可（父组件负责清空 `copyFromPlanId`）
|
||||
|
||||
- [ ] **Step 6: Commit**
|
||||
|
||||
```bash
|
||||
git add web-admin/src/components/business/pl-plan-form-dialog/index.vue
|
||||
git commit -m "feat(pl): support copy-from plan prefill in plan form dialog"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Task 2: 列表页「复制」入口
|
||||
|
||||
**Files:**
|
||||
- Modify: `web-admin/src/views/pl/plan/index.vue`
|
||||
|
||||
- [ ] **Step 1: 状态与表单绑定**
|
||||
|
||||
增加：
|
||||
|
||||
```ts
|
||||
const copyFromPlanId = ref('')
|
||||
```
|
||||
|
||||
模板中表单：
|
||||
|
||||
```vue
|
||||
<PlPlanFormDialog
|
||||
v-model:visible="formDialogVisible"
|
||||
:plan-id="editingPlanId"
|
||||
:copy-from-plan-id="copyFromPlanId"
|
||||
@success="handlePlanMutationSuccess"
|
||||
/>
|
||||
```
|
||||
|
||||
- [ ] **Step 2: 统一打开表单的互斥赋值**
|
||||
|
||||
```ts
|
||||
function handleAdd() {
|
||||
editingPlanId.value = ''
|
||||
copyFromPlanId.value = ''
|
||||
formDialogVisible.value = true
|
||||
}
|
||||
|
||||
function handleEdit(row: Plan) {
|
||||
editingPlanId.value = row.id
|
||||
copyFromPlanId.value = ''
|
||||
formDialogVisible.value = true
|
||||
}
|
||||
|
||||
function handleCopy(row: Plan) {
|
||||
editingPlanId.value = ''
|
||||
copyFromPlanId.value = row.id
|
||||
formDialogVisible.value = true
|
||||
}
|
||||
|
||||
function handleToolbarCopy() {
|
||||
if (!selectedPlan.value) return
|
||||
handleCopy(selectedPlan.value)
|
||||
}
|
||||
```
|
||||
|
||||
- [ ] **Step 3: 工具栏按钮**
|
||||
|
||||
在「新增计划」后增加（`btn-ghost`，仅单选可点）：
|
||||
|
||||
```vue
|
||||
<el-button
|
||||
class="btn-ghost"
|
||||
:disabled="!selectedPlan"
|
||||
@click="handleToolbarCopy"
|
||||
>
|
||||
<el-icon><CopyDocument /></el-icon>复制
|
||||
</el-button>
|
||||
```
|
||||
|
||||
`CopyDocument` 加入 `@element-plus/icons-vue` 的 import。
|
||||
|
||||
- [ ] **Step 4: 查看弹窗 hero-actions**
|
||||
|
||||
在「编辑」按钮旁增加「复制」（**无** `canEditPlan` 限制，任意状态可复制）：
|
||||
|
||||
```vue
|
||||
<el-button class="btn-ghost" @click="handleCopy(viewingPlan)">
|
||||
<el-icon><CopyDocument /></el-icon>复制
|
||||
</el-button>
|
||||
```
|
||||
|
||||
放在编辑按钮之后（或编辑之前；与编辑并列即可）。不强制关闭查看弹窗。
|
||||
|
||||
- [ ] **Step 5: Commit**
|
||||
|
||||
```bash
|
||||
git add web-admin/src/views/pl/plan/index.vue
|
||||
git commit -m "feat(pl): add copy entry on transport plan list and view dialog"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Task 3: 文档收尾与验收
|
||||
|
||||
**Files:**
|
||||
- Modify: `docs/superpowers/specs/2026-08-06-pl-plan-copy-design.md`
|
||||
- 本计划文件勾选完成项
|
||||
|
||||
- [ ] **Step 1: 设计文档状态**
|
||||
|
||||
将文首 `**状态：** 设计已确认` 改为 `**状态：** 已实现`。
|
||||
|
||||
- [ ] **Step 2: 更新知识图谱**
|
||||
|
||||
```bash
|
||||
./scripts/update-graph.sh frontend
|
||||
```
|
||||
|
||||
- [ ] **Step 3: 浏览器走查**
|
||||
|
||||
打开 `http://localhost:3006/#/pl/plan-module/plan`：
|
||||
|
||||
1. 勾选 1 条 →「复制」→ 标题「新增运输计划」；创建日期为今天；跟进人为当前用户
|
||||
2. 合同/基础/产品计划数量/备注/取送货已填；车牌、承运商为空
|
||||
3. 保存 → 新编号、待安排；源计划不变
|
||||
4. 对已作废或已归档计划从查看弹窗复制，可打开预填
|
||||
5. 0 条 / 多条勾选时工具栏「复制」禁用；编辑入口仍正常
|
||||
|
||||
- [ ] **Step 4: Commit**
|
||||
|
||||
```bash
|
||||
git add docs/superpowers/specs/2026-08-06-pl-plan-copy-design.md docs/superpowers/plans/2026-08-06-pl-plan-copy.md
|
||||
git commit -m "docs: mark transport plan copy design implemented"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Spec 覆盖自检
|
||||
|
||||
| Spec 要求 | Task |
|
||||
|-----------|------|
|
||||
| 打开新增弹窗预填，保存才建单 | Task 1 + 2 |
|
||||
| 列表工具栏单选 + 查看弹窗复制 | Task 2 |
|
||||
| 任意状态可复制 | Task 2 Step 4（无状态门禁） |
|
||||
| createDate=当天，跟进人=当前用户 | Task 1 Step 3 |
|
||||
| 计划/取送货日期原样 | Task 1 Step 3 |
|
||||
| 不复制车辆/承运商/运费 | Task 1 Step 3 |
|
||||
| 产品仅计划数量，无证书 URL / actualQty | Task 1 Step 2 |
|
||||
| 复制态关闭日期联动 watch | Task 1 Step 4 |
|
||||
| 拉源失败关弹窗 | Task 1 Step 3 |
|
||||
| 无新 API | 全任务 |
|
||||
Reference in new issue
Block a user