Awesome

Util平台介绍

Util应用框架是一组类库,它们提供了有用的功能.

虽然Util配套代码生成器能够帮助你创建项目基架,但直接使用它们的成本依然高昂.

第一个挡在前面的障碍是权限功能,它是任何业务项目的基石.

为了减轻使用Util应用框架的负担,我们创建了该项目, 名为 Util Platform, 即 Util平台.

Util平台处于起步阶段,目前提供了基于资源和角色的权限模块,可以控制前端菜单和按钮,并能同时控制API的访问.

后续将持续更新,添加更多基础功能.

开源协议: MIT

可以在商业项目随意使用.

欢迎参与贡献

你如果感兴趣,可以参与该项目的开发, 共同创建基础业务功能,为 .NET 生态添砖加瓦.

Util应用框架交流QQ群(24791014)

Util平台项目介绍

为了满足单体架构和微服务架构的需求, Util平台分为三套项目.

Util.Platform.Single

Util.Platform.Single 是Util平台单体架构版本.
Util.Platform.Dapr

Util.Platform.Dapr 是Util平台微服务架构版本.
Util.Platform.Share

Util.Platform.Share 是Util平台的共享库,抽取单体架构版本和微服务架构版本的共享代码,并发布到Nuget供两个版本使用.

Util平台功能列表

系统功能
- 登录
- 退出登录
权限管理模块
- 应用程序管理
- 声明管理
- 资源管理
  - 模块资源管理
  - 操作资源管理
  - 身份资源管理
  - Api资源管理
- 用户管理
- 角色管理
  - 将用户添加到角色
  - 从角色移除用户
- 权限管理
  - 授予角色操作权限
  - 拒绝角色操作权限
  - 授予角色API权限
  - 拒绝角色API权限

开发指南

开发环境说明
- 开发工具使用 VS , Rider , VS Code 均可.
  - 如果使用 VS Code, 安装 .Net 默认推荐插件即可, 无需安装其它插件.
- 安装 .Net 8 SDK .
- 安装 NodeJs.
- 开启 Yarn.
- 为避免开发环境搭建麻烦, 本项目已使用 Sqlite 作为默认开发数据库,无需安装任何数据库即可运行.
- 开发环境搭建可参考之前的文章: https://zhuanlan.zhihu.com/p/663947596
运行说明
- 进入项目路径 src\Util.Platform.Api 运行命令 dotnet watch run, 启动 Web Api.
  - 如果看到 Swagger 界面,则表示启动成功.
- 进入项目路径 src\Util.Platform.Ui 运行命令 dotnet run, 启动 UI.
  - 注意: 不要使用 dotnet watch run 命令.
  - dotnet run 运行时,会自动运行 yarn 和 npm start 命令,无需单独执行.
  - 第一次运行时,将还原 npm 包,需要较长时间, 请保障 yarn 命令可用.
  - npm 包还原成功后, 将启动 Angular 服务器.
  - 如果看到消息 Local: http://localhost:6003/ ,则表示前端已启动成功 .
- 手工打开浏览器,并输入 https://localhost:16003
  - 由于 dotnet run 命令不会自动打开浏览器,需要手工打开浏览器.
  - 注意: 打开的地址为 https://localhost:16003
  - 注意: http://localhost:6003/ 是Angular 服务器的地址,不要访问它.
- 如果顺利,现在 Web Api 和 UI 都已经运行,进入UI会将浏览器定向到登录页面.
  - 使用管理员 admin 登录, 密码为 admin.
  - 也可使用测试用户 test 登录, 密码为 test .
- 登录成功, 将进入管理后台.
- 开发说明
  - 编辑 .cshtml 文件和 .ts 文件,将会自动刷新浏览器.
  - 其它操作与原生 angular 应用相同.

Nuget包

包名	版本	下载量
Util.Platform.Share.Apps
Util.Platform.Share.Infrastructure
Util.Platform.Share.Middlewares
Util.Platform.Share.Tools
Util.Platform.Share.Ui.TagHelper
Util.Platform.Share.Identity.Application
Util.Platform.Share.Identity.Common
Util.Platform.Share.Identity.Data
Util.Platform.Share.Identity.Domain
Util.Platform.Share.Identity.Dtos
Util.Platform.Share.Identity.Queries
Util.Platform.Share.Identity.IdentityServer