IDDD_Samples 开源项目指南

项目概述

VaughnVernon's IDDD_Samples 是一个基于 Vaughn Vernon 所著《实现领域驱动设计》一书的示例代码库。这些样本展示了不同的界限上下文（Bounded Context），旨在作为学习领域驱动设计 (DDD) 的参考。请注意，项目可能随时间演化，部分测试不完整，代码质量并非生产级，重在教学。

1. 项目目录结构及介绍

IDDD_Samples/
├── iddd_agilepm/                 # 敏捷项目管理的上下文
│   ├── src/main/java/...
│   └── src/test/java/...
├── iddd_collaboration/           # 基于事件溯源与CQRS的协作上下文
│   ├── src/main/java/...
│   └── src/test/java/...
├── iddd_common/                  # 共享可复用组件
│   ├── src/main/java/...
│   └── src/test/java/...
├── iddd_identityaccess/          # 使用ORM（Hibernate）的身份访问上下文
│   ├── src/main/java/...
│   └── src/test/java/...
├── build.gradle                 # Gradle构建脚本
├── gradlew                      # Gradle wrapper脚本（Unix/Linux）
├── gradlew.bat                  # Gradle wrapper脚本（Windows）
├── gradle.properties             # Gradle属性配置
├── README.md                    # 项目读我文件
├── gitignore                     # Git忽略文件配置
└── settings.gradle              # Gradle设置文件

每个子目录代表一个界限上下文，包含相应的源码和测试代码，src/main/java 和 src/test/java 分别存放业务逻辑和测试逻辑。

2. 项目的启动文件介绍

此项目为Java应用，没有传统意义上的单一启动文件。启动特定模块通常依赖于Spring Boot或者自定义main方法。然而，由于此示例项目并不集中管理启动点（尤其是不涉及Spring Boot的应用部分），启动服务需要通过Gradle任务执行，比如：

• 运行所有测试：在根目录下运行 ./gradlew test
• 编译并构建项目：运行 ./gradlew build

对于直接运行应用的需求，需要具体到各个模块内部寻找其入口类，这在实际操作中较少见，更多是通过集成环境或命令行指定任务来启动特定服务。

3. 项目的配置文件介绍

• 全局配置：配置主要分散在各个模块下的资源文件夹内，例如数据库连接字符串、Hibernate配置等可能会位于模块的src/main/resources下。
• MySQL配置: 项目依赖MySQL，但配置不在主项目中直接定义。使用时，依据startContainers.sh脚本启动Docker容器内的MySQL实例，具体的数据库配置通常在测试环境中或通过环境变量传递。
• RabbitMQ配置: 类似地，RabbitMQ连接信息同样不直接在代码配置文件中声明，而是在需要的地方动态配置或通过环境管理。

特别注意的是，对于外部服务如MySQL和RabbitMQ的配置，startContainers.sh脚本提供了便捷方式来启动必要的服务容器，并可以自动导入SQL脚本进行初始化，但这不是项目内的直接配置文件。

项目构建和配置更强调通过现代CI/CD工具和环境变量来管理，而非传统意义上的单个配置文件。使用时需依据Gradle的任务和各上下文内部的文档说明来操作。