gaoluyang
4 小时以前 d6c9307412ed55f3509d20cdb13c6a6602f2d89b
feat(erp): 销售订单提交即生效,不再走 BPM 审批

- submitSaleOrder 不再创建 BPM 流程实例,校验通过后直接置为已审核并生成 MPS
- 合同转来订单与手工/导入订单统一走同一套提交即生效逻辑
- 同步更新业务可视化文档中的销售订单流程口径

Co-Authored-By: Claude Code <noreply@anthropic.com>
已修改10个文件
73 ■■■■■ 文件已修改
docs/project-business/data/business.json 2 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/data/flows.json 4 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/data/modules.json 2 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/data/objects.json 2 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/mermaid/02-sales-flow.mmd 3 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/mermaid/04-production-flow.mmd 2 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/mermaid/08-module-relation.mmd 2 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/controller/admin/sale/ErpSaleOrderController.java 2 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/service/sale/ErpSaleOrderService.java 8 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/service/sale/ErpSaleOrderServiceImpl.java 46 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/data/business.json
@@ -43,7 +43,7 @@
    ],
    [
      "销售如何影响生产",
      "销售订单审批通过后,需生产明细自动创建 MES 主生产计划(MPS),MPS 下发驱动工单与任务"
      "销售订单提交生效后,需生产明细自动创建 MES 主生产计划(MPS),MPS 下发驱动工单与任务"
    ],
    [
      "采购如何影响库存",
docs/project-business/data/flows.json
@@ -5,7 +5,7 @@
      "name": "销售流程",
      "mermaid": "mermaid/02-sales-flow.mmd",
      "color": "#4f9cff",
      "summary": "线索转化客户 → 商机推进 → 报价(可AI识别) → 合同 BPM 审批 → 生成 ERP 销售订单(合同转来的订单提交免审批直接生效,提交后不可修改;台账含销售类型、手工合同号、产品编号与生产数量) → 需生产行自动建 MPS → 发货通知(物流公司/快递费/开票状态,审批默认物流) → 发货台账按产品平铺 → 销售出库提交(需检验行转待检测) → 独立录入 OQC 后按物料+盘号+数量关联回写 → 拣货发运 → 开票(BPM) → 录入发票与款项节点 → 回款(先开票校验,创建为未提交,显式提交 BPM 协同审批,审批通过才回写回款计划);发货单/成品出库单可导出带电子章的 Word 供手填签字归档;客户档案支持多收货地址。",
      "summary": "线索转化客户 → 商机推进 → 报价(可AI识别) → 合同 BPM 审批 → 生成 ERP 销售订单(提交即生效、不走 BPM,提交后不可修改;台账含销售类型、手工合同号、产品编号与生产数量) → 需生产行自动建 MPS → 发货通知(物流公司/快递费/开票状态,审批默认物流) → 发货台账按产品平铺 → 销售出库提交(需检验行转待检测) → 独立录入 OQC 后按物料+盘号+数量关联回写 → 拣货发运 → 开票(BPM) → 录入发票与款项节点 → 回款(先开票校验,创建为未提交,显式提交 BPM 协同审批,审批通过才回写回款计划);发货单/成品出库单可导出带电子章的 Word 供手填签字归档;客户档案支持多收货地址。",
      "steps": [
        {
          "stage": "获客",
@@ -38,7 +38,7 @@
        },
        {
          "stage": "接单",
          "action": "合同一键生成销售订单(XSDD)后在销售管理提交:合同转来的订单免 BPM 直接生效(20),提交后不可修改;手工/导入订单仍走 BPM。生效后自动为 needProduction 明细创建 MPS 流转生产,无需生产的订单可直接生成仓储发货通知单",
          "action": "销售订单(XSDD)提交即生效(20)、不再走 BPM 审批,提交后不可修改(手工/导入/合同转来订单一致)。生效后自动为 needProduction 明细创建 MPS 流转生产,无需生产的订单可直接生成仓储发货通知单",
          "roles": [
            "销售",
            "计划员"
docs/project-business/data/modules.json
@@ -164,7 +164,7 @@
        "采购来票(绑定采购订单+MES采购入库单·双层剩余额度校验)",
        "付款单(必须关联来票·BPM)",
        "供应商往来(订单/来票/付款三流水·左右展示开票金额)",
        "销售订单(BPM·审批通过自动建MPS)",
        "销售订单(提交即生效·自动建MPS)",
        "出库状态回写",
        "收款单(关联CRM客户)",
        "结算账户",
docs/project-business/data/objects.json
@@ -388,7 +388,7 @@
      "name": "销售订单",
      "module": "进销存",
      "table": "erp_sale_order",
      "doc": "XSDD编号,BPM 审批,需生产行自动建 MPS,出库状态:未0已预留1部分2全部3,生产完成事件回写",
      "doc": "XSDD编号,提交即生效(不走 BPM),需生产行自动建 MPS,出库状态:未0已预留1部分2全部3,生产完成事件回写",
      "upstream": [
        "合同"
      ],
docs/project-business/mermaid/02-sales-flow.mmd
@@ -13,8 +13,7 @@
  D -->|直接建合同| G
  Q[合同 Excel 导入·一合同多产品明细行] -->|批量建草稿合同| G
  G -->|BPM审批通过20| H[生成 ERP 销售订单 XSDD]
  H -->|手工/导入订单·提交BPM| I[销售订单·合同转来订单提交免BPM直通20·提交后不可修改]
  H -->|合同转来订单·提交免审批·直接生效| I
  H -->|手工/导入/合同转来订单·提交即生效·不走BPM| I[销售订单·提交后直接20·生成MPS·不可修改]
  H -.->|销售台账展示| H1[销售类型 1内销2外销3样品4其他·合同号可手工填·产品编号·生产数量]
  I -->|明细需生产·自动创建| J[MES 主生产计划 MPS]
  I --> K[发货通知单·物流公司/快递费/开票状态·审批流默认物流审批]
docs/project-business/mermaid/04-production-flow.mmd
@@ -1,5 +1,5 @@
flowchart TD
  P0[销售订单明细 needProduction=1] -->|审批通过自动创建| P1[MPS 主生产计划·草稿0→已下发1]
  P0[销售订单明细 needProduction=1] -->|销售订单提交生效后自动创建| P1[MPS 主生产计划·草稿0→已下发1]
  P1 -->|下发或合并下发·仅创建人或超管可操作| P2[生产工单·草稿0→已确认1]
  P2 -->|按工艺路线工序自动生成| P3[生产任务×N·预备0→生产中1→部分完成2→完成4·可暂停9]
  P3 --> P4[生产领料 或 线边虚拟库备料]
docs/project-business/mermaid/08-module-relation.mmd
@@ -6,7 +6,7 @@
  SRM[SRM 供应商档案·询价比价] -->|询价确认生成采购订单草稿| ERP
  ERP -.->|供应商往来读取供应商名称| SRM
  ERP -->|确认收货生成到货通知| MES
  ERP -->|销售订单审批生成MPS| MES
  ERP -->|销售订单提交生效生成MPS| MES
  MES -->|入库出库回写单据进度| ERP
  MES -->|ProductionFinishedEvent| ERP
  MES -->|MesProFeedbackWageApi·按报工人汇总核算周期内已审批报工工资| HRM
yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/controller/admin/sale/ErpSaleOrderController.java
@@ -99,7 +99,7 @@
    }
    @PostMapping("/submit")
    @Operation(summary = "提交销售订单(合同转来的订单免审批直接生效,其余走协同办公审批)")
    @Operation(summary = "提交销售订单(提交即生效,不再走协同办公审批)")
    @PreAuthorize("@ss.hasPermission('erp:sale-order:update-status')")
    public CommonResult<Boolean> submitSaleOrder(@RequestParam("id") Long id,
                                                 @RequestParam("processDefinitionKey") String processDefinitionKey) {
yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/service/sale/ErpSaleOrderService.java
@@ -45,13 +45,13 @@
    void updateSaleOrder(@Valid ErpSaleOrderSaveReqVO updateReqVO);
    /**
     * 提交销售订单审批(协同办公 BPM)
     * 提交销售订单(不再走协同办公 BPM 审批)
     *
     * 未提交或已驳回的销售订单可提交,提交后进入协同办公审批流程
     * 未提交或已驳回的销售订单可提交,提交后直接生效并生成 MPS
     *
     * @param id 编号
     * @param processDefinitionKey 流程定义的标识
     * @param userId 提交人编号
     * @param processDefinitionKey 流程定义的标识(已废弃,保留参数兼容旧前端/接口调用)
     * @param userId 提交人编号(已废弃,保留参数兼容旧前端/接口调用)
     */
    void submitSaleOrder(Long id, String processDefinitionKey, Long userId);
yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/service/sale/ErpSaleOrderServiceImpl.java
@@ -8,8 +8,6 @@
import cn.iocoder.yudao.framework.common.util.number.MoneyUtils;
import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
import cn.iocoder.yudao.framework.operatelog.core.util.OperateLogUtils;
import cn.iocoder.yudao.module.bpm.api.task.BpmProcessInstanceApi;
import cn.iocoder.yudao.module.bpm.api.task.dto.BpmProcessInstanceCreateReqDTO;
import cn.iocoder.yudao.module.bpm.dal.dataobject.definition.BpmCategoryDO;
import cn.iocoder.yudao.module.bpm.dal.dataobject.definition.BpmProcessDefinitionInfoDO;
import cn.iocoder.yudao.module.bpm.enums.task.BpmTaskStatusEnum;
@@ -114,8 +112,6 @@
    @Resource
    private StorageAttachmentApi storageAttachmentApi;
    @Resource
    private BpmProcessInstanceApi processInstanceApi;
    @Resource
    private BpmCategoryService bpmCategoryService;
    @Resource
@@ -418,44 +414,18 @@
            throw exception(SALE_ORDER_SUBMIT_FAIL_ITEM_EMPTY, saleOrder.getNo());
        }
        // 4. 合同转来的销售订单(contractId 非空)无需再走审批:
        //    合同在 CRM 已审批通过,订单内容由合同带入,提交即生效。
        // 4. 销售订单不走审批流程:业务校验通过后直接生效(不再创建 BPM 流程实例)
        //    生效后:需要生产的明细自动创建 MPS 流转生产模块;无需生产的明细可直接在仓储生成发货通知单。
        //    历史合同生成的订单明细可能未维护“是否需要生产”,按系统默认(需要生产)补齐后再生效。
        if (saleOrder.getContractId() != null) {
            items.stream()
                    .filter(item -> item.getNeedProduction() == null)
                    .forEach(item -> saleOrderItemMapper.updateById(
                            new ErpSaleOrderItemDO().setId(item.getId()).setNeedProduction(1)));
            saleOrderMapper.updateById(new ErpSaleOrderDO()
                    .setId(id)
                    .setStatus(ErpAuditStatus.APPROVING.getStatus())
                    .setProcessInstanceId(""));
            updateSaleOrderAuditStatus(id, cn.iocoder.yudao.module.bpm.enums.task.BpmProcessInstanceStatusEnum.APPROVE.getStatus());
            return;
        }
        // 5. 创建 BPM 流程实例(审批在协同办公完成)
        // 全局免审批:业务校验通过后直接执行审批通过逻辑,无需流程模型。
        if (processInstanceApi.isGlobalAutoApprove()) {
            saleOrderMapper.updateById(new ErpSaleOrderDO()
                    .setId(id)
                    .setStatus(ErpAuditStatus.APPROVING.getStatus())
                    .setProcessInstanceId(""));
            updateSaleOrderAuditStatus(id, cn.iocoder.yudao.module.bpm.enums.task.BpmProcessInstanceStatusEnum.APPROVE.getStatus());
            return;
        }
        String processInstanceId = processInstanceApi.createProcessInstance(userId,
                new BpmProcessInstanceCreateReqDTO()
                        .setProcessDefinitionKey(processDefinitionKey)
                        .setBusinessKey(String.valueOf(id)));
        // 6. 更新销售订单状态为审批中,记录流程实例编号
        //    历史订单/接口调用可能未维护“是否需要生产”,按系统默认(需要生产)补齐后再生效。
        items.stream()
                .filter(item -> item.getNeedProduction() == null)
                .forEach(item -> saleOrderItemMapper.updateById(
                        new ErpSaleOrderItemDO().setId(item.getId()).setNeedProduction(1)));
        saleOrderMapper.updateById(new ErpSaleOrderDO()
                .setId(id)
                .setStatus(ErpAuditStatus.APPROVING.getStatus())
                .setProcessInstanceId(processInstanceId));
                .setProcessInstanceId(""));
        updateSaleOrderAuditStatus(id, cn.iocoder.yudao.module.bpm.enums.task.BpmProcessInstanceStatusEnum.APPROVE.getStatus());
    }
    @Override