Idurar ERP-CRM 系统安装与配置指南
项目地址: https://gitcode.com/gh_mirrors/id/idurar-erp-crm 系统概述
Idurar ERP-CRM 是一款基于现代Web技术栈构建的企业资源计划(ERP)和客户关系管理(CRM)系统。该系统采用前后端分离架构，后端使用Node.js，前端使用React框架，数据库采用MongoDB。本文将详细介绍如何从零开始安装和配置该系统。
环境准备
在开始安装前，请确保您的系统满足以下要求：
- Node.js (建议版本16.x或更高)
- npm (通常随Node.js一起安装)
- MongoDB账户和数据库集群
- Git版本控制工具
详细安装步骤
第一步：获取项目代码
打开终端，执行以下命令克隆项目仓库：
git clone https://github.com/idurar/idurar-erp-crm.git
cd idurar-erp-crm
第二步：配置MongoDB数据库
- 访问MongoDB官方网站创建账户
- 按照官方文档指引创建新的数据库集群
- 记录数据库连接URI（格式通常为：
mongodb+srv://<username>:<password>@cluster.mongodb.net/<dbname>） - 将当前IP地址添加到MongoDB数据库的IP白名单中（IP变更时需要重新添加）
第三步：配置环境变量
- 进入项目backend目录，找到
.env文件 - 修改以下关键配置项：
DATABASE="your-mongodb-uri" # 替换为实际的MongoDB连接URI
第四步：后端安装与启动
- 安装后端依赖：
cd backend
npm install
- 运行初始化脚本：
npm run setup
- 启动后端服务：
npm run dev
后端服务默认会在3000端口启动，保持此终端窗口运行。
第五步：前端安装与启动
- 打开新的终端窗口，进入前端目录：
cd frontend
npm install
- 启动前端开发服务器：
npm run dev
前端服务启动后，可通过浏览器访问http://localhost:3000使用系统。
常见问题解决方案
OpenSSL相关错误处理
在某些Node.js版本(特别是v17+)中，可能会遇到OpenSSL兼容性问题。以下是解决方案：
方案一：升级Node.js版本 建议升级至Node.js v20或更高版本。
方案二：启用旧版OpenSSL提供程序
根据不同操作系统执行相应命令：
- Linux/macOS/Git Bash：
export NODE_OPTIONS=--openssl-legacy-provider
- Windows命令提示符：
set NODE_OPTIONS=--openssl-legacy-provider
- PowerShell：
$env:NODE_OPTIONS = "--openssl-legacy-provider"
执行上述命令后，重新运行前端启动命令：
npm run dev
系统验证
完成上述所有步骤后，您应该能够：
- 通过浏览器访问系统界面
- 查看后端服务运行状态
- 确认数据库连接正常
如果遇到任何问题，建议检查：
- 所有服务是否正常运行
- 数据库连接URI是否正确
- IP白名单是否配置正确
- 端口是否被占用
后续步骤
系统成功运行后，您可以：
- 创建管理员账户
- 配置系统基础参数
- 导入初始数据
- 根据业务需求进行定制开发
本指南涵盖了Idurar ERP-CRM系统的基础安装流程。如需更高级的配置或生产环境部署建议，请参考相关文档或联系技术支持。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
