主题
架构决策记录(ADR)
ADR-001 单仓多模块 + 单应用装配
- 决策:所有业务模块同仓、由
apps/pmforge-server统一装配。 - 理由:演示与交付成本最低;模块可独立编译,逐步接入。
- 代价:单 jar 体积大(约 146 MB → 全模块 327 MB)。
ADR-002 目录按 build/framework/modules/apps/web 重组
- 决策:
pmforge-*扁平目录改为build/、framework/、modules/、apps/、web/、tools/、deploy/。 - 理由:与主流多模块仓库一致,便于区分「可复用组件 / 业务模块 / 可运行应用 / 前端」。
- 代价:一次性大迁移(6844 个文件路径变化),必须同步脚本与文档。
ADR-003 知识库冻结,工程手册增量
- 决策:
docs/既有 194 页不动,新增docs/engineering/。 - 理由:知识库已发布并被引用;工程规范迭代频率高,混在一起会互相干扰。
- 代价:两套文档体系需要各自的门禁。
ADR-004 前端从零新建(shadcn 风格自绘)
- 决策:不引入外部 admin 模板,
web/pmforge-ui-web自绘组件(Tailwind + CSS 变量)。 - 理由:外部 5 个 UI 仓库不可访问;自绘可控、体积小(gzip 约 65 KB 主包)。
- 代价:组件丰富度低,复杂表格/表单需逐步补。
ADR-005 演示环境用 demo profile + 真实库
- 决策:不引入 H2 演示库,直接使用 MySQL
pmforge-jdk8+demoprofile。 - 理由:数据真实、菜单/权限/租户链路完整;避免 H2 与 MySQL 方言差异。
- 代价:依赖本机 MySQL;演示数据随库变化。
ADR-006 移除 AI 模块
- 决策:删除
modules/ai及全部 AI 相关文档、菜单、配置、前端入口。 - 理由:Spring AI 1.x 需要 Spring Boot 3 / Jakarta,与主干
javax不兼容;保留半成品只会造成「文档有、代码跑不了」的误导。 - 代价:后续若要做 AI 能力,需单独建服务(Boot 3 / Jakarta)或整体升级主干。
- 代价:门户保留入口但不可用;升级 Boot 3 时统一处理。
ADR-007 IoT 消息总线在 demo 用 local
- 决策:
pmforge.iot.message-bus.type=local。 - 理由:Redis 实现要求 Redis ≥ 5.0,本机为 3.x。
- 代价:演示环境无跨实例消息;不影响单机功能。