主题
架构
本页是「架构」栏目索引。四篇正文分别回答:怎么分层、怎么装配、请求怎么走、数据怎么落。本栏目讲机制,不重复生成物里的接口/表清单。
口径:接口与表数量以
/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;只做装配放 server | ARCH-01 |
| 模块依赖方向 | infra 不依赖任何 module,system 依赖 infra,业务模块再依赖二者;禁止反向 | ARCH-01 |
| 跨模块调用 | 只依赖对方 api 包的接口,不注入 Service/DO | ARCH-01 |
为什么 *CommonApi 在 common | starter 需要调用业务模块,但框架不能依赖 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 只注册 EnvironmentPostProcessor | ARCH-02 |
请求 URL 为什么有 /admin-api | WebMvcRegistrations 按 controller 包统一加前缀,Controller 本身不写 | ARCH-03 |
| 权限怎么判 | @PreAuthorize("@ss.hasPermission(...)") → PermissionCommonApi → 菜单角色缓存 | ARCH-03 |
| 租户怎么隔离 | TenantLineInnerInterceptor 拼 tenant_id;全局表用 @TenantIgnore | ARCH-04 |
| ID 怎么生成 | id-type: NONE 启动时适配:MySQL 等 AUTO,PG/Oracle 等 INPUT + @KeySequence | ARCH-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 |
推荐读法
- 第一次接触代码:先看本页图,再读 分层与依赖,最后跟一遍 请求处理链路。
- 要加模块/加 starter:直接读 模块化与自动配置,按「启用/停用清单」逐项核对。
- 要改表或接新数据库:读 数据访问与多租户基线,同时对照
/code/data/。 - 要查某个接口:架构页只讲链路,具体接口去
/code/api/。
本栏目的边界
- 不复制生成物:接口数、权限点、表数字段以
/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 套。