# 盒木ERP社区版-进销存系统
**Repository Path**: himool/erp
## Basic Information
- **Project Name**: 盒木ERP社区版-进销存系统
- **Description**: 开源ERP系统，该系统前后端分离，包含PDA移动端扫码操作，api使用restful协议，方便二次开发，后端使用Python，Django，DRF等技术，前端代码使用AntD进行构建，包含采购管理，销售管理，库存管理等业务管理流程。移动端使用Uniapp，包含产品标签打印，出入库扫码等功能。
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: https://www.himool.com
- **GVP Project**: No
## Statistics
- **Stars**: 605
- **Forks**: 284
- **Created**: 2021-07-09
- **Last Updated**: 2025-08-20
## Categories & Tags
**Categories**: erp
**Tags**: Python, ERP, Django, 进销存
## README
## 语言/Language
- [中文](#中文)
- [English](#english)
## 中文
## 盒木ERP社区版--开源ERP进销存管理系统
### 使用前须知
#### 软件开放源码(发行协议:GPL-3.0)，个人用户可免费学习使用，但禁止任何单位或个人修改软件后再次发行的行为。商业使用需得到我司授权，否则我们将通过法律途径解决侵权问题。
### 公司介绍
[盒木科技](https://www.himool.com)是一家专注于**智能制造**系统研发的科技创新企业。目前已发布[盒木MES制造执行系统](https://www.himool.com/product/mes/)，[盒木WMS仓库管理系统](https://www.himool.com/product/wms/)，[盒木WCS仓库控制系统](https://www.himool.com/product/wcs/), [盒木IoT物联网数据采集平台](https://www.himool.com/product/iot/)及盒木ERP企业管理系统。其中ERP含社区版和企业版：
* **社区版**为开源进销存系统，包含采购，销售，库存，财务等模块。
* **企业版**为智慧工厂管理系统，除了社区版功能外，还增加了生产管理，质检管理，物料管控及追溯，实时看板，移动端App等实用功能。
#### ERP的服务模式
* 客户定制服务。无论社区版还是企业版，针对有定制需求的客户我们将提供定制开发服务。
* 社区版商业授权。开源社区需要您的支持以得以发展，如果您希望将我们的系统或源码二次开发后出售给其他客户，请先联系我们获得商业授权，否则将承担法律风险。
### 项目介绍
#### 该系统前后端分离，api使用restful协议，方便二次开发，后端使用Python，Django，DRF等技术，前端代码使用AntD进行构建，包含采购管理，销售管理，库存管理等业务管理流程。移动端使用Uniapp，包含产品标签打印，出入库扫码等功能。
* Gitee地址: [Gitee](https://gitee.com/himool/erp)
* Github地址: [Github](https://github.com/HimoolTech/ERP)
### 项目背景
#### 目前市面上没有一款采用流行的前后端技术易用开源的ERP系统。有不少朋友也跟我们反应实施了ERP系统但是仍然会面临许多问题，尤其二开的费用高昂。于是我们总结了这些年ERP系统开发的经验，设计了这款开源的ERP系统，支持高自由度的开发，来支持企业的自定义需求。
### 硬件要求及开发环境
* 移动端打印功能需指定型号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. marketing@himool.com
### Company Introduction
Himool Technology is focus on supply chain digitalization. All the products are developed by ourselves, now we have published [Himool MES](https://www.himool.com/product/mes/), [Himool WMS](https://www.himool.com/wms/), [Himool WCS](https://www.himool.com/wcs/) and [Himool ERP](https://www.himool.com/erp/). 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.
### 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/HimoolERP/ERP)
### 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
### Functional Modules
### PDA Demo
### PC Demo
