跳到主要内容

新项目最小接入

本页说明如何从零接入 Geelato Framework，在不引入平台重扩展的前提下跑通一个最小 Spring Boot Web 应用。

推荐接入顺序​

  1. 引入 geelato-framework-bom
  2. 引入 geelato-framework-starter
  3. 参考 geelato-sample-quickstart 搭建最小工程
  4. 跑通主库、JdbcTemplate、Dao、ORM 和一个示例接口
  5. 业务需要基础后台能力时，再切到 geelato-app-scaffold
  6. 再按需叠加 runtime、designer 或业务扩展模块

最小依赖原则​

最小接入阶段建议只保留：

  • geelato-framework-bom
  • geelato-framework-starter
  • 一个主数据源驱动
  • Spring Boot Web 启动工程

不建议在最小接入阶段直接引入：

  • 平台化上传实现
  • 设计时建模治理能力
  • message、market、schedule 等扩展模块
  • 需要额外中间件的重量级平台能力

最小配置面​

当前 starter 自动装配的前提是存在 spring.datasource.primary.jdbc-url，并会默认创建：

  • primaryDataSource
  • primaryJdbcTemplate
  • primaryDao
  • dbGenerateDao

如存在 spring.datasource.secondary.jdbc-url，还会额外创建 secondary 相关 Bean。

推荐起点​

当前官方最小样例是 geelato-sample-quickstart，它使用：

  • geelato-framework-starter
  • H2 内存数据库
  • 默认关闭 JTA / Seata 代理（ORM 自动绑定 dynamicDao，无需额外配置）

这条链路的目的不是展示平台全能力，而是验证框架底座可以被独立消费。

何时切换到脚手架​

当项目明确需要登录、MQL、组织与用户、字典、上传等基础后台能力时，不建议继续在最小 sample 上扩展，而应直接采用 geelato-app-scaffold。其定位是可直接开工的官方脚手架，而非最小样例。

若目标不是运行官方示例，而是新建业务工程并长期依赖 starter，请继续阅读 基于 app-scaffold-starter 创建业务项目。

最小成功标准​

最短成功路径应至少满足：

  • 应用可以正常启动
  • 主数据源可用
  • JdbcTemplate 和 Dao 可注入
  • ORM 自动装配可用
  • 能调用一个运行时接口

下一步​