# SmartEnt CloudHub
**Repository Path**: yangjuncom/smart-ent-cloud-hub
## Basic Information
- **Project Name**: SmartEnt CloudHub
- **Description**: **智企云枢** 是一套面向中大型企业级系统的轻量化 DDD 领域驱动设计架构解决方案。采用模块化垂直拆分、AI独立层、工作流独立解耦、基础设施统一适配的设计理念，满足私有化部署、多业务模块扩展、智能AI赋能、流程化审批等复合业务场景
- **Primary Language**: C#
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-29
- **Last Updated**: 2026-06-22
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 智企云枢 SmartEnt CloudHub
**企业级轻量化 DDD 分层架构 · 模块化垂直拆分 · AI赋能 · 工作流解耦**
[在线文档](#) | [快速开始](#快速开始) | [架构说明](#架构设计) | [贡献指南](#贡献指南)
---
## 📋 项目简介
**智企云枢** 是一套面向中大型企业级系统的轻量化 DDD 领域驱动设计架构解决方案。采用模块化垂直拆分、AI独立层、工作流独立解耦、基础设施统一适配的设计理念，满足私有化部署、多业务模块扩展、智能AI赋能、流程化审批等复合业务场景。
### ✨ 核心特性
- 🏗️ **轻量化 DDD 分层架构** - 标准七层类库拆分，职责单一、依赖受控、分层解耦
- 📦 **模块化垂直拆分** - 系统、OA、CRM、SRM、项目、工作流、AI完全隔离
- 🔌 **独立模块设计** - 工作流、AI 独立类库，可单独启用/禁用，扩展性极强
- 🔐 **企业级认证授权** - JWT Bearer Token 认证方案，支持角色权限管理
- 📋 **完整的系统管理** - 用户、角色、菜单、操作日志完整实现
- 🔄 **工作流引擎** - WorkflowCore 流程编排，支持会签、或签、条件节点
- 🚀 **高性能跨平台** - 基于 .NET 8，适配 Windows / Linux / Docker 部署
- 📊 **多数据库支持** - MySQL（默认）、SqlServer、PostgreSQL、Oracle
- 🔄 **Redis缓存集成** - StackExchange.Redis，支持分布式锁
- 📝 **操作日志记录** - AOP切面自动记录操作日志
---
## 🛠️ 技术栈
| 分类 | 技术 | 版本/说明 |
|:---:|:---|:---|
| **核心框架** | .NET | 8.0 |
| **ORM框架** | SqlSugar | 支持多数据库切换 |
| **身份授权** | JWT Bearer Token | 认证方案 |
| **工作流引擎** | WorkflowCore | 流程编排与审批 |
| **消息队列** | RabbitMQ | 异步消息处理 |
| **缓存/分布式锁** | Redis | StackExchange.Redis |
| **向量数据库** | PGVector | AI语义检索 |
| **AI能力基座** | SemanticKernel | 大模型集成 |
| **前端框架** | Vue3 + TypeScript | 响应式UI |
| **UI组件库** | Element Plus | 企业级组件库 |
| **前端构建** | Vite | 快速构建工具 |
| **状态管理** | Pinia | Vue3状态管理 |
| **路由** | Vue Router | 路由管理 |
| **HTTP客户端** | Axios | 网络请求 |
| **数据库** | MySQL | 8.0+（默认主库） |
| **API文档** | Swagger | Swashbuckle.AspNetCore |
| **日志** | NLog | 结构化日志 |
---
## 📁 项目结构
### 整体目录
```
SmartEnt CloudHub/
├── src/ # 后端源码解决方案
│ ├── SmartEntCloudHub.Api/ # 启动入口 / 接口层
│ ├── SmartEntCloudHub.Application/ # 应用服务层
│ ├── SmartEntCloudHub.Domain/ # 领域层
│ ├── SmartEntCloudHub.Core/ # 核心公共层【最底层】
│ ├── SmartEntCloudHub.Infrastructure/ # 基础设施层
│ ├── SmartEntCloudHub.Workflow/ # 独立工作流模块
│ └── SmartEntCloudHub.AI/ # 独立AI模块
├── src-web/ # Vue3 前端源码
│ ├── src/
│ │ ├── api/ # API接口封装
│ │ ├── components/ # 公共组件
│ │ ├── layouts/ # 页面布局
│ │ ├── router/ # 路由配置
│ │ ├── store/ # 状态管理
│ │ ├── utils/ # 工具函数
│ │ └── views/ # 页面视图
│ ├── public/
│ ├── package.json
│ ├── vite.config.ts
│ └── tsconfig.json
├── tests/ # 单元测试、集成测试
├── docs/ # 数据库脚本、设计文档、接口文档
├── deploy/ # Docker、部署配置、私有化部署脚本
├── .gitignore
├── README.md
└── SmartEntCloudHub.sln # 整体解决方案入口
```
### 后端分层架构
```
┌─────────────────────────────────────────────────────────┐
│ SmartEntCloudHub.Api (接口层) │
│ Controllers / Middlewares / Filters / Configurations │
└────────────────────────┬────────────────────────────────┘
│
┌───────────────┼───────────────┐
│ │ │
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌────────────────────┐
│ Core │ │ Application │ │ Infrastructure │
│ (底层) │ │ │ │ │
│ 公共能力 │ │ 业务编排 │ │ 数据持久化 │
│ 扩展方法 │ │ DTO定义 │ │ 中间件集成 │
│ 配置模型 │ │ 服务实现 │ │ Redis/RabbitMQ │
└──────────────┘ └──────┬───────┘ └───────────┬────────┘
│ │ │
└───────────────┼─────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ SmartEntCloudHub.Domain (领域层) │
│ Entities / Enums / DomainServices / Events / Interfaces│
└─────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────┐
│ SmartEntCloudHub.Workflow (工作流模块) │
│ Configs / Definitions / Nodes / Handlers / Services │
└─────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────┐
│ SmartEntCloudHub.AI (AI模块) │
│ Kernel / Prompts / Services / Vector / KnowledgeBase │
└─────────────────────────────────────────────────────────┘
```
### 各层级职责
| 层级 | 职责 | 依赖 |
|:---:|:---|:---:|
| **Core** | 全局底层基础通用能力：扩展方法、工具类、配置模型、异常类 | 无 |
| **Domain** | DDD核心：实体模型、枚举、领域规则、业务抽象 | Core |
| **Application** | 业务编排：DTO、服务实现、参数校验、事件处理 | Core, Domain |
| **Infrastructure** | 基础设施：数据持久化、Redis、RabbitMQ、文件存储 | Core, Domain |
| **Api** | 启动入口：控制器、中间件、过滤器、配置 | 全部层 |
| **Workflow** | 工作流：流程定义、节点、处理器、服务 | Core, Domain |
| **AI** | 人工智能：语义服务、向量检索、知识库 | Core, Domain |
---
## 🏗️ 架构设计
### 设计理念
```
轻量化 DDD 领域驱动设计
+ 模块化垂直拆分
+ AI独立层
+ 工作流独立解耦
+ 基础设施统一适配
```
### 核心优势
1. **标准 DDD 轻量化分层** - 结构清晰，符合企业级开发规范
2. **模块垂直拆分** - 各业务模块完全隔离，便于独立开发与部署
3. **独立模块设计** - 工作流、AI 可单独启用/禁用，按需加载
4. **中间件统一封装** - Redis/RabbitMQ/SqlSugar 统一适配，便于切换
5. **前后端分离** - 配套完整文档、部署脚本、测试项目
6. **私有化交付友好** - 支持多数据库、跨平台部署
---
## 🚀 快速开始
### 环境要求
| 环境 | 版本要求 |
|:---:|:---:|
| .NET SDK | 8.0+ |
| MySQL | 8.0+ |
| Redis | 6.0+ |
| Node.js | 18+ (前端) |
### 后端启动
```bash
# 1. 克隆项目
git clone https://gitee.com/yangjuncom/smart-ent-cloud-hub.git
# 2. 进入项目目录
cd smart-ent-cloud-hub
# 3. 还原依赖
dotnet restore
# 4. 配置数据库连接
# 编辑 src/SmartEntCloudHub.Api/appsettings.json
# 配置 MySQL 连接字符串、Redis 连接等
# 5. 初始化数据库
# 执行 docs/数据库脚本.sql
# 6. 运行项目
cd src/SmartEntCloudHub.Api
dotnet run
# 7. 访问 Swagger
# https://localhost:7105/swagger
```
### 前端启动
```bash
# 1. 进入前端目录
cd src-web
# 2. 安装依赖
npm install
# 3. 运行项目
npm run dev
# 4. 访问前端
# http://localhost:5173
```
### 测试账号
| 角色 | 用户名 | 密码 | 说明 |
|:---:|:---:|:---:|:---|
| 超级管理员 | admin | 123456 | 拥有所有权限 |
| 部门管理员 | techmanager | 123456 | 管理本部门及下属 |
| 普通用户 | frontenddev | 123456 | 前端开发工程师 |
---
## 📚 文档目录
| 文档 | 说明 |
|:---|:---|
| [架构说明文档](docs/PROJECT_STRUCTURE.md) | 完整的架构设计与目录结构说明 |
| [API接口文档](docs/API_DOCUMENTATION.md) | REST API 接口详细说明 |
| [数据库脚本](docs/数据库脚本.sql) | MySQL 建表与初始化数据脚本 |
---
## 📦 功能模块
### 已完成模块 ✅
- [x] 后台底层框架搭建
- [x] 用户登录/登出
- [x] JWT 认证授权
- [x] 用户管理（CRUD、分配角色）
- [x] 角色管理（CRUD、分配菜单）
- [x] 菜单管理（CRUD、树形结构）
- [x] 数据权限过滤
- [x] 操作日志记录（AOP切面）
- [x] 集成多种数据库（MySQL/SqlServer/PostgreSQL/Oracle）
- [x] 集成 SqlSugar ORM
- [x] Redis 缓存集成
- [x] Swagger API 文档
- [x] 全局异常处理
- [x] CORS 跨域配置
- [x] Vue3 前端项目搭建
- [x] 前端路由守卫（未登录跳转登录页）
### 规划模块 📋
- [ ] OA 办公协同模块
- [ ] CRM 客户管理模块
- [ ] SRM 供应链管理模块
- [ ] Project 项目管理模块
- [ ] Workflow 工作流模块
- [ ] AI 人工智能模块
- [ ] 单元测试与集成测试
---
## 🤝 贡献指南
我们欢迎所有形式的贡献！
### 如何贡献
1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request
### 代码规范
- 遵循 .NET 编码规范
- 类名、方法名使用 PascalCase
- 私有字段使用 camelCase 或 _camelCase
- 数据库表名、列名使用 snake_case
- 所有公共方法需添加 XML 注释
---
## 📄 开源协议
本项目基于 [MIT](LICENSE) 协议开源。
---
## 👥 作者信息
| 项目 | 信息 |
|:---|:---|
| **项目名称** | 智企云枢 SmartEnt CloudHub |
| **编制人** | Sun |
| **编制日期** | 2026年5月25日 |
| **文档版本** | V1.0 最终完整版 |
---
## 📞 联系方式
- **问题反馈**：(675703306@qq.com)
- **功能建议**：(675703306@qq.com)
---
**⭐ 如果这个项目对您有帮助，请给一个 Star ⭐**
Made with ❤️ by Sun