# 电商库存管理系统

> 📦 多平台电商库存统一管理工具 - 支持淘宝/京东/拼多多库存同步

[![Version](https://img.shields.io/badge/version-1.0.0-blue)](https://github.com)
[![License](https://img.shields.io/badge/license-MIT-green)](https://github.com)

---

## ✨ 功能特性

- 🏪 **店铺管理** - 管理淘宝/京东/拼多多多平台店铺
- 📦 **商品管理** - 统一管理商品信息、SKU、价格
- 📊 **库存管理** - 多平台库存同步、库存预警
- 📋 **订单管理** - 订单跟踪、状态管理
- ⚠️ **库存预警** - 低库存自动提醒
- 🔄 **自动同步** - 每 30 分钟自动同步库存
- 📈 **数据看板** - 实时统计销售和库存数据

---

## 🚀 快速开始

### 安装依赖

```bash
cd /root/.openclaw/workspace/电商卖家需要多平台库存管理
npm install
```

### 启动服务

```bash
npm start
```

### 访问系统

打开浏览器访问：http://localhost:3003

---

## 📁 项目结构

```
电商卖家需要多平台库存管理/
├── src/
│   ├── backend/
│   │   ├── server.js      # Express 服务器
│   │   └── database.js    # SQLite 数据库操作
│   └── data/
│       └── inventory.db   # SQLite 数据库
├── frontend/
│   ├── index.html         # 首页看板
│   ├── shops.html         # 店铺管理
│   ├── products.html      # 商品管理
│   ├── inventory.html     # 库存管理
│   └── orders.html        # 订单管理
├── ecosystem.config.js    # PM2 配置
├── package.json
└── README.md
```

---

## 📋 API 接口

### 店铺 API
- GET `/api/shops` - 获取店铺列表
- POST `/api/shops` - 创建店铺
- PUT `/api/shops/:id` - 更新店铺
- DELETE `/api/shops/:id` - 删除店铺

### 商品 API
- GET `/api/products` - 获取商品列表
- POST `/api/products` - 创建商品
- PUT `/api/products/:id` - 更新商品
- DELETE `/api/products/:id` - 删除商品

### 库存 API
- GET `/api/inventory` - 获取库存列表
- GET `/api/inventory/product/:id` - 商品库存详情
- PUT `/api/inventory/:productId/:shopId` - 更新库存
- POST `/api/inventory/sync` - 手动同步库存

### 订单 API
- GET `/api/orders` - 获取订单列表
- POST `/api/orders` - 创建订单
- PUT `/api/orders/:id/status` - 更新订单状态

### 预警 API
- GET `/api/alerts` - 获取预警列表
- PUT `/api/alerts/:id/read` - 标记已读
- GET `/api/alerts/unread-count` - 未读预警数

### 统计 API
- GET `/api/stats/overview` - 概览统计

---

## 💻 技术栈

| 层级 | 技术 |
|------|------|
| 后端 | Node.js + Express |
| 数据库 | SQLite3 |
| 前端 | HTML + TailwindCSS |
| 定时任务 | node-cron |
| 部署 | PM2 |

---

## 📊 数据库表

- **shops** - 店铺表 (平台、店铺 ID)
- **products** - 商品表 (SKU、价格、分类)
- **inventory** - 库存表 (多平台库存)
- **orders** - 订单表
- **stock_alerts** - 库存预警表
- **sync_logs** - 同步日志表

---

## 🔧 部署

### PM2 部署

```bash
# 启动服务
npx pm2 start ecosystem.config.js --env production

# 查看状态
npx pm2 status

# 查看日志
npx pm2 logs ecommerce-inventory
```

### 访问地址

| 环境 | 地址 |
|------|------|
| 本地 | http://localhost:3003 |
| 服务器 | http://服务器IP:3003 |

---

## ⏰ 自动同步

系统每 30 分钟自动同步一次库存，模拟从各平台 API 获取最新库存数据。

手动同步：
```bash
curl -X POST http://localhost:3003/api/inventory/sync
```

---

## 📝 使用场景

### 多店铺库存管理
- 同时在淘宝、京东、拼多多开店
- 统一查看和管理所有店铺库存
- 避免超卖和库存积压

### 库存预警
- 设置安全库存阈值
- 低库存自动提醒
- 及时补货避免缺货

### 订单跟踪
- 统一管理多平台订单
- 跟踪订单状态
- 统计销售数据

---

## 🎯 下一步计划

- [ ] 对接真实平台 API
- [ ] 自动下单功能
- [ ] 数据报表导出
- [ ] 多用户权限

---

*项目由 SaaS Insight 自动创建 | 最后更新：2026-03-11*