soda-core 17.0.1 · Apache Maven Central

soda—— Spring Boot DDD 框架,一套项目结构,每个文件一个家

简单 · 面向对象 · 领域驱动 · 架构

企业级 DDD 与 CQRS,为 Spring Boot 而生
刻意做简单

干净的 DDD 四层架构、CQRS 与事件驱动设计——都在一个 Spring Boot starter 里。在线生成脚手架项目,直接开干。

17.0.1 · 一套 jar Java 17+ Spring Boot 3.2 – 4.1 MIT 协议
名字里有什么

四个字母,一套架构

SODA 不是又一个框架,而是一套 Spring Boot 的 DDD 项目结构——软件在生长中依然可读。

S

Simple · 简单易用

低仪式感、低学习门槛。DDD 需要的构件都在,多余的都没有。

O

Object-Oriented · 面向对象

封装与清晰的归属权,模型就是面向对象建出来的。

D

Domain-Driven · 领域驱动

领域优先:聚合根、实体、领域事件、统一语言。

A

Architecture · 分层架构

四层边界严格——每个文件都有唯一的家。

内置 CQRS

命令与查询说不同的语言——这是刻意的。写规则留在领域里,读性能保持飞快。

AI 时代

好架构,是 AI 的护栏

边界清楚,才敢放手让 AI 写

🧱

每层只做一件事

依赖方向固定,改动只有一个家。AI 加的代码只能落在该落的层里,想跑偏也跑不了。

📘

项目自带 AI 说明书

生成的项目内置 CLAUDE.md:分层职责、命名约定、加接口的完整清单。AI 一读就懂,不用你反复交代。

🎯

一句话,一整套

说“加个订单查询接口”,AI 按约定产出 Query、Handler、Repository、Assembler——文件齐、命名对、位置准。

~/my-soda-project/CLAUDE.md
## 场景 A · 新增纯读接口

Step 1 领域模型 + 仓储
  1  XxxDetail.java            domain/{领域}/
  2  XxxData.java              domain/{领域}/
  3  ListXxxQuery.java         application/cqrs/command/query/
  4  XxxReadRepository.java    infrastructure/repository/{领域}/

Step 2 API 层
  5  XxxVO.java                application/{领域}/model/vo/
  6  XxxAssembler.java         infrastructure/assembler/
  7  ListXxxQueryHandler.java  application/cqrs/handler/query/
  8  XxxAppService + Impl      application/{领域}/service/

你只管说清楚要什么。

为什么选 soda

该简单的地方,毫不花哨

⚡

极简易用

DDD 与 CQRS 去掉学术包袱,新人几天内就能上手产出。

🚀

性能友好

读模型为查询提速,写模型守好业务规则——CQRS 读写分离,各司其职。

💾

存储高效

克制的持久化模式,不强制事件溯源的存储税。

🔍

调试简单

数据路径清晰、每类一地。出问题时,你永远知道去哪找。

常见问题

常见问题,认真回答

为什么说“好架构是 AI 的护栏”?
靠边界来守:每个文件只有一个家,依赖方向固定;生成的项目还内置 CLAUDE.md——分层职责、命名约定、加接口的完整清单。AI 读一次就懂,写出的代码自然落在该落的层里,想跑偏也跑不了。
DDD四层架构是哪四层?怎么分层?
四层、每类一地:domain(聚合根、实体、领域事件)、application(命令、查询、Handler)、infrastructure(持久化、消息)、api。依赖由外向内,领域层永不依赖基础设施层。SODA 生成的就是这个结构。
CQRS是什么?和DDD有什么关系?
CQRS 是命令查询职责分离:写模型守住业务规则,读模型为查询提速,两边各司其职。它和 DDD 是天然搭档——DDD 管好业务复杂度,CQRS 管好读写路径。SODA 把两者内置在一个 starter 里。
Spring Boot怎么做DDD落地?有没有现成脚手架?
有。SODA 提供一个 Spring Boot starter 加一个在线生成器:浏览器里生成 DDD 脚手架项目,四层结构、CQRS、领域事件开箱即用,代码永远归你。
DDD框架怎么选?SODA有什么不同?
看三点:仪式感低不低、边界清不清、AI 友不友好。SODA 的取舍是“该有的构件都在,多余的一概没有”——DDD/CQRS 去掉学术包袱,一套 jar 同时支持 Spring Boot 3.2 ~ 4.1,MIT 协议,项目自带 AI 说明书。
DDD架构和MVC架构有什么区别?
MVC 按技术职责分层(模型/视图/控制器),适合简单 CRUD;DDD 按业务领域分层(领域、应用、基础设施、接口),业务复杂时让领域模型成为核心。SODA 是后者,并把它简化到几天就能上手。

你的下一个 Spring Boot 项目,
从第一天就结构正确

在浏览器里生成它,代码永远归你。