Skip to content

预留模块概览(⏸) ​

仓库里有 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。

波次模块结果处理
1member、pay、bpm✅直接通过;pay 仅有 MapStruct 未映射告警
2mall、crm✅trade-api 原本是空模块(只有 pom):把 TradeOrderApi、TradeOrderRespDTO、订单枚举与 api/package-info 迁入;statistics 补 pmforge-module-trade 依赖
3erp、wms、im、iot、mes✅直接通过;iot 为 iot-core/biz/gateway 三子模块
4mp、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 / 11system、infra被 mall-product 依赖;system 用反射适配,未启用时相关路径不可用05-01 会员管理
支付 pay应用、渠道、支付/退款订单、钱包/余额/流水等 10 项237 / 19 / 60 / 14system渠道密钥与证书需自行准备;无生产 DDL04-01 应用管理
工作流 bpm流程模型、定义、实例、任务、抄送等 20 项242 / 12 / 76 / 8system;Flowable 6.8引擎版本与 BOM 需对齐;流程表单与业务表耦合03-01 流程设计
商城 mall商品、交易、营销、统计 16 项(4 个子模块)849 / 73 / 316 / 49member、pay(再按 product → promotion → trade → statistics)体量最大且子模块互相依赖,必须按序启用06-01 商品管理
CRM crm客户、联系人、商机、合同、回款、销售漏斗282 / 24 / 167 / 21system、infra、bpm依赖 bpm,而 bpm 本身休眠;无测试 DDL08-01 CRM 客户管理
ERP erp采购、销售、库存、财务、往来账216 / 23 / 146 / 33system33 张表无生产 DDL;财务逻辑未验证08-02 ERP 企业资源
WMS wms仓库、入库、出库、盘点、调拨160 / 17 / 77 / 16system库存并发与单据状态机未验证08-03 WMS 仓库管理
MES mes工单、生产、质量、设备、条码1148 / 127 / 762 / 133system单体最大:133 表/127 控制器,构建与迁移成本最高08-04 MES 制造执行
IoT iot设备接入、物模型、数据采集、规则引擎463 / 19 / 106 / 17system、iot-core;MQTT Broker需外部 Broker;iot-biz/iot-gateway 拆包,依赖名与根 pom 不一致08-05 IoT 物联网
IM im单聊、群聊、消息、已读、会话300 / 30 / 126 / 17system、infra;WebSocket长连接与多实例路由未验证;无生产 DDL09-01 IM 即时通讯
微信公众号 mp素材、菜单、自动回复、用户标签124 / 12 / 52 / 8system、infra;公众号 AppID未列入功能清单,价值与维护成本不匹配无(未列入清单)
报表 report数据源、数据集、图表、大屏(JimuReport 集成)31 / 2 / 5 / 1system;JimuReport 依赖代码量最小但强绑定第三方报表引擎09-02 数据报表

2. 依赖关系 ​

启用顺序不是按功能点多少排,而是按 pom.xml 的真实依赖排。下表的「直接依赖」来自各模块 pom.xml,「被谁依赖」来自根/服务端 pom 与模块内的 import:

模块直接依赖被谁依赖能否单独启用
membersystem、inframall-product可以,且应作为 mall 的前置
paysystemmall-trade可以,渠道先用沙箱
bpmsystemcrm可以,但 crm 等它
mall-productmembermall-promotion、mall-trade、mall-statistics否,先 member
mall-promotionproduct、trade-api、system、infra、membermall-trade、mall-statistics否
mall-tradetrade-api、product、pay、promotion、member、systemmall-statistics否,需 pay
mall-statisticspromotion、product、trade-api、member、pay—否,最后
aisystem、infra—可以(需模型 Key)
crmsystem、infra、bpm—否,先 bpm
erp / wms / messystem—可以,但建议独立库/进程
iot-bizsystem、iot-core—否,需 Broker
imsystem、infra—可以,需 WebSocket 容量规划
mpsystem、infra—可以,需公众号账号
reportsystem—可以,需 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/test DDL,迁移只能从 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. 启用步骤 ​

  1. 根 pom.xml:取消对应 <module> 注释(第 18–31 行区)。mall、iot 是聚合模块,取消后会自动带入子模块。
  2. apps/pmforge-server/pom.xml:取消对应 <dependency> 注释。注意名称与根 pom 不完全一致:mall 要引 pmforge-module-product/promotion/trade/statistics(不是 mall 聚合),iot 要引 pmforge-module-iot-biz(不是 pmforge-module-iot)。
  3. 补数据库: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 的测试建表脚本,可作为生产脚本的起点。
  4. 解除兜底路由:pmforge-server 的 DefaultController 为禁用模块注册了 /admin-api/<module>/** 并返回 NOT_IMPLEMENTED,启用后要删掉对应方法,避免与真实控制器映射冲突(member 没有兜底方法)。
  5. 纳入生成流程:tools/docs/scan-knowledge.mjs 第 39 行 const MODULE_ORDER = ['system', 'infra'],需把新模块加入,否则代码索引不会包含它;随后执行 npm run docs:gen(本页写作时未执行)。
  6. 编译与冒烟:先单模块 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. 启用优先级建议 ​

优先级模块理由
P0member8 个功能点,只依赖 system/infra;是 mall-product 的硬前置,system 已留反射适配
P0pay10 个功能点,独立依赖 system;是 trade 的硬前置,渠道可先用沙箱
P0bpm预留中功能点最多(20),且 crm 依赖它;先起引擎再谈审批场景
P1mall16 个功能点、体量最大,必须等 member/pay 就绪;建议按 product → promotion → trade → statistics 逐个开
P1crm21 张表、24 个控制器,依赖 bpm;业务闭环清晰,适合作为企业应用第一个试点
P1ai13 个功能点,依赖最少(system/infra),但需要外部模型 Key,适合独立小规模验证
P2erp33 张表且无测试 DDL,建议先做采购-库存最小链路
P2wms16 张表、有测试 DDL,可与 erp 库存联动验证
P2im长连接需单独容量规划,30 个控制器,建议独立部署
P2iot需 MQTT Broker 与设备模拟器,iot-biz/iot-gateway 拆包,运维成本高
P2mes1148 Java/133 表,建议最后做,且单独数据库/进程
P3mp未列入功能清单、无 PRD,公众号能力与主业务弱相关
P3report仅 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 聚合
无生产 DDLsql/mysql/pmforge.sql 只覆盖 system/infra 48 表;预留模块只有骨架(325 表)与部分测试 DDL逐表核对骨架后落库,或按业务补齐索引与约束
文档/索引缺失接口/数据索引不包含休眠模块,本页数字来自手工统计启用时同步 MODULE_ORDER 并重新生成
兜底路由冲突DefaultController 的 /** 映射与真实控制器同时存在启用时删除对应兜底方法,重启后检查映射日志

8. 相关页面 ​