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

Npm包

包名	版本	下载量
util-platform
util-platform-identity