# dorive

**Repository Path**: xboss-data-warehouse/dorive

## Basic Information

- **Project Name**: dorive
- **Description**: 🔥🔥🔥dorive是一个轻量化渐进式开发框架，帮助开发者，快速落地领域驱动项目。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2025-03-05
- **Last Updated**: 2025-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">Dorive</h1>
<h3 align="center">轻量级领域驱动框架</h3>
<p align="center">
  <img src="https://img.shields.io/github/license/chentaoah/dorive" alt="license">
  <img src="https://img.shields.io/github/v/release/chentaoah/dorive?display_name=tag&include_prereleases" alt="release">
  <img src="https://img.shields.io/github/commit-activity/y/chentaoah/dorive" alt="commit">
  <img src="https://img.shields.io/github/stars/chentaoah/dorive?color=%231890FF&style=flat-square" alt="stars">
</p>
<hr/>

###  📚简介

dorive是一个轻量的以领域驱动为核心的业务框架，它提供了诸多开箱即用的功能，旨在帮助开发者，在项目中快速、便捷地应用领域驱动。

这些功能涵盖了依赖注入校验、依赖即用配置、实体定义与映射、级联查询与操作、实体多态、实体事件通知、复杂推导查询、ref引用、复杂计数统计、表结构生成、数据库逆向生成、接口代码生成等，可以满足大部分开发场景。

###  🎁名称由来

dorive = domain + driven 或 do + driven ，是原公司项目沉淀后的开源库。“do”表明了一种态度，只有付诸行动，才能有所收获。

###  🍺设计理念

dorive是Mybatis-Plus的拓展，易于集成，开发者无需添加任何配置与代码。

dorive的优势：

- 极少的sql编写（与数据存储方式解耦）
- 一次建模，任意查询（代码的通用性强，开发成本低）
- 面向对象，动态拓展（可维护性、可拓展性强）
- 事件通知，代码解耦（耦合度低）
- 正向+逆向工程（开发速度快）

### 📊架构设计

<img src="https://gitee.com/digital-engine/dorive/raw/master/doc/img/framework.png" alt="avatar" style="zoom: 50%;" />

###  🛠️模块说明

| 模块                       | 说明             |
| -------------------------- | ---------------- |
| dorive-api                 | 领域驱动统一规范 |
| dorive-core                | 核心实现         |
| dorive-event               | 事件通知实现     |
| dorive-query               | 关联查询实现     |
| dorive-ref                 | 仓储引用实现     |
| dorive-env                 | 简易化配置       |
| dorive-sql                 | 动态查询语句实现 |
| dorive-mybatis-plus        | mybatis-plus适配 |
| dorive-inject              | 模块化依赖校验   |
| dorive-web                 | web开发适配      |
| dorive-spring-boot-starter | 启动器           |

### 🔗依赖说明

| 依赖库                    | 版本   | 说明                |
| ------------------------- | ------ | ------------------- |
| spring-boot-starter-web   | 2.7.18 | spring-boot web集成 |
| spring-tx                 | 5.3.31 | spring事务管理      |
| hutool-all                | 5.8.25 | 工具库              |
| mybatis-plus-boot-starter | 3.5.7  | 数据库操作          |

###  📦安装

因项目尚未上传至Maven中央仓库，请访问Gitee主页：[dorive](https://gitee.com/digital-engine/dorive/tree/master)，下载源码至本地后，使用Maven命令安装。

```shell
mvn install
```

然后就可以使用Maven引入了。

```xml
<dependency>
    <groupId>com.gitee.digital-engine</groupId>
    <artifactId>dorive-spring-boot-starter</artifactId>
    <version>3.5.0.6</version>
</dependency>
```

### 📝文档

wiki地址：

- [Gitee wiki](https://gitee.com/digital-engine/dorive/wikis/pages)

### 🐞bug反馈与建议

提交问题反馈请说明正在使用的JDK版本、dorive版本，以及依赖库版本。

- [Gitee issue](https://gitee.com/digital-engine/dorive/issues)

### 📘版本说明

| 版本 | 说明                                                         |
| ---- | ------------------------------------------------------------ |
| 1.x  | 试验领域驱动落地的可能性                                     |
| 2.x  | 完成基本功能开发，并在项目中应用                             |
| 3.x  | 重新设计内部架构，并优化大量代码。自3.4.3.4版本开始，项目进入维护阶段 |

### 🌿分支说明

| 分支   | 说明                                                         |
| ------ | ------------------------------------------------------------ |
| master | 主分支，release版本使用的分支，不接收任何pr或修改            |
| 3.x    | 版本分支，分支名即版本号，版本号高于master的，为正在开发的分支 |

### 🤝与我（们）一起

1. 请将个人联系方式，发送邮件至digital_engine@163.com
2. 等待维护者向你发出邀请

###  ⭐Star dorive

[![Stargazers over time](https://starchart.cc/chentaoah/dorive.svg?variant=adaptive)](https://starchart.cc/chentaoah/dorive)

### 🙏🏻特别感谢

- [hutool](https://gitee.com/dromara/hutool/tree/v5-master/)
- [mybatis-plus](https://gitee.com/baomidou/mybatis-plus/tree/master/)