Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lampo1024/DncZeus
DncZeus 是一个基于.NET 7 + Vue.js(iview-admin) 的前后端分离的通用后台权限(页面访问、操作按钮控制)管理系统框架。后端使用.NET 7 + EF Core构建，UI则是目前流行的基于Vue.js的iView(iview-admin)。项目实现了前后端的动态权限管理和控制以及基于JWT的用户令牌认证机制，让前后端的交互更流畅。码云镜像:https://gitee.com/rector/DncZeus 。演示地址(demo):
https://github.com/lampo1024/DncZeus
csharp dnczeus dotnet dotnet-6 dotnet-core entity-framework entity-framework-core iview iview-admin jwt jwt-authentication jwt-bearer-tokens net-6 net-core net-core-webapi netcore vue vue-ui
Last synced: about 1 month ago
JSON representation
DncZeus 是一个基于.NET 7 + Vue.js(iview-admin) 的前后端分离的通用后台权限(页面访问、操作按钮控制)管理系统框架。后端使用.NET 7 + EF Core构建，UI则是目前流行的基于Vue.js的iView(iview-admin)。项目实现了前后端的动态权限管理和控制以及基于JWT的用户令牌认证机制，让前后端的交互更流畅。码云镜像:https://gitee.com/rector/DncZeus 。演示地址(demo):
- Host: GitHub
- URL: https://github.com/lampo1024/DncZeus
- Owner: lampo1024
- License: mit
- Created: 2018-12-15T13:35:54.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-09-27T22:17:56.000Z (about 1 year ago)
- Last Synced: 2024-10-29T17:51:39.786Z (about 1 month ago)
- Topics: csharp, dnczeus, dotnet, dotnet-6, dotnet-core, entity-framework, entity-framework-core, iview, iview-admin, jwt, jwt-authentication, jwt-bearer-tokens, net-6, net-core, net-core-webapi, netcore, vue, vue-ui
- Language: C#
- Homepage: https://dnczeus.codedefault.com
- Size: 6.13 MB
- Stars: 1,501
- Watchers: 69
- Forks: 435
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-admin - DncZeus - admin) 的前后端分离的通用后台权限(页面访问、操作按钮控制)管理系统框架 (.Net)
README
# DncZeus
## 前言
### **关于 DncZeus**
**DncZeus = Dnc + Zeus**
"Dnc"--.Net Core 的缩写；
"Zeus"--中文译为**宙斯**，是古希腊神话中的众神之王，奥林匹斯十二主神之首，统治宇宙万物的至高无上的主神（在古希腊神话中主神专指宙斯），人们常用“众神和人类的父亲”、“神王”来称呼他，是希腊神话诸神中最伟大的神。
**DncZeus**的愿景就是做一个.NET Core领域小白也能上手的简易、通用的后台权限管理模板系统基础框架"。
## 项目简介
**DncZeus**是一个基于 .NET 7 + Vue.js 的前后端分离的通用后台管理系统框架。后端使用.NET 7 + Entity Framework Core 构建，UI 则是目前流行的基于 Vue.js 的 iView。项目实现了前后端的动态权限管理和控制以及基于 JWT 的用户令牌认证机制，让前后端的交互更流畅。
**注意：** DncZeus并不是一个完整的业务系统，但她提供完成业务系统的绝大多数开发场景，让每一位.NET 开发者都能基于**DncZeus**快速开发出交互、体验以及功能具佳的.NET 7 单页应用程序(SPA)。
## 支持DncZeus(求Star :))
如果你觉得DncZeus对你或者他人有用，请为DncZeus点个赞，求扩散，让更多人获得帮助！！！
## 文档(Document)
* [关于 DncZeus](https://codedefault.com/p/getting-started)
* [开发环境和工具](https://codedefault.com/p/environment-and-developement-tools)
* [下载项目&安装依赖](https://codedefault.com/p/download-and-restore-dnczeus)
* [DncZeus项目结构解析](https://codedefault.com/p/solution-structure-introduction)
* [新建你的页面](https://codedefault.com/p/create-page)
* [DncZeus框架用户动态权限数据流，鉴权、令牌、验证详解](https://codedefault.com/p/dnczeus-doc-support-dynamic-router-and-dynamic-menu-rendering)
* [DncZeus前后端分离项目打包/发布/部署及注意事项](https://codedefault.com/p/dnczeus-build-and-deploy)
## 在线体验(Demo)
超级管理员：administrator
管理员：admin
密码：111111
地址：[https://dnczeus.codedefault.com][7]
试试以不同用户名登录系统，可以体验不同角色的不同菜单权限。
**由于是个人项目，资金有限，体验服是低配，请大家爱惜，轻戳，不胜感激！！！**
*国内码云镜像地址：[https://gitee.com/rector/DncZeus][9]*
## 适合人群
由于 DncZeus 考虑到初级.NET 开发者都可以使用，所以后端项目未涉及过多架构和封装(代码逻辑一目了然)，但为了你更好地熟悉和运用 DncZeus，你需要了解：
- .NET 7
- Vue.js
- iView
ASP.NET Core 的知识能确保你可以看懂和了解后端是如何实现和工作的，而 Vue.js 框架则是前端实现的基石，当然 iView 这个基于 Vue.js 的 UI 框架也是必须要了解的，因为 DncZeus 正是基于 [iview-admin][1](iView 的一个后台管理系统示例项目)来实现的前端 UI 交互。
如果你对这两个方面的知识还不熟悉，建议你可以先学习一些理论再来运用 DncZeus 这个框架。关于 .NET 7 和 Vue.js 的入门请参考：
- [.NET 7 官方文档][2]
- [Vue.js 官方文档][3]
## 环境和工具
1. Node.js(同时安装 npm 前端包管理工具)
2. Visual Studio 2022
3. VS Code 或者其他前端开发工具
4. git 管理工具
5. MySQL,PostgreSQL或SQL Server(SQL Server 2012+)
## 技术实现
- .NET 7
- ASP.NET Core WebApi
- JWT 令牌认证
- AutoMapper
- Entity Framework Core 7
- .NET 7 依赖注入
- Swagger UI
- Vue.js(ES6 语法)
- iView(基于 Vue.js 的 UI 框架)
## 下载项目
### 使用Git工具下载
首先请确保你本地开发环境已安装了git管理工具，然后在需要存放本项目的目录打开git命令行工具**Git Bash Here**，在命令行中输入如下命令：
```
git clone https://github.com/lampo1024/DncZeus.git
```
以上命令就把DncZeus的远程代码拉取到你的本地开发机上。
### 手动下载
如果你不愿意使用git管理工具下载DncZeus的远程代码，你也可以在github托管地址手动下载，打开地址[https://github.com/lampo1024/DncZeus][4]，找到页面中的按钮"Clone or download"，如下图示：
![手动下载DncZeus][5]
在弹出的对话框中点击按钮"Download ZIP"即可开始下载DncZeus的源代码，如下图：
![手动下载DncZeus源代码][6]
## 安装依赖
### 前端项目
在将DncZeus的源代码下载到本地之后，如果你使用的git管理工具，**可以不用**退出当前的git管理工具，输入如下命令：
```
cd DncZeus/DncZeus.App
```
进入到DncZeus的前端项目目录[DncZeus.App](如果是手动下载的源代码，请在此目录打开命令行工具)。在命令行中输入如下命令进行前端依赖包的还原操作：
```
npm install
```
或者
```
npm i
```
### 后端项目
在Visual Studio中打开解决方案[DncZeus.sln]。首先根据自己的开发环境(SQL Server数据库类型，本示例默认是SQL Server Localdb)修改配置文件`appsettings.json`中的数据库连接字符串，示例默认连接字符串为：
```
"ConnectionStrings": {
"DefaultConnection": "Server=(localdb)\\mssqllocaldb;Database=DncZeus;Trusted_Connection=True;MultipleActiveResultSets=true"
}
```
打开项目根目录中的脚本文件夹[Scripts]，执行你的数据库类型对应的脚本文件以初始化系统数据。
**v2.1.0开始，DncZeus同时支持MySQL,PostgreSQL,MSSQL三种类型数据库啦！！！你可以根据需要选择适合自己的数据库哟**
恭喜你，到这里所有的准备工作就完成了。
赶紧体验DncZeus框架吧！！！
## 运行
1. 使用Visual Studio开发工具打开DncZeus根目录中的VS解决方案文件[DncZeus.sln](或者你喜欢的话，使用VS Code来进行.NET 7的开发也是可以的)，设置DncZeus.Api项目为默认启动项并运行此项目。
> 这时在浏览器中打开地址：http://localhost:54321/swagger ，便可以查看到DncZeus已经实现的后端API接口服务了。
2. 在命令行中进入到DncZeus的前端项目目录[DncZeus.App]，运行如下命令以启动前端项目服务：
```
npm run dev
```
成功运行后会自动在浏览器中打开地址: http://localhost:9000
## 使用和授权
DncZeus项目是一个开源项目，你可以直接基于本项目进行扩展或者二次开发，也可以修改其中的代码。
**但请保留原文件中的版权信息，尊重本人的劳动成果，违者必究，谢谢合作**。
## 捐赠作者(Rector)
如果你觉得**DncZeus**是你喜欢的类型，或者能帮你找到一些开发的灵感，请捐赠我(Rector)以维护DncZeus的体验服务器，谢谢支持！！！
### 感谢热心，友爱的捐赠者
| 名称 | 金额(元) | 方式 |
| ------------- | -------- | ---- |
| \*\*\*\*) | 20.00 | 微信 |
| \*\*\*\*宇 | 8.00 | 微信 |
| \*\*\*\*宇 | 50.00 | 微信 |
| \*\*\*\*佑 | 6.00 | 微信 |
| \*\*\*\*沫 | 20.00 | 微信 |
| \*\*\*\*离 | 8.00 | 微信 |
| \*\*\*\*害 | 50.00 | 微信 |
| \*\*\*\*头 | 10.00 | 微信 |
| \*\*\*\*) | 5.00 | 微信 |
| \*\*\*\*龙 | 21.00 | 微信 |
| 北京:Net:柠檬 | 5.00 | 微信 |
## 问题与反馈
遇到问题怎么办？
* 直接提交issue
* QQ群：483350228
* [码友网][8]
## 版本变更日志
### v2.1.1(2023-02-28)
* 新增PostgreSQL数据库支持
### v2.1.0(2023-02-24)
* .NET SDK升级到.NET 7
* 同时支持MySQL,PostgreSQL,MS SQL Server数据库(请修改appsettings.json的配置项`DataProvider`，可选值：`MYSQL`,`MSSQL`)
* 将SQL脚本全部使用Linq语法重构
### v2.0.0
* 支持动态路由和动态菜单渲染
* 优化登录逻辑
* 添加退出系统确认，优化退出逻辑
* 优化路由导航守护
* 优化页面刷新的数据加载逻辑
### v1.0.0
* 支持基本的用户&权限管理
* 前端静态路由
[1]: https://github.com/iview/iview-admin
[2]: https://docs.microsoft.com/en-us/aspnet/core/?view=aspnetcore-2.2
[3]: https://vuejs.org/
[4]: https://github.com/lampo1024/DncZeus
[5]: https://statics.codedefault.com/uploads/2018/12/1.png
[6]: https://statics.codedefault.com/uploads/2018/12/2.png
[7]: https://dnczeus.codedefault.com
[8]: https://codedefault.com
[9]: https://gitee.com/rector/DncZeus