# comfy

**Repository Path**: eruca520/comfy

## Basic Information

- **Project Name**: comfy
- **Description**: No description available
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-05
- **Last Updated**: 2026-01-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 仓库管理系统

**注意：本项目由AI全面生成，提供完整的仓库管理功能。**

## 项目介绍

一个基于Vue 3和Element Plus的现代化仓库管理系统，提供商品管理、库存管理、订单管理、盘点管理和数据管理等功能。系统采用模块化设计，支持API调用，具有良好的扩展性和可维护性。

## 功能特性

### 📊 工作台
- 实时数据统计（商品总数、订单总数、总库存、低库存商品）
- 快捷操作入口
- 近期订单和低库存商品提醒

### 📦 商品管理
- 商品信息维护（添加、编辑、删除）
- 商品分类管理
- 安全库存设置

### 📈 库存管理
- 实时库存查询
- 库存变动记录
- 库存预警功能

### 📋 订单管理
- 订单创建和管理
- 入库/出库操作
- 订单状态跟踪

### 🔍 盘点管理
- 库存盘点功能
- 盘点差异分析
- 盘点报告生成

### 📁 数据管理
- 数据导入导出（CSV格式）
- 模板下载功能
- 数据统计和预览

### 🎨 UI设计
- 现代化的侧边栏导航
- 响应式布局，适配不同屏幕尺寸
- 清晰的视觉层次和信息架构

## 技术栈

| 技术 | 版本 | 说明 |
|------|------|------|
| Vue | 3.3.4 | 前端框架 |
| Element Plus | 2.3.12 | UI组件库 |
| Vue Router | 4.x | 路由管理 |
| Vite | 4.4.9 | 构建工具 |

## 项目结构

```
inventory-vue/
├── src/
│   ├── api/              # API模块
│   │   ├── apiRequest.js       # 请求封装
│   │   ├── productApi.js       # 商品API
│   │   ├── inventoryApi.js     # 库存API
│   │   ├── orderApi.js         # 订单API
│   │   ├── importExportApi.js  # 导入导出API
│   │   └── index.js            # API入口
│   ├── components/       # Vue组件
│   │   ├── Dashboard.vue       # 工作台
│   │   ├── ProductManagement.vue  # 商品管理
│   │   ├── StockManagement.vue    # 库存管理
│   │   ├── OrderManagement.vue    # 订单管理
│   │   ├── InventoryCheck.vue     # 盘点管理
│   │   └── DataManagement.vue     # 数据管理
│   ├── utils/            # 工具函数
│   │   ├── inventoryManager.js      # 库存管理器
│   │   └── enhancedInventoryManager.js  # 增强库存管理器
│   ├── App.vue           # 根组件
│   ├── main.js           # 入口文件
│   └── router.js         # 路由配置
├── index.html            # HTML模板
├── package.json          # 项目配置
├── vite.config.js        # Vite配置
└── README.md             # 项目说明
```

## 安装和运行

### 环境要求

- Node.js >= 16.0.0
- npm >= 7.0.0

### 安装步骤

1. **克隆仓库**

```bash
git clone https://gitee.com/eruca520/comfy.git
cd comfy/inventory-vue
```

2. **安装依赖**

```bash
npm install
```

3. **启动开发服务器**

```bash
npm run dev
```

4. **构建生产版本**

```bash
npm run build
```

5. **预览生产版本**

```bash
npm run preview
```

## 使用说明

### 1. 登录系统

启动开发服务器后，访问 `http://localhost:3000/` 即可进入系统。

### 2. 工作台

- 查看系统概览和关键数据
- 使用快捷操作快速进入各功能模块

### 3. 商品管理

- 点击左侧导航栏的"商品管理"进入
- 可以添加、编辑、删除商品信息
- 设置商品的安全库存

### 4. 库存管理

- 点击左侧导航栏的"库存管理"进入
- 查看当前库存状态
- 进行库存调整操作

### 5. 订单管理

- 点击左侧导航栏的"订单管理"进入
- 创建入库/出库订单
- 查看订单历史记录

### 6. 数据管理

- 点击左侧导航栏的"数据管理"进入
- 导出商品模板或库存数据
- 导入CSV格式的数据文件

## API接口

系统提供了完整的API接口，支持外部系统调用：

- `GET /api/products` - 获取商品列表
- `POST /api/products` - 添加商品
- `PUT /api/products/:id` - 更新商品
- `DELETE /api/products/:id` - 删除商品
- `GET /api/inventory` - 获取库存信息
- `POST /api/inventory/transactions` - 创建库存交易
- `GET /api/orders` - 获取订单列表
- `POST /api/orders` - 创建订单

详细的API文档请参考 `src/api/` 目录下的各API模块文件。

## 贡献指南

欢迎对项目进行贡献！请按照以下步骤：

1. Fork 本仓库
2. 新建 `Feat_xxx` 分支
3. 提交代码
4. 新建 Pull Request

## 许可证

MIT License

## 未来发展

### 近期规划

1. **用户权限管理**
   - 实现用户角色和权限控制
   - 支持多用户操作和权限分离

2. **数据可视化**
   - 添加图表统计功能
   - 支持数据趋势分析

3. **批量操作**
   - 支持批量导入/导出数据
   - 批量修改商品信息

4. **移动端适配**
   - 优化移动端界面
   - 支持触摸操作

### 长期规划

1. **多仓库支持**
   - 支持管理多个仓库
   - 仓库间数据同步

2. **供应链管理**
   - 供应商管理
   - 采购订单管理
   - 配送管理

3. **AI智能分析**
   - 销售预测功能
   - 库存优化建议

4. **集成第三方服务**
   - 支付系统集成
   - 物流系统集成
   - ERP系统对接

## 联系方式

如有问题或建议，请通过以下方式联系：

- 邮箱：your-email@example.com
- Gitee：[https://gitee.com/eruca520/comfy](https://gitee.com/eruca520/comfy)

---

**感谢使用仓库管理系统！** 🎉