后端前端企业应用CRM【免费下载链接】idurar-erp-crmFree Open Source ERP CRM Software Accounting Invoicing | Node.Js React项目地址https://gitcode.com/gh_mirrors/id/idurar-erp-crm点击查看免费下载导读IDURAR 是一个基于 MERN 技术栈Node.js / Express.js / MongoDB / React.js构建的开源 ERP 与 CRM 一体化应用同时集成了 Redux 状态管理与 Ant DesignAntD组件库覆盖发票、报价、客户、付款、库存与会计等完整业务闭环。本文以仓库内乌尔都语功能文档为主线结合当前仓库的真实源码、配置与路由实现系统讲解 IDURAR 的功能模块划分、前后端工程结构、认证授权机制、发票与财务核算的底层数据模型以及从零安装部署的完整流程帮助开发者快速理解并二次开发这套开源 ERP/CRM 系统。一、项目概览一套软件两大核心ERP CRMIDURAR 定位为简单易用的开源 ERP/CRM既面向企业内部的进销存与财务核算ERP 部分也面向客户关系全生命周期管理CRM 部分。仓库根目录 README.md 明确描述了其技术底座为 Advanced Mern Stack即Node.js Express.js后端运行时与 Web 框架承载 REST APIMongoDB Mongoose文档型数据库与 ODM 建模层React.js Redux前端 UI 框架与全局状态管理Ant DesignAntD企业级组件库提供表格、表单、弹窗、布局等开箱即用的 UI 能力前后端工程分别位于仓库的 backend/ 与 frontend/ 目录两者均为4.1.0版本并在engines字段中锁定了运行环境Node.js 20.9.0、npm 10.2.4。后端包依赖覆盖了express、mongoose、jsonwebtoken、bcryptjs、multer文件上传、joi参数校验、pugPDF 模板渲染等关键组件前端则使用 Vite 作为构建工具依赖antd5、react18、reduxjs/toolkit与react-router-dom。二、功能模块全景从用户权限到报表分析的九大能力原文档按照业务域将 IDURAR 的功能划分为九个模块以下逐一结合仓库源码给出实现佐证。1. 用户管理与权限控制文档要点管理员可创建、编辑、删除用户账户提供基于角色的访问控制RBAC通过认证与授权机制保障访问安全。在源码层面认证能力由 createAuthMiddleware/index.js 统一封装它是一个返回login、logout、forgetPassword、resetPassword、isValidAuthToken五个方法的工厂函数支持传入任意用户模型如Admin复用。核心入口 adminAuth/index.js 即通过createAuthMiddleware(Admin)创建针对管理员模型的认证中间件。后端在 app.js 中按层级挂载路由app.use(/api, coreAuthRouter); // 登录/登出/密码重置公开 app.use(/api, adminAuth.isValidAuthToken, coreApiRouter); // 核心 API需认证 app.use(/api, adminAuth.isValidAuthToken, erpApiRouter); // 业务 API需认证 app.use(/download, coreDownloadRouter); app.use(/public, corePublicRouter);其中isValidAuthToken作为守卫中间件保护所有业务 API管理员资料更新、密码修改等能力则定义在 coreApi.js包括/admin/profile/update支持头像图片上传、/admin/profile/password、/admin/password-update/:id等路由角色模型如role: owner在 setup.js 初始化管理员时写入。2. CRM 客户关系管理文档要点管理线索Leads、潜在客户Prospects与客户Customers的联系记录销售机会的预测与跟进记录邮件、电话、会议等客户互动历史支持安排会议并向客户发送通知与提醒。客户业务对应Client实体其 Mongoose 模型定义在 Client.js发票模型中通过client: { type: mongoose.Schema.ObjectId, ref: Client, autopopulate: true }外键关联客户见 Invoice.js并使用mongoose-autopopulate插件自动填充客户详情方便在发票列表中直接展示客户信息。前端方面客户管理页面位于 pages/Customer/index.jsx 及其 config.js对应的客户表单为 CustomerForm.jsx。路由注册见 routes.jsx/customer路径即客户列表页。3. 销售管理文档要点创建并管理销售订单、关联具体客户实时检查产品可用性并在销售后更新库存生成发票并接入主流支付网关处理付款提供销售业绩看板与汇总分析。销售核心实体是Invoice发票。其数据模型 Invoice.js 定义了完整字段number发票编号与year联合使用、date与expiredDate开票与到期日、items明细数组itemName、quantity、price、total、金额汇总字段subTotal、taxTotal、total、discount、credit、currency币种如NA、paymentStatusunpaid/paid/partially、statusdraft/pending/sent/refunded/cancelled/on hold以及pdf字段存储生成的 PDF 路径。发票的 REST API 由通用 CRUD 工厂路由生成。在 appApi.js 中每个业务实体自动注册 9 条标准路由router.route(/${entity}/create).post(catchErrors(controller[create])); router.route(/${entity}/read/:id).get(catchErrors(controller[read])); router.route(/${entity}/update/:id).patch(catchErrors(controller[update])); router.route(/${entity}/delete/:id).delete(catchErrors(controller[delete])); router.route(/${entity}/search).get(catchErrors(controller[search])); router.route(/${entity}/list).get(catchErrors(controller[list])); router.route(/${entity}/listAll).get(catchErrors(controller[listAll])); router.route(/${entity}/filter).get(catchErrors(controller[filter])); router.route(/${entity}/summary).get(catchErrors(controller[summary]));其中invoice、quote、payment三个实体额外注册/${entity}/mail邮件发送接口quote还拥有/convert/:id转发票接口。实体清单并非硬编码而是由 models/utils/index.js 通过 glob 扫描src/models/appModels/**/*.js动态生成——新增一个模型文件即可自动获得全套 CRUD 能力这是理解 IDURAR 扩展性的关键。发票控制器的具体实现分布在 invoiceController/ 目录下create.js、read.js、update.js、paginatedList.js、sendMail.js、summary.js等前端发票模块位于 InvoiceModule/页面路由覆盖/invoice列表、/invoice/create、/invoice/read/:id、/invoice/update/:id与/invoice/pay/:id登记收款。4. 采购管理文档要点创建采购订单并指定数量与产品跟踪供应商信息、维护供应商关系收货并同步更新库存处理采购发票与供应商付款。从源码结构看采购能力并未拆分为独立实体而是通过通用的createCRUDController工厂createCRUDController/ 下的create.js、paginatedList.js、summary.js等与业务模型组合实现。供应商与采购相关数据沿用模型驱动路由机制——开发者将新模型放入appModels目录即可获得与发票一致的增删改查、搜索、筛选与汇总接口。这种约定优于配置的设计降低了采购模块二次开发的成本。5. 库存管理文档要点管理与跟踪库存水平支持库存转移与调整低库存自动通知并在需要补货时生成采购订单提供条码扫描能力允许创建产品分类、定义属性与价格。库存编号的生成由中间件 middlewares/inventory/ 提供其中 generateUniqueNumber.js 负责生成唯一编号配套中间件在 index.js 中统一导出。库存设置的默认参数可在 inventory 相关默认配置 中查阅这些 JSON 文件在安装初始化阶段由 setup.js 批量写入Setting集合。6. 财务管理文档要点管理总账General Ledger系统以跟踪收入与支出管理应收应付、发票与付款追踪生成资产负债表与利润表等财务报告与主流会计软件集成。财务数据模型中Invoice承担应收侧Payment承担实收侧二者通过payment: [{ type: mongoose.Schema.ObjectId, ref: Payment }]数组关联Invoice.js。发票汇总控制器 summary.js 展示了财务统计的典型实现通过 MongoDB Aggregation Pipeline 按week/month/year分组$facet一次性输出totalInvoice总金额与单数、statusCounts按状态计数、paymentStatusCounts按付款状态计数、overdueCounts按expiredDate早于当前时间的逾期计数并额外聚合paymentStatus in [unpaid,partially]的未收金额$sum: { $subtract: [$total, $credit] }最终返回total、total_undue与performance三部分。这套聚合逻辑正是财务看板与报表背后的数据来源。币种与货币格式化能力由 utils/currency.js、utils/currencyList.js 以及前端 settings/useMoney.jsx 提供财务相关设置项如发票税显示、默认客户、PDF 页脚、状态枚举定义在 invoiceSettings.json其中invoice_status默认值为[draft, pending, sent, received, refund, cancelled, on hold]invoice_pdf_footer默认文案为 Invoice was created on a computer and is valid without the signature and seal。7. 项目管理文档要点创建并跟踪项目向团队成员分配任务、设定截止日期并监控进度分配资源并跟踪项目支出提供文档共享与实时沟通等协作能力。项目管理在源码中同样以通用 CRUD 机制为底座可由开发者通过新增appModels模型快速扩展出项目、任务、资源等实体。前端框架层提供的 CrudModule.jsx 与 ErpPanelModule内含CreateItem.jsx、UpdateItem.jsx、DeleteItem.jsx、ReadItem.jsx、SearchItem.jsx、DataTable.jsx是一套可直接复用的模块化页面组件新业务页面可基于它们快速搭建这与文档所述项目管理的可扩展能力在架构上一脉相承。8. 报表与数据分析文档要点生成覆盖业务多方面的综合报表提供可定制的 KPI 看板支持按需定义自定义报表以数据可视化呈现信息。除上文 summary.js 外付款实体也有对应的 summary.js客户实体有 summary.js——即每个业务实体都通过/${entity}/summary接口暴露聚合统计。前端看板组件集中在 DashboardModule/包含SummaryCard.jsx、PreviewCard.jsx、CustomerPreviewCard.jsx与RecentTable最近记录表构成首页概览的数据可视化层。9. 集成与定制文档要点与第三方应用/API 集成如邮件营销工具、CRM 平台按业务需求定制配置与界面外观通过 API 或 Webhooks 实现数据交换。IDURAR 的定制能力集中体现在Setting设置体系后端 settingController/ 提供listAll、readBySettingKey、listBySettingKey、updateBySettingKey、updateManySetting等接口配合 middlewares/settings/ 下的loadSettings.js、listAllSettings.js、increaseBySettingKey.js中间件实现按 Key 读写配置的通用配置中心。前端设置模块位于 SettingModule/覆盖公司信息、财务、货币格式、通用设置与 Logo 上传CompanyLogoSettingsModule。后端还通过cors({ origin: true, credentials: true })app.js默认开放跨域便于与其他系统做数据交换。邮件发送依赖resend、openai等包见 backend/package.json。三、前后端工程架构约定式 CRUD 与模块化页面后端模型驱动的自动路由IDURAR 后端最具特色的设计是模型即路由。梳理其调用链models/utils/index.js 扫描src/models/appModels/**/*.js为每个模型生成{ entity, modelName, controllerName }元数据appApi.js 遍历元数据为每个实体注册统一的 create/read/update/delete/search/list/listAll/filter/summary 路由控制器由 appControllers/index.js 统一导出并挂载到catchErrors错误处理器errorHandlers.js上。因此新增一个业务实体通常只需三步在appModels下创建 Mongoose 模型文件、在appControllers下创建同名控制器、必要时在appApi.js中补充实体专属路由如 invoice 的 mail、quote 的 convert。前端路由与模块组件前端基于 Vite React Router 构建路由集中在 routes.jsx并配合 AppRouter.jsx 与 AuthRouter.jsx 区分受保护与公开页面。状态管理采用 Redux按领域拆分为auth、crud、adavancedCrud、erp、settings五组 actions/reducer/selectors见 redux/统一由 store.js 与 storePersist.js 管理持久化。API 请求层封装在 request/request.js、errorHandler.js、successHandler.js、codeMessage.js服务端地址配置位于 config/serverApiConfig.js。四、从零部署环境准备与启动步骤依据仓库 INSTALLATION-INSTRUCTIONS.md完整部署流程如下Step 1克隆仓库并进入目录git clone https://github.com/idurar/idurar-erp-crm.git cd idurar-erp-crmStep 2准备 MongoDB在 MongoDB 官网注册账号并创建数据库集群记录Connect to your application URI将password替换为真实密码并将当前 IP 加入数据库白名单IP 变更后需重新配置。Step 3/4配置环境变量编辑 backend/ 目录下的.env文件将DATABASEyour-mongodb-uri替换为实际 MongoDB URI。后端 setup.js 会依次加载.env与.env.local。Step 5安装后端依赖cd backend npm installStep 6运行初始化脚本npm run setup该脚本setup.js会执行初始化任务创建默认管理员账户邮箱adminadmin.com、密码admin123、角色owner、批量写入defaultSettings/*.json中的全部默认设置、插入默认税率Tax 0%与默认付款方式Default Payment Mode。Step 7启动后端服务npm run dev后端监听请求后前端即可通过 API 交互。可用的 npm 脚本还包括npm start生产启动、npm run production与npm run reset数据重置见 backend/package.json。Step 8/9安装并启动前端cd frontend npm install npm run dev前端 Vite 开发服务器启动后浏览器访问localhost:3000即可打开系统。OpenSSL 兼容性说明若在旧版 Node.jsV17 及以下启动前端时遇到ERR_OSSL_EVP_UNSUPPORTED类错误推荐升级到 Node.js v20本仓库锁定的版本或在命令行启用 legacy OpenSSL provider# Unix-like (Linux/macOS/Git Bash) export NODE_OPTIONS--openssl-legacy-provider # Windows CMD set NODE_OPTIONS--openssl-legacy-provider # PowerShell $env:NODE_OPTIONS --openssl-legacy-provider五、二次开发指引在约定框架内扩展业务结合前文分析基于 IDURAR 扩展新业务模块的建议路径为数据层在 appModels/ 下新增 Mongoose 模型复用removed软删除、createdBy、created/updated等既有字段约定控制层参照 invoiceController/ 的实现风格编写create、read、update、paginatedList、summary等方法金额计算可复用currency.js与 settings/useMoney.js 的格式化逻辑路由层新增实体自动获得标准 CRUD 路由专属能力在 appApi.js 中按实体条件追加表现层前端参照 ErpPanelModule 组装页面或在 routes.jsx 注册自定义页面表单可复用 DynamicForm 与 AntD 组件体系配置层在 defaultSettings/ 添加 JSON 设置项通过设置中心按 Key 读写。结语IDURAR 以模型驱动路由 通用 CRUD 控制器 模块化前端面板三层架构将 ERP 的进销存财务与 CRM 的客户全生命周期管理统一在 MERN 技术栈之上。本文从九个业务模块出发逐一落到模型、路由、控制器与前端组件的具体实现并给出了可复现的部署与扩展路径——开发者既可以将其作为企业业务系统直接使用也可以借助其约定式扩展机制在 appModels 与 appControllers 的框架内快速落地自有业务模块。赞分享后端前端企业应用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 是一款基于 MERN 技术栈Node后端前端企业应用CRMIDURAR 开源 ERP/CRM 软件功能全景解析基于 MERN 技术栈的发票、库存与财务管理实现IDURAR 开源 ERP/CRM 软件功能全景解析基于 MERN 技术栈的发票、库存与财务管理实现 导读 IDURAR 是一款免费开源的企业资源计划ERP后端前端企业应用CRMIDURAR 开源 ERP CRM 软件功能全景解析基于 MERN 技术栈的发票、客户与库存管理实战指南IDURAR 开源 ERP CRM 软件功能全景解析基于 MERN 技术栈的发票、客户与库存管理实战指南 IDURAR 是一款免费开源的 ERP企业资源计划后端前端企业应用CRM上一篇【亲测免费】 推荐文章解锁无限可能 - TikTokMod 开源项目探索下一篇暗黑破坏神2存档编辑器5步轻松修改你的游戏角色数据创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考