Files
shanxia2.0/docs/superpowers/plans/2026-08-05-crm-contract-reedit-to-draft.md
T
2026-08-06 09:58:20 +08:00

4.5 KiB
Raw Blame History

合同审批中/已审批可再编辑回草稿 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、getContractReeditConfirmMessage from ./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