当你无意间推开这一扇门，将会感叹原来生活可以如此的美好。
springboot-framework 是基于 Spring Boot 的领域驱动设计（DDD）与事件风暴落地框架，提供统一响应封装、动态分页查询、领域事件、数据权限、脚本引擎、认证授权等开箱即用能力。
本框架以领域驱动设计为核心方法论。我们沉淀了一篇关于 DDD 的实践思考，欢迎交流：
DDD 让业务决定模型，让模型组织软件，让数据与技术服务于业务。
核心观点：
- DDD 不是技术框架、不是四层架构、也不是一套规范，而是一种以业务为出发点、以领域模型为核心组织软件设计的方法论；
- 通过业务、数据、技术解耦，让业务复杂度可控、软件质量可测、业务能力可复用；
- DDD 不是复杂系统的专属方案，项目大小决定的是落地深度，而不是是否需要业务建模与职责分离；
- 在 Vibe Coding 时代，代码可以快速生成，但经过验证、可以复用并能够持续演进的业务模型，才是软件真正能够长期积累的核心资产。
项目当前维护两条版本线：
| 版本线 | 最低 JDK 要求 | Spring Boot 版本 | 开发版本号 |
|---|---|---|---|
| 17.3.x | JDK 17 | Spring Boot 3.x | 17.3.0-SNAPSHOT |
| 8.2.x | JDK 8 | Spring Boot 2.x | 8.2.0-SNAPSHOT |
版本号含义：第一位为最低 JDK 版本，第二位为 Spring Boot 大版本，第三位为补丁版本。项目采用 Maven ${revision} CI-Friendly 版本机制，正式发布时通过 -Drevision=x.y.z 指定版本号，无需修改 pom。
Version lines: 17.3.x requires JDK 17+ and Spring Boot 3.x; 8.2.x requires JDK 8+ and Spring Boot 2.x.
| 模块 | 说明 |
|---|---|
springboot-starter |
DDD 核心：统一响应封装、动态分页查询、领域事件系统、国际化异常、事务管理 |
springboot-starter-script |
Groovy 脚本引擎（运行时编译、缓存、热更新、REST API） |
springboot-starter-data-fast |
JPA 增强，动态过滤查询与 HQL 构建 |
springboot-starter-data-authorization |
数据权限，SQL 拦截透明注入行级/列级权限条件 |
springboot-starter-security |
JWT 无状态认证 / Redis 有状态认证 |
仓库中的
example（DDD 示例后端）与frontend（前端示例 monorepo）均为示例工程，不属于框架核心内容，仅供学习参考。前端 UI 组件库由独立仓库 ui-compoments 维护，与本项目无关。
Maven 引入（以正式发布版本为例，最新版本见上方 Maven Central 徽章；开发快照请使用 17.3.0-SNAPSHOT）：
<!-- Spring Boot 领域驱动框架 -->
<dependency>
<groupId>com.codingapi.springboot</groupId>
<artifactId>springboot-starter</artifactId>
<version>17.3.0</version>
</dependency>
<!-- 脚本引擎框架 -->
<dependency>
<groupId>com.codingapi.springboot</groupId>
<artifactId>springboot-starter-script</artifactId>
<version>17.3.0</version>
</dependency>
<!-- 快速数据呈现框架 -->
<dependency>
<groupId>com.codingapi.springboot</groupId>
<artifactId>springboot-starter-data-fast</artifactId>
<version>17.3.0</version>
</dependency>
<!-- 数据权限框架 -->
<dependency>
<groupId>com.codingapi.springboot</groupId>
<artifactId>springboot-starter-data-authorization</artifactId>
<version>17.3.0</version>
</dependency>
<!-- security & jwt 权限框架 -->
<dependency>
<groupId>com.codingapi.springboot</groupId>
<artifactId>springboot-starter-security</artifactId>
<version>17.3.0</version>
</dependency>
示例工程的运行与使用见 示例工程手册。
工作流引擎（springboot-starter-flow）已从本框架移除，重构为独立仓库维护：codingapi/flow-engine。需要使用流程引擎的项目请改用独立仓库。
The workflow engine (springboot-starter-flow) has been moved to a standalone repository: codingapi/flow-engine.
详见 CONTRIBUTING。