# HzyAdmin

**Repository Path**: hzy6/HzyAdmin

## Basic Information

- **Project Name**: HzyAdmin
- **Description**: 通用管理平台！基于【.Net9、HZY.Framework】兼容【模块化、Winforms、Wpf】基础功能：【AOP、数据权限、按钮权限、动态菜单、动态任务调度、动态WebApi、定时标记 [Scheduled("0/5 * * * * ?")] 、代码生成】
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: http://47.98.179.56/docs
- **GVP Project**: No

## Statistics

- **Stars**: 1325
- **Forks**: 457
- **Created**: 2018-03-12
- **Last Updated**: 2026-03-26

## Categories & Tags

**Categories**: backend

**Tags**: Vite3, Winforms, vue3, NET9, EFCORE9

## README

# 有问题请提 Issues ：[https://gitee.com/hzy6/HzyAdmin/issues/new](https://gitee.com/hzy6/HzyAdmin/issues/new)

> ⚠️ .slnx 文件无法打开？请使用 Rider 或 Visual Studio（需开启 .slnx 预览功能）

![输入图片说明](gitee/images/image_cover.png)

# HzyAdmin 通用管理平台

基于 .NET 10 + Vue 3 的前后端分离权限管理后台，采用模块化架构设计，支持快速开发企业级应用。

## 技术栈

### 后端技术

| 技术 | 说明 |
| --- | --- |
| .NET 10 | 基础框架 |
| Entity Framework Core 10 | ORM 框架 |
| HZY.Framework | 核心框架（DI、动态API、仓储等） |
| Rougamo.Fody | AOP 编程 |
| Redis/FreeRedis | 分布式缓存 |
| Quartz.NET | 定时任务调度 |
| Mapster | 对象映射 |
| MiniExcel | Excel 处理 |
| Swagger/Knife4j | API 文档界面 |

### 前端技术

| 技术 | 说明 |
| --- | --- |
| Vue 3.5+ | 渐进式 JavaScript 框架 |
| Ant Design Vue 4.x | UI 组件库 |
| Vite 7.x | 构建工具 |
| Pinia 3.x | 状态管理 |
| TypeScript 5.x | 类型支持 |
| Vue Router 4.x | 路由管理 |
| VxeTable 4.x | 高级表格组件 |
| ECharts 6.x / @antv/g2 | 图表可视化 |
| WangEditor 5.x | 富文本编辑器 |
| vue-i18n 11.x | 国际化支持 |

## 项目结构

```
HzyAdmin/
├── hzy-backend/                          # 后端项目
│   ├── src/                              # 源代码
│   │   ├── HZY.Host.Admin/               # Web API 主机项目
│   │   ├── HZY.Repository.Admin/         # 数据仓储层
│   │   ├── HZY.Shared.Admin/             # 共享模块（DTO、枚举等）
│   │   ├── HZY.Shared/                   # 基础共享模块
│   │   ├── HZY.Core/                     # 核心模块
│   │   ├── HZY.Core.EntityFramework/     # EF Core 扩展
│   │   ├── HZY.Core.Identity/            # 身份认证模块
│   │   ├── HZY.Core.Redis/               # Redis 缓存模块
│   │   ├── HZY.Core.FreeRedis/           # FreeRedis 模块
│   │   ├── HZY.Core.Quartz/              # 定时任务模块
│   │   ├── HZY.Core.MessageQueueCap/     # 消息队列模块
│   │   ├── HZY.Core.UploadFile/          # 文件上传模块
│   │   ├── HZY.Core.Logs/                # 日志模块
│   │   ├── HZY.Core.Swagger/             # Swagger 文档
│   │   ├── HZY.Core.QrCode/              # 二维码模块
│   │   └── HZY.Core.Razor/               # Razor 视图模块
│   ├── tests/                            # 测试项目
│   ├── projects/                         # 项目配置
│   └── admin-generate-ef-seed-data/      # 种子数据生成工具
│   └── hzy-frontend-admin/               # 前端项目
├── doc/                                  # 文档和数据库脚本
└── gitee/                                # 图片资源
```

## 功能模块

### 系统管理

| 模块 | 说明 |
| --- | --- |
| 用户管理 | 用户增删改查、分配角色、重置密码 |
| 角色管理 | 角色配置、菜单权限、功能权限分配 |
| 菜单管理 | 菜单配置、按钮权限、图标管理 |
| 组织机构 | 部门树形结构管理 |
| 岗位管理 | 岗位信息管理 |
| 字典管理 | 系统字典数据维护 |
| API 管理 | 系统 API 接口管理 |
| 文件管理 | 系统文件上传管理 |
| 操作日志 | 用户操作日志记录与查询 |
| 数据权限 | 数据行级权限控制 |
| 多语言 | 国际化语言配置 |
| 服务器监控 | 服务器状态监控 |
| 个人中心 | 个人信息修改、密码修改 |

### 开发工具

| 模块 | 说明 |
| --- | --- |
| 定时任务 | Quartz 任务调度管理 |
| EF Core 监控 | EF Core 运行状态监控 |

## 快速开始

### 环境要求

- .NET 10.0 SDK
- Node.js 18+
- Redis
- Rider 或 Visual Studio 2022
- VS Code（前端开发）

### 后端启动

```bash
cd hzy-backend

# 还原依赖
dotnet restore

# 运行项目
dotnet run --project src/HZY.Host.Admin
```

### 前端启动

```bash
cd hzy-backend/hzy-frontend-admin

# 安装依赖
npm install
# 或
yarn install

# 启动开发服务器
npm run dev
# 或
yarn dev

# 构建生产版本
npm run build
```

### 数据库配置

数据库脚本位于 `doc/` 目录：

- `hzy_admin_2026_pgsql.sql` - PostgreSQL 脚本

其他数据库（MySQL、SQL Server）请使用 EF Core 迁移：

```bash
cd hzy-backend/src/HZY.Host.Admin

# 添加迁移
dotnet ef migrations add InitialCreate

# 更新数据库
dotnet ef database update
```

### Docker 部署

项目提供完整的 Docker Compose 配置，一键部署所有服务。

**服务组件：**
- `hzy-admin` - API 服务 (端口 5500)
- `postgres` - PostgreSQL 16 数据库 (端口 5432)
- `redis` - Redis 7 缓存 (端口 6379)

**启动服务：**

```bash
cd src/HZY.Host.Admin

# 启动所有服务
docker-compose up -d

# 查看日志
docker-compose logs -f hzy-admin

# 停止服务
docker-compose down
```

**仅启动数据库和缓存（本地开发调试）：**

```bash
docker-compose up -d postgres redis
```

**初始化数据库：**

```bash
# 方式一：使用项目提供的 SQL 脚本
docker exec -i hzy-postgres psql -U root -d hzy_admin_2026 < ../../doc/hzy_admin_2026_pgsql.sql

# 方式二：进入容器执行
docker exec -it hzy-postgres psql -U root -d hzy_admin_2026 -f /docker-entrypoint-initdb.d/init.sql
```

**配置说明：**

可通过环境变量覆盖配置：
- `AdminRepositoryOptions__ConnectionString` - 数据库连接字符串
- `AdminRepositoryOptions__DefaultDatabaseType` - 数据库类型
- `ConnectionStrings__Redis` - Redis 连接字符串

## 相关链接

- 📖 **文档/演示地址**：http://47.98.179.56/docs
- 🎬 **Bilibili 视频介绍**：https://www.bilibili.com/video/BV1tt4y157qH
- 🔗 **MVC 版本**：https://gitee.com/hzy6/hzy-admin-mvc
- ⏰ **WebApi 任务调度平台**：https://gitee.com/hzy6/hzy-quartz
- 📦 **NuGet 包**：https://www.nuget.org/packages?q=hzy

## 截图展示

### 模块化工程结构
![输入图片说明](gitee/images/project_map.jpg)

### 功能列表
![输入图片说明](gitee/images/menu_map_2023-2-3.jpg)

### 微服务案例模块化工程结构
![输入图片说明](gitee/images/project_1.jpg)

### 属性注入
![输入图片说明](gitee/images/attr_inj.png)

### ✨ 界面截图

![输入图片说明](gitee/images/winform.png)

| ![输入图片说明](gitee/images/theme_dark.png) | ![输入图片说明](gitee/images/theme_dark_1.png) |
|---|---|

| ![输入图片说明](gitee/images/DataAuthority.png) | ![输入图片说明](gitee/images/function.png) |
|---|---|

| ![输入图片说明](gitee/images/MenuInfo.png) | ![输入图片说明](gitee/images/menu_function.png) |
|---|---|

| ![输入图片说明](gitee/images/home.png) | ![输入图片说明](gitee/images/icons.png) |
|---|---|

| ![输入图片说明](gitee/images/chart.png) | ![输入图片说明](gitee/images/%E6%9B%B4%E5%A4%9A%E5%9B%BE%E8%A1%A8.png) |
|---|---|

| ![输入图片说明](gitee/images/user_list.png) | ![输入图片说明](gitee/images/wangeditor.png) |
|---|---|

| ![输入图片说明](gitee/images/code_gen.png) | ![输入图片说明](gitee/images/user_center.png) |
|---|---|

| ![输入图片说明](gitee/images/login.png) | ![输入图片说明](gitee/images/Efcore%20%E7%9B%91%E6%8E%A7.png) |
|---|---|

![输入图片说明](gitee/images/home1.png)

## 贡献指南

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

## 开源协议

本项目基于 [MIT](LICENSE) 协议开源。