主题
架构说明
1. 分层与依赖方向
apps/pmforge-server → modules/* → framework/* → build/pmforge-bom
│ │
└── web 静态资源 └── 跨模块调用只走 <module>.api 包apps/pmforge-server是唯一组合根:@SpringBootApplication(scanBasePackages = "${pmforge.info.base-package}.server", "${pmforge.info.base-package}.module")。framework/每个 starter =core/(无 Spring 依赖的封装)+config/(自动配置),通过META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports注册。pmforge-common额外承载framework/common/biz契约接口(PermissionCommonApi、OAuth2TokenCommonApi、TenantCommonApi等),避免 starter 反向依赖业务模块。
2. 运行时装配
apps/pmforge-server/pom.xml 目前装配 17 个业务模块(system、infra、member、report、bpm、pay、mp、product、promotion、trade、statistics、crm、erp、iot-biz、mes、wms、im),单端口 48080。
3. 请求链路
- CORS / Trace / 请求体缓存 / 加密 / 租户上下文 / 访问日志 / XSS / Spring Security(
WebFilterOrderEnum固定顺序)。 TokenAuthenticationFilter解析Authorization: Bearer,写入SecurityContext(LoginUser、TenantContextHolder)。- Controller
@PreAuthorize("@ss.hasPermission('module:entity:action')")→SecurityFrameworkServiceImpl→PermissionCommonApi。 - Service(
@Transactional)→ MyBatis-Plus Mapper;拦截器顺序:租户(index 0)→ 数据权限(index 0,与租户同级,依赖自动配置加载顺序)→ 分页。 - 响应统一
CommonResult{code,msg,data};分页{list,total};异常由GlobalExceptionHandler转错误码。
4. 多租户与数据权限
tenant_id由TenantLineInnerInterceptor自动注入,TenantBaseDO承载字段,@TenantIgnore放行。- 数据权限通过
@DataPermission+DeptDataPermissionRule生成 SQL 片段,跨部门可见范围来自PermissionCommonApi。 - 已知问题:租户与数据权限两个拦截器都插到 index 0,顺序依赖自动配置名称排序(
data-permission先于tenant),见docs/reference/项目质量自检与缺陷清单.md第 10 节。
5. 前端架构
web/pmforge-ui-web:Vue 3.5 + Vite 6 + TypeScript + Tailwind 3.4(CSS 变量色板,shadcn 风格自绘组件)+ Pinia + vue-router(hash 模式)。- 页面:
/门户(15 个模块卡)→/login(admin/admin123)→/app控制台(system 8 页 + infra 4 页 + 预留模块预览页)。 - 构建产物直接写入
apps/pmforge-server/src/main/resources/static,因此生产只有一个端口、一份 jar。
6. 关键约束
- Java 8 + Spring Boot 2.7:所有新增依赖必须兼容
javax.*。 - 数据库兼容 8 套脚本,新增表结构必须同步全部脚本(见
deploy/scripts中的校验思路)。 - 原 AI 模块已整体移除(
modules/ai、PRD、菜单、配置、前端入口),后续要做 AI 能力需独立服务或升级到 Spring Boot 3。