基于Python开发的前后端分离ERP进销存系统

## 语言/Language - [中文](#中文) - [English](#english) ## 中文 ## 盒木ERP社区版--开源ERP进销存管理系统 ### 使用前须知 #### 软件开放源码(发行协议:GPL-3.0)，个人用户可免费学习使用，但禁止任何单位或个人修改软件后再次发行的行为。商业使用需得到我司授权，否则我们将通过法律途径解决侵权问题。 #### 我们欢迎对开源技术感兴趣的朋友一起加入到我们项目中来完善系统功能并为客户提供服务。欢迎扫描下方二维码添加技术交流群<br /><br />  ### 公司介绍 盒木科技是一家专注于**智慧工厂和仓储系统**研发的科技创新企业。目前已发布[盒木ERP企业管理系统](https://www.himool.com/erp)，[盒木WMS仓库管理系统](https://www.himool.com/wms)及[盒木WCS仓库控制系统](https://www.himool.com/wcs)。其中ERP含社区版和企业版： * **社区版**为开源进销存系统，包含采购，销售，库存，财务等模块。适用于贸易类企业。 * **企业版**为智慧工厂管理系统，除了社区版功能外，还增加了生产管理，质检管理，物料管控及追溯，实时看板，移动端App等实用功能。 #### ERP的服务模式 * SaaS网络版。如需购买可点击[该淘宝链接](https://item.taobao.com/item.htm?id=619069183482) * 客户定制服务。无论社区版还是企业版，针对有定制需求的客户我们将提供定制开发服务。 * 社区版商业授权。开源社区需要您的支持以得以发展，如果您希望将我们的系统或源码二次开发后出售给其他客户，请先联系我们获得商业授权，否则将承担法律风险。 #### 欢迎有软件需求的客户或意向成为代理（[代理条件](https://www.himool.com/partner)）的公司/个人扫描下方客户经理二维码。个人学习请勿添加！！！<br /> 添加微信时请备注单位/个人称呼+目的（如代理合作，客户咨询等），否则不予通过。<br /><br />  ### 项目介绍 #### 该系统前后端分离，api使用restful协议，方便二次开发，后端使用Python，Django，DRF等技术，前端代码使用AntD进行构建，包含采购管理，销售管理，库存管理等业务管理流程。移动端使用Uniapp，包含产品标签打印，出入库扫码等功能。 * Gitee地址: [Gitee](https://gitee.com/himool/erp) * Github地址: [Github](https://github.com/himool/HimoolERP) * Demo地址: [Demo](https://erp.himool.com) ### 项目背景 #### 目前市面上没有一款采用流行的前后端技术易用开源的ERP系统。有不少朋友也跟我们反应实施了ERP系统但是仍然会面临许多问题，尤其二开的费用高昂。于是我们总结了这些年ERP系统开发的经验，设计了这款开源的盒木ERP系统，支持高自由度的开发，来支持企业的自定义需求。我们的代码将持续更新，并且保持与[Demo](https://erp.himool.com)地址的同步。 ### 硬件要求及开发环境 * 移动端打印功能需指定型号PDA，请联系作者购买 * Python版本为V3.9+ * Django版本为V3.2+ * Django-rest-framework版本为V3.12+ * Vue版本为2.6+ * PDA端使用Uniapp * 数据库为MySQL * 前端组件为AntD * 其他Python包可参考requirements.txt文件 ### 搭建运行环境 * pip install -r requirements.txt * cd frontend #进入frontend文件夹 * npm install -g @vue/cli #安装vue脚手架 * npm install #安装依赖包 ### 配置 MySQL 1. 数据库字符集设置为 utf8mb4 2. 创建 erp-db 数据库(先设置字符集, 再创建数据库) CREATE DATABASE erp_db; 3. 创建配置文件 * python tools/create_configs.py 4. 迁移数据库 * python manage.py makemigrations * python manage.py migrate 5. 创建用户 * python manage.py runscript create_user ### 本地运行 1. 启动后端服务 python manage.py runserver 2. 启动前端服务 npm run serve 3. 浏览器访问前端地址 ### 服务器运行 1. 配置 uwsgi pip install uwsgi 2. 运行 uwsgi uwsgi --ini [项目路径]/configs/uwsgi.ini 3. 配置 nginx(配置文件在 /configs/nginx) 4. 构建前端文件 进入 frontend 目录, npm run build ### 业务流程  ### 管理模块  ### PDA界面截图  ### PC界面截图          ## English ## Himool ERP--Open Source ERP System ### Read me #### License Agreement:GPL-3.0，you can use this project for learning, business purpose is prohibited, please request authority from us before you use it for business. #### If you're interested to join us and make this project perfect, please send email to me. [email protected]<br /><br /> ### Company Introduction Himool Technology is focus on supply chain digitalization. All the products are developed by ourselves, now we have published [Himool ERP](https://www.himool.com/erp), [Himool WMS](https://www.himool.com/wms) and [Himool WCS](https://www.himool.com/wcs). ERP is free，only charge fee to customized demands and agency who requests authorit, we're aiming to be the leader of open-source ERP providers, we offer professional ERP service to our customers.<br /> #### If you're interested in join as an agent([Conditions to be an agent](https://www.himool.com/partner)), please scan below wechat QR code, call me +86 18761717855 or email me.<br />  ### Project Introduction #### Himool ERP contains core processes like master data, purchasing, sales, inbound, outbound and payment. * Gitee地址: [Gitee](https://gitee.com/himool/erp) * Github地址: [Github](https://github.com/himool/HimoolERP) * Demo地址: [Demo](https://erp.himool.com) ### Devlopment Environment * Python version V3.9+ * Django version V3.2+ * Djangorestframework version V3.12+ * Vue version 2.6+ * Uniapp for mobile device * MySQL for database * AntD for frontend UI element * Please refer to requirement.txt for other python package ### Build Environment * Install Pythonpip install -r requirements.txt * Go to frontend foldercd frontend * Install vuenpm install -g @vue/cli * Install package dependenciesnpm install ### Config MySQL 1. utf8mb4 for Database character setting 2. Create datebase: CREATE DATABASE erp_db; CREATE DATABASE erp_db; 3. Migrate Database * python manage.py makemigrations * python manage.py migrate 4. Create User * python manage.py runscript create_user ### Run in Local Machine 1. Start Backend service python manage.py runserver 2. Start frontend service npm run serve 3. Access frontend address ### Run in Server 1. Config uwsgi pip install uwsgi 2. Run uwsgi uwsgi --ini [project path]/configs/uwsgi.ini 3. Config nginx(Config file in /configs/nginx) 4. Build frontend file Go to frontend directory, npm run build ### Business Workflow ![Busines