后端前端企业应用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 应用当前仓库版本 4.1.0展开梳理其基于 MERN 技术栈Node.js、Express.js、MongoDB、React.js的整体架构逐一解析用户管理、客户关系管理、销售、采购、仓库、财务、项目、报表分析、集成定制等核心业务模块并结合仓库源码给出模块实现依据。读完本文你将掌握 IDURAR 的功能全貌、数据模型设计思路与可验证的源码级实现路径。技术栈概览Advanced MERN Stack 与 AntD/Redux 的组合原文档明确 IDURAR 是基于MERN Stack构建的免费开源 ERP CRM 软件技术组合为Node.js React.js Redux Express.js MongoDB AntDesignAntD。这一表述在仓库源码中得到完整印证后端backend/以 Express 为 Web 框架Mongoose 作为 MongoDB ODM见 backend/package.json 中express^4.18.2、mongoose^8.1.1、mongoose-autopopulate等依赖同时集成了jsonwebtokenJWT 鉴权、bcryptjs密码哈希、joi请求参数校验、multer文件上传、pughtml-pdf服务端渲染 PDF 单据、currency.js货币运算等核心库。前端frontend/采用 React 18 与 Ant Design 5 组件库配合 Redux/Redux Toolkit 做状态管理、react-router-dom 做路由、axios 发起请求、Vite 做构建工具见 frontend/package.json。服务端入口与脚本后端入口为 backend/src/server.jsbackend/package.json 提供devnodemon 热重载、start生产启动、setup初始化数据库与默认设置等脚本。从源码结构看这种Advanced MERN的进阶之处体现在后端通过 glob 扫描模型文件自动注册实体与路由见下文模型驱动的架构一节前端则以 ErpPanelModule 等通用模块统一支撑各业务实体的增删改查。用户管理账户生命周期与基于角色的访问控制原文档指出用户管理模块应具备以下能力仓库均有对应实现创建、编辑、删除用户账户核心用户模型为 backend/src/models/coreModels/Admin.js管理员/后台用户配套控制器位于 backend/src/controllers/coreControllers/adminController。基于角色的访问控制RBAC通过 adminAuth 相关中间件实现鉴权与权限校验见 backend/src/controllers/middlewaresControllers/createAuthMiddleware 下的authUser.js、isValidAuthToken.js等。认证与授权机制完整链路包括login.js登录签发 JWT、logout.js登出、forgetPassword.js与resetPassword.js找回/重置密码、sendMail.js邮件发送前端对应 frontend/src/pages/Login.jsx、frontend/src/pages/ForgetPassword.jsx、frontend/src/pages/ResetPassword.jsx以及 frontend/src/auth/auth.service.js 中的 token 管理。密码安全方面后端使用 bcryptjs 对密码做哈希存储会话凭据通过 JWT 在前后端之间传递属于 MERN 应用的标准安全实践。客户关系管理CRM客户档案、销售机会与沟通跟踪CRM 模块围绕客户全生命周期展开客户档案管理核心模型 backend/src/models/appModels/Client.js 定义客户字段包括name必填、phone、country、address、email以及enabled启用状态、createdBy/assigned创建人与归属负责人等。前端表单 frontend/src/forms/CustomerForm.jsx 与页面 frontend/src/pages/Customer/index.jsx 提供交互界面。销售机会Leads生成与资格评定前端提供 frontend/src/forms/LeadForm.jsx 表单用于录入潜在客户信息并推进销售机会。沟通历史跟踪客户记录可关联发票、报价、付款等业务单据形成沟通与交易轨迹原文档提及的邮件、通话、会议安排能力在系统中体现为邮件发送invoice/quote/payment 均支持/mail路由见下文路由解析与日程类提醒功能。约会计划与通知/提醒结合发票的recurring周期重复字段daily/weekly/monthly/quarter/annually与单据到期日expiredDate系统可对客户形成周期性跟进提醒。销售管理销售订单、库存联动、开票与支付原文档列出的销售管理能力在发票Invoice与付款Payment两大模型中落实得最充分销售订单与开票核心模型 backend/src/models/appModels/Invoice.js 定义了发票的完整结构number/year编号与年份、date/expiredDate开票日与到期日、client关联客户自动填充、items明细行itemName、description、quantity、price、total、taxRate/subTotal/taxTotal/total税额与小计合计、currency、discount、credit、paymentStatusunpaid/paid/partially、statusdraft/pending/sent/refunded/cancelled/on hold、isOverdue逾期标记等字段。库存联动销售发生后库存水平会随之更新其库存编号生成与唯一性保障位于 backend/src/middlewares/inventory/generateUniqueNumber.js。支付集成付款模型 backend/src/models/appModels/Payment.js 记录client、invoice、date、amount、currency、ref、description并回写到发票的payment数组与paymentStatus前端 frontend/src/modules/InvoiceModule/RecordPaymentModule 提供登记付款操作界面。发票 PDF 生成后端通过 Pug 模板渲染发票/报价/付款单据backend/src/pdf/Invoice.pug、backend/src/pdf/Quote.pug、backend/src/pdf/Payment.pug并经由 backend/src/handlers/downloadHandler/downloadPdf.js 提供下载能力。销售报表与趋势分析发票控制器提供 summary 汇总接口见 backend/src/controllers/appControllers/invoiceController/summary.js前端 Dashboard 模块frontend/src/modules/DashboardModule以卡片与图表形式呈现销售趋势。采购管理采购订单、供应商关系与入库原文档描述的采购管理能力包括创建/管理采购订单、跟踪供应商信息、收货入库并同步更新库存、处理采购发票与供应商付款。从仓库源码结构看采购相关实体遵循与客户/发票一致的模型 控制器 路由模式前端提供 frontend/src/forms/OrderForm.jsx 与 frontend/src/forms/InventoryForm.jsx 等表单支撑采购订单与库存数据的录入。库存中间件目录 backend/src/middlewares/inventory 集中处理库存编号生成等逻辑与销售/采购流程联动。供应商付款与发票处理可复用付款模型与设置模块如货币格式、财务设置完成backend/src/settings 提供相关配置上下文。仓库管理库存跟踪、补货提醒、条码与商品分类库存水平管理与货品转移/调整仓库能力由库存模型与前端库存表单frontend/src/forms/InventoryForm.jsx承载支持货品入库、出库与调整。低库存自动提醒与补货订单系统设置模块backend/src/setup/defaultSettings 下的各类默认设置 JSON可配置提醒阈值与业务规则。条码扫描原文档提到的条码扫描能力对应商品/库存条码字段的管理为仓储作业提供高效录入方式。商品分类、属性与定价商品可通过分类、属性和价格信息进行组织并与发票明细items中的itemName、price等字段打通支撑开票时快速引用。财务管理总账、应收应付、财务报告与软件集成总账系统财务模块跟踪收入与支出交易发票应收与付款实收模型构成资金流的主干。应收/应付账款Invoice 的paymentStatusunpaid/paid/partially与isOverdue字段直接支撑应收账款跟踪付款记录对应实收采购侧对应应付。财务报告包含资产负债表、利润表等报表通过 summary 类接口与前端 Dashboard 汇总呈现。货币与金额格式系统内置货币列表backend/src/utils/currencyList.js与金额格式化工具backend/src/settings/useMoney.js、frontend/src/settings/useMoney.jsx前端 MoneyFormatSettings 设置页frontend/src/pages/Settings/MoneyFormatSettings.jsx可配置货币符号、小数位等格式。第三方软件同步集成通过设置中的集成配置如邮件服务 Resend、OpenAI 等依赖见 backend/package.json与 API 能力实现外部系统对接。项目管理项目跟踪、任务分配、资源与协作项目创建与进度跟踪项目实体沿用例 CRUD 模式构建可创建项目并跟踪状态。任务分配与截止日期任务可分配给团队成员并设定期限进度通过看板式/列表式界面跟进。资源分配与成本跟踪结合财务模块统计项目相关支出与人工成本。协作功能文档共享与实时通信通过附件Invoice 模型中的files字段支持id/name/path/description/isPublic与通知机制实现。报表与数据分析汇总接口、KPI 看板与数据可视化综合报表生成每个业务实体均提供summary汇总接口如 invoiceController/summary.js、paymentController/summary.js支撑跨模块业务分析。可定制 KPI 看板前端 Dashboard 模块frontend/src/modules/DashboardModule以 PreviewCard、SummaryCard 等组件呈现关键指标frontend/src/modules/DashboardModule/components/SummaryCard.jsx。自定义报表通过过滤filter、搜索search、分页列表paginatedList等通用接口组合出符合特定业务要求的报表视图。数据可视化前端基于 AntD 与图表组件实现数据展示界面位于 Dashboard 与各业务页面。集成与个性化API、Webhooks 与外观定制第三方应用/API 集成后端支持邮件营销、CRM 平台等外部系统对接依赖层面可见resend邮件、openai等集成库backend/package.json。功能与外观定制系统设置模块backend/src/controllers/coreControllers/settingController、backend/src/middlewares/settings支持按业务需求配置应用、公司、发票、报价、财务、货币格式等设置项前端 frontend/src/pages/Settings 提供可视化配置界面公司设置、财务设置、通用设置、货币格式设置、公司 Logo 设置等。API 与 WebhooksREST API 是系统与外部交换数据的标准通道统一路由模式见下文公开路由 backend/src/routes/coreRoutes/corePublicRouter.js 服务于无需鉴权的公开资源。用户界面React Ant Design 构建的响应式体验组件化界面前端基于 Ant Design 5 与 React 18 构建通用组件DataTable、CreateForm、UpdateForm、ReadItem、SearchItem、DeleteModal 等位于 frontend/src/components保证各业务模块交互一致性。易用的导航、搜索与过滤路由体系frontend/src/router/routes.jsx配合页面侧边导航与 DataTable 的搜索/过滤能力实现。多设备响应式样式体系frontend/src/style 下的 partials CSS与响应式 Hookfrontend/src/hooks/useResponsive.jsx确保在不同屏幕尺寸下的良好体验。多语言支持前端本地化模块frontend/src/locale与后端语言配置backend/src/locale共同支撑国际化。源码视角模型驱动的自动路由架构IDURAR 后端最具特色的设计是模型驱动的自动注册机制这也是理解其各业务模块为何能快速扩展的关键自动发现模型backend/src/models/utils/index.js 使用 glob 扫描src/models/appModels下的所有模型文件自动生成routesList实体名 模型名 控制器名三元组。自动装配控制器backend/src/controllers/appControllers/index.js 优先加载各实体的自定义控制器目录未自定义的实体自动使用通用 CRUD 控制器backend/src/controllers/middlewaresControllers/createCRUDController。统一 REST 路由backend/src/routes/appRoutes/appApi.js 为每个实体统一注册以下路由方法路径用途POST/{entity}/create创建记录GET/{entity}/read/:id读取单条PATCH/{entity}/update/:id更新记录DELETE/{entity}/delete/:id删除记录GET/{entity}/search搜索GET/{entity}/list分页列表GET/{entity}/listAll全量列表GET/{entity}/filter条件过滤GET/{entity}/summary汇总统计此外invoice、quote、payment三类实体额外注册POST /{entity}/mail邮件发送路由quote还注册GET /quote/convert/:id报价转发票路由。通用 CRUD 控制器createCRUDController/create.js、update.js 等配合joi模式校验如 invoiceController/schemaValidate.js保证了各实体数据写入的一致性与安全性。快速上手本地运行 IDURAR完整的安装步骤见仓库根目录的 INSTALLATION-INSTRUCTIONS.md核心流程为克隆仓库并在backend/下配置.env将DATABASE变量替换为 MongoDB 连接 URI在backend/目录执行npm install安装后端依赖执行npm run setup运行初始化脚本创建默认管理员与默认设置默认设置定义于 backend/src/setup/defaultSettings执行npm run dev启动后端服务另开终端进入frontend/执行npm install后运行npm run dev启动前端开发服务器。若启动前端时遇到 OpenSSL 相关的 Node.js 兼容报错建议升级至 Node.js 20 或按安装文档启用 legacy OpenSSL provider 后重试。总结IDURAR 将 MERN 技术栈与模型驱动自动路由的工程化设计结合用一套通用 CRUD 体系承载了用户、CRM、销售、采购、仓库、财务、项目、报表、集成九大业务域的完整 ERP/CRM 能力数据模型层Client、Invoice、Payment、Admin、Setting提供了清晰的业务结构通用控制器与统一 REST 路由保证了各模块行为一致且易于扩展前端以 React Ant Design 提供统一、响应式的操作界面。对希望自建开源 ERP/CRM 或基于 MERN 栈搭建业务系统的开发者而言IDURAR 的模型分层、自动路由与设置驱动架构都是可直接借鉴的范本。赞分享后端前端企业应用CRM【免费下载链接】idurar-erp-crmFree Open Source ERP CRM Software Accounting Invoicing | Node.Js React项目地址https://gitcode.com/gh_mirrors/id/idurar-erp-crm点击查看免费下载相关推荐WSA-Windows-10深度解析Windows 10上原生运行Android应用的终极方案WSA Windows 10深度解析Windows 10上原生运行Android应用的终极方案 你是否曾想过在Windows 10上像运行原生应用一样流畅地使后端前端企业应用CRM围棋AI分析神器LizzieYzy从新手到高手的完整使用指南围棋AI分析神器LizzieYzy从新手到高手的完整使用指南 LizzieYzy是一款功能强大的围棋AI分析工具专为围棋爱好者提供专业级的棋局分析和学习支持后端前端企业应用CRMLabel Studio 多模态数据标注完整指南从部署到拿到可训练数据集Label Studio 多模态数据标注完整指南从部署到拿到可训练数据集 模型训了一版又一版标注数据还散落在 Excel 和图片查看器里格式不统一、多人各后端前端企业应用CRM上一篇Agent 上下文工程技能库实战把上下文管理从概念落到生产系统下一篇Kindle Comic Converter终极指南三步轻松将漫画转换为Kindle电子书创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
