IDURAR 开源 ERP/CRM 系统功能全景解析：基于 MERN 技术栈的企业业务管理架构

后端前端企业应用CRM【免费下载链接】idurar-erp-crmFree Open Source ERP CRM Software Accounting Invoicing | Node.Js React项目地址https://gitcode.com/gh_mirrors/id/idurar-erp-crm点击查看免费下载导读本篇技术指南以 IDURAR 官方功能清单features 目录下的多语言产品说明为主体结合仓库源码深入剖析这款开源 ERP/CRM 系统的功能架构与实现原理。读者将理解 IDURAR 的 MERN 技术栈选型、十大核心业务模块用户、CRM、销售、采购、库存、财务、项目、报表、集成、界面的设计要点掌握从克隆仓库到前后端联调运行的完整部署流程并可通过源码路径进一步深入验证每个功能背后的实现机制。一、项目概览与技术栈IDURAR 是一款基于Advanced Mern Stack构建的开源 ERP / CRM 软件覆盖发票Invoice、报价Quote、会计Accounting等核心业务场景。后端技术栈由 Node.js、Express.js、MongoDBMongoose构成前端使用 React.js 搭配 Ant DesignAntD组件库与 Redux 状态管理。从 backend/package.json 可以看到当前后端版本为4.1.0并明确声明运行环境要求Node.js20.9.0、npm10.2.4。关键依赖包括Mongoose 8.xMongoDB ODM配合mongoose-autopopulate实现关联字段自动填充express express-rate-limit cors cookie-parserHTTP 服务、接口限流、跨域与 Cookie 解析jsonwebtoken bcryptjsJWT 令牌认证与密码哈希joi请求参数校验pug html-pdf使用 Pug 模板渲染并生成 PDF报价单、发票、付款单currency.js / moment金额计算与日期处理multer aws-sdk/client-s3本地与 S3 对象存储的文件上传。后端源码通过module-alias将映射到src目录统一了模块引用方式如require(/handlers/errorHandlers)。二、用户管理与权限控制认证与授权文档规划的用户管理能力包括允许管理员创建、编辑、删除用户账户实现基于角色的访问控制RBAC以管理用户权限提供认证与授权机制确保安全访问。在仓库中这一模块的落地位于 backend/src/controllers/coreControllers/adminAuth 与 backend/src/controllers/middlewaresControllers/createAuthMiddleware。createAuthMiddleware(Admin)工厂函数统一生成四类认证能力login管理员登录forgetPassword/resetPassword忘记密码与重置密码流程isValidAuthTokenJWT 令牌有效性校验中间件logout登出。对应路由在 backend/src/routes/coreRoutes/coreAuth.js 中公开POST /login、POST /forgetpassword、POST /resetpassword、POST /logout登出需经过isValidAuthToken中间件。管理员资料管理则在 backend/src/routes/coreRoutes/coreApi.js 中定义包括读取管理员、更新密码、更新个人资料支持通过singleStorageUpload上传头像图片以及个人资料密码修改等接口配合Admin、AdminPassword两个核心模型见 backend/src/models/coreModels。三、CRM 客户关系管理文档规划的 CRM 能力包括创建和管理潜在客户与现有客户的联系人实现销售线索的生成与资格认定提供客户沟通历史管理工具电子邮件、电话、会议支持安排预约并向客户发送通知或提醒。仓库中以Client模型backend/src/models/appModels/Client.js作为 CRM 的数据核心。Invoice模型通过client: { type: mongoose.Schema.ObjectId, ref: Client, autopopulate: true }与客户建立强关联并在读取发票时自动填充客户完整信息。前端侧客户管理页frontend/src/pages/Customer/index.jsx与CustomerForm.jsx表单frontend/src/forms/CustomerForm.jsx提供联系人录入、编辑与检索交互。值得注意的是仓库当前的业务实体集中在客户、发票、付款三类见 backend/src/models/appModels 下的Client.js、Invoice.js、Payment.js文档中提到的销售线索Lead资格认定、预约提醒等更广泛的 CRM 能力属于产品规划范围从源码结构看尚未以独立实体形式在appModels中出现。四、销售管理与发票文档规划的销售管理能力包括创建和管理销售订单并关联到特定客户实现库存跟踪以检查产品可用性并在每次销售后更新库存水平生成发票并集成主流支付网关提供控制台与报告以跟踪销售绩效和分析趋势。发票模块是仓库中实现最完整的部分。以 backend/src/models/appModels/Invoice.js 为例其 Schema 覆盖了发票全生命周期字段编号体系number、year组合生成年度流水号业务状态status枚举draft / pending / sent / refunded / cancelled / on hold付款状态paymentStatus枚举unpaid / paid / partially配合isOverdue逾期标记与credit信用额金额结构subTotal、taxRate、taxTotal、discount、total完整计算链明细行items数组记录itemName、description、quantity、price、total转换来源converted字段记录发票由quote或offer转换而来与Quote、Offer模型关联周期与到期recurringdaily/weekly/monthly/annually/quarter与date、expiredDate附件与 PDFfiles附件数组与pdf字段。发票控制器backend/src/controllers/appControllers/invoiceController提供create、read、update、remove、paginatedList、summary、sendMail、schemaValidate等完整操作。其中sendMail与mail路由在 backend/src/routes/appRoutes/appApi.js 中针对invoice、quote、payment三个实体统一开放POST /{entity}/mail邮件发送接口。前端发票模块frontend/src/modules/InvoiceModule包含创建、数据表格、读取、更新、记录付款RecordPaymentModule五个子模块表单由InvoiceForm.jsx承载覆盖从录入到开票的完整操作闭环。五、采购管理文档规划的采购管理能力包括创建和管理采购订单指定数量与所需产品跟踪供应商信息并管理供应商关系接收货物并相应更新库存水平管理采购发票与对供应商的付款。从当前仓库源码结构看采购订单、供应商等尚未以独立 Mongoose 模型存在于 backend/src/models/appModels 中这一能力属于文档定义的产品功能规划。不过Invoice模型中的recurring与库存联动设计销售后更新库存为采购流程的落地预留了数据联动基础。读者可将此模块视为路线图中的规划能力并结合库存管理章节理解其设计意图。六、库存管理文档规划的库存管理能力包括提供工具管理和跟踪库存水平包括库存转移与调整设置低库存自动通知并在需要补货时生成采购订单提供条形码扫描能力以高效管理库存允许用户对产品分类、定义属性并设置价格信息。仓库中与库存直接相关的实现体现在后端中间件层。backend/src/middlewares/inventory/generateUniqueNumber.js用于生成唯一编号典型用于发票、报价等单据的序列号生成backend/src/middlewares/inventory/index.js 将编号生成器组织为可复用的中间件。同时前端提供了 InventoryForm.jsx 表单组件表明产品与库存实体的录入界面已经存在。从模型目录看Product等库存核心实体尚未出现在appModels中条形码扫描、低库存预警与自动补货属于规划中的高阶能力。七、财务管理与会计文档规划的财务管理能力包括实现总账系统以跟踪财务交易成本与收入管理应收应付账款包括开票与付款跟踪生成财务报表资产负债表、损益表集成主流会计软件实现无缝财务协同。付款模块是当前仓库财务能力的核心实现。Payment模型backend/src/models/appModels/Payment.js与控制器 backend/src/controllers/appControllers/paymentController 提供创建、更新、删除、邮件发送、汇总等操作。Invoice模型通过payment: [ObjectId ref Payment]数组记录每张发票关联的付款记录paymentStatus字段据此在unpaid / paid / partially间流转。财务与货币相关设置由financeSettings.json与moneyFormatSettings.jsonbackend/src/setup/defaultSettings定义前端 FinanceSettingsModule 与 MoneyFormatSettingsModule 提供可视化配置界面。金额计算与货币格式化分别由 backend/src/settings/useMoney.js 与 frontend/src/settings/useMoney.jsx 封装支持多币种记账。八、项目管理文档规划的项目管理能力包括提供项目管理能力允许用户创建和跟踪项目向团队成员分配任务、设置截止日期并跟踪进度分配资源并跟踪项目成本提供协作功能如文档共享与实时通信。从当前仓库结构看项目Project、任务Task实体尚未作为独立模型出现在appModels中实时通信模块如 Socket.IO 集成也未在 backend/package.json 依赖中体现。因此该项目管理章节属于文档定义的产品愿景当前开源版本尚未落地为独立业务模块。九、报表与分析文档规划的报表能力包括生成关于业务各个方面的全面报告与分析提供可定制的仪表盘以跟踪关键绩效指标KPI允许用户根据特定需求定义自定义报告实现数据可视化技术以视觉化呈现信息。仓库中报表能力的实现以汇总summary接口为核心通用 CRUD 控制器backend/src/controllers/middlewaresControllers/createCRUDController为每个业务实体统一生成summary方法并在 backend/src/routes/appRoutes/appApi.js 中开放GET /{entity}/summary路由用于聚合统计。前端仪表盘由 frontend/src/modules/DashboardModule 承载包含SummaryCard、PreviewCard、CustomerPreviewCard、RecentTable等组件frontend/src/modules/DashboardModule/components以卡片与表格形式呈现业务 KPI 概览。此外发票、客户、付款均提供独立的汇总接口见 backend/src/controllers/appControllers 下各模块的summary.js支撑多维度的业务统计。十、集成与定制能力文档规划的集成与定制能力包括与主流第三方应用或 API 集成如邮件工具、CRM 平台允许按特定业务需求定制应用功能与外观提供 API 或 Webhooks 以促进 ERP/CRM 应用与其他系统间的数据交换。仓库中的集成与扩展机制体现在几个层面通用 CRUD 工厂createCRUDController/index.js 从模型文件自动生成标准 CRUD 方法集models/utils/index.js 通过globSync扫描./src/models/**/*.js自动注册模型、实体与路由清单。这意味着新增一个appModels下的模型文件即可自动获得全套 CRUD API——这是系统可扩展性的核心机制。控制器自动装配appControllers/index.js 先加载appControllers/*/**/下的自定义控制器未定义自定义控制器的实体自动回退到通用 CRUD 控制器实现了默认全有、按需覆盖的定制模式。设置系统核心设置 APIcoreApi.js 的/setting/*系列路由支持按settingKey读取、列表与批量更新配置前端 SettingModule 提供公司信息、财务、货币格式、通用设置、公司 Logo 上传等可视化配置满足按需定制的诉求。外部服务依赖resend邮件发送、openaiAI 能力、aws-sdk/client-s3对象存储等依赖已就位为邮件通知、智能助手与云存储集成提供了底层支撑。十一、用户友好界面文档规划的界面设计要求包括使用 React.js 与 Ant Design 设计直观、响应式、用户友好的界面实现简洁的导航菜单、搜索功能与过滤器确保在不同设备与屏幕尺寸下保持一致且视觉舒适的界面。前端目录结构充分体现了这一设计目标组件库frontend/src/componentsDataTable数据表格、CrudModal、CreateForm、UpdateForm、SelectAsync、AutoCompleteAsync、SearchItem、ReadItem、DeleteModal、Notification等通用组件覆盖增删改查全流程交互布局体系frontend/src/layoutDashboardLayout、CrudLayout、ErpLayout、AuthLayout、SettingsLayout、ProfileLayout等分层布局样式主题frontend/src/style/partialscore.css、erp.css、customAntd.css等基于 AntD 的定制样式模块化页面frontend/src/pagesInvoice、Payment、Customer、Settings 等业务页面与 frontend/src/modules 模块化组件一一对应搜索、筛选、分页等能力由 DataTable 与上下文状态管理frontend/src/context/crud统一提供。响应式方面useResponsive.jsx 等 Hook 支撑了多设备适配符合文档跨设备一致体验的要求。十二、本地部署指南根据 INSTALLATION-INSTRUCTIONS.md完整部署分九步1. 克隆仓库git clone https://github.com/idurar/idurar-erp-crm.git cd idurar-erp-crm2. 创建 MongoDB 数据库集群注册 MongoDB 账号并创建数据库/集群记录Connect to your application URI将password替换为实际密码并把当前 IP 加入数据库 IP 白名单。3–4. 配置环境变量检查backend目录下的.env文件将其中DATABASEyour-mongodb-uri替换为实际 MongoDB URI。5. 安装后端依赖cd backend npm install6. 运行初始化脚本npm run setup该脚本对应 backend/src/setup/setup.js负责必要的数据库初始化与默认设置写入默认设置 JSON 位于 backend/src/setup/defaultSettings。7. 启动后端服务npm run dev后端入口为 backend/src/server.js生产环境可使用npm start。8–9. 安装并启动前端另开终端cd frontend npm install npm run dev前端默认运行于http://localhost:3000Vite 配置见 frontend/vite.config.js。OpenSSL 兼容性提示若前端启动报 OpenSSL 错误Node.js v17 兼容问题建议升级到 Node.js v20本项目engines声明的目标版本或启用 legacy OpenSSL providerUnix 系Linux / macOS / Git bashexport NODE_OPTIONS--openssl-legacy-providerWindows CMDset NODE_OPTIONS--openssl-legacy-providerPowerShell$env:NODE_OPTIONS --openssl-legacy-provider十三、总结IDURAR 以 MERN 技术栈为基座通过模型自动注册 CRUD 控制器工厂 AntD 组件库的组合构建了一套功能覆盖用户、CRM、销售、库存、财务、报表等场景的 ERP/CRM 系统。其中发票、付款、客户三大业务实体与认证、设置两大支撑体系已在源码中完整落地采购、项目、高级库存能力则属于文档规划的产品路线。对于希望深入二次开发的工程师建议从 backend/src/models/utils/index.js实体自动注册、createCRUDController通用 CRUD与 appApi.js路由生成三处入手即可快速理解系统新增业务模块的完整链路。赞分享后端前端企业应用CRM【免费下载链接】idurar-erp-crmFree Open Source ERP CRM Software Accounting Invoicing | Node.Js React项目地址https://gitcode.com/gh_mirrors/id/idurar-erp-crm点击查看免费下载相关推荐IDURAR 开源 ERP CRM 系统功能全景解析基于 MERN 技术栈的企业级业务管理实战指南IDURAR 开源 ERP CRM 系统功能全景解析基于 MERN 技术栈的企业级业务管理实战指南 导读 本文以 IDURAR 官方功能特性文档 fea后端前端企业应用CRMIDURAR 开源 ERP/CRM 软件功能全景解析基于 MERN 技术栈的 Node.js React 企业管理系统IDURAR 开源 ERP/CRM 软件功能全景解析基于 MERN 技术栈的 Node.js React 企业管理系统 导读 IDURARIDURAR后端前端企业应用CRMIDURAR 开源 ERP/CRM 功能全景解析基于 MERN 技术栈的免费开源企业管理软件IDURAR 开源 ERP/CRM 功能全景解析基于 MERN 技术栈的免费开源企业管理软件 IDURAR idurar erp crm https://l后端前端企业应用CRM上一篇终极Windows部署自动化MediaCreationTool.bat完整指南与实战技巧下一篇Steam创意工坊下载终极指南5分钟学会用WorkshopDL免费下载模组创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考