diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js index 3d57af26..a0515914 100644 --- a/docs/.vuepress/config.js +++ b/docs/.vuepress/config.js @@ -1,7 +1,7 @@ /* * @Author: yubaolee | ahfu~ <954478625@qq.com> * @Date: 2023-08-12 10:48:24 - * @LastEditTime: 2025-04-09 16:16:23 + * @LastEditTime: 2025-04-09 20:38:14 * @Description: * @ * @Copyright (c) 2023 by yubaolee | ahfu~ , All Rights Reserved. @@ -104,7 +104,12 @@ module.exports = { collapsable: false, children: ['moduleauth','apiauth', 'logininfo', 'dataprivilege', 'datapropertyrule'], }, - 'form', + { + title: '表单设计', // 必要的 + sidebarDepth: 1, // 可选的, 默认值是 1 + collapsable: false, + children: ['form'], + }, { title: '工作流', // 必要的 sidebarDepth: 1, // 可选的, 默认值是 1 @@ -181,11 +186,7 @@ module.exports = { }, 'components', 'faq', - ], - - '/net/': [ - ['', '项目介绍'], 'start', 'deploy', 'devnew' - ], + ] }, }, } \ No newline at end of file diff --git a/docs/core/start.md b/docs/core/start.md index c9088099..01e6b4e0 100644 --- a/docs/core/start.md +++ b/docs/core/start.md @@ -10,10 +10,6 @@ gitee上面两个版本。其中： .Net目前SDK升级特别方便。请参考：[3分钟的时间把.net core 3.1的升级到.NET 5](https://www.cnblogs.com/yubaolee/p/Net3ToNet5.html)，所以不要纠结SDK版本问题。 -::: tip 提示 -如果你使用的是.Net 4.0/4.5,请点击[这里](https://gitee.com/dotnetchina/OpenAuth.Net/tree/4.0) 下载后端代码，该分支已停止维护。参考文档：[http://doc.openauth.net.cn/net/](http://doc.openauth.net.cn/net/) - -::: ## 安装sdk diff --git a/docs/net/README.md b/docs/net/README.md deleted file mode 100644 index c9d91a45..00000000 --- a/docs/net/README.md +++ /dev/null @@ -1,40 +0,0 @@ -::: danger 郑重提示 - -本文档是针对[OpenAuth.Net 4.0分支](https://gitee.com/yubaolee/OpenAuth.Net/tree/4.0/)（基于.Net 4.5开发环境），如果你是用.Net Core 3.1/.Net 5/6/7..或以后版本开发环境，请移步 [.net core版本](/core)文档。 - -::: - -OpenAuth.Net 4.0分支是基于 **.Net Framework 4.5** 的开源权限工作流快速开发框架（主分支已经更新为.Net最新跨平台开发环境）。框架基于Martin Fowler企业级应用开发思想及全新技术组合（Asp.Net MVC、EF、AutoFac、WebAPI、Swagger、Json.Net等），核心模块包括：组织机构、角色用户、权限授权、表单设计、工作流等。它的架构精良易于扩展，是中小企业的首选。 - -## 特性 - -采用经典DDD架构,每一行代码都经过深思熟虑，符合SOLID规则！ - -符合国情的RBAC（基于角色的访问控制），可以直接应用到你的系统。 - -1. 菜单权限 经理和业务员登陆系统拥有的功能菜单是不一样的 -1. 按钮权限 经理能够审批，而业务员不可以 -1. 数据权限 A业务员看不到B业务员的单据 -1. 字段权限 某些人查询客户信息时看不到客户的手机号或其它字段 - -**用户**应用系统的具体操作者，我这里设计用户是可以直接给用户分配菜单/按钮，也可以通过角色分配权限。 - -**角色**为了对许多拥有相似权限的用户进行分类管理，定义了角色的概念，以上所有的权限资源都可以分配给角色，角色和用户N:N的关系。 - -**机构**树形的公司部门结构，国内公司用的比较多，它实际上就是一个用户组，机构和用户设计成N:N的关系，也就是说有时候一个用户可以从属于两个部门，这种情况在我们客户需求中的确都出现过。 - -## 技术栈 -* 前端 vue + layui + ztree + gooflow + leipiformdesign -* 后端 asp.net mvc + Web API + EF + autofac + swagger + json.net -* 代码生成工具 CodeSmith -* 设计工具 PowerDesigner + Enterprise Architect - -## 系统工程结构： -1. OpenAuth.Repository 系统仓储层，用于数据库操作 -1. OpenAuth.App 应用层，为界面提供接口 -1. OpenAuth.Mvc Web站点 -1. OpenAuth.UnitTest 单元测试 -1. Infrastructure 通用工具集合 -1. OpenAuth.WebApi SSO服务及为第三方提供接口服务 - - diff --git a/docs/net/deploy.md b/docs/net/deploy.md deleted file mode 100644 index 6be44e2f..00000000 --- a/docs/net/deploy.md +++ /dev/null @@ -1,32 +0,0 @@ -# 发布部署 - -直接使用Visual Studio的发布功能，发布到对应的文件夹 - -* OpenAuth.Mvc发布 - -![](/dotnetdeploy.png) - -* OpenAuth.WebApi发布 - -![](/dotnetapideploy.png) - - - -然后把对应的发布文件部署到IIS下。成功后直接访问： - -* [http://localhost:56813](http://localhost:56813) 为项目的主界面，对应OpenAuth.Mvc项目。如下图所示： -![说明](https://gitee.com/uploads/images/2018/0328/150659_6900820e_362401.png "说明") - -* [http://localhost:52789/Swagger/ui/index](http://localhost:52789/Swagger/ui/index) 为项目WebApi接口部分，对应OpenAuth.WebApi项目，主要为其他项目提供数据接口及为OpenAuth.Mvc提供单点登录SSO功能。这是一个纯WebAPI项目，本身是没有界面的（所以3.0以前的版本会报找不到页面的错误），为了美观，增加了swagger的支持！ -![](/donetswagger.png) - - - -::: warning 提别提醒 - -如果WebApi不是使用的52789端口，需要在OpenAuth.Mvc的Web.config中修改下面配置： - -```xml - -``` -::: diff --git a/docs/net/devnew.md b/docs/net/devnew.md deleted file mode 100644 index e7d9c7e6..00000000 --- a/docs/net/devnew.md +++ /dev/null @@ -1,61 +0,0 @@ -# 添加新模块 - -本章节以项目自带的数据库OpenAuthDB中Stock表为基础介绍如何添加一个新模块，并对新模块进行授权等操作。 - -暂且为该模块命名为`仓库管理`,现在开始： - -## 编写代码 - - * 使用CodeSmith生成数据库实体访问代码，用于操作数据库 - - * 使用CodeSmith Generator Studio 打开Openauth.Net项目中CodeSmith文件夹。 - - ![](http://119.84.146.233:8887/upload_files/190110171420673.png " ") - - * 右建Entity.cst，选择Execute。弹出数据库的相关配置。 - - * 配置连接字符串SourceDatabase、Class命名空间的及Output输出文件夹。 - - * 点击`Generate`生成代码，生成后代码在`X:\~~\OpenAuth.Net\CodeSmith\CSharp`文件夹中。 - - * 将生成的代码按上图红色箭头的指示复制到项目中。可以只复制`Entities\Stock.cs`、`Mapping\StockMap.cs`、`OpenAuthDBContext.cs` - - * 使用CodeSmith生成界面及逻辑代码 - - * 右建WebGenerate.cst，选择Execute。弹出数据库的相关配置。 - - * 选择数据库中Stock表，其他配置不变。 - - ![](http://119.84.146.233:8887/upload_files/190110171420676.png "") - - * 点击`Generate`生成代码，生成后代码在`X:\~~\OpenAuth.Net\CodeSmith\CSharp`文件夹中。 - - ![](http://119.84.146.233:8887/upload_files/190110171757977.png "") - - * 生成的代码严格按照应用层APP、控制器controllers、用户界面views、用户界面脚本userJs划分。将生成的代码复制到项目对应的文件夹中。 - - * 在visual studio中根据自己的业务做简单的调整，然后编译生成。即完成了一个新模块的开发。 - - `注意` 使用代码生成器适用于大批量简单逻辑的代码生成，复杂逻辑可以基于现有代码直接手动修改。 - -## 创建模块 - - * 添加模块 - - ![](http://119.84.146.233:8887/upload_files/190110172049261.png) - - `注意` 模块标识必须和模块的controller一致，否则模块不能正常加载 - - * 添加菜单 - - ![](http://www.openauth.net.cn/upload/180523111946327.png) - - 默认的domId有`btnAdd`、`btnEdit`、`btnDel`可以参考`userJs\stocks.js`中的代码定义 - - * 授权 - - 模块添加成功后，如果用的是System账号，退出重新登陆即可看到新加的模块。如果为其他角色分配模块，按照下面的方式： - -![](http://119.84.146.233:8887/upload_files/190110172339544.png) - - 以上就是一个普通模块开发的全过程，是不是so easy🙂，快下载代码体验吧！ \ No newline at end of file diff --git a/docs/net/start.md b/docs/net/start.md deleted file mode 100644 index 431f6d90..00000000 --- a/docs/net/start.md +++ /dev/null @@ -1,62 +0,0 @@ -# 快速开始 - -## 下载代码 - -使用git工具下载代码，代码地址：https://gitee.com/yubaolee/OpenAuth.Net.git - -## 修改连接字符串 - -* 修改OpenAuth.Mvc/Web.config连接字符串，如下： -```xml - -``` - -* 修改OpenAuth.WebApi/Web.config连接字符串,如下： -```xml - -``` - -## 设置启动项 - -在vs解决方案视图中，右键解决方案“OpenAuth”属性，调整启动项，如下： -![设置启动项](/dotnetstart.png "设置启动项") - -::: warning 提别提醒 - -很多人启动的时候会遇到下面这个异常 - -![](/starterror.png) - -99.9999%的人是因为没有启动OpenAuth.WebApi项目造成的。务必按上面进行启动项设置🙂 -::: - -## 编译运行 - -使用Visual Studio菜单栏中的【启动】按钮或快捷键F5，启动运行。 -`注：首次启动时，visual studio会启动nuget还原第三方依赖包，请保持网络通畅，并等待一段时间` - -启动成功后，可以在浏览器访问两个网址： - -* [http://localhost:56813](http://localhost:56813) 为项目的主界面，对应OpenAuth.Mvc项目。如下图所示： -![说明](https://gitee.com/uploads/images/2018/0328/150659_6900820e_362401.png "说明") - -* [http://localhost:52789/Swagger/ui/index](http://localhost:52789/Swagger/ui/index) 为项目WebApi接口部分，对应OpenAuth.WebApi项目，主要为其他项目提供数据接口及为OpenAuth.Mvc提供单点登录SSO功能。这是一个纯WebAPI项目，本身是没有界面的（所以3.0以前的版本会报找不到页面的错误），为了美观，增加了swagger的支持！ -![](/donetswagger.png) - - -::: warning 提别提醒 - -如果WebApi不是使用的52789端口，需要在OpenAuth.Mvc的Web.config中修改下面配置： - -```xml - -``` -::: - - - -## 更多文档 - -如需更多文档请点击[这里](http://openauth.net.cn/question/detail.html?id=a2be2d61-7fcb-4df8-8be2-9f296c22a89c) - -![更多文档](http://demo.openauth.net.cn:8887/upload_files/200415002234330.png "更多文档") \ No newline at end of file