HzyAdmin 通用管理平台使用教程

1. 项目介绍

HzyAdmin 是一个基于前后端分离架构的通用管理平台。它采用了现代化的技术栈，包括后端的 .Net8 和 EFCore8，以及前端使用 Vue3.x、Antd Of Vue 4.x、Vite、Pinia 2.0.x 和 TypeScript。项目旨在为开发者提供一个具备数据权限、按钮权限、动态菜单、动态任务调度、动态WebApi 和定时任务等功能的权限管理系统基架。

2. 项目快速启动

环境准备

• 开发环境：Visual Studio 2022
• .Net 版本：.Net 8.0
• 代码编辑器：Visual Studio Code
• 数据库：MySQL、SQL Server 或 PostgreSQL
• 缓存：Redis

克隆项目

首先，你需要克隆项目到本地开发环境：

git clone https://github.com/hzy-6/hzy-admin.git

数据库初始化

根据你的数据库类型选择相应的脚本，在项目根目录的 doc 文件夹中执行数据库脚本以创建必要的数据库表。

启动服务

• 启动后端服务：

  在 Visual Studio 或 Visual Studio Code 中打开 admin-server 文件夹，运行项目。

• 启动前端服务：

  在命令行中进入 admin-client-blazor 文件夹，执行以下命令：

  npm install
  npm run dev
  

运行项目

确保后端和前端服务都在运行，然后在浏览器中访问前端服务提供的地址，通常是 http://localhost:8080。

3. 应用案例和最佳实践

HzyAdmin 提供了一个模块化工程结构，可以方便地扩展和定制。以下是一些应用案例和最佳实践：

• 数据权限控制：根据用户的角色和权限动态展示数据。
• 按钮权限控制：根据用户的权限动态启用或禁用按钮。
• 动态菜单生成：根据用户的权限动态生成导航菜单。
• 动态任务调度：使用内置的定时任务功能，如使用 Quartz.NET 实现定时任务。

4. 典型生态项目

• MVC 版本：hzy-admin-mvc
• WebApi 任务调度平台：hzy-quartz

以上是 HzyAdmin 通用管理平台的基本使用教程，希望对您有所帮助。