01-总纲：16个模块的低代码平台长什么样

01-总纲：16个模块的低代码平台长什么样

browise 是一个跑了14年、经过3个生产级政务项目（海南新农保、海南异地就医、海口海关内控）验证的低代码平台，最终形态是 Spring Boot 2.7 + Vue3 + 16个Maven模块。这篇文章是整个系列的地图——每个模块是什么、依赖关系怎么排、一个请求怎么穿过它们。

一、项目背景：三代演化

browise 不是从零设计出来的。它有一条清晰的演化链：

第一代（2010前后）  PowerBuilder C/S 应用
     │ DataWindow 数据窗口思想在这里形成
     ▼
第二代 wiserise     Java + 自研 route.java 前端控制器 + Activiti 5.13
     │ 615个Java文件，海口海关内控系统生产运行
     │ commonSql.java 2135行的元数据SQL引擎
     ▼
第三代 browise      Spring Boot 2.7 + Vue3 + 16模块
       667个单测100%通过，Playwright E2E 79/79

第三代的重写不是推倒重来——PROJECT.md 里有一张完整的 wiserise→browise 迁移映射表：commonSql.java 拆成了 EaEngine + SqlBuilder，DataWindow.js 变成了 MetaGrid.vue，Row.java 的 _t/_o 语义在前端 useRowSet.ts 里原样复刻。

二、16个模块的职责

打开根目录 pom.xml，modules 段落定义了全部16个模块。按依赖层次从底到顶：

基础层（无内部依赖）

核心层

业务层

装配与启动层

加前端 browise-vue/（core 9文件 + components 76文件 + demo 53页）。

三、模块依赖的关键设计：data不依赖crypto

BROWISE-GUIDE.md 里明确记录了一条依赖原则：browise-data 不依赖 browise-crypto。

为什么？data模块的 BaseEntity 是业务实体的基类，它的 save() 需要在写库前做字段加密。如果 data 直接依赖 crypto，那么所有用 BaseEntity 的项目都被迫引入国密依赖——即使它根本不需要加密。

解法是 EntityLifecycleListener 接口（987B）：

browise-data 定义接口:
  interface EntityLifecycleListener {
      beforeSave(entity)
      afterQuery(entity)
  }

browise-spring-boot-starter 桥接:
  CryptoEntityLifecycleListener implements EntityLifecycleListener {
      // 内部调 CryptoHelper 的签名+加密
  }

starter 负责把 crypto 的能力"注入"到 data 的生命周期里——两个模块互相看不见，靠一个接口契约协作。这是依赖倒置在模块划分上的应用。

四、一个请求穿过哪些模块

浏览器
  │ POST /ea/page/SYS_USER_s
  ▼
JwtAuthFilter (platform模块)
  │ 验token → 黑名单 → CurrentUser.set → 菜单鉴权
  ▼
EaController (formbuilder模块)
  │ /ea/page/{sqlId} 接收请求
  ▼
EaEngine (metadata模块)
  │ ①EaMetadataCache查EA01-05元数据
  │ ②SqlBuilder按方言拼SQL
  │ ③EaConnectionProvider拿连接执行
  │ ④postProcess: 字段解密+脱敏
  │ ⑤SlowSqlMonitor计时
  ▼
Oracle (ojdbc8)
  │
  ▼
Result { code, msg, data } (common模块)
  │
  ▼
前端 useRowSet (browise-vue)
  │ rows灌入primary缓冲，_t全为0
  ▼
MetaGrid渲染

一次分页查询穿过 4 个后端模块 + 2 个前端核心文件。后续每一篇都在拆解这条链上的某一段。

五、规模盘点

667个单测100%通过，含15个Oracle集成测试（真实连库验证EA01≥74条元数据、审计三表写入）。

六、系列规划

这个系列59篇，按数据流顺序拆：

每篇绑定真实源码路径，代码占比不低于40%。

✅ 亮点：以模块依赖图+请求全链路两张地图组织16个模块的介绍，点出"data不依赖crypto靠starter桥接"这条最关键的架构决策。适合想了解多模块低代码平台怎么分层的技术负责人。扩展方向：第02篇拆DataWindow设计哲学、第04篇展开请求全链路每一跳。