1 Star 1 Fork 2.5K

云龙 / Admin.NET

forked from zuohuaijun / Admin.NET 
加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
Apache-2.0

Admin.NET

前后端分离架构,开箱即用,紧随前沿技术

star fork star star GitHub license

🍟 概述

  • 基于.NET 5实现的通用权限管理平台(RBAC模式)。整合最新技术高效快速开发,前后端分离模式,开箱即用。
  • 后台基于Furion框架,前端基于小诺Antd Vue框架。集EFCore、多租户、分库读写分离、缓存、数据校验、鉴权、动态API、gRPC等众多黑科技于一身。
  • 模块化架构设计,层次清晰,业务层推荐写到单独模块,框架升级不影响业务!
  • 核心模块包括:用户、角色、职位、组织机构、菜单、字典、日志、多应用管理、文件管理、定时任务等功能。
  • 代码量少、上手简单、功能强大、易扩展,轻松开发从现在开始!
如果对您有帮助,点击右上角⭐Star⭐关注 ,感谢支持开源!

🍁 框架拓展包

包类型 名称 版本 描述
nuget Furion.Extras.Admin.NET nuget Admin.NET 核心包
可自行按照 Furion 框架脚手架初始化工程,然后引用此包即可,其他层配置见源代码。🔊此包会紧跟Furion版本更新而更新。

🍀 框架脚手架

模板类型 名称 版本 描述
nuget Furion.Admin.NET.Template.App nuget Admin.NET 框架模板
打开 CMD 或 Powershell 执行dotnet命令

1、安装脚手架
dotnet new --install Furion.Admin.NET.Template.App

2、更新脚手架
dotnet new --install Furion.Admin.NET.Template.App

3、使用脚手架(生成之后推荐将所有的 nuget 包更新到最新版本)
dotnet new Admin.NET -n 你的项目名称

其实安装之后可以直接在VS里面进行可视化及创建工程

🐱‍🚀 模块/插件化开发

  • 按照 Furion 框架脚手架或者本框架脚手架初始化工程。
  • 创建自己业务的 Dll 插件库工程,引用 Furion.Extras.Admin.NET 包,编写自己的业务代码包括实体、服务等。
  • 在 XXX.Web.Entry 层里面的 appsettings.json 配置此插件 Dll 的路径。配置文档说明
  • 此时框架和自己业务实体可以同时做数据迁移,耦合度最低。也可以自行将数据库分系统库、业务库等。
  • 将自己业务前端代码包括view和api文件复制到前端工程相应目录即可。

仓库内 plugin 文件内为本框架模块/插件开发事例,供参考。

🎭 插件市场

欢迎大家勇于参与开源,贡献自己的应用插件,你我都可以做到,.NET正在迅速崛起,我们都是历史的见证人💪

【核酸采集系统】

【工作流】

😎 衍生版本

【Admin.NET】隆重推出SqlSugar版本

如果集成其他ORM,请参照各自操作使用说明。系统默认EFCore不会处理其他ORM实体等,请自行处理。

👑 多租户简介

框架目前采用基于共享数据库TenantId的方式实现,后期可无缝迁移转换到基于多库或者Schema模式。

  • 平台超管对租户进行增删改查操作,对各租户进行权限(菜单)的分配,租户管理员密码默认123456
  • 租户管理员根据平台分配的权限再对本租户内用户进一步权限划分
  • 针对新开发的业务功能,平台超管可以针对性分配给各租户(比如某租户购买后才有此功能菜单等)

🥞 更新日志

更新日志 点击查看

🍿 在线体验

感谢安徽合肥的网友🎉微信号Protear🎉提供的云服务器

🍄 快速启动

需要安装:VS2019(最新版)、npm或yarn(最新版)

  • 启动后台:打开backend/Admin.NET.sln解决方案,直接运行(F5)即可启动(数据库默认SQLite)
  • 启动前端:VSCode或HBuilder,打开frontend文件夹,进行依赖下载,运行npm install或yarn命令,再运行npm run serve或 yarn run serve
  • 浏览器访问:http://localhost:81 (默认前端端口为:81,后台端口为:5566)

🏀 分层说明

├─Admin.NET.Application             ->业务应用层,在此写您具体业务代码是🌻🌻🌻
├─Admin.NET.Core                    ->框架核心层,后期准备做成NuGet包直接引用即可
├─Admin.NET.Database.Migrations     ->架构维护层,主要存放迁移中间文件
├─Admin.NET.EntityFramework.Core    ->EF Core配置层,主要配置数据库及相关
├─Admin.NET.Web.Core                ->Web核心层,主要是服务注册及鉴权
├─Admin.NET.Web.Entry               ->Web入口层/启动层,可任意更换
注:建议自己的业务代码直接写在【Admin.NET.Application】层里面,包括实体与服务等,或者单独新建个业务应用工程,进行模块化开发。
😛其他层尽量不要管,可随框架升级而无缝升级。

📖 帮助文档

👉后台文档:

👉前端文档:

  1. Ant Design Pro of Vue 使用文档 https://pro.antdv.com/docs/getting-started
  2. Ant Design of Vue 组件文档 https://www.antdv.com/docs/vue/getting-started-cn/
  3. Vue 开发文档 https://cn.vuejs.org/v2/guide/

👉快捷部署到 linux 文档:

👉代码生成器使用教程:

👉fork项目后该这样做后续开发:

👉关于signalr使用:

😎通读以上文档,您就可以玩转本项目了(其实您已经是高手了)。项目使用上的问题,文档中基本都可以找到答案。

🍎 效果图

🍖 详细功能

  1. 主控面板、控制台页面,可进行工作台,分析页,统计等功能的展示。
  2. 用户管理、对企业用户和系统管理员用户的维护,可绑定用户职务,机构,角色,数据权限等。
  3. 应用管理、通过应用来控制不同维度的菜单展示。
  4. 机构管理、公司组织架构维护,支持多层级结构的树形结构。
  5. 职位管理、用户职务管理,职务可作为用户的一个标签,职务目前没有和权限等其他功能挂钩。
  6. 菜单管理、菜单目录,菜单,和按钮的维护是权限控制的基本单位。
  7. 角色管理、角色绑定菜单后,可限制相关角色的人员登录系统的功能范围。角色也可以绑定数据授权范围。
  8. 字典管理、系统内各种枚举类型的维护。
  9. 访问日志、用户的登录和退出日志的查看和管理。
  10. 操作日志、用户的操作业务的日志的查看和管理。
  11. 服务监控、服务器的运行状态,CPU、内存、网络等信息数据的查看。
  12. 在线用户、当前系统在线用户的查看。
  13. 公告管理、系统的公告的管理。
  14. 文件管理、文件的上传下载查看等操作,文件可使用本地存储,阿里云oss,腾讯cos接入,支持拓展。
  15. 定时任务、定时任务的维护,通过cron表达式控制任务的执行频率。
  16. 系统配置、系统运行的参数的维护,参数的配置与系统运行机制息息相关。
  17. 邮件发送、发送邮件功能。
  18. 短信发送、短信发送功能,可使用阿里云sms,腾讯云sms,支持拓展。

💪 数据库操作

本框架ORM默认采用EF Core开发,加上拓展比如SqlSugar,理论上兼容并支持所有类型数据库。😜

【MySQL】

  1. Admin.NET.EntityFramework.Core 项目安装 Pomelo.EntityFrameworkCore.MySql,Nuget 需安装 5.0 版本 (支持 MySql 5.x +) MySql.EntityFrameworkCore:支持 (MySql 8.x +)
  2. DefaultDbContext.cs 指定 DbProvider , [AppDbContext("DefaultConnection", DbProvider.MySql)]
  3. dbsettings.json 配置 "DefaultConnection": "Data Source=localhost;Database=Admin.NET;User ID=root;Password=000000;pooling=true;port=3306;sslmode=none;CharSet=utf8;"
  4. 打开程序包管理器控制台,默认项目Admin.NET.Database.Migrations 执行命令:Add-Migration Init和update-database

【SQLServer】

  1. Admin.NET.EntityFramework.Core 项目安装 Microsoft.EntityFrameworkCore.SqlServer
  2. DefaultDbContext.cs 指定 DbProvider , [AppDbContext("DefaultConnection", DbProvider.SqlServer)]
  3. dbsettings.json 配置 "DefaultConnection": "Server=localhost;Database=Admin.NET;User=sa;Password=000000;MultipleActiveResultSets=True;"
  4. 打开程序包管理器控制台,默认项目Admin.NET.Database.Migrations 执行命令:Add-Migration Init 和 update-database
提示:其他类型数据库依次类推,首先添加EF的Core版包,然后指定数据库类型,修改数据库连接字符串,执行EF迁移命令即可。

【数据库初始化操作】 GIT完成后默认为SqlLite数据库,使用其他数据库可通过基于EF Core的CodeFirst初始化,添加好拓展包,创建好空数据库,设置好数据库信息和后,即可通过此操作可进行数据库初始化操作。

  1. 启动项目设置为 XXXX.Web.Entry
  2. 程序包管理控制台默认项目设置为 XXXX.Database.Migrations
  3. 依次输入并回车执行
    Add-Migration v1.0.0 -Context DefaultDbContext
    update-database v1.0.0 -Context DefaultDbContext 
    Add-Migration v1.0.0 -Context MultiTenantDbContext
    update-database v1.0.0 -Context MultiTenantDbContext

至此完成初始数据部署。后期添加/修改自己业务的数据类后通过更新版本号来更新数据库即可。

    Add-Migration v1.0.1 -Context DefaultDbContext
    update-database v1.0.1 -Context DefaultDbContext 
    Add-Migration v1.0.1 -Context MultiTenantDbContext
    update-database v1.0.1 -Context MultiTenantDbContext

【EF批量操作】

使用 Zack.EFCore.Batch https://hub.fastgit.org/yangzhongke/Zack.EFCore.Batch 安装对应包即可

  1. MSSQL:Zack.EFCore.Batch.MSSQL
  2. MySql:Zack.EFCore.Batch.MySQL.Pomelo
  3. Npgsql:Zack.EFCore.Batch.Npgsql
  4. Oracle:Zack.EFCore.Batch.Oracle
  5. Sqlite:Zack.EFCore.Batch.Sqlite
提示:记得修改Admin.NET.EntityFramework.Core层里面Startup注册服务类型 opt.UseBatchEF_Sqlite(), 改成相应得库类型。

⚡ 近期计划

  • 集成多租户功能
  • 集成代码生成器
  • 集成导入导出
  • 在线用户及黑名单
  • 邮件发送
  • 短信发送
  • 集成微信开发
  • 实现电商应用插件
  • 集成工作流

🥦 补充说明

  • 基于.NET 5平台 Furion 开发框架与小诺Antd Vue版本相结合,实时跟随基架升级而升级!
  • 持续集百家所长,完善与丰富本框架基础设施,为.NET生态增加一种选择!
  • 后期会推出基于此框架的相关应用场景案例,提供给大家使用!
  • 有问题讨论的小伙伴可加群一起学习讨论。 QQ群1【87333204】 QQ群2【252381476】

🍻 贡献代码

Admin.NET 遵循 Apache-2.0 开源协议,欢迎大家提交 PRIssue

感谢每一位贡献代码的朋友。感谢 TLog 作者 提供的贡献者实时头像。

Giteye chart

💐 特别鸣谢

如果对您有帮助,您可以点右上角 💘Star💘支持一下,这样我们才有持续下去的动力,谢谢!!!

Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright © 2021 Admin.NET, Dilon Co.,Ltd. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

简介

🔥基于.NET 5/6实现的通用管理平台。整合最新技术,模块插件式开发,前后端分离,开箱即用。集成EF Core、多租户、缓存、数据校验、鉴权、动态API、通讯、任务调度、gRPC等众多黑科技。代码简洁、易扩展,轻松开发从这里开始! 展开 收起
C#
Apache-2.0
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
C#
1
https://gitee.com/571183806/Admin.NET.git
git@gitee.com:571183806/Admin.NET.git
571183806
Admin.NET
Admin.NET
master

搜索帮助

14c37bed 8189591 565d56ea 8189591