OpenAuth.Core 项目教程

1. 项目目录结构及介绍

OpenAuth.Core 是一个基于 .Net Core 的快速应用开发框架，具有权限管理和工作流系统。以下是项目的目录结构及其介绍：

OpenAuth.Core/
├── OpenAuth.App/          # 应用层，包含业务逻辑
├── OpenAuth.Identity/     # 身份认证模块
├── OpenAuth.Mvc/          # MVC 前端模块
├── OpenAuth.Repository/   # 数据访问层，包含数据库操作
├── OpenAuth.WebApi/       # Web API 接口模块
├── docs/                  # 项目文档
├── snapshots/             # 数据库脚本
├── .gitignore             # Git 忽略文件配置
├── CHANGELOG.md           # 项目更新日志
├── LICENSE                # 项目许可证
├── OpenAuth.Net.sln       # 项目解决方案文件
├── README.md              # 项目介绍文件

目录结构说明

• OpenAuth.App: 包含应用层的业务逻辑，处理具体的业务操作。
• OpenAuth.Identity: 负责身份认证和授权管理。
• OpenAuth.Mvc: 提供 MVC 前端页面，用户界面相关代码。
• OpenAuth.Repository: 数据访问层，处理数据库操作。
• OpenAuth.WebApi: 提供 Web API 接口，用于前后端数据交互。
• docs: 项目文档，包含使用说明和开发指南。
• snapshots: 数据库脚本，用于数据库的初始化和更新。
• .gitignore: Git 忽略文件配置，指定哪些文件不需要版本控制。
• CHANGELOG.md: 项目更新日志，记录每次版本更新的内容。
• LICENSE: 项目许可证，说明项目的开源协议。
• OpenAuth.Net.sln: 项目解决方案文件，用于 Visual Studio 等 IDE 打开项目。
• README.md: 项目介绍文件，包含项目的基本信息和使用说明。

2. 项目启动文件介绍

OpenAuth.Core 项目的启动文件主要位于 OpenAuth.Mvc 和 OpenAuth.WebApi 目录中。以下是启动文件的介绍：

OpenAuth.Mvc 启动文件

• Startup.cs: 这是 MVC 项目的启动文件，负责配置应用程序的服务和中间件。
• Program.cs: 这是 MVC 项目的入口文件，负责启动应用程序。

OpenAuth.WebApi 启动文件

• Startup.cs: 这是 Web API 项目的启动文件，负责配置 API 服务和中间件。
• Program.cs: 这是 Web API 项目的入口文件，负责启动 API 服务。

启动文件说明

• Startup.cs:

  • 配置依赖注入（DI）服务。
  • 配置身份认证和授权。
  • 配置 MVC 或 Web API 的路由。
  • 配置中间件，如 Swagger、CORS 等。

• Program.cs:

  • 配置应用程序的主机环境。
  • 启动应用程序的主机服务。

3. 项目的配置文件介绍

OpenAuth.Core 项目的配置文件主要位于项目的根目录和各个模块的目录中。以下是主要的配置文件介绍：

根目录配置文件

• appsettings.json: 这是主要的配置文件，包含应用程序的配置项，如数据库连接字符串、日志配置、身份认证配置等。

OpenAuth.Mvc 配置文件

• appsettings.json: 包含 MVC 项目的特定配置，如视图路径、静态文件路径等。

OpenAuth.WebApi 配置文件

• appsettings.json: 包含 Web API 项目的特定配置，如 API 路由、CORS 配置等。

配置文件说明

• appsettings.json:
  • ConnectionStrings: 数据库连接字符串配置。
  • Logging: 日志配置，包括日志级别、输出路径等。
  • IdentityServer: 身份认证服务器配置，如客户端ID、密钥等。
  • AllowedHosts: 允许访问的主机列表。

通过以上配置文件，可以灵活地配置 OpenAuth.Core 项目的各项功能和行为。