Skip to content

架构决策记录(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 + demo profile。
  • 理由:数据真实、菜单/权限/租户链路完整;避免 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。
  • 代价:演示环境无跨实例消息;不影响单机功能。