4.5 KiB
合同审批中/已审批可再编辑回草稿 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: 允许 approving / approved(未执行)合同再次编辑;保存后变为 draft 并清理进行中审批,可再次提交审批。
Architecture: 后端放宽 update_contract 状态门禁,保存时统一回草稿并按需 delete_pending_approvals。前端抽出可编辑状态与确认文案工具函数,列表/详情/查看弹窗打开编辑前对非草稿可编辑状态弹确认。
Tech Stack: Python 3.9 / FastAPI CRUD、pytest、Vue 3 / Element Plus
Spec: docs/superpowers/specs/2026-08-05-crm-contract-reedit-to-draft-design.md
File map
| 文件 | 职责 |
|---|---|
backend/app/crud/crm/contract.py |
update_contract:可编辑状态校验 + 回草稿副作用 |
backend/tests/test_crm_contract_reedit_to_draft.py |
门禁断言单测 |
web-admin/src/views/crm/contract/contractType.ts |
isContractEditableStatus、getContractReeditConfirmMessage |
web-admin/src/views/crm/contract/index.vue |
列表编辑按钮与 handleUpdate |
web-admin/src/views/crm/contract/detail.vue |
详情「修改」按钮与 handleEdit |
web-admin/src/views/crm/contract/components/ContractDetailDialog.vue |
查看弹窗「修改」 |
Task 1: 后端 update_contract 放宽门禁 + 回草稿
Files:
-
Modify:
backend/app/crud/crm/contract.py(update_contract) -
Create:
backend/tests/test_crm_contract_reedit_to_draft.py -
Step 1: 增加可编辑状态常量与断言函数(紧挨
update_contract之前) -
Step 2: 改写
update_contract门禁与回草稿副作用 -
Step 3: 写单测
-
Step 4: 运行单测
Task 2: 前端共享工具函数
Files:
-
Modify:
web-admin/src/views/crm/contract/contractType.ts -
Step 1: 追加导出
export const CONTRACT_EDITABLE_STATUSES = ['draft', 'approving', 'approved'] as const
export type ContractEditableStatus = (typeof CONTRACT_EDITABLE_STATUSES)[number]
export function isContractEditableStatus(status?: string | null): boolean {
return CONTRACT_EDITABLE_STATUSES.includes(
(status || '').trim() as ContractEditableStatus
)
}
export function getContractReeditConfirmMessage(status?: string | null): string | null {
const s = (status || '').trim()
if (s === 'approving') {
return '编辑保存后将作废当前审批流,合同变回草稿,需重新提交审批'
}
if (s === 'approved') {
return '编辑保存后合同将变回草稿,需重新提交审批'
}
return null
}
Task 3: 合同列表 index.vue
Files:
-
Modify:
web-admin/src/views/crm/contract/index.vue -
Step 1: import
isContractEditableStatus、getContractReeditConfirmMessagefrom./contractType -
Step 2: 编辑按钮
:disabled="single || !isContractEditableStatus(selectedRows[0]?.status)" -
Step 3:
handleUpdate改为 async:可编辑校验 → 有确认文案则$modal.confirm→ 打开表单弹窗
文案失败提示:仅草稿、审批中或已审批(未执行)的合同才能修改
Task 4: 详情页 detail.vue
Files:
-
Modify:
web-admin/src/views/crm/contract/detail.vue -
Step 1: 「修改」按钮
v-if="isContractEditableStatus(contract?.status)" -
**Step 2:
handleEdit同样:校验 → 确认 →router.push表单页
Task 5: 查看弹窗 ContractDetailDialog.vue
Files:
-
Modify:
web-admin/src/views/crm/contract/components/ContractDetailDialog.vue -
Step 1: 「修改」按钮 v-if 使用
isContractEditableStatus -
Step 2:
handleDetailEdit:校验 → 确认 → 关闭详情并打开编辑弹窗
Task 6: 验收与图谱
- 再跑
pytest tests/test_crm_contract_reedit_to_draft.py -v - 对照 spec 验收要点手工核对
./scripts/update-graph.sh backend与./scripts/update-graph.sh frontend
Spec coverage
| Spec 要求 | Task |
|---|---|
| 可编辑 draft/approving/approved | 1, 2 |
| 不开放 executing/finished/invalid | 1, 3–5 |
| 打开编辑前确认文案 | 2–5 |
| 保存回 draft + 清 approval_status | 1 |
| approving 清理待审 | 1 |
| 提交审批仍仅 draft | 不变 |
| 列表/详情/弹窗入口 | 3–5 |