主题
预留模块概览(⏸)
仓库里有 12 个模块的源码。截至 2026-11-18,这 12 个模块均已在根 pom.xml 启用并通过 mvn package 与 test-compile;但它们的 <dependency> 仍未加入 pmforge-server,即已编译、未接入运行时,因此状态一律为 ⏸。
统计口径:Java 文件数为模块目录全量
Get-ChildItem -Recurse -Filter *.java的结果;控制器/接口为@RestController与@Get/Post/Put/Delete/PatchMapping计数;表数为dal/dataobject/**/*DO.java数量(与已实现模块的生成物口径一致)。数字代表代码存在量,不代表可运行。
0. 构建状态(2026-11-18)
按依赖顺序分四波把 13 个模块纳入 Reactor,逐波跑 mvn -B -ntp -DskipTests compile;全量再跑 package 与 test-compile。
| 波次 | 模块 | 结果 | 处理 |
|---|---|---|---|
| 1 | member、pay、bpm | ✅ | 直接通过;pay 仅有 MapStruct 未映射告警 |
| 2 | mall、crm | ✅ | trade-api 原本是空模块(只有 pom):把 TradeOrderApi、TradeOrderRespDTO、订单枚举与 api/package-info 迁入;statistics 补 pmforge-module-trade 依赖 |
| 3 | erp、wms、im、iot、mes | ✅ | 直接通过;iot 为 iot-core/biz/gateway 三子模块 |
| 4 | mp、report | ✅ | 仅 MapStruct 未映射告警 |
验证命令与结果:mvn -B -ntp -Dmaven.test.skip=true package → BUILD SUCCESS(17 个 Reactor 模块);mvn -B -ntp test-compile → BUILD SUCCESS;apps/pmforge-server/target/pmforge-server.jar 仍只装配 system + infra。
1. 13 个模块总表
| 模块 | 规划能力(功能点) | 代码规模(Java / 控制器 / 接口 / 表) | 启用前置 | 主要风险 | PRD |
|---|---|---|---|---|---|
| 会员 member | 会员用户、等级、积分、签到等 8 项 | 191 / 20 / 72 / 11 | system、infra | 被 mall-product 依赖;system 用反射适配,未启用时相关路径不可用 | 05-01 会员管理 |
| 支付 pay | 应用、渠道、支付/退款订单、钱包/余额/流水等 10 项 | 237 / 19 / 60 / 14 | system | 渠道密钥与证书需自行准备;无生产 DDL | 04-01 应用管理 |
| 工作流 bpm | 流程模型、定义、实例、任务、抄送等 20 项 | 242 / 12 / 76 / 8 | system;Flowable 6.8 | 引擎版本与 BOM 需对齐;流程表单与业务表耦合 | 03-01 流程设计 |
| 商城 mall | 商品、交易、营销、统计 16 项(4 个子模块) | 849 / 73 / 316 / 49 | member、pay(再按 product → promotion → trade → statistics) | 体量最大且子模块互相依赖,必须按序启用 | 06-01 商品管理 |
| CRM crm | 客户、联系人、商机、合同、回款、销售漏斗 | 282 / 24 / 167 / 21 | system、infra、bpm | 依赖 bpm,而 bpm 本身休眠;无测试 DDL | 08-01 CRM 客户管理 |
| ERP erp | 采购、销售、库存、财务、往来账 | 216 / 23 / 146 / 33 | system | 33 张表无生产 DDL;财务逻辑未验证 | 08-02 ERP 企业资源 |
| WMS wms | 仓库、入库、出库、盘点、调拨 | 160 / 17 / 77 / 16 | system | 库存并发与单据状态机未验证 | 08-03 WMS 仓库管理 |
| MES mes | 工单、生产、质量、设备、条码 | 1148 / 127 / 762 / 133 | system | 单体最大:133 表/127 控制器,构建与迁移成本最高 | 08-04 MES 制造执行 |
| IoT iot | 设备接入、物模型、数据采集、规则引擎 | 463 / 19 / 106 / 17 | system、iot-core;MQTT Broker | 需外部 Broker;iot-biz/iot-gateway 拆包,依赖名与根 pom 不一致 | 08-05 IoT 物联网 |
| IM im | 单聊、群聊、消息、已读、会话 | 300 / 30 / 126 / 17 | system、infra;WebSocket | 长连接与多实例路由未验证;无生产 DDL | 09-01 IM 即时通讯 |
| 微信公众号 mp | 素材、菜单、自动回复、用户标签 | 124 / 12 / 52 / 8 | system、infra;公众号 AppID | 未列入功能清单,价值与维护成本不匹配 | 无(未列入清单) |
| 报表 report | 数据源、数据集、图表、大屏(JimuReport 集成) | 31 / 2 / 5 / 1 | system;JimuReport 依赖 | 代码量最小但强绑定第三方报表引擎 | 09-02 数据报表 |
2. 依赖关系
启用顺序不是按功能点多少排,而是按 pom.xml 的真实依赖排。下表的「直接依赖」来自各模块 pom.xml,「被谁依赖」来自根/服务端 pom 与模块内的 import:
| 模块 | 直接依赖 | 被谁依赖 | 能否单独启用 |
|---|---|---|---|
| member | system、infra | mall-product | 可以,且应作为 mall 的前置 |
| pay | system | mall-trade | 可以,渠道先用沙箱 |
| bpm | system | crm | 可以,但 crm 等它 |
| mall-product | member | mall-promotion、mall-trade、mall-statistics | 否,先 member |
| mall-promotion | product、trade-api、system、infra、member | mall-trade、mall-statistics | 否 |
| mall-trade | trade-api、product、pay、promotion、member、system | mall-statistics | 否,需 pay |
| mall-statistics | promotion、product、trade-api、member、pay | — | 否,最后 |
| ai | system、infra | — | 可以(需模型 Key) |
| crm | system、infra、bpm | — | 否,先 bpm |
| erp / wms / mes | system | — | 可以,但建议独立库/进程 |
| iot-biz | system、iot-core | — | 否,需 Broker |
| im | system、infra | — | 可以,需 WebSocket 容量规划 |
| mp | system、infra | — | 可以,需公众号账号 |
| report | system | — | 可以,需 JimuReport |
3. 逐个模块要点
- member(8 项):会员列表/详情、标签、等级、积分记录/配置、签到配置、优惠券;
system的MemberServiceImpl已用反射预留适配点,但 member 未启用时容器里没有MemberUserApi,相关场景会抛NoSuchBeanDefinitionException。启用后 mall-product 才可用。 - pay(10 项):支付应用、渠道(支付宝/微信)、支付订单、退款、钱包/余额/流水、回调通知;渠道参数是运行时配置,能编译不代表能支付。
sql/无生产 DDL,需从 14 个 DO 反推建表。 - bpm(20 项):BPMN/仿钉钉设计器、流程定义/部署/分类、发起与待办/已办、会签/抄送/委派等;预留里功能点最多。底层 Flowable 6.8,升级需同步 BOM;crm 的审批依赖它。
- mall(16 项):
product(128 Java/13 控制器)、promotion(331/37)、trade(291/19)、statistics(68/4)+trade-api;依赖 member、pay、trade-api,是依赖链最深的模块。 - crm(未拆功能点):客户/联系人/商机/合同/回款/漏斗,21 张表;
pom.xml依赖 bpm,因此必须先起 bpm;无src/testDDL,迁移只能从 DO 推导。 - erp(未拆功能点):采购/销售/库存/财务/往来账,33 张表、23 个控制器;表多且跨单据,建议先只启用采购-库存子链路。
- wms(未拆功能点):仓库/入库/出库/盘点/调拨,16 张表;有测试 DDL;库存扣减与单据状态机是主要验证点。
- mes(未拆功能点):工单/生产/质量/设备/条码,1148 个 Java 文件、133 张表,是全仓最重的模块;建议独立部署、单独数据库,不要与主应用同进程。
- iot(未拆功能点):
iot-core(52 Java,无控制器)+iot-biz(250/19)+iot-gateway(112,0 控制器);设备接入依赖 MQTT Broker,规则引擎需压测。 - im(未拆功能点):单聊/群聊/消息/已读/会话,30 个控制器、17 张表;依赖 WebSocket 与多实例消息路由,有测试 DDL 但无生产 DDL。
- mp(未拆功能点):公众号素材、菜单、自动回复、用户标签,8 张表;不在功能清单 3.x 中,也没有独立 PRD,优先级最低。
- report(未拆功能点):2 个控制器、5 个接口、1 张表,实质是 JimuReport 的接入层;是否启用取决于是否接受该第三方报表引擎。
4. 启用步骤
- 根
pom.xml:取消对应<module>注释(第 18–31 行区)。mall、iot 是聚合模块,取消后会自动带入子模块。 apps/pmforge-server/pom.xml:取消对应<dependency>注释。注意名称与根 pom 不完全一致:mall 要引pmforge-module-product/promotion/trade/statistics(不是 mall 聚合),iot 要引pmforge-module-iot-biz(不是pmforge-module-iot)。- 补数据库:
sql/mysql/pmforge.sql覆盖 system/infra 的 48 张表;另有按 DO 自动生成的 预留模块 DDL 骨架(sql/mysql/pmforge-modules-skeleton.sql,325 张表,含类型推断与简化说明),以及 bpm/im/iot-biz/member/pay/report/mall/mes/wms 的测试建表脚本,可作为生产脚本的起点。 - 解除兜底路由:
pmforge-server的DefaultController为禁用模块注册了/admin-api/<module>/**并返回NOT_IMPLEMENTED,启用后要删掉对应方法,避免与真实控制器映射冲突(member 没有兜底方法)。 - 纳入生成流程:
tools/docs/scan-knowledge.mjs第 39 行const MODULE_ORDER = ['system', 'infra'],需把新模块加入,否则代码索引不会包含它;随后执行npm run docs:gen(本页写作时未执行)。 - 编译与冒烟:先单模块
mvn compile,再起服务验证登录、菜单、权限、定时任务/流程/支付回调等关键链路;验证通过前状态保持 ⏸。
5. 启用前检查清单
- [ ] 根
pom.xml与apps/pmforge-server/pom.xml的模块名/依赖名一致(尤其 mall 子模块、iot-biz) - [ ] 生产 DDL 已执行,字符集、排序规则、
tenant_id与主库一致 - [ ] 菜单与按钮权限 SQL 已执行,角色已授权
- [ ]
DefaultController中对应的兜底方法已删除 - [ ]
MODULE_ORDER已加入模块,接口/数据索引重新生成 - [ ] 依赖的中间件可用(Quartz、Redis、MQTT、对象存储、模型服务)
- [ ] 前端路由与菜单已配置(若配套
pmforge-ui使用) - [ ] 冒烟通过:登录 → 菜单 → 核心 CRUD → 回调/任务 → 权限校验
6. 启用优先级建议
| 优先级 | 模块 | 理由 |
|---|---|---|
| P0 | member | 8 个功能点,只依赖 system/infra;是 mall-product 的硬前置,system 已留反射适配 |
| P0 | pay | 10 个功能点,独立依赖 system;是 trade 的硬前置,渠道可先用沙箱 |
| P0 | bpm | 预留中功能点最多(20),且 crm 依赖它;先起引擎再谈审批场景 |
| P1 | mall | 16 个功能点、体量最大,必须等 member/pay 就绪;建议按 product → promotion → trade → statistics 逐个开 |
| P1 | crm | 21 张表、24 个控制器,依赖 bpm;业务闭环清晰,适合作为企业应用第一个试点 |
| P1 | ai | 13 个功能点,依赖最少(system/infra),但需要外部模型 Key,适合独立小规模验证 |
| P2 | erp | 33 张表且无测试 DDL,建议先做采购-库存最小链路 |
| P2 | wms | 16 张表、有测试 DDL,可与 erp 库存联动验证 |
| P2 | im | 长连接需单独容量规划,30 个控制器,建议独立部署 |
| P2 | iot | 需 MQTT Broker 与设备模拟器,iot-biz/iot-gateway 拆包,运维成本高 |
| P2 | mes | 1148 Java/133 表,建议最后做,且单独数据库/进程 |
| P3 | mp | 未列入功能清单、无 PRD,公众号能力与主业务弱相关 |
| P3 | report | 仅 31 个 Java 文件,但绑定 JimuReport;等报表需求明确再评估 |
7. 共性风险
| 风险 | 表现 | 应对 |
|---|---|---|
| 编译与运行时脱节 | 已编译不等于可运行:库表、菜单、配置、外部依赖都还没接 | 用 sql/mysql/pmforge-modules-skeleton.sql 或各模块测试 DDL 起手补库表,再补菜单 SQL 与接口冒烟 |
| 依赖漂移 | server pom 引 product/promotion/trade/statistics、iot-biz,与根 pom 的 mall/iot 命名不一致 | 以 server pom 的子模块名为准,核对根 pom 聚合 |
| 无生产 DDL | sql/mysql/pmforge.sql 只覆盖 system/infra 48 表;预留模块只有骨架(325 表)与部分测试 DDL | 逐表核对骨架后落库,或按业务补齐索引与约束 |
| 文档/索引缺失 | 接口/数据索引不包含休眠模块,本页数字来自手工统计 | 启用时同步 MODULE_ORDER 并重新生成 |
| 兜底路由冲突 | DefaultController 的 /** 映射与真实控制器同时存在 | 启用时删除对应兜底方法,重启后检查映射日志 |