# WMS for openclaw

**Repository Path**: electronicCommerce/wms-for-openclaw

## Basic Information

- **Project Name**: WMS for openclaw
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-08
- **Last Updated**: 2026-03-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WMS 仓库管理系统

基于 Laravel + MySQL + Layui 的电商仓库管理系统

## 技术栈

- **后端**: Laravel 10 + PHP 8.1+
- **数据库**: MySQL 8.0+
- **前端**: Layui 2.8 + jQuery
- **缓存**: Redis (可选)

## 功能模块

### 一、基础资料与配置
1. 商品管理 - SKU、条码、规格、重量、体积
2. 货架管理 - 库区、货位编码
3. 批次管理 - 生产日期、失效日期
4. 容器管理 - 纸箱、周转箱
5. 供应商管理

### 二、入库管理
6. 入库单管理
7. 入库质检
8. 上架管理

### 三、库存管理
9. 库存查询
10. 库存锁定/预占
11. 库存盘点
12. 库龄管理
13. 库存移动/补货
14. 异常库存管理

### 四、出库管理
15. 出库单管理
16. 订单下架（拣货）
17. 订单打包
18. 订单发货
19. 物流追踪

### 五、订单与波次管理
20. 订单管理
21. 波次策略
22. 订单拦截/取消

### 六、退货管理
23. 退货单管理
24. 退货质检
25. 退货上架
26. 退款/换货处理

### 七、系统支持
27. 权限管理
28. 日志管理

## 安装步骤

### 1. 环境要求
- PHP >= 8.1
- MySQL >= 8.0
- Composer
- Node.js & NPM (可选，用于前端构建)

### 2. 安装 Laravel 项目
```bash
composer create-project laravel/laravel wms
cd wms
```

### 3. 配置数据库
复制 `code/` 目录下的所有文件到 Laravel 项目中

修改 `.env` 文件：
```env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=wms
DB_USERNAME=root
DB_PASSWORD=your_password
```

### 4. 执行迁移
```bash
php artisan migrate
```

### 5. 安装依赖（如果需要权限管理）
```bash
composer require spatie/laravel-permission
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"
```

### 6. 启动服务
```bash
php artisan serve
```

访问 http://localhost:8000

## 项目结构

```
wms/
├── app/
│   ├── Models/              # 数据模型
│   ├── Http/
│   │   └── Controllers/
│   │       └── Admin/       # 后台控制器
│   ├── Services/            # 业务逻辑层
│   └── Repositories/        # 数据访问层
├── database/
│   └── migrations/          # 数据库迁移文件
├── resources/
│   └── views/
│       └── admin/           # 后台视图
├── routes/
│   └── admin.php            # 后台路由
└── config/
```

## 数据库表结构

- categories - 商品分类
- brands - 品牌
- goods - 商品
- goods_images - 商品图片
- goods_attributes - 商品属性
- warehouses - 仓库
- zones - 库区
- locations - 货位
- containers - 容器
- suppliers - 供应商
- customers - 客户
- inbound_orders - 入库单
- inbound_items - 入库明细
- quality_checks - 质检记录
- putaway_tasks - 上架任务
- inventories - 库存
- inventory_logs - 库存流水
- inventory_locks - 库存锁定
- stock_checks - 盘点单
- stock_check_items - 盘点明细
- move_tasks - 移库任务
- outbound_orders - 出库单
- outbound_items - 出库明细
- picking_tasks - 拣货任务
- packing_records - 打包记录
- orders - 订单
- order_items - 订单明细
- waves - 波次
- wave_orders - 波次订单关联
- return_orders - 退货单
- return_items - 退货明细
- return_quality_checks - 退货质检
- operation_logs - 操作日志

## 核心功能说明

### 入库流程
1. 创建入库单 → 2. 收货确认 → 3. 质检 → 4. 生成上架任务 → 5. 上架确认 → 6. 更新库存

### 出库流程
1. 订单同步 → 2. 生成波次 → 3. 分配拣货任务 → 4. PDA拣货 → 5. 打包 → 6. 发货 → 7. 物流回传

### 库存盘点
1. 创建盘点单 → 2. 分配盘点任务 → 3. 盘点录入 → 4. 差异审核 → 5. 库存调整

## 开发团队

- 开发: OpenClaw AI Assistant
- 日期: 2026-03-08

## 许可证

MIT License