OpenPetra 项目启动与配置教程

1. 项目目录结构及介绍

OpenPetra 是一个基于 .NET 的开源会计和教会管理系统。以下是 OpenPetra 项目的目录结构及其基本介绍：

openpetra
├── Client
│   ├── Core
│   ├── MPower
│   ├── Mobile
│   └── Web
├── Server
│   ├── Common
│   ├── Partner
│   ├── Finance
│   ├── Personnel
│   └── Conference
├── SQL
│   ├── PostgreSQL
│   └── MySQL
├── Tests
│   ├── UnitTests
│   ├── IntegrationTests
│   └── PerformanceTests
├── Tools
├── Documentation
├── .gitignore
├── .gitmodules
├── build.sh
├── build.bat
├── Dockerfile
├── Petra.sln
└── README.md

• Client: 包含了客户端应用程序的代码，分为 Core（核心组件）、MPower（桌面应用程序）、Mobile（移动应用程序）和 Web（Web应用程序）。
• Server: 包含服务器端组件的代码，包括 Common（通用组件）、Partner（合作伙伴管理）、Finance（财务管理）、Personnel（人事管理）和 Conference（会议管理）。
• SQL: 包含与数据库相关的 SQL 脚本，支持 PostgreSQL 和 MySQL。
• Tests: 包含单元测试、集成测试和性能测试的代码。
• Tools: 包含辅助工具和脚本。
• Documentation: 包含项目文档。
• .gitignore: 指定 Git 忽略的文件和目录。
• .gitmodules: 指定 Git 子模块。
• build.sh: 用于 Linux 系统的构建脚本。
• build.bat: 用于 Windows 系统的构建脚本。
• Dockerfile: 用于构建 Docker 容器的文件。
• Petra.sln: Visual Studio 解决方案文件。
• README.md: 项目说明文件。

2. 项目的启动文件介绍

OpenPetra 的启动文件主要依赖于其解决方案文件 Petra.sln，该文件可以在 Visual Studio 或其他兼容的 IDE 中打开。

• Petra.sln: 此文件是 Visual Studio 解决方案文件，它将项目的所有组件（如 Core、MPower、Mobile 和 Web）组织在一个统一的开发环境中。在 Visual Studio 中打开此文件，然后按 F5 键可以启动调试。

对于 Web 应用程序，你可以在 Client/Web 目录中找到 Web 项目的启动文件，如 Startup.cs。

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // ...
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        // ...
        app.UseRouting();
        // ...
    }
}

3. 项目的配置文件介绍

OpenPetra 使用多种配置文件来设置应用程序的行为，以下是几个主要的配置文件：

• appsettings.json: 这是一个标准的 ASP.NET Core 配置文件，用于存储应用程序级别的配置信息，如数据库连接字符串、服务配置等。

{
  "ConnectionStrings": {
    "DefaultConnection": "Your Connection String Here"
  }
}

• config.json: 用于存储特定于 OpenPetra 的配置信息，如 API 密钥、外部服务配置等。

{
  "APIKey": "Your API Key Here",
  "ExternalServiceUrl": "Your Service URL Here"
}

• web.config: 对于 Web 应用程序，这是一个 ASP.NET 配置文件，包含了应用程序的设置和配置信息。

<configuration>
  <connectionStrings>
    <add name="DefaultConnection" connectionString="Your Connection String Here" providerName="System.Data.SqlClient" />
  </connectionStrings>
  <!-- ... -->
</configuration>

确保在启动项目之前正确配置这些文件，以便应用程序可以正确运行。