如何快速上手 GreaterWMS：开源仓库管理系统的完整指南 🚀

GreaterWMS 是一款功能强大的开源仓库管理系统，源自福特亚太售后物流仓储供应链流程，支持仓库空间共享与供需匹配，帮助用户高效管理库存并创造收益。本文将带你轻松掌握项目结构、启动方法和核心配置，让仓库管理变得简单高效！

📋 项目核心目录结构解析

了解项目结构是高效使用的第一步。GreaterWMS 采用清晰的模块化设计，主要分为前端、后端和配置文件三大部分：

GreaterWMS/
├── app/                  # 移动应用源码（支持Android/iOS）
├── templates/            # 前端模板文件
├── greaterwms/           # 后端核心源码
├── docker-compose.yml    # Docker快速部署配置
├── manage.py             # Django管理脚本
└── requirements.txt      # Python依赖包列表

📱 移动端与前端目录

• app/：存放移动应用源码，支持跨平台部署，满足仓库移动操作需求。
• templates/：包含前端界面模板，其中 src/ 目录存放Vue组件和页面逻辑，public/ 存放静态资源。

图：GreaterWMS系统主界面，直观展示仓库管理核心功能

🖥️ 后端核心目录

• greaterwms/：后端灵魂所在，包含：
  • settings.py：项目配置中心（数据库、静态文件等）
  • urls.py：API路由定义
  • wsgi.py/asgi.py：服务器网关接口配置

📦 业务功能模块

项目按业务场景拆分多个功能模块，如：

• goods/：商品管理
• stock/：库存操作
• dn/：出库管理
• asn/：入库管理

⚡ 快速启动项目的两种方法

1️⃣ 传统Python环境启动

# 克隆仓库
git clone https://gitcode.com/gh_mirrors/gr/GreaterWMS

# 安装依赖
pip install -r requirements.txt

# 数据库迁移
python manage.py makemigrations
python manage.py migrate

# 启动开发服务器
python manage.py runserver 0.0.0.0:8000

2️⃣ Docker一键部署（推荐新手）

# 启动容器集群
docker-compose up -d

# 查看服务状态
docker-compose ps

图：GreaterWMS移动端出库操作界面，支持仓库移动作业

🔧 核心配置文件详解

1. settings.py：系统配置中枢

位置：greaterwms/settings.py

主要配置项：

# 数据库配置（默认SQLite，支持MySQL/PostgreSQL）
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

# 静态文件路径
STATIC_URL = '/static/'
STATICFILES_DIRS = [BASE_DIR / "static"]

2. docker-compose.yml：容器化配置

快速调整服务端口和依赖：

version: '3'
services:
  web:
    build: .
    command: python manage.py runserver 0.0.0.0:8000
    ports:
      - "8000:8000"  # 端口映射
    volumes:
      - .:/code       # 代码热更新

📱 移动端与多端协同

项目提供完整的移动端解决方案，源码位于 app/ 目录，支持：

• 扫码入库/出库
• 库存实时查询
• 移动盘点

图：GreaterWMS移动端设备管理界面，适配仓库手持终端

📚 官方资源与扩展

• 项目文档：docs/PR_GUIDELINES.md
• 依赖管理：requirements.txt
• 静态资源：static/ 和 static_new/ 目录存放系统图片和样式文件

💡 新手常见问题解决

1. 依赖安装失败：使用Python 3.8+环境，推荐虚拟环境隔离
2. 数据库连接错误：检查 settings.py 中的数据库配置
3. 端口占用：修改 docker-compose.yml 中的端口映射

通过本文的指南，你已经掌握了GreaterWMS的核心结构和启动方法。这个开源仓库管理系统不仅能帮你高效管理库存，还支持仓库空间共享，让闲置资源创造价值！立即动手尝试，开启智能仓库管理之旅吧！