Files
shanxia2.0/docs/superpowers/plans/2026-08-08-quote-contract-approval-menus.md
T
2026-08-08 20:43:48 +08:00

3.3 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: 将报价单、合同的「待审批 / 已审批」从管理页拆到独立菜单;管理页 tab 顺序为「全部」在前且默认选中;审批页去掉制单类操作;权限码独立。

Architecture: 现有 index.vue 抽为带 mode: 'manage' | 'approve' 的列表页组件;管理/审批各一薄包装页。路由与 sys_menu 各增审批菜单;角色菜单对已有 list 权限角色幂等挂上 approve(可后续单独收回)。

Tech Stack: Vue 3 + Element Plus(web-admin)、MySQL sys_menu / sys_role_menu、前端路由 sqxp.ts

Decisions:

  • 管理页默认 Tab:全部报价 / 全部合同
  • 权限:crm:quote:approve、crm:contract:approve(独立)
  • 审批页去掉:新增、编辑、删除、提交审批、复制新增等制单操作
  • 合同同步拆分;列表逻辑抽组件复用

Task 1: 报价单列表组件化 + 双入口

Files:

  • Create: web-admin/src/views/crm/quote/QuoteListPage.vue(由现 index 迁入 + mode)

  • Create: web-admin/src/views/crm/quote/index.vue(薄包装 mode=manage)

  • Create: web-admin/src/views/crm/quote/approval/index.vue(薄包装 mode=approve)

  • Modify: web-admin/src/router/modules/sqxp.ts

  • 迁入列表逻辑,mode 控制 tab / 默认视图 / 工具栏

  • manage:全部报价 | 我的报价,默认 all

  • approve:待审批 | 已审批,默认 submitted;隐藏新增/编辑/删除/复制/提交审批

  • 路由增加 quote-approval → /crm/quote/approval/index,menuCode: crm:quote:approve

Task 2: 合同列表组件化 + 双入口

Files:

  • Create: web-admin/src/views/crm/contract/ContractListPage.vue

  • Create/Modify: web-admin/src/views/crm/contract/index.vue

  • Create: web-admin/src/views/crm/contract/approval/index.vue

  • Modify: web-admin/src/router/modules/sqxp.ts

  • manage:全部合同 | 我的合同 | 执行中 | 已完成 | 已作废,默认 all

  • approve:待审批 | 已审批;隐藏新增/编辑/删除/提交审批;保留审批通过/驳回等

  • 路由增加 contract-approval,menuCode: crm:contract:approve

Task 3: 菜单 SQL + 基线快照

Files:

  • Create: docs/sql/migrations/2026-08-08-quote-contract-approval-menus.sql

  • Modify: docs/sql/shanxia2.0.sql(INSERT 新菜单行;必要时调整 order_num)

  • 菜单 ID:CRM…0016 报价单审批、CRM…0021 合同审批

  • order_num:报价管理 5、报价审批 6、合同管理 7、合同审批 8;顺延调价函/客户等

  • 幂等:拥有 list 菜单的角色自动挂 approve(可再单独配置)

Task 4: 收尾

  • App.vue / pattern-index 如需登记标题或参考页则更新
  • ./scripts/update-graph.sh frontend

验收

  1. CRM 侧栏出现「报价单审批」「合同审批」
  2. 报价/合同管理页无待审批/已审批 tab,默认「全部」
  3. 审批页仅审批相关操作,权限与 list 可分离
  4. 原审批查询参数语义不变(pendingApprovalUserId / approvedByUserId)