zhontai / admin.core

中台Admin前后端分离的权限管理系统。支持多租户、数据权限、动态Api、任务调度、OSS文件上传、滑块拼图验证、国内外主流数据库自由切换和动态高级查询。基于.Net跨平台开发的WebApi。集成统一认证授权、事件总线、数据验证、分布式缓存、分布式事务、Ip限流、全Api鉴权、集成测试、性能分析、健康检查、接口文档等。

中台admin

前后端分离后台权限管理系统

中文 | English

 

🌈 介绍

基于 .Net8.0 + FreeSql 全家桶 + Autofac + CAP + Mapster 等技术，前后端分离后台权限管理系统。想你所想的开发理念，希望减少工作量，帮助大家实现快速开发。基于 FreeSql Orm 开发，支持国内外主流数据库、读写分离、分表分库、分布式事务 TCC/ SAGA 等功能。启动项目即自动生成数据库，CodeFirst 模式支持从实体配置自动同步表结构和权限数据至数据库。新版 swagger 接口文档更易于接口阅读和测试。

⛱️ 线上预览

• Admin.Core v3 版本预览 https://admin.zhontai.net

💒 代码仓库

• Admin.Core v3 版本 https://github.com/zhontai/Admin.Core

🚀 功能介绍

1. 用户管理：配置用户，查看部门用户列表，支持禁用/启用、重置密码、设置主管、用户可配置多角色、多部门和上级主管。
2. 角色管理：配置角色，支持角色分组、设置角色菜单和数据权限、批量添加和移除角色员工。
3. 部门管理：配置部门，支持树形列表展示。
4. 权限管理：配置分组、菜单、操作、权限点、权限标识，支持树形列表展示。
5. 租户套餐：配置租户套餐，支持新增/移除套餐企业。
6. 租户管理：配置租户，新增租户时初始化部门、角色和管理员数据，支持租户配置套餐、禁用/启用功能。
7. 字典管理：配置字典，查看字典类型和字典数据列表，支持字典类型和字典数据维护。
8. 任务调度：查看任务和任务日志列表，支持任务新增、修改启动、执行、暂停、复制、查看日志等功能。
9. 缓存管理：缓存列表查询，支持根据缓存键清除缓存
10. 接口管理：配置接口，支持接口同步功能，用于新增权限点选择接口，支持树形列表展示。
11. 视图管理：配置视图，支持视图维护功能，用于新增菜单选择视图，支持树形列表展示。
12. 文件管理：支持文件列表查询、文件上传/下载、查看大图、复制文件地址、删除文件功能。
13. 登录日志：登录日志列表查询，记录用户登录成功和失败日志。
14. 操作日志：操作日志列表查询，记录用户操作正常和异常日志。

⚡ 使用说明

使用 .Net 最新版本 .Net 版本 >= 7.0+

使用项目源码新建项目

# 克隆项目
git clone https://github.com/zhontai/Admin.Core.git

# 进入项目
cd Admin.Core

# 打开项目
打开 ZhonTai.sln 解决方案

# 运行项目
设置 ZhonTai.Host 为启动项目 Ctrl + F5 直接编译运行项目
或 在 ZhonTai.Host 目录打开 cmd 输入 dotnet run 命令运行项目

# 打包发布
选择 ZhonTai.Host 右键菜单点击发布

使用项目模板新建项目

# 安装模板
dotnet new install ZhonTai.Template

# 查看帮助
dotnet new MyApp -h

# 新建项目
dotnet new MyApp -n MyCompanyName.MyProjectName

# 运行项目
设置 MyCompanyName.MyProjectName.Host 为启动项目 Ctrl + F5 直接编译运行项目
或 在 MyCompanyName.MyProjectName.Host 目录打开 cmd 输入 dotnet run 命令运行项目

# 打包发布
选择 MyCompanyName.MyProjectName.Host 右键菜单点击发布

📚 开发文档

• 查看开发文档：https://zhontai.net

💯 学习交流加 QQ 群

中台 admin 开发群（2000 人群）。

• QQ 群号：1058693879

  

💕 特别感谢

• FreeSql
• FreeRedis
• FreeSql.Cloud
• FreeScheduler

❤️ 鸣谢列表

• .Net
• Autofac
• Mapster
• DotNetCore.CAP
• NLog
• Yitter.IdGenerator
• Newtonsoft.Json
• Swashbuckle.AspNetCore
• FluentValidation.AspNetCore
• AspNetCore.Diagnostics.HealthChecks
• MiniProfiler
• IdentityServer4
• AspNetCoreRateLimit
• OnceMi.AspNetCore.OSS
• Lazy.SlideCaptcha.Core
• UAParser

💌 支持作者

如果觉得框架不错，或者已经在使用了，希望你可以去 Github 或者 Gitee 帮我点个 ⭐ Star，这将是对我极大的鼓励与支持。

admin.core's Issues

Mysql5.6.45下创建索引出错。

CREATE UNIQUE INDEX uk_document_image_documentid_url ON admindb.ad_document_image(DocumentId, Url);
Index column size too large. The maximum column size is 767 bytes.

新版事务回滚失效

DynamicApi的方法调用Service时 无法进入事务执行代码

接口数据权限问题

在处理接口数据权限时，UserService中GetDataPermissionAsync获取权限，但是第一次访问该方法已经设置了缓存，key是var key = CacheKeys.DataPermission + User.Id;，每次的key都一样，下次获取数据权限直接从缓存中获取了await Cache.GetOrSetAsync(key，...），即不会根据不同的接口apipath 去判断权限。

demo网站的日志管理里泄露访客ip真的没问题？

ip姑且是隐私吧？demo网站至少这点处理下吧

已搭建好前后端 ,运行 ,出现验证码问题

租户 独立数据库和独立分表，像没很好的实现

租户 独立数据库和独立分表，像没很好的实现

目前框架不支持使用字典进行动态更新，希望支持

目前框架不支持使用字典进行动态更新，例如下面这样写，会报错：
Dictionary<string, object> dic = new Dictionary<string, object>();
dic.Add("Id", user.Id);
dic.Add("ModifiedTime", DateTime.Now);
await _userRepository.Orm.UpdateDict(dic).AsTable("app_user").WherePrimary("Id").ExecuteAffrowsAsync();

报错的原因是在DbHelper文件的 AuditValue 【路径是：\src\platform.ZhonTai.Admin\Core\Db\DbHelper.cs】方法里面，e.Property 等于null

目前我是这样解决的

/// <summary>
/// 审计数据
/// </summary>
/// <param name="e"></param>
/// <param name="timeOffset"></param>
/// <param name="user"></param>
public static void AuditValue(AuditValueEventArgs e, TimeSpan timeOffset, IUser user)
{
    //处理使用字典更新时候，Property是空报错问题
    if (e.Property == null)
    {
        return;
    }

路由不能访问

http://localhost:8000/api/admin/auth/getverifycode?lastKey=

更改用户角色之后，用户权限缓存没有清理/更新

UserService==》UpdateAsync：
var key = string.Format(CacheKey.UserPermissions, user.Id);
await _cache.DelAsync(key);

线上遇到更新用户后调用GetDataPermissionAsync返回为空的问题

管理员 修改 (其他用户) 信息调用 UserService.UpdateAsync 后有一个 await Cache.DelAsync(CacheKeys.DataPermission + user.Id)
导致 (其他用户) 无法通过GetDataPermissionAsync 获取到信息

有代码生成器？

3.7.0升级5.1.3报错An exception was thrown while activating ZhonTai.Admin.Repositories.TaskExtRepository.

在配置前置服务时增加
AdminDbKeys.TaskDb = DbKeys.AppDb;
将taskDb和AppDb合并

修复vue3接口管理-上级接口不显示完整树菜单的问题

https://github.com/zhontai/Admin.Core/blob/56b57a2e5a39e7936b79aa1baded628e0a9982b2/ui/zhontai.ui.admin.vue3/src/views/admin/api/index.vue#L48C1-L48C110
此处应该修改为 :api-tree-data="state.apiTreeData" ，否则造成“上级接口”在二级菜单下时看不到完整树菜单的问题。

点几个菜单都很卡，原因未知

第一次进入后台，以前没访问过。

点员工管理，卡住很久(没有心理准备,没计算时间)才打开新tab，再次进入后台之后一切正常，无法重现。

直接点租户管理，卡住近10s才打开新tab，再次进入后台之后一切正常，无法重现。

后面的没点了。

换浏览器也无法重现，估计跟缓存有关？

Api接口怎么同步

显示成功, 但实际后台似乎是404? 这个应该改哪里

Readme介绍里clone地址错误

应为： git clone https://github.com/zhontai/Admin.Core.git

希望加入分布式和ci/cd

参考这个https://github.com/luoyunchong/lin-cms-dotnetcore
Docker
Azure DevOps

模板新建项目只有后端的

通过如下命令建的项目，里面没有前端代码。
dotnet new MyApp -n MyCompanyName.MyProjectName -md true -db MySql
希望加入前端代码

vue3缺少2个依赖，导致pnpm dev会报错

ui/zhontai.ui.admin.vue3/package.json里，缺少依赖：lodash-es和dayjs，导致pnpm dev下页面会报错。为了兼容pnpm，建议增加这2个依赖，谢谢。

get-permission-list 接口出错: Parameter '@cte_pid' must be defined.

使用项目模板 ZhonTai.Template v3.7.0 新建项目，运行，测试角色管理 -> 主管理员 - 设置菜单权限 出错：

前端展示：

后端控制台

后端日志：

同步接口未成功

同步未成功，控制台报错 。
http://localhost:8052/admin/swagger-resources 404

能看到系统的在线人员吗?

系统的当前在线人员能看到吗?

单文件发布有问题

单文件发布有问题

这里应该判断secretKey，而不是passwordEncryptKey

Admin.Core/Admin.Core.Services/Admin/Auth/AuthService.cs

Line 80 in 0e811e0

if (passwordEncryptKey.IsNull())

虽然不影响验证过程。

ZhonTai.Common.Helpers.ConfigHelper对路径的处理建议

public static IConfiguration Load(string fileName, string environmentName = "", bool optional = true, bool reloadOnChange = false)方法中在加载配置文件的时候,对文件名进行小写转换,对linux大小写敏感系统有潜在无法找到文件的风险.
var builder = new ConfigurationBuilder() .SetBasePath(filePath) .AddJsonFile(fileName.ToLower() + ".json", optional, reloadOnChange);
类似路径,文件相关的都适用这个建议

功能非常多真不容易

我也做了一个类似基础开发框架
https://github.com/neozhu/smartadmin.core.urf
功能没那么多，但很简单，小项目做做还是很快的

add 希望新增页面的水印能够是当前登录用户的用户名或唯一编码属性

希望页面水银功能能够支持绑定字段，绑定为当前登录用户的id或者其他主键，主要考虑的是数据的安全，防止系统数据被截图或拍摄传播

后台任务处理数据没有用户信息，更新会携带租户id条件导致无法更新

用了DisableGlobalFilter还是会携带租户id，后台任务没有用户信息状态，有什么不用改造admin的方法么？或者增加一个不携带租户id更新的入口？

列表点击编辑背景会闪一下，新增不会

错误信息状态码可否设置为非200状态码

现在ResultOutput.Exception 返回的状态码统一为200，但安全检测有时是根据状态码判断，200成功状态直接当漏洞注入成功。

请问项目是不是严重依赖freesql，有没有 办法搞个抽象剥离下，特别是事务那块。

cs文件文件编码

似乎不是所有文件的编码都是utf8的，最近几次提交的文件中混有936编码文件。

新增租户后，无法登录，提示 账号未分配权限

新增租户后，设置了租户的权限 但是无法登录租户端 提示 账号未分配权限。

有没有群号？大家加入一起学习

想问几个问题

使用模板生成项目初始化导入数据的密码和appconfig.json文件设置不一致

使用模板生成新项目，修改Host\Configs下的数据库链接，并保持generateData为false，直接运行项目vue3登录会发现密码123asd是错的，应该是111111。

TransactionInterceptor逻辑不支持嵌套事务。

FreeSql_Issues_问题.zip

我写一个demo，测试 这串代码 TransactionInterceptor
AutofacModule 目前使用的你这个项目中的逻辑。

  public class AutofacModule : Autofac.Module
    {
        protected override void Load(ContainerBuilder builder)
        {
            builder.RegisterType<TransactionInterceptor>();

            builder.RegisterType<BlogService>()
                .InterceptedBy(typeof(TransactionInterceptor))
                .EnableClassInterceptors();

            builder.RegisterType<TagService>().AsSelf()
                .InstancePerLifetimeScope()
                .InterceptedBy(typeof(TransactionInterceptor))
                .EnableClassInterceptors();

            //builder.RegisterType<UnitOfWorkInterceptor>();
            //builder.RegisterType<UnitOfWorkAsyncInterceptor>();

            //builder.RegisterType<BlogService>()
            //    .InterceptedBy(typeof(UnitOfWorkInterceptor))
            //    .EnableClassInterceptors();

            //builder.RegisterType<TagService>().AsSelf()
            //    .InstancePerLifetimeScope()
            //    .InterceptedBy(typeof(UnitOfWorkInterceptor))
            //    .EnableClassInterceptors();
        }
    }

然后多次调用这个接口，连接点击。就会报错了。

Swagger的建议

建议app.config里 增加个swagger折叠的配置

这个框架集成事件总线了吗？

你好，这个框架集成事件总线了吗？

Localization English Option

Hello can you allow english please

中台项目图片上传后不显示问题

参考个人头像上传的功能，然后给其他的栏目做图片上传，图片上传成功，然后路径也正确，但图片显示不出来，请赐教！