mirror of
https://gitee.com/dotnetchina/OpenAuth.Net.git
synced 2025-11-08 02:14:44 +08:00
docs: 删除.net 4.0的文档
This commit is contained in:
wintel
@@ -1,7 +1,7 @@
|
||||
/*
|
||||
* @Author: yubaolee <yubaolee@163.com> | 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'
|
||||
],
|
||||
]
|
||||
},
|
||||
},
|
||||
}
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -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服务及为第三方提供接口服务
|
||||
|
||||
|
||||
@@ -1,32 +0,0 @@
|
||||
# 发布部署
|
||||
|
||||
直接使用Visual Studio的发布功能，发布到对应的文件夹
|
||||
|
||||
* OpenAuth.Mvc发布
|
||||
|
||||
|
||||
|
||||
* OpenAuth.WebApi发布
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
然后把对应的发布文件部署到IIS下。成功后直接访问：
|
||||
|
||||
* [http://localhost:56813](http://localhost:56813) 为项目的主界面，对应OpenAuth.Mvc项目。如下图所示：
|
||||
|
||||
|
||||
* [http://localhost:52789/Swagger/ui/index](http://localhost:52789/Swagger/ui/index) 为项目WebApi接口部分，对应OpenAuth.WebApi项目，主要为其他项目提供数据接口及为OpenAuth.Mvc提供单点登录SSO功能。这是一个纯WebAPI项目，本身是没有界面的（所以3.0以前的版本会报找不到页面的错误），为了美观，增加了swagger的支持！
|
||||
|
||||
|
||||
|
||||
|
||||
::: warning 提别提醒
|
||||
|
||||
如果WebApi不是使用的52789端口，需要在OpenAuth.Mvc的Web.config中修改下面配置：
|
||||
|
||||
```xml
|
||||
<add key="SSOPassport" value="http://localhost:你的端口号" />
|
||||
```
|
||||
:::
|
||||
@@ -1,61 +0,0 @@
|
||||
# 添加新模块
|
||||
|
||||
本章节以项目自带的数据库OpenAuthDB中Stock表为基础介绍如何添加一个新模块，并对新模块进行授权等操作。
|
||||
|
||||
暂且为该模块命名为`仓库管理`,现在开始：
|
||||
|
||||
## 编写代码
|
||||
|
||||
* 使用CodeSmith生成数据库实体访问代码，用于操作数据库
|
||||
|
||||
* 使用CodeSmith Generator Studio 打开Openauth.Net项目中CodeSmith文件夹。
|
||||
|
||||
|
||||
|
||||
* 右建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表，其他配置不变。
|
||||
|
||||
|
||||
|
||||
* 点击`Generate`生成代码，生成后代码在`X:\~~\OpenAuth.Net\CodeSmith\CSharp`文件夹中。
|
||||
|
||||
|
||||
|
||||
* 生成的代码严格按照应用层APP、控制器controllers、用户界面views、用户界面脚本userJs划分。将生成的代码复制到项目对应的文件夹中。
|
||||
|
||||
* 在visual studio中根据自己的业务做简单的调整，然后编译生成。即完成了一个新模块的开发。
|
||||
|
||||
`注意` 使用代码生成器适用于大批量简单逻辑的代码生成，复杂逻辑可以基于现有代码直接手动修改。
|
||||
|
||||
## 创建模块
|
||||
|
||||
* 添加模块
|
||||
|
||||
|
||||
|
||||
`注意` 模块标识必须和模块的controller一致，否则模块不能正常加载
|
||||
|
||||
* 添加菜单
|
||||
|
||||
|
||||
|
||||
默认的domId有`btnAdd`、`btnEdit`、`btnDel`可以参考`userJs\stocks.js`中的代码定义
|
||||
|
||||
* 授权
|
||||
|
||||
模块添加成功后，如果用的是System账号，退出重新登陆即可看到新加的模块。如果为其他角色分配模块，按照下面的方式：
|
||||
|
||||
|
||||
|
||||
以上就是一个普通模块开发的全过程，是不是so easy🙂，快下载代码体验吧！
|
||||
@@ -1,62 +0,0 @@
|
||||
# 快速开始
|
||||
|
||||
## 下载代码
|
||||
|
||||
使用git工具下载代码，代码地址：https://gitee.com/yubaolee/OpenAuth.Net.git
|
||||
|
||||
## 修改连接字符串
|
||||
|
||||
* 修改OpenAuth.Mvc/Web.config连接字符串，如下：
|
||||
```xml
|
||||
<add name="OpenAuthDBContext" connectionString="Data Source=.;Initial Catalog=OpenAuthDB;Persist Security Info=True;User ID=sa;Password=000000;MultipleActiveResultSets=True" providerName="System.Data.SqlClient" />
|
||||
```
|
||||
|
||||
* 修改OpenAuth.WebApi/Web.config连接字符串,如下：
|
||||
```xml
|
||||
<add name="OpenAuthDBContext" connectionString="Data Source=.;Initial Catalog=OpenAuthDB;Persist Security Info=True;User ID=sa;Password=000000;MultipleActiveResultSets=True" providerName="System.Data.SqlClient" />
|
||||
```
|
||||
|
||||
## 设置启动项
|
||||
|
||||
在vs解决方案视图中，右键解决方案“OpenAuth”属性，调整启动项，如下：
|
||||
|
||||
|
||||
::: warning 提别提醒
|
||||
|
||||
很多人启动的时候会遇到下面这个异常
|
||||
|
||||
|
||||
|
||||
99.9999%的人是因为没有启动OpenAuth.WebApi项目造成的。务必按上面进行启动项设置🙂
|
||||
:::
|
||||
|
||||
## 编译运行
|
||||
|
||||
使用Visual Studio菜单栏中的【启动】按钮或快捷键F5，启动运行。
|
||||
`注：首次启动时，visual studio会启动nuget还原第三方依赖包，请保持网络通畅，并等待一段时间`
|
||||
|
||||
启动成功后，可以在浏览器访问两个网址：
|
||||
|
||||
* [http://localhost:56813](http://localhost:56813) 为项目的主界面，对应OpenAuth.Mvc项目。如下图所示：
|
||||
|
||||
|
||||
* [http://localhost:52789/Swagger/ui/index](http://localhost:52789/Swagger/ui/index) 为项目WebApi接口部分，对应OpenAuth.WebApi项目，主要为其他项目提供数据接口及为OpenAuth.Mvc提供单点登录SSO功能。这是一个纯WebAPI项目，本身是没有界面的（所以3.0以前的版本会报找不到页面的错误），为了美观，增加了swagger的支持！
|
||||
|
||||
|
||||
|
||||
::: warning 提别提醒
|
||||
|
||||
如果WebApi不是使用的52789端口，需要在OpenAuth.Mvc的Web.config中修改下面配置：
|
||||
|
||||
```xml
|
||||
<add key="SSOPassport" value="http://localhost:你的端口号" />
|
||||
```
|
||||
:::
|
||||
|
||||
|
||||
|
||||
## 更多文档
|
||||
|
||||
如需更多文档请点击[这里](http://openauth.net.cn/question/detail.html?id=a2be2d61-7fcb-4df8-8be2-9f296c22a89c)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user