介绍
Easy.Admin 是什么
-
这是一套基于 aspnetcore 的通用权限框架,前后端分离方式。仅包含用户、角色、菜单这三个功能。包含日志、orm、缓存、api 文档生成以及常用开发小工具。
-
Easy.Admin 提供了基础设施如:异常拦截、统一响应结果、自定义模型绑定等。除此之外的功能大部分由NewLifex.XCode提供。
特点
起步
- 分别克隆前后端项目,注意是克隆而不是下载,否则会给后面带来麻烦。
git clone https://github.com/xxred/Easy.Admin.git
git clone https://github.com/xxred/Easy.Front-End.git
- 趁着克隆期间,下载前端环境,nodejs,安装完之后验证 node 版本以及安装 yarn。
node -v
npm -v
npm install -g yarn
-
项目下载完之后,进入前端项目执行命令
yarn
还原前端项目包。 -
运行后端项目,后端项目会自动运行前端项目,因此要保证前端项目路径配置正确。配置位于 appsettings.Development.json 的
ClientAppSourcePath
项,去掉此项则不运行前端项目,前端项目可单独跑。 -
如果后端项目运行时代码报错 IIS 没有启用,请点击带有绿色图标运行按钮内右边的箭头,下拉选择 Easy.Admin 再运行。如果后端项目已经运行,swagger 能访问,页面不能访问且报错包含
npm
,请检查前端项目路径配置是否正确,以及是否还原前端项目包
前置学习参考
-
后端大部分功能包含在 NewLife.XCode,特别是数据库操作部分,系列教程参考:https://www.cnblogs.com/nnhy/p/xcode_curd.html
例程参考
-
上文提到的添加控制器和公共模板,参考NewLife.IdentityServer4
-
公共页面模板以及模板替换参考,NewLife.IdentityServer4.Vue