GreaterWMS开源库存管理系统完整部署指南
项目概述
GreaterWMS是一款功能强大的开源库存管理系统,该系统源自福特亚太区售后物流仓储供应链流程。项目采用现代化的技术栈构建,支持多语言界面,提供完整的仓库管理解决方案。
技术架构
GreaterWMS基于以下核心技术构建:
- 后端框架:Django + Python
- 前端框架:Quasar + Vue.js
- 部署工具:Docker + Docker Compose
- 数据库支持:PostgreSQL / SQLite
- 异步处理:Twisted框架
环境准备
在开始部署前,请确保系统满足以下要求:
- Python 3.8或更高版本
- Node.js 14.19.3或更高版本
- Docker和Docker Compose(推荐使用)
- 至少2GB可用内存
详细部署步骤
第一步:获取项目代码
git clone https://gitcode.com/gh_mirrors/gr/GreaterWMS.git
cd GreaterWMS
第二步:安装依赖包
安装Python依赖:
pip install -r requirements.txt
安装前端依赖:
npm install
第三步:Docker容器化部署
使用Docker Compose快速启动所有服务:
docker-compose up -d
该命令将启动以下服务:
- Web应用服务器
- 数据库服务
- 缓存服务
- 静态文件服务
第四步:基础配置修改
编辑基础URL配置文件,设置正确的访问地址:
# 修改基础URL配置后重启服务
docker-compose restart
第五步:开发环境运行
如需在开发环境中运行:
启动后端服务:
cd GreaterWMS
daphne -p 8008 greaterwms.asgi:application
启动前端界面:
cd templates
quasar dev
第六步:移动端应用构建
支持Android和iOS平台应用构建:
npm install cordova -g
cd app
yarn install
# 开发模式运行
quasar dev -m cordova -T android
# 构建发布版本
quasar build -m android
项目结构说明
GreaterWMS采用模块化设计,主要目录结构包括:
- app/ - 移动端应用源码
- templates/ - Web前端模板
- backend/ - Django后端应用
- static_new/ - 静态资源文件
核心功能模块
系统包含以下主要功能模块:
- 入库管理(ASN) - 处理货物入库流程
- 出库管理(DN) - 管理货物出库操作
- 库存管理 - 实时库存监控和盘点
- 仓库管理 - 仓库空间和货位管理
- 商品管理 - 商品信息和分类管理
- 供应商管理 - 供应商信息维护
- 客户管理 - 客户信息管理
配置说明
数据库配置
系统支持多种数据库后端,默认使用SQLite,生产环境建议使用PostgreSQL。
API文档配置
API文档访问路径配置为基础URL加上'/docs/'路径。
常见问题解决
依赖安装问题
如遇到依赖安装失败,请检查:
- Python和Node.js版本是否符合要求
- 网络连接是否正常
- 系统权限是否足够
端口冲突处理
如默认端口8008被占用,可在配置文件中修改端口号。
总结
通过以上步骤,您已成功部署GreaterWMS开源库存管理系统。该系统提供完整的仓库管理功能,支持多平台访问,能够满足不同规模企业的仓储管理需求。
系统启动后,您可以通过浏览器访问Web界面,或使用移动端应用进行库存管理操作。GreaterWMS将持续为您提供稳定可靠的库存管理服务。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考





