Skip to content

Latest commit

 

History

History
237 lines (152 loc) · 8.58 KB

README.md

File metadata and controls

237 lines (152 loc) · 8.58 KB
Raw

DncZeus用户授权数据流图

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)

在线体验(Demo)

超级管理员：administrator 管理员：admin

密码：111111

地址：https://dnczeus.codedefault.com

试试以不同用户名登录系统，可以体验不同角色的不同菜单权限。

由于是个人项目，资金有限，体验服是低配，请大家爱惜，轻戳，不胜感激！！！

国内码云镜像地址：https://gitee.com/rector/DncZeus

适合人群

由于 DncZeus 考虑到初级.NET 开发者都可以使用，所以后端项目未涉及过多架构和封装(代码逻辑一目了然)，但为了你更好地熟悉和运用 DncZeus，你需要了解：

  • .NET 7
  • Vue.js
  • iView

ASP.NET Core 的知识能确保你可以看懂和了解后端是如何实现和工作的，而 Vue.js 框架则是前端实现的基石，当然 iView 这个基于 Vue.js 的 UI 框架也是必须要了解的，因为 DncZeus 正是基于 iview-admin(iView 的一个后台管理系统示例项目)来实现的前端 UI 交互。

如果你对这两个方面的知识还不熟悉，建议你可以先学习一些理论再来运用 DncZeus 这个框架。关于 .NET 7 和 Vue.js 的入门请参考：

环境和工具

  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，找到页面中的按钮"Clone or download"，如下图示：

手动下载DncZeus

在弹出的对话框中点击按钮"Download ZIP"即可开始下载DncZeus的源代码，如下图：

手动下载DncZeus源代码

安装依赖

前端项目

在将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接口服务了。

  1. 在命令行中进入到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
  • 码友网

版本变更日志

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

  • 支持基本的用户&权限管理
  • 前端静态路由