Skip to content

架构 ​

本页是「架构」栏目索引。四篇正文分别回答:怎么分层、怎么装配、请求怎么走、数据怎么落。本栏目讲机制,不重复生成物里的接口/表清单。

口径:接口与表数量以 /code/api/ 、/code/data/ 的生成物为准。默认构建(只启用 system、infra)为 328 个接口、48 张表;生成物里的 388 张表包含 13 个预留模块的实体(其中多数没有随仓库提供 DDL),不是默认可建表数。

一页看懂 ​

text
┌──────────────┐   HTTP/JSON   ┌──────────────────────────────────┐
│ 管理端/开放端 │ ────────────▶ │ pmforge-server :48080             │
└──────────────┘               │ 空壳容器:依赖 + 启动 + 配置       │
                               └───────────────┬──────────────────┘
                                               │ depends
                     ┌─────────────────────────┴─────────────────────────┐
                     │ module-system / module-infra / 预留业务模块        │
                     │ Controller → Service → Mapper → DO                │
                     └─────────────────────────┬─────────────────────────┘
                                               │ depends
                     ┌─────────────────────────┴─────────────────────────┐
                     │ framework:1 个 common + 14 个 starter            │
                     │ core(能力)+ config(自动配置)                   │
                     └─────────────────────────┬─────────────────────────┘
                                               │ versions
                     ┌─────────────────────────┴─────────────────────────┐
                     │ pmforge-dependencies(BOM)                       │
                     └─────────────────────────┬─────────────────────────┘
                                               │
        MySQL / PostgreSQL / Oracle / SQL Server / DM / Kingbase / OpenGauss / HighGo

四篇导读 ​

页面回答的问题一句话结论
分层与依赖代码放哪层?模块能不能互相依赖?依赖只能朝 infra → system → 业务模块 方向走;框架不反向依赖业务,契约下沉到 common/biz。
模块化与自动配置starter 怎么被装进来?模块怎么启停?每个 starter 都是 core + config,用 AutoConfiguration.imports 注册;spring.factories 只用于两个 EnvironmentPostProcessor。
请求处理链路一个创建请求经过哪些关卡?Filter 在 -104…-99 完成租户/日志/XSS/安全,Controller 显式返回 CommonResult,租户、数据权限、分页三个 MyBatis 拦截器依次生效。
数据访问与多租户基线表怎么建、租户怎么隔离、ID 怎么来?默认 BaseDO 管审计与逻辑删除,TenantBaseDO + TenantLine 管租户;ID 走数据库自增/序列,不启用雪花。

架构速查表 ​

关注点结论去读
新功能落在哪层有业务语义放 module;可复用能力放 framework starter;只做装配放 serverARCH-01
模块依赖方向infra 不依赖任何 module,system 依赖 infra,业务模块再依赖二者;禁止反向ARCH-01
跨模块调用只依赖对方 api 包的接口,不注入 Service/DOARCH-01
为什么 *CommonApi 在 commonstarter 需要调用业务模块,但框架不能依赖 module,只能把契约下沉ARCH-01
可选模块怎么解耦根/server pom 注释、@ConditionalOnClass(name=...)、SpringUtil 反射,三种代价不同ARCH-01
模块怎么启停根 pom → server pom → SQL → 配置 → system_menu,五处都要动ARCH-02
自动配置怎么生效13 个 AutoConfiguration.imports(12 starter + iot-core);2 个 spring.factories 只注册 EnvironmentPostProcessorARCH-02
请求 URL 为什么有 /admin-apiWebMvcRegistrations 按 controller 包统一加前缀,Controller 本身不写ARCH-03
权限怎么判@PreAuthorize("@ss.hasPermission(...)") → PermissionCommonApi → 菜单角色缓存ARCH-03
租户怎么隔离TenantLineInnerInterceptor 拼 tenant_id;全局表用 @TenantIgnoreARCH-04
ID 怎么生成id-type: NONE 启动时适配:MySQL 等 AUTO,PG/Oracle 等 INPUT + @KeySequenceARCH-04
新库怎么初始化建库 → sql/mysql/pmforge.sql → sql/mysql/quartz.sql → 改 apps/pmforge-server/src/main/resources/application-local.yaml → 启动ARCH-04
读写分离现状master/slave 已配置,但代码没有 @DS("slave"),slave 当前不承流ARCH-04

关键数字(默认构建) ​

指标数值口径
根 pom 激活的 Maven 模块5 个dependencies、framework、server、system、infra
framework 模块15 个1 个 pmforge-common + 14 个 starter
默认接口 / 表315 / 48只含 system、infra;48 张中 infra 的 16 张含 5 张 demo 表
AutoConfiguration.imports 源文件13 个12 个 framework starter + iot-core
有脚本的 SQL 方言8 套mysql、postgresql、oracle、sqlserver、dm、kingbase、opengauss、highgo

推荐读法 ​

本栏目的边界 ​

  • 不复制生成物:接口数、权限点、表数字段以 /code/api/、/code/data/ 为准。
  • 不写部署运维:本文只描述应用内架构;启动参数、环境变量以仓库 README 与 application-*.yaml 为准。
  • 不声称“模块零依赖”:实际规则是单向依赖,system → infra、crm → system/infra/bpm 都是存在的。
  • 不把“15 个组件”说成“15 个 starter”:实际是 1 个 pmforge-common + 14 个 starter。
  • 不把 sql/db2/ 当成已支持:该目录为空;有脚本的方言是 8 套,不是 9 套。