Admin.NET简介

• 基于.NET 6实现的通用管理平台。整合最新技术，模块插件式开发，前后端分离，开箱即用；
• 后台基于Furion框架，前端基于vue2；
• 集成EF Core、多租户、缓存、数据校验、鉴权、事件总线、动态API、通讯、远程请求、任务调度、gRPC等众多黑科技；
• 核心模块包括：用户、角色、职位、组织机构、菜单、字典、日志、应用管理、文件管理、定时任务等功能；
• 代码简洁、易扩展！

模块/插件化开发

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

多租户简介

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

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

分层说明

├─Admin.NET.Application             ->业务应用层，在此写您具体业务代码
├─Admin.NET.Core                    ->框架核心层，实体类
├─Admin.NET.Database.Migrations     ->架构维护层，主要存放迁移中间文件
├─Admin.NET.EntityFramework.Core    ->EF Core配置层，主要配置数据库及相关
├─Admin.NET.Web.Core                ->Web核心层，主要是服务注册及鉴权
├─Admin.NET.Web.Entry               ->Web入口层/启动层，可任意更换
├─Furion.Extras.Admin.NET           ->封装的框架核心层

快速安装

1. 使用git下载源码

git clone https://gitee.com/zuohuaijun/Admin.NET.git

源代码结构如下图所示，backend文件夹为服务端程序源码，frontend文件夹为前端程序源码。

2.数据库初始化

项目默认是SqlLite数据库，使用其他数据库可通过基于EF Core的CodeFirst初始化，这里我们采用MySql5.7来进行初始化。

使用vs2022打开服务端源码，Admin.NET.EntityFramework.Core项目下修改dbsettings.Development.json配置文件下的DefaultConnection（业务数据库）和MultiTenantConnection（租户数据库）两项数据库连接字符串和账户密码。

修改DefaultDbContext.cs（业务数据库上下文）和MultiTenantDbContext.cs（租户数据库上下文）中的DbProvider为MySql，并使用nuget安装对应的包：Pomelo.EntityFrameworkCore.MySql。

设置项目启动项为Admin.NET.Web.Entry，默认项目为Admin.NET.Database.Migrations

手动创建两个空数据库并依次执行如下命令初始化数据库，等待初始化成功。

    Add-Migration Init -Context DefaultDbContext
    update-database Init -Context DefaultDbContext 
    Add-Migration Init -Context MultiTenantDbContext
    update-database Init -Context MultiTenantDbContext

3.服务端运行

编译Admin.NET.Web.Entry项目，成功后进入编译程序，执行命令运行服务端（前端默认连接的服务端端口为5566）。

dotnet Admin.NET.Web.Entry.dll --urls="http://*:5566"

4.前端编译运行

前端默认端口为81

npm install
npm run start

启动成功后访问http://localhost:81

• 超级管理员:superAdmin
• 系统管理员:admin
• 普通用户:zuohuaijun
• 以上默认密码：123456

系统通用的功能主要有

1. 主控面板、控制台页面，可进行工作台，分析页，统计等功能的展示。
2. 用户管理、对企业用户和系统管理员用户的维护，可绑定用户职务，机构，角色，数据权限等。
3. 应用管理、通过应用来控制不同维度的菜单展示。
4. 机构管理、公司组织架构维护，支持多层级结构的树形结构。
5. 职位管理、用户职务管理，职务可作为用户的一个标签，职务目前没有和权限等其他功能挂钩。
6. 菜单管理、菜单目录，菜单，和按钮的维护是权限控制的基本单位。
7. 角色管理、角色绑定菜单后，可限制相关角色的人员登录系统的功能范围。角色也可以绑定数据授权范围。
8. 字典管理、系统内各种类型的维护。
9. 访问日志、用户的登录和退出日志的查看和管理。

10. 操作日志、用户操作业务的日志的查看和管理。

11. 服务监控、服务器的运行状态，CPU、内存、网络等信息数据的查看。

12. 在线用户、当前系统在线用户的查看。

13. 公告的管理、系统的公告的管理。

14. 文件管理、文件的上传下载查看等操作，文件可使用本地存储，阿里云oss，腾讯cos接入，支持拓展。

15. 定时任务、定时任务的维护，通过cron表达式控制任务的执行频率。

16. 系统配置、系统运行的参数的维护，参数的配置与系统运行机制息息相关。

17. 邮件发送功能。

18. 短信发送、短信发送功能，可使用阿里云sms，腾讯云sms，支持拓展。

Admin.NET 遵循 Apache-2.0 开源协议。