# spring-cloud-DDD-structure

**Repository Path**: Little-Orange-O/spring-cloud-ddd-structure

## Basic Information

- **Project Name**: spring-cloud-DDD-structure
- **Description**: DDD微服务落地示例项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-03
- **Last Updated**: 2026-04-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DDD设计微服务框架

## 一、项目背景

本系统采用 **领域驱动设计（DDD）** 的思想进行模块化开发，旨在实现业务逻辑与基础设施解耦、提升可维护性与扩展性。通过清晰的层级划分和组件隔离，支持未来多服务协同、异步消息处理等复杂场景。

## 二、总体架构图

``` mermaid
flowchart TB
    %% Common 模块（最左侧）
    COM["公共组件 Common<br/><hr/><font size=2>• 通用工具类<br/>• 共享常量<br/>• 异常定义<br/>• 公共组件<br/>common</font>"]

    %% 启动层
    subgraph BL["<br/>启动层<br/><br/>"]
        BS["启动模块 Bootstrap<br/><hr/><font size=2>• 应用配置加载<br/>• 依赖注入配置<br/>• 服务生命周期<br/>• 启动引导程序<br/>boot-starter</font>                                                            "]
    end

    %% 应用层
    subgraph AL["<br/>应用层<br/><br/>"]
        direction LR
        APP["应用服务 Application<br/><hr/><font size=2>• 业务流程编排<br/>• 事务管理<br/>• 权限控制<br/>• 业务规则协调<br/>application</font>"]
        SCH["调度服务 Scheduler<br/><hr/><font size=2>• 定时任务<br/>• 作业调度<br/>• 批处理任务<br/>• 定时数据同步<br/>scheduler</font>"]
        INB["入站适配器 Inbound<br/><hr/><font size=2>• 请求处理<br/>• 参数校验<br/>• 协议适配<br/>• 接口实现<br/>infrastructure/inbound</font>"]
        EL["事件监听器 Event Listener<br/><hr/><font size=2>• 消息订阅<br/>• 事件处理<br/>• 消息路由<br/>• 异步处理<br/>infrastructure/messaging/event-listener</font>"]
        
        subgraph IC["接口契约"]
            API["服务API Service API<br/><hr/><font size=2>• 接口定义<br/>• DTO对象<br/>• 接口文档<br/>• 版本控制<br/>service-api</font>"]
            ID["接口规范 Interface Definition<br/><hr/><font size=2>• 接口规范<br/>• 参数约束<br/>• 错误码定义<br/>• 接口协议<br/>interface-definition</font>"]
        end
    end

    %% 领域层
    subgraph DL["<br/>领域层<br/><br/>"]
        DOM["领域模型 Domain Model<br/><hr/><font size=2>• 聚合根定义<br/>• 实体对象<br/>• 值对象<br/>• 领域服务<br/>• 领域事件<br/>domain</font>                                                            "]
    end

    %% 基础设施层
    subgraph IL["<br/>基础设施层<br/><br/>"]
        direction LR
        REPO["数据仓储 Repository<br/><hr/><font size=2>• 数据持久化<br/>• 缓存管理<br/>• 数据查询<br/>• ORM映射<br/>infrastructure/repo</font>"]
        EP["事件发布器 Event Publisher<br/><hr/><font size=2>• 事件发布<br/>• 消息分发<br/>• 异步通知<br/>• 消息持久化<br/>infrastructure/messaging/event-publisher</font>"]
        OUT["出站适配器 Outbound<br/><hr/><font size=2>• 外部服务调用<br/>• 协议转换<br/>• 熔断降级<br/>• 负载均衡<br/>infrastructure/outbound</font>"]
    end

    %% 模块内部关系
    APP --- SCH --- INB --- EL
    REPO --- EP --- OUT

    %% 层次依赖关系
    BL ===> AL
    AL ===> DL
    DL ===> IL

    %% Common的依赖
    AL & DL & IL -.-> COM

    %% 接口契约依赖
    API --> ID
    INB --> ID

    %% 样式定义
    classDef common fill:#FFFFFF,stroke:#78909C,stroke-width:2px,color:#37474F
    classDef starter fill:#FFFFFF,stroke:#1E88E5,stroke-width:2px,color:#1565C0
    classDef application fill:#FFFFFF,stroke:#3949AB,stroke-width:2px,color:#283593
    classDef domain fill:#FFFFFF,stroke:#2E7D32,stroke-width:4px,color:#1B5E20,font-weight:bold
    classDef infra fill:#FFFFFF,stroke:#757575,stroke-width:2px,color:#424242
    classDef contract fill:#FFFFFF,stroke:#7B1FA2,stroke-width:2px,color:#4A148C
    
    %% 层容器样式 - 移除背景，调整标题样式
    classDef layer fill:none,stroke:#90A4AE,stroke-width:3px,color:#FFFFFF,font-weight:bold

    %% 应用样式
    class COM common
    class BS starter
    class APP,SCH,INB,EL application
    class DOM domain
    class REPO,EP,OUT infra
    class API,ID contract
    class BL,AL,DL,IL layer
    
    %% 连接线样式
    linkStyle default stroke:#B0BEC5,stroke-width:1px
    linkStyle 2,3,4,5 stroke:#546E7A,stroke-width:3px
    linkStyle 6,7 stroke:#90A4AE,stroke-dasharray: 5 5
```

## 三、模块划分与职责说明

### 1. 启动层（Bootstrap Layer）

#### 模块名称：

boot-starter

#### 核心职责

1. 应用初始化配置（如 Spring Boot 配置加载）
2. 依赖注入容器配置
3. 服务生命周期管理（启动/关闭钩子）
4. 由于domain不依赖容器，此处需要配置domain服务bean到容器中

#### 对外暴露

无接口，仅用于启动项目

### 2. 应用层（Application Layer）

#### Application模块

##### 1. 模块名称

application

##### 2. 核心职责

1. 接收页面请求：接收用户页面请求
2. 编排业务流程：组织协调领域服务和实体操作，完成特定业务场景。
3. 管理事务边界：确保一系列操作要么全部成功，要么全部回滚，维护数据的一致性和完整性。
4. 调用领域模型完成规则协调