lsm/OpenAuth.Net
1
0
Fork 0
mirror of https://gitee.com/dotnetchina/OpenAuth.Net.git synced 2025-07-16 16:50:54 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

docs: 调整文档

Browse Source
This commit is contained in:
yubaolee 2025-06-07 22:06:28 +08:00
parent 0df485d290
commit d41d91b44e
2 changed files with 14 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
newdocs/docs/.vuepress/navbar.ts
View File

@ -1,7 +1,7 @@
/* /*
* @Author: yubaolee <yubaolee@163.com> | ahfu~ <954478625@qq.com> * @Author: yubaolee <yubaolee@163.com> | ahfu~ <954478625@qq.com>
* @Date: 2025-04-23 20:26:48 * @Date: 2025-04-23 20:26:48
* @LastEditTime: 2025-06-07 21:41:34 * @LastEditTime: 2025-06-07 21:56:14
* @Description: 顶部超链接 * @Description: 顶部超链接
* Copyright (c) 2025 by yubaolee | ahfu~ , All Rights Reserved. * Copyright (c) 2025 by yubaolee | ahfu~ , All Rights Reserved.
*/ */
@ -20,7 +20,7 @@ export const navbar = defineNavbarConfig([
}, },
{ {
text: '付费订阅文档', text: '付费订阅文档',
icon: 'logos:opensource', icon: 'ri:vip-crown-2-line',
items: [ items: [
{ text: 'vue3前端', link: '/notes/pro/README.md', icon: 'material-icon-theme:vue' }, { text: 'vue3前端', link: '/notes/pro/README.md', icon: 'material-icon-theme:vue' },
{ text: '移动UniApp', link: '/notes/mobile/README.md', icon: 'ri:smartphone-line' } { text: '移动UniApp', link: '/notes/mobile/README.md', icon: 'ri:smartphone-line' }

40
newdocs/docs/notes/core/start.md
View File

@ -14,6 +14,10 @@ gitee上面两个版本。其中：
.Net目前SDK升级特别方便。请参考：[3分钟的时间把.net core 3.1的升级到.NET 5](https://www.cnblogs.com/yubaolee/p/Net3ToNet5.html)，所以不要纠结SDK版本问题。 .Net目前SDK升级特别方便。请参考：[3分钟的时间把.net core 3.1的升级到.NET 5](https://www.cnblogs.com/yubaolee/p/Net3ToNet5.html)，所以不要纠结SDK版本问题。
## 系统架构
![系统架构](http://img.openauth.net.cn/系统架构.png)
## 安装sdk ## 安装sdk
@ -32,7 +36,7 @@ OpenAuth.Net文件夹结构及功能说明如下：
┣ 📂mysql初始化脚本 ┣ 📂mysql初始化脚本
┣ 📂OpenAuth.App //应用逻辑代码 ┣ 📂OpenAuth.App //应用逻辑代码
┣ 📂OpenAuth.Identity //IdentityServer4服务器，提供OAuth服务 ┣ 📂OpenAuth.Identity //IdentityServer4服务器，提供OAuth服务
┣ 📂OpenAuth.Mvc //开源版Web站点 ┣ 📂OpenAuth.Mvc //开源版Web站点，已弃用⚠️
┣ 📂OpenAuth.Repository //数据库访问相关代码 ┣ 📂OpenAuth.Repository //数据库访问相关代码
┣ 📂OpenAuth.WebApi //WebApi接口站点 ┣ 📂OpenAuth.WebApi //WebApi接口站点
┣ 📂sql server 初始化脚本 ┣ 📂sql server 初始化脚本
@ -51,39 +55,32 @@ skinparam handwritten true
actor 用户 actor 用户
boundary index.cshtml boundary vue2
control XXController control XXController
entity OpenAuth.App entity OpenAuth.App
entity OpenAuth.Repository entity OpenAuth.Repository
database OpenAuthDB database OpenAuthDB
participant vue2
box "OpenAuth.Mvc" #LightBlue box "OpenAuth.WebApi" #LightBlue
participant index.cshtml
participant XXController participant XXController
end box end box
participant OpenAuth.App participant OpenAuth.App
participant OpenAuth.Repository participant OpenAuth.Repository
participant OpenAuthDB participant OpenAuthDB
用户 -> index.cshtml : 用户浏览页面 用户 -> vue2 : 用户浏览页面
index.cshtml -> XXController : 前端通过ajax调用数据 vue2 -> XXController : 前端通过ajax调用数据
XXController -> OpenAuth.App : 调用逻辑层 XXController -> OpenAuth.App : 调用逻辑层
OpenAuth.App -> OpenAuth.Repository : 逻辑层调用仓储进行数据读写 OpenAuth.App -> OpenAuth.Repository : 逻辑层调用仓储进行数据读写
OpenAuth.Repository -> OpenAuthDB : 仓储层进行数据库操作 OpenAuth.Repository -> OpenAuthDB : 仓储层进行数据库操作
@enduml @enduml
我们以【资源管理】功能为例，该功能涉及的文件如下：
![20220407153729](http://img.openauth.net.cn/20220407153729.png)
## 初始化数据库 ## 初始化数据库
使用数据库脚本`sql server 初始化脚本`或`mysql初始化脚本` 文件夹里面的结构脚本和数据脚本初始化数据库 使用数据库脚本`SqlServer脚本`或`mysql脚本` 文件夹里面的结构脚本和数据脚本初始化数据库
::: warning 注意
如果使用企业版的OpenAuth.WebApi,则新建一个空数据库：OpenAuthPro。使用OpenAuth.Pro前端源码文件夹【sql脚本】中，运行`Sql Server脚本.sql`（或mysql脚本）
:::
## 打开项目 ## 打开项目
@ -146,19 +143,6 @@ OpenAuth.Repository -> OpenAuthDB : 仓储层进行数据库操作
,"OpenAuthDBContext3":"MySql" ,"OpenAuthDBContext3":"MySql"
}, },
``` ```
## 编译运行MVC
使用visualstudio生成解决方案。
`注：首次启动时，visual studio会启动nuget还原第三方依赖包，请保持网络通畅，并等待一段时间`
启动openauth.mvc项目。
![启动](http://img.openauth.net.cn/2025-04-24-00-07-51.png)
启动成功后使用浏览器打开[http://localhost:1802](http://localhost:1802) 即可访问，如下图所示：
![说明](http://img.openauth.net.cn/2025-04-24-00-08-18.png)
## 编译运行WebApi ## 编译运行WebApi