# Admin.NET

**Repository Path**: xue5zhijing/Admin.NET

## Basic Information

- **Project Name**: Admin.NET
- **Description**: 🔥基于 .NET 6/8 (Furion/SqlSugar) 实现的通用权限开发框架，前端采用 Vue3/Element-plus，代码简洁、易扩展。整合最新技术，模块插件式开发，前后端分离，开箱即用。集成多租户、缓存、数据校验、鉴权、事件总线、动态API、通讯、远程请求、任务调度、打印等众多黑科技。让开发更简单、更通用、更流行！
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: next
- **Homepage**: https://jiuai.blog.csdn.net/
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 3384
- **Created**: 2024-06-07
- **Last Updated**: 2025-04-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center"><h1>9iAdmin.NET</h1></div>
<div align="center"><h3>学会站在巨人肩膀上的 .NET 通用权限开发框架</h3></div>


## 🎁框架介绍
基于 .NET6 (Furion/SqlSugar) 实现的通用权限开发框架，前端采用 Vue3+Element-plus+Vite5，整合众多优秀技术和框架，模块插件式开发。集成多租户、缓存、数据校验、鉴权、事件总线、动态API、通讯、远程请求、任务调度、打印等众多黑科技。代码结构简单清晰，注释详尽，易于上手与二次开发，即便是复杂业务逻辑也能迅速实现，真正实现“开箱即用”。
面向中小企业快速开发平台框架，框架采用主流技术开发设计，前后端分离架构模式。完美适配国产化软硬件环境，支持国产中间件、国产数据库、麒麟操作系统、Windows、Linux部署使用；集成国密加解密插件，使用SM2、SM3、SM4等国密算法进行签名、数据完整性保护；软件层面全面遵循等级保护测评要求，完全符合等保、密评要求。


### 🍁说明
1. 支持各种数据库，后台配置文件自行修改（自动生成数据库及种子数据）

   支持数据库：MySql,SqlServer,Sqlite(默认)等,项目默认数据库类型 Sqlite， 路径为项目 Admin.NET.Web.Entry 下面 DataSource=./Admin.NET.db。
   
   根据业务需要可自动更换各种数据库，只需要修改数据库类型和连接字符串即可，系统自动创建数据库表，无需任何 SQL 脚本文件。
   
   项目采用前后端分离模式，需要先运行后端再运行前端。
   
   首次运行初始化库、表时开启Admin.NET.Application\Configuration\Database.json中

  	+ "EnableInitDb": true,// 首次启用库初始化（重新生成项目，重启后端）
  	
	+ "EnableInitTable": true,// 启用表初始化，表结构发生变化时开启
	
	+ "EnableInitSeed": true, // 启用种子初始化，修改种子数据时开启一次
	
   后端运行：Admin.NET.Web.Entry\bin\Debug\net6.0\Admin.NET.Web.Entry.exe

2. 前端运行步骤：（命令窗口路径切换到Web目录下后执行）
<ul>
<li>①、安装依赖pnpm install (更新依赖 pnpm update),package.json有变动需执行一次 </li>
<li>②、前端运行pnpm run dev (如果自动打开，需要配置.env中VITE_OPEN = true)</li>
<li>③、重新打包pnpm run build  (如果内存溢出错误，修改package.json第9行，方法见下)</li>
</ul>

- 前端访问默认地址： http://localhost:8888    （修改接口在.env中，VITE_PORT = 8888）

- 后台默认超管账号/密码： superadmin/123456

- API接口默认端口(swagger)：5005     (默认登录密码同后台登录密码)。


```bash
vue3打包时，如果出现内存溢出错误，修改参数（package.json第9行）：
"build": "node --max_old_space_size=20480 ./node_modules/vite/bin/vite.js build",

版本要求:Node>=16。新版本的 Node 已经集成了 npm 所以不需要额外的安装。本项目推+ 荐用 pnpm，直接安装: npm install -g pnpm
查看Node版本号：node -v
查看pnpm版本号：pnpm -v
查看pnpm镜像地址：npm config get registry
设置镜像源地址（新）pnpm config set registry=https://registry.npmmirror.com
```

3. QQ：<u>250913233</u> ，VX：<u>jiuailtd</u>

4. [线上演示环境](http://101.43.53.74:5005/dist/index.html)

5. [Gitee 镜像地址](https://gitee.com/xue5zhijing/Admin.NET.git)

6. [使用笔记](https://blog.csdn.net/uaime/article/details/130855179)

### 📙开发流程
```bash
# 克隆项目
git clone https://gitee.com/xue5zhijing/Admin.NET.git

# 保存项目到您的账号下（先注册账号，登录gitee.com)
右上角点击 Fork

学习摸索...多交流...
git上传三步骤(项目根目录下,右键选择 Open Git Bash Here)
如果需要拉取：git pull origin(或git pull origin next:next)
git add .
git commit -m "更新说明文件内容"
git push origin next
```
<img src="https://gitee.com/xue5zhijing/Admin.NET/raw/next/doc/img/git1.png"/>
<img src="https://gitee.com/xue5zhijing/Admin.NET/raw/next/doc/img/git2.png"/>
<img src="https://gitee.com/xue5zhijing/Admin.NET/raw/next/doc/img/git3.png"/>
<img src="https://gitee.com/xue5zhijing/Admin.NET/raw/next/doc/img/git4.png"/>

### 📙 接口API自动生成*.ts方法(swagger)

- 生成地址：[swagger](https://editor-next.swagger.io/)
- 本地接口json生成访问5005地址后（全选）复制到上界面编辑区中
- 对接接口下载后（解压）放入web/src/api-services对应文件夹中（细心）。
- 参考下图进行操作
<img src="https://gitee.com/xue5zhijing/Admin.NET/raw/next/doc/img/swagger.jpg"/>

### 🍎 部分效果图
<table>
    <tr>
        <td><img src="https://gitee.com/xue5zhijing/Admin.NET/raw/next/doc/img/20.png"/></td>
        <td><img src="https://gitee.com/xue5zhijing/Admin.NET/raw/next/doc/img/21.png"/></td>
        <td><img src="https://gitee.com/xue5zhijing/Admin.NET/raw/next/doc/img/22.png"/></td>
        <td><img src="https://gitee.com/xue5zhijing/Admin.NET/raw/next/doc/img/23.png"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/xue5zhijing/Admin.NET/raw/next/doc/img/24.png"/></td>
        <td><img src="https://gitee.com/xue5zhijing/Admin.NET/raw/next/doc/img/25.png"/></td>
        <td><img src="https://gitee.com/xue5zhijing/Admin.NET/raw/next/doc/img/26.png"/></td>
        <td><img src="https://gitee.com/zuohuaijun/Admin.NET/raw/next/doc/img/4.png"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/zuohuaijun/Admin.NET/raw/next/doc/img/5.png"/></td>
        <td><img src="https://gitee.com/zuohuaijun/Admin.NET/raw/next/doc/img/6.png"/></td>
        <td><img src="https://gitee.com/zuohuaijun/Admin.NET/raw/next/doc/img/7.png"/></td>
        <td><img src="https://gitee.com/zuohuaijun/Admin.NET/raw/next/doc/img/8.png"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/zuohuaijun/Admin.NET/raw/next/doc/img/9.png"/></td>
        <td><img src="https://gitee.com/zuohuaijun/Admin.NET/raw/next/doc/img/10.png"/></td>
        <td><img src="https://gitee.com/zuohuaijun/Admin.NET/raw/next/doc/img/11.png"/></td>
        <td><img src="https://gitee.com/zuohuaijun/Admin.NET/raw/next/doc/img/12.png"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/zuohuaijun/Admin.NET/raw/next/doc/img/13.png"/></td>
        <td><img src="https://gitee.com/zuohuaijun/Admin.NET/raw/next/doc/img/14.png"/></td>
        <td><img src="https://gitee.com/zuohuaijun/Admin.NET/raw/next/doc/img/15.png"/></td>
        <td><img src="https://gitee.com/zuohuaijun/Admin.NET/raw/next/doc/img/16.png"/></td>
    </tr>
</table>

### 🍖内置功能
 1. 主控面板：控制台页面，可进行工作台，分析页，统计等功能的展示。
 2. 用户管理：对企业用户和系统管理员用户的维护，可绑定用户职务，机构，角色，数据权限等。
 3. 机构管理：公司组织架构维护，支持多层级结构的树形结构。
 4. 职位管理：用户职务管理，职务可作为用户的一个标签。
 5. 菜单管理：配置系统菜单，操作权限，按钮权限标识等，包括目录、菜单、按钮。
 6. 角色管理：角色绑定菜单后，可限制相关角色的人员登录系统的功能范围。角色也可以绑定数据授权范围。
 7. 字典管理：对系统中经常使用的一些较为固定的数据进行维护。
 8. 访问日志：用户的登录和退出日志的查看和管理。
 9. 操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
10. 服务监控：服务器的运行状态，CPU、内存、网络等信息数据的查看。
11. 在线用户：当前系统在线用户的查看，包括强制下线。基于 SignalR 实现。
12. 公告管理：系统通知公告信息发布维护，使用 SignalR 实现对用户实时通知。
13. 文件管理：文件的上传下载查看等操作，文件可使用本地存储，阿里云oss、腾讯cos等接入，支持拓展。
14. 任务调度：采用 Sundial，.NET 功能齐全的开源分布式作业调度系统。
15. 系统配置：系统运行的参数的维护，参数的配置与系统运行机制息息相关。
16. 邮件短信：发送邮件功能、发送短信功能。
17. 系统接口：使用 Swagger 生成相关 api 接口文档。支持 Knife4jUI 皮肤。
18. 代码生成：可以一键生成前后端代码，自定义配置前端展示控件，让开发更快捷高效。
19. 在线构建器：拖动表单元素生成相应的 VUE 代码(支持vue3)。
20. 对接微信：对接微信小程序开发，包括微信支付。
21. 导入导出：采用 Magicodes.IE 支持文件导入导出，支持根据H5模板生成PDF等报告文件。
22. 限流控制：采用 AspNetCoreRateLimit 组件实现对接口访问限制。
23. ES 日志：通过 NEST 组件实现日志存取到 Elasticsearch 日志系统。
24. 开放授权：支持OAuth 2.0开放标准授权登录，比如微信。
25. APIJSON：适配腾讯APIJSON协议，支持后端0代码。
26. 新闻发布模块、个人笔记。
27. 物联网远程控制（MQTT）、网络串口调试助手（网络透传）、云直播。

### 🎀捐赠支持(多少都是心意）
```
如果对您有帮助，请点击右上角⭐Star关注或扫码捐赠，感谢支持，共同学习！
```
<img src="https://gitee.com/xue5zhijing/Admin.NET/raw/next/doc/img/pay.png"/>
<p><a href="https://jiuai.blog.csdn.net/" target="_black">个人博客</a></p>

#### 💐特别鸣谢
- 👉 Admin.NET：[https://gitee.com/zuohuaijun/Admin.NET](https://gitee.com/zuohuaijun/Admin.NET)
- 👉 Furion：[https://gitee.com/dotnetchina/Furion](https://gitee.com/dotnetchina/Furion)
- 👉 vue-next-admin：[https://lyt-top.gitee.io/vue-next-admin-doc-preview/](https://lyt-top.gitee.io/vue-next-admin-doc-preview/)
- 👉 SqlSugar：[https://gitee.com/dotnetchina/SqlSugar](https://gitee.com/dotnetchina/SqlSugar)
- 👉 Element Plus：[https://element-plus.org/zh-CN/](https://element-plus.org/zh-CN/)
- 👉 swagger工具：[https://editor-next.swagger.io/](https://editor-next.swagger.io/)