265 lines
14 KiB
Markdown
265 lines
14 KiB
Markdown
# 仅创建人可删除 — 删除接口 / 页面对照表与分阶段改造方案
|
||
|
||
> **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:** 业务数据删除时，仅允许 `create_by === 当前用户`（`super_admin` 可例外）；后端强制校验，前端按创建人显隐/禁用删除按钮。
|
||
|
||
**Architecture:** 后端新增统一 `assert_row_deletable_by_creator()`，在各模块 `soft_delete` / `delete_*` 入口调用；前端新增 `canDeleteByCreator()` 工具与可选 `CreatorDeleteButton` 包装；列表批量删除过滤非本人数据并提示。系统管理类主数据默认**不纳入**本规则（见 §4）。
|
||
|
||
**Tech Stack:** FastAPI + SQLAlchemy（backend）、Vue 3 + Element Plus（web-admin）
|
||
|
||
**默认产品假设（实施前需客户签字确认）：**
|
||
|
||
| 项 | 默认 |
|
||
|----|------|
|
||
| 超管 | `super_admin` 可删除任意业务数据 |
|
||
| 系统管理 | 租户/用户/角色/菜单/部门/字典/站点/职位/流程定义/请假 — **不适用**创建人规则 |
|
||
| 子表 | 跟进、联系人、开票信息、商机产品等 — **适用**创建人规则 |
|
||
| 历史空 `create_by` | 仅 `super_admin` 可删；普通用户不可删 |
|
||
| 比对字段 | 后端用 `user_id`（UUID）；前端用 `row.createBy`，禁止用 `realName` |
|
||
|
||
---
|
||
|
||
## 1. 统计摘要
|
||
|
||
| 类别 | 后端删除接口（约） | 前端含「删除」页面（约） |
|
||
|------|-------------------|-------------------------|
|
||
| CRM 业务 | 18 | 22 |
|
||
| PL 物流 | 8 | 9 |
|
||
| DB 地磅 | 3 | 2 |
|
||
| BX 报销 | 5 | 5 |
|
||
| 系统管理 | 11 | 11 |
|
||
| **UI 本地删除（不改）** | — | ~8 组件/页 |
|
||
| **合计（业务范围内）** | **34** | **38** |
|
||
|
||
---
|
||
|
||
## 2. 需改造对照表（业务数据 — 纳入范围）
|
||
|
||
### 2.1 CRM
|
||
|
||
| # | 实体 | 后端接口 | 后端实现位置 | 前端 API | 前端页面 / 入口 | 批量删除 | 现状 |
|
||
|---|------|----------|--------------|----------|-----------------|----------|------|
|
||
| C01 | 线索 | `POST /web/crm/clue/delete` | `crm.py` → `soft_delete_clue` | `delClue` | `crm/clue/index.vue` 行删 | 否 | 仅 data_scope |
|
||
| C02 | 线索 | 同上 | 同上 | `delClue` | `crm/clue/detailDrawer.vue` 主删 | — | 无创建人校验 |
|
||
| C03 | 线索跟进 | `POST /web/crm/clue/follow/delete` | `delete_clue_follow` | `delClueFollow` | `detailDrawer.vue` 跟进删 | 否 | 前端 `canManageFollow`（createBy）；后端 data_scope |
|
||
| C04 | 客户 | `POST /web/crm/customer/delete` | `soft_delete_customer` | `fetchDeleteCustomer` | `crm/customer/index.vue` | 否 | 无 |
|
||
| C05 | 客户 | 同上 | 同上 | 同上 | `CustomerDetailDialog.vue` 主删 | — | 无 |
|
||
| C06 | 客户跟进 | `POST /web/crm/customer/follow/delete` | `soft_delete_follow` | `fetchDeleteCustomerFollow` | `CustomerDetailDialog.vue` | 否 | 前端 realName+admin（脆弱） |
|
||
| C07 | 联系人 | `POST /web/crm/contact/delete` | `soft_delete_contact` | `fetchDeleteContact` | `CustomerDetailDialog.vue`、`ContactList.vue` | 否 | 无 |
|
||
| C08 | 开票信息 | `POST /web/crm/invoice-info/delete` | `soft_delete_invoice_info` | `delInvoiceInfo` | `InvoiceInfo.vue` | 否 | 无 |
|
||
| C09 | 商机 | `POST /web/crm/opportunity/delete` | `soft_delete_opportunities` | `delOpportunity` | `opportunity/index.vue` | 否 | 无 |
|
||
| C10 | 商机 | 同上 | 同上 | 同上 | `OpportunityDetailDrawer.vue` 主删 | — | 无 |
|
||
| C11 | 商机跟进 | `POST /web/crm/opportunity/follow/delete` | `soft_delete_opportunity_follow` | `delOpportunityFollow` | `OpportunityDetailDrawer.vue` | 否 | 无 |
|
||
| C12 | 商机产品 | `POST /web/crm/opportunity/product/delete` | `soft_delete_opportunity_products` | `delOpportunityProduct` | 表单内（若有持久化删） | 否 | 无 |
|
||
| C13 | 报价 | `POST /web/crm/quote/delete` | `soft_delete_quotes` | `delQuote` | `quote/index.vue` | 是 | 无 |
|
||
| C14 | 报价 | 同上 | 同上 | 同上 | `quote/detail.vue`、`QuoteDetailDialog.vue` | — | 无 |
|
||
| C15 | 报价产品 | `POST /web/crm/quote/product/delete` | `soft_delete_quote_products` | `delQuoteProduct` | 已保存明细删（若有） | 否 | 无；表单内行删见 §3 |
|
||
| C16 | 合同 | `DELETE /web/crm/contract/{ids}` | `soft_delete_contracts` | `delContract` | `contract/index.vue` | 是 | 无 |
|
||
| C17 | 合同 | 同上 | 同上 | 同上 | `contract/detail.vue`、`ContractDetailDialog.vue` | — | 无 |
|
||
| C18 | 合同变更 | `DELETE /web/crm/contract/change/{ids}` | `soft_delete_contract_changes` | `delChange` | `contract/change/index.vue` | 是 | 无 |
|
||
| C19 | 合同模板 | `DELETE /web/crm/contract/template/{ids}` | `soft_delete_contract_templates` | `delTemplate` | `contract/template/index.vue` | 是 | 无 |
|
||
| C20 | 产品 | `POST /web/crm/products/delete` | `soft_delete_product` | `fetchDeleteProduct` | `crm/product/index.vue` | 是 | 无 |
|
||
| C21 | 产品分类 | `POST /web/crm/product-categories/delete` | `soft_delete_category` | `fetchDeleteProductCategory` | `crm/product-category/index.vue` | 否 | 无 |
|
||
| C22 | 公海规则 | `POST /web/crm/customer/pool/rule/delete` | `delete_pool_rules` | `fetchDeletePoolRule` | `customer/pool/RuleIndex.vue` | 否 | 无 |
|
||
| C23 | 供应商信息 | `POST /web/crm/supplierInfo/delete` | `soft_delete_supplier_info` | `delSupplierInfo` | **暂无独立列表删入口** | — | 预留后端 |
|
||
|
||
### 2.2 PL 物流
|
||
|
||
| # | 实体 | 后端接口 | 后端实现位置 | 前端 API | 前端页面 | 批量 | 现状 |
|
||
|---|------|----------|--------------|----------|----------|------|------|
|
||
| P01 | 承运商 | `DELETE /transport/carrier/{id}` | `pl/base_data.py` | `carrierApi.delete` | `pl/carrier/index.vue` | 否 | data_scope |
|
||
| P02 | 车辆 | `DELETE /transport/vehicle/{id}` | 同上 | `vehicleApi.delete` | `pl/vehicle/index.vue` | 否 | data_scope |
|
||
| P03 | 自有车辆 | 同上 | 同上 | 同上 | `pl/self-vehicle/index.vue` | 否 | data_scope |
|
||
| P04 | 人员 | `DELETE /transport/personnel/{id}` | 同上 | `personnelApi.delete` | `pl/personnel/index.vue` | 否 | data_scope |
|
||
| P05 | 司机 | `DELETE /transport/driver/{id}` | 同上 | `driverApi.delete` | `pl/driver/index.vue` | 否 | data_scope |
|
||
| P06 | 车辆-司机关联 | `DELETE /transport/vehicle-driver/{id}` | 同上 | （内嵌于车辆/人员维护） | 车辆/人员表单内 | 否 | data_scope |
|
||
| P07 | 运输计划 | `DELETE /transport/plan/{id}` | `pl/plan.py` | `planApi.delete` | `pl/plan/index.vue` | 否 | data_scope |
|
||
| P08 | 运费结算单 | `DELETE /transport/freight/{id}` | `pl/freight.py` → `delete_draft_settlement` | `freightApi.delete` | `pl/freight/SettlementBillPanel.vue` | 否 | 仅草稿；无 create_by 校验 |
|
||
|
||
### 2.3 DB 地磅
|
||
|
||
| # | 实体 | 后端接口 | 后端实现位置 | 前端 API | 前端页面 | 现状 |
|
||
|---|------|----------|--------------|----------|----------|------|
|
||
| D01 | 库存记录 | `DELETE /inventory/{id}` | `db/inventory.py` | `inventoryApi.delete` | `db/inventory/index.vue` | 前端日期规则；后端 data_scope |
|
||
| D02 | 地磅计划 | `DELETE /plans/{id}` | `db/plans.py` | `plansApi.delete` | `db/plans/index.vue` | data_scope |
|
||
| D03 | 过磅记录 | `DELETE /weighing/{id}` | `db/weighing.py` | `weighingApi.delete` | 公开页若有 | data_scope |
|
||
|
||
### 2.4 BX 报销
|
||
|
||
| # | 实体 | 后端接口 | 后端实现位置 | 前端 API | 前端页面 | 现状 |
|
||
|---|------|----------|--------------|----------|----------|------|
|
||
| B01 | 报销申请 | `DELETE /reimburses/{id}` | `bx/reimburse.py` → `ReimburseService.soft_delete` | `reimburseApi.delete` | `bx/reimburse/apply/index.vue` | data_scope |
|
||
| B02 | 预支申请 | `DELETE /advances/{id}` | `bx/advance.py` | `advanceApi.delete` | `bx/advance/apply/index.vue` | data_scope |
|
||
| B03 | 费用项 | `DELETE /expense-items/{id}` | `bx/expense_item.py` | `expenseItemApi.delete` | `bx/expense-item/index.vue` | data_scope |
|
||
| B04 | 附件 | `DELETE /attachments/{id}` | `bx/attachment.py` | `attachmentApi.delete` | `BxAttachmentUpload` 等 | 随主单；删附件也需创建人 |
|
||
| B05 | BX 工作流配置 | `DELETE /workflows/{id}` | `bx/workflow.py` | `workflowApi.delete` | `bx/workflow/reimburse|advance/index.vue` | **建议归入系统配置，默认不改造** |
|
||
|
||
---
|
||
|
||
## 3. 不纳入改造（UI 本地 / 非持久化删除）
|
||
|
||
| 页面 / 组件 | 说明 |
|
||
|-------------|------|
|
||
| `QuoteFormPanel.vue` `handleDeleteProducts` / `handleRemoveProduct` | 编辑表单内未提交行，非 API 删库 |
|
||
| `contract/form.vue` 行项删除 | 同上 |
|
||
| `ContractAttachmentPanel.vue` | 表单附件列表本地 splice |
|
||
| `attachment-upload-field`、`BxAttachmentUpload` | 未保存附件卡片 |
|
||
| `FlowDesigner.vue` | 流程设计器节点/连线 |
|
||
| `system/user/detail.vue` 地址删除 | 本地 mock 数组 |
|
||
| `art-global-search` 搜索历史 | 本地 storage |
|
||
|
||
---
|
||
|
||
## 4. 默认排除（系统管理 — 待客户确认是否纳入）
|
||
|
||
| # | 实体 | 后端接口 | 前端页面 |
|
||
|---|------|----------|----------|
|
||
| S01 | 租户 | `DELETE /web/admin/tenants/{id}` | `system/tenant/index.vue` |
|
||
| S02 | 用户 | `DELETE /web/admin/users/{id}` | `system/user/index.vue` |
|
||
| S03 | 角色 | `DELETE /web/admin/role-management/{id}` | `system/role/index.vue` |
|
||
| S04 | 菜单 | `DELETE /web/admin/menus/{id}` | `system/menu/index.vue` |
|
||
| S05 | 部门 | `DELETE /web/admin/depts/{id}` | `system/dept/index.vue` |
|
||
| S06 | 字典类型/数据 | `DELETE .../dict-types|dict-data/{id}` | `system/dict/index.vue` |
|
||
| S07 | 站点 | `DELETE /web/admin/sites/{id}` | `system/site/index.vue` |
|
||
| S08 | 职位 | `DELETE /web/admin/posts/{id}` | `system/post/index.vue` |
|
||
| S09 | 流程定义 | `DELETE /web/admin/workflow/defs/{id}` | `system/workflow/process/index.vue` |
|
||
| S10 | 请假 | `DELETE /web/admin/leave/{id}` | `system/leave/index.vue` |
|
||
|
||
---
|
||
|
||
## 5. 分阶段改造方案
|
||
|
||
### Phase 0 — 基础设施（必须先做）
|
||
|
||
**后端**
|
||
|
||
- [ ] 新建 `backend/app/core/delete_guard.py`
|
||
- `assert_row_deletable_by_creator(row, user_info, *, message="仅创建人可删除")`
|
||
- `assert_rows_deletable_by_creator(rows, user_info)` — 批量时全量校验
|
||
- `super_admin` bypass；`create_by` 为空时仅超管可删
|
||
- [ ] 单元测试 `backend/tests/test_delete_guard.py`（创建人匹配 / 不匹配 / 超管 / 空 create_by）
|
||
|
||
**前端**
|
||
|
||
- [ ] 新建 `web-admin/src/utils/creator-delete.ts`
|
||
- `getCurrentUserId()` — 从 `useUserStore().info` 取 `userId` / `id`
|
||
- `canDeleteByCreator(row, currentUserId?)` — 比对 `row.createBy`
|
||
- `filterDeletableRows(rows)` — 批量删前过滤
|
||
- `CREATOR_DELETE_TIP = '仅创建人可删除'`
|
||
- [ ] 可选：`web-admin/src/components/business/creator-delete-button/index.vue` — 统一 disabled + tooltip
|
||
|
||
**文档**
|
||
|
||
- [ ] OpenSpec 变更提案：`openspec/changes/creator-only-delete/`（permission + api conventions 各一条 Requirement）
|
||
|
||
---
|
||
|
||
### Phase 1 — CRM 主实体（优先级最高）
|
||
|
||
**后端（每个 soft_delete 入口加 assert）**
|
||
|
||
- [ ] C01–C02 线索 — `soft_delete_clue`
|
||
- [ ] C04–C05 客户 — `soft_delete_customer`
|
||
- [ ] C09–C10 商机 — `soft_delete_opportunities`
|
||
- [ ] C13–C14 报价 — `soft_delete_quotes`
|
||
- [ ] C16–C17 合同 — `soft_delete_contracts`
|
||
- [ ] C18 合同变更 — `soft_delete_contract_changes`
|
||
- [ ] C19 合同模板 — `soft_delete_contract_templates`
|
||
|
||
**前端**
|
||
|
||
- [ ] 上表对应 10 个页面/抽屉：行删 / 工具栏删 `v-if="canDeleteByCreator(row)"`
|
||
- [ ] 批量删（报价/合同/变更/模板）：选中时过滤 + `ElMessage.warning` 提示跳过条数
|
||
- [ ] 列表接口确认返回 `createBy`（缺则补 `_row_to_dict`）
|
||
|
||
**验收**
|
||
|
||
- [ ] 用户 A 创建、用户 B（同部门、有删权限）调用 API 返回 403
|
||
- [ ] 用户 A 可删自己的数据；超管可删任意
|
||
|
||
---
|
||
|
||
### Phase 2 — CRM 子实体 + 主数据
|
||
|
||
**后端**
|
||
|
||
- [ ] C03/C06–C08/C11–C12 跟进、联系人、开票、商机产品
|
||
- [ ] C20–C22 产品、分类、公海规则
|
||
- [ ] C23 供应商（仅后端，无 UI 也先加固）
|
||
|
||
**前端**
|
||
|
||
- [ ] 替换 `CustomerDetailDialog` 跟进删：`realName` → `canDeleteByCreator`
|
||
- [ ] 统一 `clue/detailDrawer` `canManageFollow` 改用公共 util
|
||
- [ ] `InvoiceInfo`、`ContactList`、`product`、`product-category`、`RuleIndex`
|
||
|
||
---
|
||
|
||
### Phase 3 — PL + DB
|
||
|
||
**后端**
|
||
|
||
- [ ] P01–P08：`delete_carrier/vehicle/personnel/driver/plan` + `delete_draft_settlement` 加 create_by
|
||
- [ ] P06 `vehicle-driver` 删关联
|
||
- [ ] D01–D03 库存/计划/过磅
|
||
|
||
**前端**
|
||
|
||
- [ ] PL 9 页 + DB 2 页按钮控制
|
||
- [ ] `db/inventory`：**保留**现有日期规则，与创建人规则 **AND** 关系
|
||
|
||
---
|
||
|
||
### Phase 4 — BX 报销
|
||
|
||
**后端**
|
||
|
||
- [ ] B01–B04：在 `BxCrudService.soft_delete` 或各 Service 包装层加 create_by（注意 BX 部分历史 `create_by` 存 name 的脏数据，需迁移或兼容比对）
|
||
|
||
**前端**
|
||
|
||
- [ ] `bx/reimburse/apply`、`bx/advance/apply`、`bx/expense-item`、附件组件
|
||
|
||
**备注：** B05 BX 工作流配置默认跳过；若客户要求纳入，单独开 Phase 4b。
|
||
|
||
---
|
||
|
||
### Phase 5 — 系统管理（可选，需客户确认）
|
||
|
||
- [ ] 若确认纳入：S01–S10 后端 + 11 个 system 页面
|
||
- [ ] 若不纳入：在帮助文档注明「系统管理不受创建人删除限制」
|
||
|
||
---
|
||
|
||
## 6. 批量删除统一行为
|
||
|
||
| 场景 | 前端 | 后端 |
|
||
|------|------|------|
|
||
| 选中含他人数据 | 禁用批量删或只提交本人 id 并提示 | 对每条 assert；部分失败返回明细 |
|
||
| 选中全无 createBy | 普通用户禁用；超管可删 | 空 create_by 仅超管 |
|
||
| 混合选中 | 推荐：过滤后仅删本人，Message 汇总 | 事务：建议**全失败**或**逐条**（与 CRM 现有 delClue 部分失败风格对齐） |
|
||
|
||
---
|
||
|
||
## 7. 实施顺序与估时
|
||
|
||
| Phase | 范围 | 后端 | 前端 | 估时 |
|
||
|-------|------|------|------|------|
|
||
| 0 | 基础设施 | 0.5d | 0.5d | 1d |
|
||
| 1 | CRM 主实体 | 1d | 1.5d | 2.5d |
|
||
| 2 | CRM 子实体 | 1d | 1d | 2d |
|
||
| 3 | PL + DB | 1d | 1d | 2d |
|
||
| 4 | BX | 1d | 0.5d | 1.5d |
|
||
| 5 | 系统管理（可选） | 1d | 1d | 2d |
|
||
|
||
**建议迭代：** 每 Phase 独立 PR，先后端再前端，每模块手工回归 2 用户（创建人 / 非创建人）。
|
||
|
||
---
|
||
|
||
## 8. 下一步
|
||
|
||
1. 客户确认 § 默认产品假设 + §4 系统管理是否纳入
|
||
2. 执行 **Phase 0** 并合入主分支
|
||
3. 按 Phase 1 → 4 逐步交付，每阶段更新本文件 checkbox
|