163 lines
4.1 KiB
Markdown
163 lines
4.1 KiB
Markdown
# ERP系统后端项目
|
|
|
|
## 项目状态
|
|
|
|
✅ **已完成模块**:
|
|
1. 采购单模块 (PurchaseOrderController)
|
|
2. 收货单模块 (ReceivingOrderController)
|
|
3. 模板模块 (TemplateController)
|
|
4. 仓库模板绑定模块 (WarehouseTemplateBindingController)
|
|
5. 订单模块 (OrderController)
|
|
6. **店铺授权模块 (ShopAuthController)**
|
|
7. **平台商品模块 (PlatformController)**
|
|
|
|
## 新增模块详情
|
|
|
|
### 店铺授权模块 (ShopAuthController)
|
|
- 支持多平台授权 (淘宝、天猫、京东、拼多多、抖音)
|
|
- 完整的OAuth2授权流程
|
|
- 令牌管理和刷新机制
|
|
- 店铺信息管理
|
|
|
|
### 平台商品模块 (PlatformController)
|
|
- 平台商品数据同步
|
|
- 商品信息管理
|
|
- 批量操作支持
|
|
- 同步状态跟踪
|
|
- 统计功能
|
|
|
|
## 数据库结构
|
|
|
|
### 店铺授权表 (shop_auths)
|
|
```sql
|
|
CREATE TABLE shop_auths (
|
|
id INT PRIMARY KEY AUTO_INCREMENT,
|
|
platform VARCHAR(50) NOT NULL,
|
|
shop_name VARCHAR(255) NOT NULL,
|
|
access_token TEXT NOT NULL,
|
|
refresh_token TEXT,
|
|
expires_at DATETIME,
|
|
status VARCHAR(50) DEFAULT 'active',
|
|
config JSON,
|
|
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
|
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
|
|
);
|
|
```
|
|
|
|
### 平台商品表 (platforms)
|
|
```sql
|
|
CREATE TABLE platforms (
|
|
id INT PRIMARY KEY AUTO_INCREMENT,
|
|
shop_auth_id INT NOT NULL,
|
|
platform_product_id VARCHAR(100) NOT NULL,
|
|
platform_sku_id VARCHAR(100),
|
|
title VARCHAR(200) NOT NULL,
|
|
description TEXT,
|
|
price DECIMAL(10,2) NOT NULL,
|
|
original_price DECIMAL(10,2),
|
|
stock INT DEFAULT 0,
|
|
sold INT DEFAULT 0,
|
|
images JSON,
|
|
specs JSON,
|
|
status ENUM('on_sale', 'off_sale', 'deleted') DEFAULT 'on_sale',
|
|
sync_status ENUM('pending', 'syncing', 'synced', 'failed') DEFAULT 'pending',
|
|
last_sync_at DATETIME,
|
|
sync_error TEXT,
|
|
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
|
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
|
FOREIGN KEY (shop_auth_id) REFERENCES shop_auths(id) ON DELETE CASCADE,
|
|
INDEX idx_shop_product (shop_auth_id, platform_product_id),
|
|
INDEX idx_sync_status (sync_status),
|
|
INDEX idx_status (status)
|
|
);
|
|
```
|
|
|
|
## API接口
|
|
|
|
### 店铺授权模块
|
|
- `GET /api/shops` - 店铺列表
|
|
- `GET /api/shops/platforms` - 支持的平台
|
|
- `POST /api/shops/auth-url` - 获取授权URL
|
|
- `POST /api/shops/callback` - 授权回调
|
|
- `GET /api/shops/{id}` - 店铺详情
|
|
- `POST /api/shops/{id}/refresh` - 刷新令牌
|
|
- `DELETE /api/shops/{id}` - 删除授权
|
|
|
|
### 平台商品模块
|
|
- `GET /api/platforms` - 商品列表
|
|
- `POST /api/platforms` - 创建商品
|
|
- `GET /api/platforms/stats` - 统计信息
|
|
- `POST /api/platforms/sync` - 同步商品
|
|
- `POST /api/platforms/batch-update` - 批量更新
|
|
- `GET /api/platforms/{id}` - 商品详情
|
|
- `PUT /api/platforms/{id}` - 更新商品
|
|
- `DELETE /api/platforms/{id}` - 删除商品
|
|
|
|
## 安装和运行
|
|
|
|
1. 安装依赖:
|
|
```bash
|
|
composer install
|
|
```
|
|
|
|
2. 配置环境:
|
|
```bash
|
|
cp .env.example .env
|
|
php artisan key:generate
|
|
```
|
|
|
|
3. 运行迁移:
|
|
```bash
|
|
php artisan migrate
|
|
```
|
|
|
|
4. 启动服务:
|
|
```bash
|
|
php artisan serve
|
|
```
|
|
|
|
## 测试
|
|
|
|
运行测试:
|
|
```bash
|
|
php artisan test
|
|
```
|
|
|
|
## 前端对接
|
|
|
|
后端开发已完成，前端可以开始对接以下接口:
|
|
1. 店铺授权相关接口
|
|
2. 平台商品管理接口
|
|
3. 其他已完成的模块接口
|
|
|
|
详细API文档请参考: `API_DOCUMENTATION.md`
|
|
|
|
## 下一步开发
|
|
|
|
1. 实现具体平台API集成
|
|
2. 添加商品同步队列
|
|
3. 实现订单同步功能
|
|
4. 完善错误处理和监控
|
|
|
|
## 项目结构
|
|
```
|
|
erp-backend/
|
|
├── app/
|
|
│ ├── Http/
|
|
│ │ └── Controllers/
|
|
│ │ ├── ShopAuthController.php
|
|
│ │ └── PlatformController.php
|
|
│ └── Models/
|
|
│ ├── ShopAuth.php
|
|
│ └── Platform.php
|
|
├── database/
|
|
│ └── migrations/
|
|
│ ├── create_shop_auths_table.php
|
|
│ └── create_platforms_table.php
|
|
├── routes/
|
|
│ └── api.php
|
|
├── tests/
|
|
│ └── ModulesTest.php
|
|
├── API_DOCUMENTATION.md
|
|
└── README.md
|
|
``` |