AdminBlazor 2.5.7

项目介绍

AdminBlazor 是一款 Blazor Server SaaS 中台项目，支持 RABC 权限菜单/按钮，支持快速代码生成一对一、一对多、多对多导航属性的 .razor 界面。

集成功能：菜单、角色、用户、公司组织、定时任务、数据字典、参数配置、租户、审批、审计、OSS文件管理

依赖组件：BootstrapBlazor、FreeSql、FreeScheduler、Rougamo

• 老版本: https://gitee.com/FreeSql/AdminBlazor
• 新版本：暂不开源（商业技术支持）

快速开始

1. 安装模板

dotnet new install AdminBlazor.Template

2. 新建项目

dotnet new admin

项目结构简洁（没有过多的分层）

3. 运行访问

http://localhost:5231

用户名：admin 密码：admin

4. 新建菜单，类型选择增删改查

5. 生成代码，在实体类型维护注释、导航属性

• 实体上的注释，会生成 HTML Label
• 实体上的导航属性，会生成丰富的 UI
• 创建实体类型，建议继承 Entity/EntityCreated/EntityModifed/EntityAudited

权限

• SysUser 多对多 SysRole
• SysRole 多对多 SysMenu

提示：AdminContext 类型已注入为 Scoped

class AdminContext
{
 public IServiceProvider Service { get; }
 public SysUser User { get; set; }
 public List<SysRole> Roles { get; }
 public List<SysMenus> RoleMenus { get; }

 //路由、按钮权限验证
 public bool AuthPath(string path);
 public bool AuthButton(string path)
}

按钮权限，在 razor 中设置特性：

[AdminButton("name")]
void ButtonClick()
{
}

//或者 webapi
[Route("api/菜单路径")]
class XxxController : ControllerBase
{
 [HttpGet("@name")]
 public JsonResult ButtonClick()
 {
 }
}

之后菜单管理，会出现对应的按钮项，勾选设置角色是否有按钮的权限。

审批

• 实体类继承 EntityAudited
• 菜单编辑选择 【审批】

• 待提交/反审，可修改/删除
• 审核中/通过，已锁定业务数据，不可修改/删除
• EntityAudited 带版本功能、审计历史变化，且多端无法同时编辑（提示正在被[admin]编辑）

租户

提示：AdminContext 类型已注入为 Scoped

class AdminContext
{
 public IServiceProvider Service { get; }
 public SysTenant Tenant { get; }
}

每个租户独立数据库，注入方式：

• 访问租户：IFreeSql/IAggregateRootRepository<T>
• 访问主库：FreeSqlCloud

FreeSqlCloud API 访问方式与 IFreeSql 一样 IAggregateRootRepository 是级联操作友好的仓储模式

定时任务

[Scheduler("任务1", "0/30 * * * * *")]
static void Scheduler001()
{
 System.Console.WriteLine("任务1 被触发...");
}

[Scheduler("任务2", Interval = TaskInterval.SEC, Argument = "10")]
static void Scheduler002(IServiceProvider service, TaskInfo task)
{
 System.Console.WriteLine("任务2 被触发...");
}

//运行时 scheduler.AddTask("任务3"...)
[Scheduler("任务3")]
static void Scheduler003()
{
 System.Console.WriteLine("任务3 被触发...");
}

组件

以下几个是 AdminBlazor 封装的组件，更多丰富的 UI 组件可以看：BootstrapBlazor

1. 增删改查 AdminTable2<TItem>

2. 弹框 AdminModal

3. 其他

<SelectDict ParentName="WLPZ" @bind-Value="item.xxx" />

<SelectEntity TItem="Classify" TKey="long?" @bind-Value="item.ClassifyId" DisplayText="e => e.ClassifyName" />

<SelectEnum TEnum="ArticleType" @bind-Value="item.ArticleType" />

<InputFile2 @bind-Value="item.Path" />

4. 更多参考 blazor.zone

Bootstrap Blazor UI