大型制造业企业统一业务集成平台建设方案

大型制造业企业统一业务集成平台建设方案

一、方案定位与核心理念

1.1 本质定位

本方案聚焦IT层业务系统之间的标准化集成，核心解决 ERP、MES、WMS、PLM、QMS、SRM、CRM 等多语言栈系统的烟囱式建设、重复开发、无序对接问题。

核心目标不是"数据搬运"，而是"业务流程贯通"——保障跨系统业务操作的事务一致性与可靠性，实现业务状态的跨系统协商与承诺。

明确边界：

• 在范围内：所有IT业务系统之间的交互标准、接口规范、服务调用、数据流转、集成管控
• 不在范围内：OT层设备数据采集、工业协议解析、实时控制指令下发（由专门OT/工业互联网方案承接）
• 与OT唯一交集：定义OT数据平台向IT系统交付数据的接口标准

1.2 核心设计原则

二、总体架构

2.1 业务领域划分（DDD）

┌─────────────────────────────────────────────────────────────┐
│                    制造业业务领域划分                         │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│   ┌─────────────┐    ┌─────────────┐    ┌─────────────┐   │
│   │  销售领域    │    │  生产领域    │    │  仓储领域    │   │
│   │   (CRM)     │◄──►│   (MES)     │◄──►│   (WMS)     │   │
│   │ • 客户管理   │    │ • 工单管理   │    │ • 库存管理   │   │
│   │ • 合同签订   │    │ • 工艺路线   │    │ • 入库作业   │   │
│   │ • 需求预测   │    │ • 报工反馈   │    │ • 出库发运   │   │
│   └──────┬──────┘    └──────┬──────┘    └──────┬──────┘   │
│          │                  │                  │          │
│          └──────────────────┼──────────────────┘          │
│                             │                             │
│                    ┌────────┴────────┐                    │
│                    │   集成平台        │                    │
│                    │ (业务编排与协调)   │                    │
│                    └─────────────────┘                    │
│                                                             │
│   ┌─────────────┐    ┌─────────────┐    ┌─────────────┐   │
│   │  财务领域    │    │  质量领域    │    │  供应领域    │   │
│   │   (ERP)     │◄──►│   (QMS)     │◄──►│   (SRM)     │   │
│   │ • 应收应付   │    │ • 来料检验   │    │ • 供应商协同 │
│   │ • 成本核算   │    │ • 过程检验   │    │ • 采购执行   │
│   │ • 发票校验   │    │ • 不合格处置 │    │ • 交期承诺   │
│   └─────────────┘    └─────────────┘    └─────────────┘   │
│                                                             │
└─────────────────────────────────────────────────────────────┘

2.2 五层技术架构

┌─────────────────────────────────────────────────────────────────────┐
│  L5 统一治理层                                                       │
│  业务集成门户 | 流程监控大盘 | 事务追踪 | 审计中心 | API资产目录      │
└─────────────────────────────────────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────┐
│  L4 统一接入层（API网关）                                            │
│  认证鉴权 | 限流熔断 | 路由转发 | 协议转换 | 业务契约校验 | 幂等拦截  │
│                    Apache APISIX / 业务网关                          │
└─────────────────────────────────────────────────────────────────────┘
                                    │
         ┌──────────────────────────┼──────────────────────────┐
         │                          │                          │
         ▼                          ▼                          ▼
┌─────────────────┐      ┌─────────────────┐      ┌─────────────────┐
│  同步业务调用    │      │  异步业务事件    │      │  长流程编排      │
│  REST/gRPC      │      │  RocketMQ       │      │  Apache Camel   │
│  (<500ms)       │      │  (事务消息)      │      │  + iPaaS低代码  │
└────────┬────────┘      └────────┬────────┘      └────────┬────────┘
         │                        │                        │
         └────────────────────────┼────────────────────────┘
                                  ▼
┌─────────────────────────────────────────────────────────────────────┐
│  L3 集成服务层（业务编排核心）                                        │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐  │
│  │ 消息路由转换 │ │ Saga编排引擎 │ │ 补偿事务管理 │ │ 状态机引擎   │  │
│  │(Apache Camel)│ │(Camel/Temporal)│ │(Camel)     │ │(Camel)      │  │
│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘  │
└─────────────────────────────────────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────┐
│  L2 消息中间件层                                                     │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │  Apache RocketMQ（业务事务消息 / 订单 / 库存 / 工单 / 财务） │   │
│  │  Apache Kafka（数据流 / 设备遥测 / 日志 / CDC / 分析类）     │   │
│  └─────────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────┐
│  L1 统一连接层                                                       │
│  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐  │
│  │ ERP  │ │ MES  │ │ PLM  │ │ SCM  │ │ CRM  │ │ QMS  │ │ WMS  │  │
│  │Adapter│ │Adapter│ │Adapter│ │Adapter│ │Adapter│ │Adapter│ │Adapter│  │
│  └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘  │
└─────────────────────────────────────────────────────────────────────┘

三、统一技术标准体系

3.1 API 设计规范（业务语义化）

URL 设计：业务动作导向

https://{gateway}/api/{version}/{domain}/{capability}/{action}

结构：
- {domain}: 业务领域（sales / production / warehousing / quality / procurement / finance / mdm）
- {capability}: 业务能力（order-management / work-order-management / inventory-management）
- {action}: 业务动作（动词），体现业务意图

请求体：业务命令模式

{
  "commandType": "CONFIRM_SALES_ORDER",
  "commandId": "cmd-uuid-v4",
  "orderId": "SO001",
  "confirmation": {
    "confirmedBy": "U1001",
    "confirmedAt": "2026-08-09T15:35:00+08:00",
    "deliveryDate": "2026-08-20",
    "paymentTerms": "NET_30"
  },
  "reason": "客户已回签合同正本"
}

响应体：业务结果导向

{
  "code": "SUCCESS",
  "message": "销售订单确认成功",
  "requestId": "req-uuid-v4",
  "timestamp": "2026-08-09T15:35:00+08:00",
  "businessResult": {
    "orderId": "SO001",
    "newStatus": "CONFIRMED",
    "affectedSystems": [
      {
        "system": "MES",
        "action": "WORK_ORDER_SCHEDULED",
        "resultId": "WO2026001"
      }
    ],
    "nextExpectedEvents": [
      {
        "eventType": "WorkOrderReleased",
        "expectedBy": "2026-08-11T18:00:00+08:00"
      }
    ]
  }
}

HTTP 方法与幂等性

请求头规范

错误码体系

3.2 通信协议选型

3.3 多语言开发适配规范

所有语言栈公共要求：

• 统一OAuth2.0鉴权
• 统一日志格式（含traceId透传）
• 统一暴露 /health 健康检查端点

四、业务交互与一致性保障

4.1 四种业务交互模式

决策原则：

• 如果上游需要知道下游是否接受以及业务结果 → 业务指令（同步）
• 如果上游只需要通知**“我已发生某业务事实”** → 业务事件（异步）

4.2 业务状态机同步（核心难点）

问题： 同一业务对象在不同系统的状态机不同步

• ERP"已下达" ≠ MES"已排产"，存在时间差和业务语义差

解决规则：

1. 各系统维护自身状态机，不直接映射其他系统状态
2. 状态变更以业务事件形式广播，订阅方自主决策是否跟进
3. 禁止直接修改对方系统的状态字段（如ERP直接调用UPDATE MES工单状态）

4.3 一致性分级策略

4.4 RocketMQ 事务消息——短流程一致性

机制： 二阶段提交 + 事务状态回查，确保"本地事务提交"与"消息发送"的原子性

典型场景：ERP生产订单下发

ERP系统                              RocketMQ
┌─────────────┐    发送半消息    ┌─────────────┐
│ 1.开始本地   │ ──────────────> │ 消息状态:    │
│   事务       │                 │ "待确认"     │
└──────┬──────┘                 └─────────────┘
       │
       ▼
┌─────────────┐                 ┌─────────────┐
│ 2.执行本地   │                 │ 消息状态:    │
│   事务       │                 │ "待确认"     │
│ (创建订单)   │                 └─────────────┘
└──────┬──────┘                 ┌─────────────┐
       │    确认消息(COMMIT)    │ 消息状态:    │
       ▼ ────────────────────> │ "已确认"     │
┌─────────────┐                 └──────┬──────┘
│ 3.提交本地   │                        │
│   事务       │                        ▼
└─────────────┘                 ┌─────────────┐
                                │ MES消费消息  │
                                │ 创建工单     │
                                └─────────────┘

⚠️ 异常：本地事务失败 → 不回确认 → RocketMQ回查 → 丢弃半消息

代码示例：

@Transactional
public void createProductionOrder(Order order) {
    // 1. 发送半消息
    TransactionSendResult result = rocketMQTemplate.sendMessageInTransaction(
        "order-topic",
        MessageBuilder.withPayload(order).build(),
        order
    );
    
    // 2. 执行本地事务（创建订单）
    orderRepository.save(order);
    
    // 3. 返回事务状态
    return LocalTransactionState.COMMIT_MESSAGE;
}

// 事务状态回查
@Override
public LocalTransactionState checkLocalTransaction(MessageExt msg) {
    String orderId = msg.getKeys();
    return orderRepository.existsById(orderId) 
        ? LocalTransactionState.COMMIT_MESSAGE 
        : LocalTransactionState.ROLLBACK_MESSAGE;
}

4.5 Camel Saga 模式——长流程一致性

适用： 跨3个以上系统的长流程（如"订单→排程→生产→质检→入库→开票"）

机制： 将全局事务拆分为多个本地事务，每个本地事务对应一个补偿操作，失败时按逆向顺序执行补偿

┌─────────────────────────────────────────────────────────────┐
│              生产订单完整流程（Saga编排）                    │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  步骤1: ERP创建订单 ──成功──▶ 步骤2: MES创建工单            │
│       │                      │                              │
│       ▼                      ▼                              │
│   补偿: 取消订单           补偿: 取消工单                    │
│                                                             │
│  步骤3: 产线生产 ──成功──▶ 步骤4: 质检完成                   │
│       │                      │                              │
│       ▼                      ▼                              │
│   补偿: 报废/返工          补偿: 标记不合格                  │
│                                                             │
│  步骤5: 成品入库 ──成功──▶ 步骤6: ERP财务结算               │
│       │                      │                              │
│       ▼                      ▼                              │
│   补偿: 退货出库           补偿: 冲销财务凭证                │
│                                                             │
│  ⚠️ 任一步骤失败 → 逆向执行补偿 → 业务回滚到初始状态        │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Camel Saga 路由示例：

from("direct:startProductionFlow")
    .saga()
    .option("orderId", header("orderId"))
    
    .to("saga:erp:createOrder")
    .onFailure("saga:erp:cancelOrder")
    
    .to("saga:mes:createWorkOrder")
    .onFailure("saga:mes:cancelWorkOrder")
    
    .to("saga:mes:startProduction")
    .onFailure("saga:mes:reverseProduction")
    
    .to("saga:wms:receiveFinishedGoods")
    .onFailure("saga:wms:returnGoods")
    
    .to("saga:erp:settleFinance")
    .onFailure("saga:erp:reverseSettlement")
    
    .end();

4.6 补偿设计原则

补偿不是技术回滚，是业务回滚：

补偿规则：

• 补偿必须是业务上可理解的逆向操作，而非数据库 DELETE
• 补偿可能部分成功（需记录补偿状态，人工介入）
• 补偿操作本身必须幂等（可能重复触发）
• 补偿不能无限递归（最多补偿到流程起点）

4.7 幂等性设计

所有跨系统写操作必须支持幂等，这是确保重试安全的底线。

幂等键规范： {业务类型}_{业务ID}_{操作类型}

• 示例：order_create_ORD-2026-0809-001

实现模式：

public class IdempotentHandler {
    public void handleOrder(OrderRequest request) {
        String idempotentKey = request.getIdempotentKey();
        
        // 1. 检查幂等记录（Redis/DB）
        if (idempotentRepository.exists(idempotentKey)) {
            return;  // 已处理，直接返回
        }
        
        // 2. 执行业务逻辑（本地事务）
        try {
            businessLogic.execute(request);
            // 3. 记录幂等（与业务在同一事务中）
            idempotentRepository.save(idempotentKey, "SUCCESS");
        } catch (Exception e) {
            idempotentRepository.save(idempotentKey, "FAILED", e.getMessage());
            throw e;
        }
    }
}

五、消息队列与事件标准

5.1 业务事件 vs 数据变更事件

5.2 Topic 命名规范

命名格式：{domain}.{capability}.{event-name}

领域前缀：
  sales.          销售领域
  production.     生产领域
  warehousing.    仓储领域
  quality.        质量领域
  procurement.    采购领域
  finance.        财务领域
  mdm.            主数据

示例：
  sales.order-management.order-confirmed
  sales.order-management.order-cancelled
  production.work-order-management.work-order-scheduled
  production.work-order-management.work-order-completed
  warehousing.inventory-management.material-reserved
  quality.incoming-inspection.material-accepted

事务消息标记：后缀加 .tx
  例：sales.order-management.order-confirmed.tx

5.3 业务事件 Payload 标准（CloudEvents）

{
  "specversion": "1.0",
  "type": "sales.order-management.order-confirmed",
  "source": "erp-order-service",
  "id": "evt-uuid-v4",
  "time": "2026-08-09T15:35:00+08:00",
  "datacontenttype": "application/json",
  
  "data": {
    "eventId": "evt-uuid-v4",
    "eventType": "ORDER_CONFIRMED",
    "occurredAt": "2026-08-09T15:35:00+08:00",
    
    "businessEntity": {
      "entityType": "SALES_ORDER",
      "entityId": "SO2026001",
      "version": 2
    },
    
    "actor": {
      "type": "USER",
      "id": "U1001",
      "name": "张三"
    },
    
    "payload": {
      "before": { "status": "DRAFT" },
      "after": {
        "status": "CONFIRMED",
        "confirmedAt": "2026-08-09T15:35:00+08:00",
        "confirmedBy": "U1001",
        "deliveryDate": "2026-08-20"
      },
      "changedAttributes": ["status", "confirmedAt", "confirmedBy", "deliveryDate"]
    },
    
    "correlation": {
      "traceId": "trace-uuid",
      "sagaTxId": "tx-uuid-v4",
      "causationId": "cmd-uuid-v4"
    }
  }
}

5.4 消息中间件选型决策

推荐： 以 RocketMQ 作为业务事务消息主引擎，Kafka 作为数据流和日志辅助引擎。

六、集成平台核心能力

6.1 统一API网关（业务契约守护者）

分层架构：

┌─────────────────────────────────────────────────────────────┐
│                   边缘网关 (Edge Gateway)                    │
│  • SSL 终止 / DDoS 防护 / WAF                               │
│  • 全局负载均衡 / 地理位置路由                               │
└─────────────────────────────────────────────────────────────┘
                              │
┌─────────────────────────────────────────────────────────────┐
│                  业务网关 (Business Gateway)                  │
│  ┌─────────────────────────────────────────────────────┐   │
│  │  业务契约层                                          │   │
│  │  • OpenAPI 校验（请求体必须符合业务契约）              │   │
│  │  • 业务语义校验（如：取消订单必须提供取消原因）         │   │
│  │  • 业务规则预检（如：订单已发货不允许取消）             │   │
│  └─────────────────────────────────────────────────────┘   │
│  ┌─────────────────────────────────────────────────────┐   │
│  │  安全与治理层                                        │   │
│  │  • OAuth2 / JWT 认证                                │   │
│  │  • 数据权限范围校验（X-Data-Scope）                   │   │
│  │  • 限流熔断（按业务重要性分级）                        │   │
│  └─────────────────────────────────────────────────────┘   │
│  ┌─────────────────────────────────────────────────────┐   │
│  │  协议转换层                                          │   │
│  │  • SOAP ↔ REST / gRPC ↔ HTTP                        │   │
│  │  • 字段映射 / 编码转换 / 脱敏加密                      │   │
│  └─────────────────────────────────────────────────────┘   │
│  ┌─────────────────────────────────────────────────────┐   │
│  │  流量管理层                                          │   │
│  │  • 灰度发布（按客户/工厂/百分比）                      │   │
│  │  • A/B 测试 / 金丝雀发布                              │   │
│  │  • 版本路由（v1 / v2 共存）                           │   │
│  └─────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘

核心功能：

1. 统一鉴权：OAuth2.0 Token校验，支持客户端凭证和用户Token两种模式
2. 流量管控：按接口/调用方维度限流，防止单一系统打垮下游
3. 熔断降级：下游系统异常时自动熔断，返回降级响应，避免雪崩
4. 协议转换：SOAP/XML等传统协议自动转换为REST/JSON标准接口
5. 业务契约校验：网关强制执行业务规则预检
6. 全量日志：记录所有请求/响应日志，包含traceId

6.2 服务编排引擎（iPaaS + Camel）

混合模式：

• 主干流程用编排（Orchestration）：确保业务完整性，使用 Camel Saga / Temporal
• 分支响应用编舞（Choreography）：保持系统自治性，使用事件订阅

核心能力：

• 低代码可视化配置跨系统调用链路
• 拖拽式字段映射，自动处理数据格式差异
• 内置主流制造业系统适配器（SAP RFC/IDoc、用友U8+、金蝶EAS等）
• 内置重试、补偿、告警策略
• 将跨系统对接周期从1-2周缩短至1-3天

6.3 主数据管理中心

数据主权原则： 每个业务数据有且只有一个"权威源系统"

主数据分发流程：

MDM/PLM 变更物料主数据
  └── 发布业务事件：mdm.master-data.material-changed
      └── 订阅方（ERP/MES/WMS/SRM）各自更新本地副本

七、数据流转规范

7.1 单一数据源与权威系统

7.2 核心业务数据流

数据流一：ERP → MES（生产订单下发）——事务消息

数据流二：MES → ERP（生产完工反馈）——事务消息

数据流三：PLM → ERP/MES（BOM变更）——Saga编排

八、治理与运维体系

8.1 API全生命周期管理

• 建立全企业统一API资产目录，所有接口必须注册
• 包含接口说明、负责人、调用关系、版本信息
• 新系统接入前可先查询是否存在可复用接口
• 接口变更需走审批流程，自动通知所有下游消费方

8.2 全链路监控

• 通过统一traceId串联跨系统调用链路
• 核心接口设置SLA告警（响应时间>500ms、错误率>0.1%自动告警）
• 技术栈：SkyWalking + ELK + Prometheus

8.3 对账与补偿机制

日终对账流程：

• 提取当日业务事件，与各系统本地业务记录比对
• 发现差异：漏发事件补发、重复消费幂等去重、状态不一致触发补偿
• 生成对账报告，推送运维人员

对账维度：

• 订单维度：ERP订单 vs MES工单 vs WMS出入库
• 库存维度：WMS实物库存 vs ERP财务库存
• 质量维度：QMS检验批次 vs MES生产批次

8.4 安全管控

• 所有接口调用必须携带统一签发的Token
• 敏感数据传输全程加密
• 敏感字段（身份证号、手机号、银行卡号）在日志中自动脱敏
• 核心接口访问日志保留180天满足等保审计
• 关键写操作接口支持请求签名+时间戳校验，防重放攻击

8.5 异常处理规范

九、实施路线图

9.1 分阶段计划

9.2 集成优先级（以业务价值为导向）

9.3 组织保障

• 成立跨部门的数据治理委员会，统一协调标准落地
• 明确各系统业务负责人和技术负责人
• 建立集成需求评审机制，新对接需求必须经过集成平台团队评审

十、避坑指南

附录：核心原则速查

本方案的核心思想： 制造业系统集成的本质是业务流程的跨系统编排与业务状态的跨系统协商。技术（API网关、消息队列、Saga编排）是手段，业务（流程、规则、状态机）才是目的。通过平台化标准化业务集成，从根本上解决系统烟囱、重复建设和对接混乱问题，实现跨系统的业务流程无缝协同。

如果您所在的企业正面临类似的系统集成困境，或有系统集成、统一身份认证相关需求，欢迎留言或私信交流。