Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/2881099/adminblazor

AdminBlazor 是一款 Blazor Server SaaS 后台管理项目，支持 RABC 权限菜单/按钮，支持一对一、一对多、多对多代码生成 .razor 界面。集成功能：菜单、角色、用户、定时任务、数据字典、租户依赖组件：BootstrapBlazor、FreeSql
https://github.com/2881099/adminblazor

admin blazor management-system saas

Last synced: 4 days ago
JSON representation

AdminBlazor 是一款 Blazor Server SaaS 后台管理项目，支持 RABC 权限菜单/按钮，支持一对一、一对多、多对多代码生成 .razor 界面。集成功能：菜单、角色、用户、定时任务、数据字典、租户依赖组件：BootstrapBlazor、FreeSql

Host: GitHub
URL: https://github.com/2881099/adminblazor
Owner: 2881099
License: apache-2.0
Created: 2024-01-31T04:45:11.000Z (12 months ago)
Default Branch: master
Last Pushed: 2024-12-27T10:41:55.000Z (25 days ago)
Last Synced: 2024-12-27T11:09:26.234Z (25 days ago)
Topics: admin, blazor, management-system, saas
Language: HTML
Homepage:
Size: 3.41 MB
Stars: 69
Watchers: 3
Forks: 18
Open Issues: 11
Metadata Files:
- Readme: readme.md
- License: LICENSE

Awesome Lists containing this project

README

        ## 项目介绍

AdminBlazor 是一款 Blazor Server SaaS 后台管理项目，支持 RABC 权限菜单/按钮，支持一对一、一对多、多对多代码生成 .razor 界面。

集成功能：菜单、角色、用户、定时任务、数据字典、租户

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

## 快速开始

1. 安装模板

> dotnet new install AdminBlazor.Template

2. 新建项目

> dotnet new admin

3. 运行访问

> http://localhost:5231/Admin

用户名：admin 密码：freesql

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

![image](Images/01.png)

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

- 实体上的注释，会生成 HTML Label

- 实体上的导航属性，会生成丰富的 UI

- 创建实体类型，建议继承 Entity/EntityCreated/EntityModifed

![image](Images/02.png)

## 权限

- UserEntity 多对多 RoleEntity

- RoleEntity 多对多 MenuEntity

提示：AdminContext 类型已注入为 Scoped

```csharp

class AdminContext

{

    public IServiceProvider Service { get; }

    public UserEntity User { get; set; }

    public List Roles { get; }

    public List RoleMenus { get; }

    //路由、按钮权限验证

    public Task AuthPath(string path);

    public Task AuthButton(string path)

}

```

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

```csharp

[AdminButton("name")]

void ButtonClick()

{

}

```

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

![image](Images/03.png)

## 租户

提示：AdminContext 类型已注入为 Scoped

```csharp

class AdminContext

{

    public IServiceProvider Service { get; }

    public TenantEntity Tenant { get; }

}

```

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

- 访问租户：IFreeSql/IAggregateRootRepository\

- 访问主库：FreeSqlCloud

> FreeSqlCloud API 访问方式与 IFreeSql 一样

> IAggregateRootRepository 是级联操作友好的仓储模式

![image](Images/04.png)

## 定时任务

```csharp

[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\

> 使用 FreeSql 对实体类型 TItem 增删改查

| 名称 | 说明 |

| --- | --- |

| bool IsDebug | 打开UI调试 |

| string Title | 标题，弹框时 |

| int PageSize | 分页，值 -1 时不分开 |

| bool IsQueryString | 查询条件与 URL QueryString 同步 |

| bool IsRemove | 开启删除 |

| bool IsRowRemove | 开启删除（表格每行） |

| bool IsAdd | 开启添加 |

| bool IsEdit | 开启编辑 |

| bool IsRefersh | 开启刷新 |

| bool IsSearchText | 开启文本搜索 |

| bool IsSingleSelect | 开启单选 |

| bool IsMultiSelect | 开启多选 |

| bool IsConfirmEdit | 开启编辑保存时，弹框确认 |

| bool IsConfirmRemove | 开启删除时，弹框确认 |

| int Colspan | 表格一行显示几条记录 |

| int BodyHeight | 表格高度 |

| string DialogClassName | 弹框样式 |

| Func\ InitQuery | 初始化查询 |

| EventCallback\\> OnQuery | 正在查询，设置条件 |

| EventCallback\ OnEdit | 正在编辑，设置编辑对象 |

| EventCallback\\> OnRemove | 正在删除 |

| EventCallback\\>\> OnSelectChanged | 选择内容发生变化 |

| EventCallback\\> OnRowClick | 单击表格行时 |

| RenderFragment TableHeader | 表格 TR 模板 |

| RenderFragment\ TableRow | 表格 TD 模板 |

| RenderFragment\ EditTemplate | 添加/编辑 模板 |

| RenderFragment CardHeader | 卡片 Header 模板 |

| RenderFragment CardFooter | 卡片 Fotter 模板 |

### 2. 弹框分配 AllocTable2\

> 弹框分配实体类型 TItem 【多对多】导航属性

| 名称 | 说明 |

| --- | --- |

| TItem Item | 被分配的对象 |

| string ChildProperty | 被分配的对象的 List<TChild> 属性 |

| string Title | 标题 |

| EventCallback\ ItemChanged | 分配变化时 |

| int PageSize | TChild 分页，值 -1 时不分页 |

| bool IsSearchText | TChild 开启文本搜索 |

| EventCallback\\> OnQuery | TChild 正在查询，设置条件 |

| RenderFragment TableHeader | TChild 表格 TR 模板 |

| RenderFragment\ TableRow | TChild 表格 TD 模板 |

### 3. 文本框 InputTable2\

> 文本框 + 按钮弹框绑定 【多对一】、【多对多】导航属性

| 名称 | 说明 |

| --- | --- |

| TKey Value | 值 |

| EventCallback\ OnValueChanged | 值变化时 |

| TItem Item | 【多对一】导航属性 |

| EventCallback\ OnItemChanged | 【多对一】导航属性变化时 |

| TItem Items | 【多对多】导航属性 |

| EventCallback\ OnItemsChanged | 【多对多】导航属性变化时 |

| Func\ DisplayText | 文本框显示内容 |

| string ModalTitle | 弹框标题 |

| int PageSize | 弹框 分页，值 -1 时不分页 |

| bool IsSearchText | 弹框 开启文本搜索 |

| RenderFragment TableHeader | 弹框 表格 TR 模板 |

| RenderFragment\ TableRow | 弹框 表格 TD 模板 |

### 4. 单选/多选 SelectTable2\

| 名称 | 说明 |

| --- | --- |

| TKey Value | 值 |

| EventCallback\ OnValueChanged | 值变化时 |

| TItem Items | 【多对多】导航属性 |

| EventCallback\ OnItemsChanged | 【多对多】导航属性变化时 |

| int PageSize | 分页，值 -1 时不分页 |

| bool IsSearchText | 开启文本搜索 |

| RenderFragment\ ChildContent | 内容模板 |

### 5. 弹框 AdminModal

| 名称 | 说明 |

| --- | --- |

| string Title | 标题 |

| bool Visible | 是否显示 |

| bool IsBackdropStatic | 是否静态模式 |

| bool IsKeyboard | 是否接受 ESC 关闭 |

| string DialogClassName | 弹框样式，如：modal-sm、modal-lg、modal-xl、modal-xxl、modal-fullscreen |

| string YesButton | 确认按钮 |

| string CloseButton | 关闭按钮 |

| EventCallback\ OnYes | 确认时 |

| EventCallback\ OnClose | 关闭时 |

| RenderFragment ChildContent | 内容模板 |