WebVella ERP 开源项目安装与使用教程

WebVella ERP 开源项目安装与使用教程

WebVella-ERP Free and open-source pluggable ERP and CRM software based on ASP.NET Core 5, RazorPages and PostgreSQL . Targets Linux or Windows as host OS. 项目地址: https://gitcode.com/gh_mirrors/we/WebVella-ERP

欢迎来到WebVella ERP的快速上手指南。本教程将引导您了解此免费且开源的ERP与CRM软件的核心结构，并指导您如何起步。WebVella ERP基于ASP.NET Core 8、Razor Pages以及PostgreSQL数据库，设计用于在Linux或Windows系统上运行。

1. 项目目录结构及介绍

WebVella ERP的项目结构高效而有序，它被精心组织以支持插件式扩展和高度定制化：

• 根目录:

  • src：主要的应用程序代码所在位置。
    • WebVella.Erp.Web: 应用的主入口点，包含了前端网页和后端处理逻辑。
    • WebVella.Erp.Plugins.*: 插件目录，每个子目录代表一个特定功能的插件，如CRM、邮件服务等。
  • WebVella.Erp.ConsoleApp: 可能包含一些后台管理或数据迁移工具。
  • WebVella.Erp.Site.*: 网站相关的组件或配置。
  • global.json, gitattributes, gitignore: 控制版本管理的文件。
  • docs/developer: 开发者文档目录，对开发者非常有用。
  • LICENSE.txt, README.md: 许可证信息与项目概述。
  • WebVella.ERP.sln: 解决方案文件，用于Visual Studio加载整个项目。

• 配置文件：

  • 配置通常分散在各个项目中，例如在.csproj文件中指定的依赖项，在特定于环境的配置文件（例如appsettings.Development.json）中定义的应用设置。

2. 项目启动文件介绍

主要的启动文件位于src\WebVella.Erp.Web项目内，具体是Startup.cs。这个文件是应用程序的入口点之一，负责配置应用程序的服务（如DI容器）、中间件、路由等关键部分。在应用启动时，它执行以下关键任务：

• 配置HTTP管道，包括添加 CORS、JWT验证等中间件。
• 注册各类服务，比如数据库上下文、自定义服务等。
• 配置视图引擎和Razor Pages。
• 设置应用的默认路由。

3. 项目的配置文件介绍

WebVella ERP的配置主要分布在几个地方：

• appsettings.json: 包含了通用的应用程序设置，如连接字符串、日志级别等。
• appsettings.{Environment}.json: 环境特定的配置，如开发、生产环境下不同的数据库连接字符串或其他环境差异性设置。
• Web.config: 在.NET Core项目中不常见，但在某些部署场景下可能用于IIS集成时的配置。
• ** individual configuration classes**: 在代码中也可能有配置类，用于封装复杂的配置逻辑。

实践步骤简述

1. 克隆项目：首先，通过HTTPS或SSH从https://github.com/WebVella/WebVella-ERP.git克隆项目到本地。
2. 环境准备：确保安装了.NET Core SDK 8或更高版本，以及PostgreSQL数据库并配置好连接。
3. 修改配置：根据你的开发环境，在appsettings.Development.json中配置正确的数据库连接字符串。
4. 构建项目：打开解决方案文件(WebVella.ERP.sln)并使用Visual Studio或命令行(dotnet build)进行构建。
5. 运行应用：使用命令行在开发模式下运行应用(dotnet run --project src/WebVella.Erp.Web)，或者在Visual Studio中直接运行。

完成以上步骤后，WebVella ERP应成功启动，你可以通过浏览器访问来查看和交互。记得查阅项目的正式文档获取更详细的安装和使用指南。

WebVella-ERP Free and open-source pluggable ERP and CRM software based on ASP.NET Core 5, RazorPages and PostgreSQL . Targets Linux or Windows as host OS. 项目地址: https://gitcode.com/gh_mirrors/we/WebVella-ERP