# DDD

**Repository Path**: black-meat/ddd

## Basic Information

- **Project Name**: DDD
- **Description**: DDD架构测试项目
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-16
- **Last Updated**: 2025-12-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DDD 项目说明

这是一个基于领域驱动设计（DDD）的 Spring Boot 项目，适用于构建模块化、可维护的 Java 应用程序。项目结构清晰，包含基础设施层、资源层和常用工具类，适合用于后端服务开发。

## 项目结构

- `Application.java`: Spring Boot 启动类。
- `infrastructure` 包含以下通用组件：
  - `AutoFillConfig`: 自动填充配置，用于插入和更新时自动填充字段。
  - `JacksonObjectMapper`: 自定义 Jackson 序列化配置。
  - `PageResult`: 分页结果封装类。
  - `Result`: 统一的 API 返回结果封装类。
  - `CommonException` 和 `GlobalException`: 全局异常处理机制。
  - `LogInterceptor` 和 `WebConfigurerAdapter`: 请求日志拦截器及 MVC 配置。
- `resource` 包含资源类，如 `AccountResource`, `CategoryResource`, `DishResource`, `PaymentResource`，用于处理业务逻辑和对外接口。

## 快速开始

### 环境要求

- JDK 1.8 或以上版本
- Maven 3.x
- Spring Boot 2.x

### 安装步骤

1. 克隆项目到本地：

   ```bash
   git clone https://gitee.com/black-meat/ddd.git
   ```

2. 进入项目目录并构建：

   ```bash
   cd ddd
   mvn clean install
   ```

3. 运行项目：

   ```bash
   mvn spring-boot:run
   ```

## 使用说明

- 项目启动后，可以通过访问 `/account`, `/category`, `/dish`, `/payment` 等资源路径进行操作。
- 所有 API 返回结果都封装在 `Result` 类中，统一返回格式。
- 分页查询结果使用 `PageResult` 封装，包含总数和记录列表。
- 异常处理通过 `GlobalException` 捕获并返回友好的错误信息。

## 贡献指南

欢迎贡献代码，请遵循以下步骤：

1. Fork 项目
2. 创建新分支 (`git checkout -b feature/new-feature`)
3. 提交更改 (`git commit -am 'Add some feature'`)
4. 推送分支 (`git push origin feature/new-feature`)
5. 创建 Pull Request

## 许可证

本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。