1 Star 0 Fork 359

Miracle / Admin.SimpleAdmin

forked from DotNet-MoYu / Admin.SimpleAdmin 
Create your Gitee Account
Explore and code with more than 12 million developers,Free private repositories !:)
Sign up
Clone or Download
README.md 12.14 KB
Copy Edit Raw Blame History
SimpleAdmin

🐔没有花里胡哨,只有简单、稳定、灵活、高效🐔

AUR star fork

如果您觉得有帮助,请点右上角 "Star" 支持一下谢谢

🎨 框架介绍 🎨

🪶SimpleAdmin 是一个小而美的通用业务型后台管理系统,专为解决开发过程中的痛点难点而生。Vue3+Vite+Vuex+JS,并在此基础上增加更人性化功能,后端基于.NET6/7+Furion,ORM 采用 Sqlsugar+单例模式,插件式开发。采用 RBAC+多机构的权限管理模式,实现全网最灵活的接口级别数据权限控制,集成国密加解密,导入导出、导入导出、批量修改等常用插件。后端代码注释覆盖率>90%,并配备超牛皮的代码生成器和超详细的手摸手教学文档,非常适合二次开发。将日常开发中的业务场景和框架紧密结合,并坚持以人为本,以业务为中心,做到开箱即用,代码简洁、易扩展,注释详细,文档齐全,让你的开发少走弯路。

🐥 选择 SimpleAdmin 的 N 个理由 🐥

📕 前端采用 Vue3+JavaScript

本系统是基于前端 Vue3+Vite+Vuex+JS,。市面上主流的 Vue3 框架大部分都是采用TypeScript开发,虽然是官方推荐,但是也增加了一些学习成本,如果您之前使用的事 vue2+js 的开发方式,那么再使用本系统就非常的好上手,也不用担心 vue2 打包之后第一次加载巨慢的问题。

🍭ORM 基于 Sqlsugar

SqlSugar 是一款老牌.NET 开源 ORM 框架,由果糖大数据科技团队维护和更新 ,开箱即用 最易上手的 ORM 框架,本系统也是基于 Sqlsugar 单例模式+CodeFirst+仓储的结构,无需担心作用域问题,直接爽撸!

文档地址:https://www.donet5.com/Home/Doc

源码地址:https://gitee.com/dotnetchina/SqlSugar

🎮 真·插件式开发,代码更灵活,架构更清晰

引入插件式开发的概念,除项目主体外,每个业务层都可以是独立的,一些拓展性功能采用插件的方式创建在独立的类库中,每一层都可以单独设置初始化表数据结构和种子数据,这样的话我们想要用哪个功能就引用该功能的项目,如果功能有问题我们也能快速定位到代码的位置,非常方便,也使得项目架构变得非常清晰,代码更灵活了,避免后期功能越来越多导致项目成为屎山。

📘 极致缓存,系统快人一步

本系统使用了大量的缓存操作,一些基础配置和用户权限信息都放在了缓存中,用户首次登录后,下次再登录接口耗时实测10-30ms

系统同时支持 MemeryCache 和 Redis 分布式缓存,Redis 客户端使用的是我基于NewLife.Redis二次封装的SimpleRedis。简化了注入操作,更方便使用。

🍎NewLife.Redis 特性
  • 在 ZTO 大数据实时计算广泛应用,200 多个 Redis 实例稳定工作一年多,每天处理近 1 亿包裹数据,日均调用量 80 亿次
  • 低延迟,Get/Set 操作平均耗时 200~600us(含往返网络通信)
  • 大吞吐,自带连接池,最大支持 1000 并发
  • 高性能,支持二进制序列化

👮RBAC+多机构的权限管理模式+权限及时刷新

作为一个后台管理系统,一个权限管理框架,权限设计作为一个管理系统的灵魂,是一个系统好不好用的关键。本系统是采用 RBAC+多机构的权限管理模式,一个机构下有多个角色,每个角色有不同的菜单和权限,可以将不同角色分配给不同的用户,这样每个用户都会拥有他所属角色的权限。当然,一个用户也可以拥有多个角色的权限,除此之外还支持给用户单独授权,让用户脱离所有角色之外,实现灵活再灵活的权限控制。并且当角色或用户的权限被修改之后,后端会立即刷新,前端只需刷新页面就能更新被重新赋予的权限,无需重新登录。

🧱 接口级别的数据范围权限

目前在我接触的大部分管理系统中,数据权限这块都不太尽如人意,要么只有接口权限没有数据权限,要么有数据权限但是用起来不是特别顺手而且还有 BUG,针对以上痛点和难点结合业务场景,本系统实现全网最灵活的接口级别数据范围权限控制,可以指定某个角色的某个接口的数据权限范围,非常的灵活。

在系统中,获取数据权限非常简单,只需一个方法搞定。

//获取数据范围
var dataScope = await _sysUserService.GetLoginUserApiDataScope();

📈 启动及运行

您是否有过在使用其他框架时,光是从启动运行都会遇到各种奇奇怪怪的问题?并且使用过程中也是各种奇奇怪怪的 bug,发到群里也没人解决,非常影响开发效率。本系统做到了启动即运行,就算是小白只要照着文档操作,也能非常容易的上手项目。就目前使用的反馈来看,业务占据大多数,系统问题只占很少的一部分,如果您在使用过程中遇到问题,或者发现 bug,可以直接发 issues 描述您的问题,只要是系统 bug 第一时间修复。或者您对当前系统有什么建议或意见,也欢迎您提出,只要是符合大部分业务场景的都会考虑支持。我们也有和谐内部的 qq/微信交流群,没有像其他系统 qq 群一样每天都是一堆启动报错问题,页面错误问题,有的只是系统功能的讨论和优化方案。

🍢 支持多种主键类型

系统默认采用long类型的雪花ID作为系统主键,但是在交流过程中发现,部分小伙伴使用string类型或者guid作为系统主键,还有的是部分老系统用的是 string 类型,但是 simpleadmin 确是long类型,所以根据这个业务场景,本框架也支持String类型的系统主键,只需要拉取对应的stringid分支即可,完全不需要另外去修改代码,并且也能和 master 分支进行最新的同步。

📞 支持 Mqtt/Signalr 的即时通讯

作为前后端分离项目,前后端交互是一个非常重要的功能。目前主流框架都是通过 Socket 实现,本系统自然也是实现了基于Signalr的前后端交互,并在此基础上实现了基于MQTT的前后端交互功能,MQTT 相比 socket 业务场景更多更灵活,在物联网方向有着非常多的应用。.NET 应用在工业物联网方向也是有很多的岗位,学习 MQTT 还是非常有必要的。

MQTT 客户端使用的是我基于NewLife.MQTT二次封装的SimpleMQTT。采用单例模式,可以动态的添加和删除 mqtt 客户端,非常好用。

文档地址:https://www.cnblogs.com/huguodong/p/16991947.html

🔧 代码生成器

大部分项目里,其实有很多代码是重复的,几乎每个模块都有 CRUD 增删改查的功能,而这些功能的实现代码往往是大同小异的。如果这些功能都要自己去手写,非常无聊枯燥,浪费时间且效率很低,还可能会写错。代码生成功能通过选择数据库表,完成单表的增删改查管理功能,还支持树形结构的表的生成可以生成包括前端、后端、和 SQL 语句,支持预览的同时还支持 ZIP 压缩包和直接生成到项目两种模式,解放你的双手,大大减少了重复代码的编写,无需复制提升开发效率。

🎺 常用功能组件化

在系统一些常用的功能直接封装成 vue 组件,如批量导入,批量导出,批量删除,批量编辑等,只需按照规范传入相应参数就可以很好的实现功能,减少了很多不必要的前端代码。最典型的就是批量导入组件,只需传入 api 接口,通过后端接口自动生成表头,并实现字段级别的错误信息提示和预览,大数据支持分段导入,非常好用。

📖 最详细的注释和手摸手教学文档,开发效率直线提升

作为一个开源项目,如何让使用者看懂代码是非常重要的,很多作者会忽视这一点,导致我们阅读其代码的时候很难理解其为什么要这么写,如果没有详细的文档,想要二次开发需要花精力去研究源码。而本系统完全不用担心这个问题,后端源码注释覆盖率超过90%
,每一个方法,每一步都有详细的解释和说明,并且推出了手摸手教学文档(博客园),目的就是让使用者能够轻易上手,就算不是自己的代码,根据注释和文档也能轻易看懂和二次开发,不用每天在群里问一些非常基础的问题,节约了大量的开发时间。

分支说明

  • js js 版本,具体版本升级内容看更新标签

  • master 正式稳定版本,具体版本升级内容看更新标签

  • dev 开发的分支(代码可能随时会推,不保证运行和使用)

  • stringid 字符串类型主键分支,系统主键用 string 类型的使用此分支

🎈 相关连接 🎈

更新日志:点击查看

文档地址:https://www.cnblogs.com/huguodong/p/17021233.html

常见问题合集:https://www.cnblogs.com/huguodong/p/17021241.html

🔖 友情链接 🔖

👏 鸣谢 👏

  • 感谢 JetBrains 提供的免费开源 License:

🤌 赞助 🤌

如果对您有帮助,请点击右上角⭐Star关注或扫码捐赠,感谢支持开源!

💾 版权声明 💾

  • 后端源码完全免费开源商用。
  • 前端源码因版权问题不能开源,后续准备替换掉之后再开源。
  • 不能以任何形式用于非法为目的的行为。
  • 任何基于本软件而产生的一切法律纠纷和责任,均于作者无关。
C#
1
https://gitee.com/zhenglibo/SimpleAdmin.git
git@gitee.com:zhenglibo/SimpleAdmin.git
zhenglibo
SimpleAdmin
Admin.SimpleAdmin
js

Search