说明文档备份地址: https://www.jianshu.com/p/a218d710bde6

欢迎加入Q群:275110998

0 介绍BoYuanCore框架

项目介绍 实现页面权限基于权限角色的后台框架，配套完善代码生成工具，可开箱即用，适用于中小型项目快速开发。 项目为.Net Core 3.1或.Net 5，使用简单的service分层架构，前端为FineUICore , 数据层使用FreeSql ORM+雪花算法实体模式，兼容各种不同的数据库迁移(支持的数据库：SqlServer, Mysql, Postgresql, Oracle 等)，并有完善的异常拦截写入日志功能。 优秀的编码体验，层次分明，简单易学，从而实现快速开发的目的，或入门学习.Net Core。 建议使用vs2019以上版本开发工具 ，数据库随意。

平时在工作或学习中，受到的FineUI和FreeSql帮助比较大，特此开源自己的项目底层架构，分享开源精神。如果对您有所有帮助，给项目点上星星，支持下开源作者。

FineUI 特点 企业级 ASP.NET UI 控件库,基于jquery实现。封装了很多常用的功能，少写很多js和css便于快速开发后台或软件管理等项目，是一个很不错的工具框架。

演示地址 https://core.fineui.com

FreeSql 特点 可能是史上最全面和稳定的ORM框架，个人认为没有之一。社区活跃，有bug不过夜，各种骚套路玩法可满足任何人不同的口味。强烈推荐大家了解下FreeSql

官网地址 https://github.com/dotnetcore/FreeSql (推荐大家看看wiki和issues)

1 下载FineUI相关框架组件。

由于版权限制，本框架需要到知识星球载FineUIPro.dll 和 FineUICore.dll这2个文件。注意知识星球是需要付费入场，入场后可以随意免费下载fineui基础版相关控件，并可以永久使用。 知识星球地址：

https://t.zsxq.com/beiMfMB

知识星球首页置顶可以下载相关dll

2 下载BoYuanCore项目，并配置

如果有问题或建议欢迎到gitee上留言。gitee有联系方式，BoYuanCore项目地址如下：

https://gitee.com/sundayisblue/BoYuanCore

下载项目后，需要重新引用FineUIPro.dll 和 FineUICore.dll。

[删除FineUICore引用，并重新引用FineUICore.dll]

[删除FineUICore引用，并重新引用FineUICore.dll]

[删除FineUIPro引用，并重新引用FineUIPro.dll]

[右键项目浏览添加引用FineUIPro.dll或引用FineUICore.dll]

加载完成后，重新生成解决方案。初次生成可能有些慢，需要从nuget下载相关组件dll。

接下来配置资源文件res文件相关。在项目doc文件夹里，解压res.7z。 [解压res.7z资源文件]

复制res到项目 BoYuanCore.Web\wwwroot 和 BoYuanCore.CodeGenerator 文件夹里

[BoYuanCore.Web\wwwroot]

[BoYuanCore.CodeGenerator]

至此项目配置完成。

注意 res文件夹不要包含在项目里(由于res文件太多，编译会很慢)，发布项目时候手动复制到服务器环境里。

3 创建项目数据库

重新生成解决方案后没有异常后，先运行代码生成工具，如下图 [先启动BoYuanCore.CodeGenerator项目]

代码生成工具是fineuipro，webform架构，这种webform开发快，不影响主业务项目。

创建数据库，如下图选择数据库，填写连接字符串，点击即可完成创建。 [创建数据库基础表结构]

4 使用代码生成工具

作为示例创建一个新的表，以Sql server数据库为例创建news表。主键id设置为bigint(对应C#是long类型，雪花主键必须以long为主键，用雪花主键方便数据库做迁移)，非自增。 [创建news表结构]

在代码生成工具中，先连接数据库，选择要生成实体的表news，最后点击生成代码。不建议直接把代码直接生成到项目里，怕不小心覆盖，默认在C盘code文件夹下，手动加入到项目里比较好。 [生成对应数据库的实体模型]

[手动加入entity模型]

同样选择数据库相关表，点击生成简单代码，在C盘生成相关页面代码。 [生成页面代码，也可以预览单页代码]

[把生成的页面代码复制到项目路径下]

[创建后的页面代码]

至此所有代码生成完成。

5 运行Core项目

这里我们选择core的启动项目方式(非iis方式，推荐core启动方式) [选择core的启动]

启动后，会有登录页面 用户名admin 默认密码是123456。core启动方式会有控制台显示，方便查看运行时的日志，包括运行的sql等。 [登录页面显示]

[首页显示]

添加页面组件。右键顶点，是添加根目录。右键文件夹可以添加子页面。 [添加页面组件]

[添加子页面]

创建权限角色 [创建权限角色-新闻编辑角色]

添加用户，并给于新闻编辑权限角色 [添加用户]

用新用户登录后界面显示

自己试试CURD功能吧。

6 更改数据库类型

代码生成工具的数据库类型不需要更改，有下拉框选项自己设置即可。

如果是项目需要，更改数据库类型，比如说sqlserver 改成 oracle mysql pgsql 等(如下图)，并在appsetting.json更改对应数据类的连接字符串即可。

7 如果页面提示错误码: xxxxxxxxxxxxxxxx ,请在项目根目录下logs文件里，找对应的错误log，即可知道bug。

如果觉得对您有所帮助，欢迎您点亮star或您支持下作者