Skip to content

架构说明 ​

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. 请求链路 ​

  1. CORS / Trace / 请求体缓存 / 加密 / 租户上下文 / 访问日志 / XSS / Spring Security(WebFilterOrderEnum 固定顺序)。
  2. TokenAuthenticationFilter 解析 Authorization: Bearer,写入 SecurityContext(LoginUser、TenantContextHolder)。
  3. Controller @PreAuthorize("@ss.hasPermission('module:entity:action')") → SecurityFrameworkServiceImpl → PermissionCommonApi。
  4. Service(@Transactional)→ MyBatis-Plus Mapper;拦截器顺序:租户(index 0)→ 数据权限(index 0,与租户同级,依赖自动配置加载顺序)→ 分页。
  5. 响应统一 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。