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 主计划/工单/报工 → 质检与仓储 → 销售出库 → 开票回款 → 售后闭环
独立模块：财务报销（yudao-module-finance，报销单/明细/发票附件/审批/归档，对外提供 yudao-module-finance-api 供他模块建单）与会员管理（yudao-module-ums，入会申请/秘书处与理事会两级审批/会员/通讯录）各自成一条链路（UMS 例外：审批通过会经 AdminUserApi 创建系统登录账号）；课题管理（yudao-module-research，课题指南/在线申报/专家评审/三级立项审批/立项通知/经费拨付）为另一条独立科研主线，向外取 ums_member 作为申报人、写 system_notice 立项公告，**并已对接财务**：经费拨付 1:1 自动生成财务报销单并提交审批，审批结果经 BPM 监听器回写课题侧拨款台账；档案管理（yudao-module-archive，分类书架/档案登记与检索/借阅两级审批/归还闭环/逾期实时提醒/统计）为第四条独立主线，**对外提供 yudao-module-archive-api 供课题、会员、财务三方向其归档**（列表页手动「归档」按钮，归档不回写来源业务状态），自身对三方**无反向依赖**

2. 目录结构

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

⚠ index.html 内嵌了 mermaid/ 与 data/ 的**镜像**（file:// 下 fetch 被浏览器拦截，故内嵌一份）。**修改 .mmd/.json 后必须同步镜像**：
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 依赖）
12-finance-flow	财务报销（独立模块）：报销单+明细+发票附件 → 提交 BPM 审批 → 通过/驳回 → 归档终态；单据来源含手工新建与「课题经费拨付自动生成」两类
13-ums-membership-flow	会员入会（独立模块）：入会申请 + 材料附件 → 提交 BPM 两级审批（秘书处初审→理事会审议）→ 通过自动建会员与登录账号 → 会员列表/通讯录检索
14-research-flow	课题管理（独立模块）：指南发布(重点/一般)→在线申报(选会员带出申报人)→专家评分明细加权排名→BPM 三级审批(秘书处形式审查→专家评审→学会立项审批)→立项编号与公告→经费拨付（凭证必填→1:1 自动生成并提交财务报销单→财务审核/财务主管两级审批→结果经监听器回写台账：通过已拨付/驳回已驳回可重发/撤回回待拨付）
15-archive-flow	档案管理（独立模块）：分类书架(树形·默认密级→新增档案自动带出)→档案登记(密级三档/载体三型/实体位置四字段/电子附件/DA 编号)→三方归档联动(课题已立项/会员正常/财务已通过各列表手动「归档」→经 `archive-api` 生成档案并回写 `archive_document_id`)→借阅登记(仅「在库」可选·同档案不得有在途借阅单)→BPM 两级审批(档案管理员审核→分管领导审批·通过后档案条件更新为借出中)→归还登记(回在库)→逾期实时计算(不建定时任务)→存量流转统计

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

4. HTML 使用方法

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

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；2026-09-28 增量补充财务报销模块（yudao-module-finance）、会员管理模块（yudao-module-ums）与课题管理模块（yudao-module-research，一期项 1~5；二期结项验收与成果归档尚未做，图中已标注未覆盖范围）；**2026-09-29 增量**：课题经费拨付对接财务报销——新建 yudao-module-finance-api（FinanceReimbursementApi 本地 Bean 调用：建单+提交/改单+重提/删除/查询），登记拨款时 1:1 自动生成 finance_reimbursement（系统生成 1 行明细）并自动提交 finance_reimbursement_approve 两级审批，新增第 15 个业务监听器 ResearchFundStatusListener 按审批结果回写课题拨款台账（通过 20 / 驳回 30 / 撤回 0），影响图 08 / 09 / 10 / 14 与 data 全部四份 json；**2026-09-29 再增量**：新增档案管理独立模块 yudao-module-archive + yudao-module-archive-api（ArchiveDocumentApi：archiveBySource 幂等归档 / isArchived / getBySource），3 张表 archive_category/archive_document/archive_borrow、6 个字典（82000~82005）、bpm_category(8003) + 手写 archive_borrow_approve.bpmn（已在 mom-jssm 部署为版本 1，form_type=20，创建路径 /archive/borrow/index、查看路径 /archive/borrow/detail/approve/index.vue）、菜单 1075600~1075699；新增业务监听器 ArchiveBorrowStatusListener，全库业务状态监听器计数修正为 24 个 *StatusListener（14 个继承 BpmProcessInstanceStatusEventListener）；三方归档回写 archive_document_id 到 research_application/ums_member/finance_reimbursement，全库表数 427→430；新增图 15-archive-flow，增量修订图 01 / 08 / 09 / 10 与 data 全部五份 json（新增 arc 模块、3 个业务对象、archive 流程、4 个业务角色）。

7. 已知待确认业务

见 data/business.json 的 pendingConfirm（页面「待确认事项」栏），要点：仓库类型/合格仓改造未落地、HRM 交接 expandUserIds 尚未被业务查询接入、回款与收款单未走 BPM、财务勾稽回写方法为空、NCR 处置不回写源单、财务报销的 BPM 流程定义未发布与普通角色未授菜单、会员管理的 BPM 流程未发布且缺审批自定义表单页、自动建账号用手机号作初始密码存在弱口令风险、课题管理的评分权重与通过阈值为占位规则待学会确认、课题经费拨付虽已对接财务报销但台账与报销单为软关联（财务侧删单会留悬空 reimbursement_id）、新建的财务报销审批流程节点审批人需上线前在 BPM 设计器按实际组织调整、申报单与会员为软关联可能悬空；档案管理的 BPM 部署产物为手工导出需严守「先部署再导出再合并」顺序、菜单与权限仅在各归档脚本中普通角色未授权、档案与来源单据（课题申报书/会员/报销单）为软关联来源删单后会留悬空快照、「文书档案」等无来源模块仅手工录入且合同档案未纳入自动归档、逾期仅查询时实时计算不建定时任务不发站内信、「同一档案仅一条未归还借阅单」由应用层校验 + 条件更新共同保证、统计为 GROUP BY 聚合过万后需改造、三方来源表各加可空列 archive_document_id 属跨模块改表需确认变更窗口等。