# MOM 工厂数字化平台 · 项目业务分析

基于真实源码（6 组并行源码走读：MES 生产质量 / MES 仓储 / ERP / CRM+SRM / 售后+HRM / AI+BI+MDM+BPM+底座）还原的业务知识模型与可视化，供新人培训、项目汇报、客户演示与开发查档使用。

## 1. 项目定位

- **系统类型**：混合系统（MOM 制造运营管理）
- **业务定位**：离散制造工厂产供销人财物一体化：覆盖『销售接单 → 采购/生产 → 质检 → 仓储 → 发货 → 回款 → 售后』全链路闭环
- **技术底座**：yudao（ruoyi-vue-pro）二开，Spring Boot + MyBatis + Flowable + Redis + MySQL 8.4 + Milvus + 通义千问；前端 mom-pro2-before（Vue3）
- **核心主线**：CRM 合同 → ERP 销售订单 → MES 主计划/工单/报工 → 质检与仓储 → 销售出库 → 开票回款 → 售后闭环

## 2. 目录结构

```text
docs/project-business/
├── index.html      # 可视化页面：双击直接打开（file:// 即可，无需任何服务）
├── mermaid/        # 11 张 Mermaid 业务图（权威源，改这里）
├── data/           # 业务数据（权威源，改这里）
│   ├── business.json  # 项目元信息/业务十问/AI能力/待确认事项
│   ├── modules.json   # 12 个业务模块定义
│   ├── objects.json   # 核心业务对象（作用/上游/下游/表名）
│   ├── flows.json     # 7 条流程（摘要+步骤+角色）
│   └── roles.json     # 角色权限
└── README.md
```

> ⚠ `index.html` 内嵌了 `mermaid/` 与 `data/` 的**镜像**（file:// 下 fetch 被浏览器拦截，故内嵌一份）。**修改 .mmd/.json 后必须同步镜像**：
>
> ```bash
> node .claude/skills/project-business-analysis/scripts/sync_index.js
> ```

## 3. Mermaid 图说明

| 文件 | 内容 |
|------|------|
| 01-business-mindmap | 业务全景思维导图（模块-能力树） |
| 02-sales-flow | 销售：线索→客户→商机→报价→合同(BPM)→销售订单→发货出库→开票回款 |
| 03-purchase-flow | 采购：SRM 准入/定标→申请(BPM)→订单→到货→IQC→入库/退货→来票→付款 |
| 04-production-flow | 生产：销售订单→MPS→工单→任务→报工(工序顺序控制)→倒冲/IPQC/产出→完工事件 |
| 05-quality-flow | 质量：IQC/IPQC/OQC/RQC 四闸口 + 判定四果 + NCR 处置闭环 |
| 06-warehouse-flow | 仓储：15 类单据、六元组库存台账、事务流水、调拨/盘点/批次SN/线边库 |
| 07-after-sales-flow | 售后：工单六态→维修/退货→MES 联动→质检入库退款三回调→关闭 |
| 08-module-relation | 模块系统关系（调用与审批回调） |
| 09-data-flow | 跨模块数据流（单据生成、字段带入、数量回写、事件） |
| 10-business-object | 核心业务对象 ER（只含业务对象，非全库表） |
| 11-ai-business-flow | AI 业务链路（OCR/质检判定/四类预测/RAG，含 API 依赖） |

图中状态数字均为源码枚举真实值（如工单 0草稿/1已确认/2完成/3取消；ERP 审批 15审批中/20已审核）。

## 4. HTML 使用方法

1. 资源管理器双击 `index.html`（或浏览器拖入）。Mermaid 走 CDN 渲染，**首次打开需联网**，之后浏览器有缓存。
2. 左侧导航切换页面；顶部搜索框支持按名称/关键词搜索业务对象、流程、模块、角色，回车点结果直达。
3. 每张图右上角：－/＋缩放、重置、全屏（适合投屏讲解）。
4. 概览页模块卡片、业务对象表格行均可点击钻取。

## 5. 数据文件说明

- `data/*.json` 是页面渲染的数据源（页面优先 fetch 本地文件，file:// 下回退内嵌镜像）。
- 字段结构自解释；新增对象请同时补 `keywords`（供搜索）。

## 6. 如何重新生成 / 维护

- 本目录由项目技能 **project-business-analysis** 管理（`.claude/skills/project-business-analysis/`），并有规则 `.claude/rules/business-visualization-maintenance.md` 强制：业务模块/流程/状态/对象/角色/AI 变更后需同步维护本目录。
- 增量维护：改对应的 `mermaid/*.mmd` + `data/*.json` → 运行上面的 sync 脚本 → 浏览器验证受影响图。
- 全量重做（偏差过大时）：对 Claude 说「重新生成业务全景」，技能会重新走读源码并按生成模式重建。
- 生成基线：dev_business @ 87bf4a99，2026-09-10。

## 7. 已知待确认业务

见 `data/business.json` 的 `pendingConfirm`（页面「待确认事项」栏），要点：仓库类型/合格仓改造未落地、HRM 交接 expandUserIds 尚未被业务查询接入、回款与收款单未走 BPM、财务勾稽回写方法为空、NCR 处置不回写源单等。