# TableTrack 库存管理模块
## 项目概述
**TableTrack 库存管理模块** 是 TableTrack 餐厅管理系统的库存管理扩展模块。该模块提供完整的库存管理功能，包括库存物品管理、采购订单、供应商管理、库存移动、配方管理等。
**注意**: 这是一个插件模块，需要配合 TableTrack 主系统使用。
## 主要功能
### 核心功能
- **库存物品管理** - 添加、编辑、管理库存物品
- **物品分类** - 库存物品分类管理
- **采购订单** - 创建和管理采购订单
- **供应商管理** - 供应商信息管理
- **库存移动** - 库存出入库记录
- **库存盘点** - 库存盘点和调整
- **配方管理** - 菜品配方和原料管理
- **批量配方** - 批量配方管理
- **单位管理** - 计量单位管理
- **库存报告** - 库存统计报告
### 控制器功能
- **InventoryDashboardController** - 库存仪表板
- **InventoryItemController** - 库存物品管理
- **InventoryItemCategoryController** - 物品分类管理
- **InventoryMovementController** - 库存移动管理
- **InventoryRecipeController** - 配方管理
- **InventoryStockController** - 库存管理
- **InventorySettingController** - 库存设置
- **PurchaseOrderController** - 采购订单管理
- **SupplierController** - 供应商管理
- **ReportController** - 报告统计
- **StockController** - 库存盘点
- **UnitController** - 单位管理
- **BatchRecipeController** - 批量配方
## 技术栈
### 后端
- **框架**: Laravel (配合 TableTrack)
- **架构**: 模块化架构 (nwidart/laravel-modules)
- **PHP 版本**: 8.0+
### 主要组件
- **Livewire** - 动态组件
- **Entities** - 数据实体
- **Listeners** - 事件监听
- **Observers** - 模型观察器
- **Exports** - 数据导出
## 文件结构
```
codecanyon-57274242-inventory-module-for-tabletrack/
└── Inventory/ # 库存模块
├── Config/ # 配置文件
├── Console/ # 命令行
├── Database/ # 数据库
│ ├── Migrations/ # 迁移文件
│ └── Seeders/ # 种子文件
├── Emails/ # 邮件模板
├── Entities/ # 数据实体
├── Exports/ # 导出功能
├── Http/
│ └── Controllers/ # 控制器
│ ├── InventoryDashboardController.php
│ ├── InventoryItemController.php
│ ├── InventoryItemCategoryController.php
│ ├── InventoryMovementController.php
│ ├── InventoryRecipeController.php
│ ├── InventorySettingController.php
│ ├── InventoryStockController.php
│ ├── PurchaseOrderController.php
│ ├── ReportController.php
│ ├── StockController.php
│ ├── SupplierController.php
│ ├── UnitController.php
│ └── BatchRecipeController.php
├── Listeners/ # 事件监听
├── Livewire/ # Livewire 组件
├── Notifications/ # 通知
├── Observers/ # 模型观察器
├── Providers/ # 服务提供者
│ └── InventoryServiceProvider.php
├── Resources/ # 资源文件
│ └── views/ # 视图模板
├── Routes/ # 路由
│ └── web.php
├── module.json # 模块配置
├── laraupdater.json # 更新配置
└── version.txt # 版本号
```
## 安装说明
### 前置要求
- 已安装 TableTrack 主系统
- PHP 8.0+
- Laravel 框架
### 安装步骤
1. 将 Inventory 文件夹复制到 TableTrack 的 Modules 目录
2. 运行模块安装命令
3. 执行数据库迁移
4. 清除缓存
### 更新
使用 laraupdater.json 配置进行模块更新
## 亮点特色
1. **完整库存管理** - 从采购到使用的全流程管理
2. **配方管理** - 菜品原料配方管理
3. **供应商管理** - 完整的供应商信息管理
4. **库存盘点** - 定期盘点和调整功能
5. **报告统计** - 详细的库存报告
6. **模块化设计** - 易于集成到 TableTrack
7. **Livewire 组件** - 动态交互体验
8. **数据导出** - 支持数据导出功能
