316 lines
8.4 KiB
Markdown
316 lines
8.4 KiB
Markdown
# 线报批量发品功能说明
|
||
|
||
## 功能概述
|
||
|
||
线报批量发品功能允许用户通过输入框输入线报消息，自动解析出商品信息，然后批量发品到多个ERP账号，并支持延迟自动上架。
|
||
|
||
## 主要特性
|
||
|
||
### 1. 智能解析
|
||
- 支持从线报消息中自动识别京东商品链接
|
||
- 支持多种链接格式（item.jd.com、u.jd.com短链接等）
|
||
- 自动提取SKUID并查询商品详情
|
||
- 获取商品名称、价格、图片、店铺等信息
|
||
|
||
### 2. 批量选择
|
||
- 可视化商品列表，支持全选/反选
|
||
- 展示商品图片、名称、价格、佣金等信息
|
||
- 灵活选择需要发品的商品
|
||
|
||
### 3. 多账号发品
|
||
- 支持同时选择多个ERP账号（胡歌、刘强东等）
|
||
- 每个商品会发送到所有选中的账号
|
||
- 自动生成商家编码，避免重复
|
||
|
||
### 4. 通用参数设置
|
||
- 支持统一设置：会员名、省市区、商品类型、行业类型、类目等
|
||
- 支持设置邮费、库存、成色、服务支持等
|
||
- 一次设置，应用到所有商品
|
||
|
||
### 5. 延迟队列上架
|
||
- 发品成功后自动加入延迟队列
|
||
- 可自定义延迟时间（1-60秒）
|
||
- 到时后自动调用上架接口
|
||
|
||
### 6. 进度跟踪
|
||
- 实时显示发品进度
|
||
- 展示每个商品在每个账号的发品状态
|
||
- 记录成功数、失败数、错误信息
|
||
|
||
### 7. 历史记录
|
||
- 保存所有批量发品任务记录
|
||
- 支持查看任务详情和发品明细
|
||
- 可追溯每个商品的发品结果
|
||
|
||
## 使用流程
|
||
|
||
### 第一步：输入线报消息
|
||
|
||
在输入框中粘贴线报消息，支持以下格式：
|
||
|
||
```
|
||
【京东】某某商品
|
||
https://item.jd.com/100012345678.html
|
||
原价：999元
|
||
...
|
||
|
||
【京东】另一个商品
|
||
https://u.jd.com/xxxxx
|
||
到手价：199元
|
||
...
|
||
```
|
||
|
||
点击"解析商品"按钮，系统会自动提取商品链接并查询详情。
|
||
|
||
### 第二步：选择商品
|
||
|
||
- 系统展示解析出的商品列表
|
||
- 勾选需要发品的商品（支持全选）
|
||
- 查看商品信息确认无误
|
||
- 点击"下一步"
|
||
|
||
### 第三步：设置参数
|
||
|
||
#### 3.1 基本设置
|
||
- **任务名称**（选填）：为本次批量发品任务命名
|
||
- **延迟上架**：设置发品成功后延迟多少秒自动上架（默认3秒）
|
||
|
||
#### 3.2 目标账号
|
||
- 选择一个或多个ERP账号（支持多选）
|
||
- 每个商品将发送到所有选中的账号
|
||
|
||
#### 3.3 通用参数
|
||
- **会员名**：闲鱼会员名（必填）
|
||
- **省市区**：发货地址代码（必填）
|
||
- **商品类型**：普通商品/已验货/验货宝等（必填）
|
||
- **行业类型**：手机/家电/数码等（必填）
|
||
- **类目ID**：商品类目ID（必填）
|
||
- **邮费**：邮费金额（元，必填）
|
||
- **库存**：库存数量（必填）
|
||
- **成色**：全新/99新等（选填）
|
||
- **服务支持**：七天无理由退货等（选填）
|
||
|
||
点击"开始批量发品"提交任务。
|
||
|
||
### 第四步：查看进度
|
||
|
||
- 系统创建批量发品任务
|
||
- 实时展示发品进度条
|
||
- 显示每个商品在每个账号的发品状态
|
||
- 发品成功的商品会自动加入延迟队列等待上架
|
||
|
||
## 数据库表结构
|
||
|
||
### batch_publish_task（批量发品任务表）
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| id | bigint | 任务ID |
|
||
| task_name | varchar(200) | 任务名称 |
|
||
| original_message | text | 原始线报消息 |
|
||
| total_products | int | 解析出的商品数量 |
|
||
| selected_products | int | 选中的商品数量 |
|
||
| target_accounts | varchar(500) | 目标ERP账号（JSON） |
|
||
| status | int | 任务状态：0待处理 1处理中 2已完成 3失败 |
|
||
| success_count | int | 成功发品数量 |
|
||
| fail_count | int | 失败发品数量 |
|
||
| common_params | text | 通用参数（JSON） |
|
||
| create_user_id | bigint | 创建人ID |
|
||
| create_user_name | varchar(100) | 创建人姓名 |
|
||
| create_time | datetime | 创建时间 |
|
||
| complete_time | datetime | 完成时间 |
|
||
|
||
### batch_publish_item（批量发品明细表）
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| id | bigint | 明细ID |
|
||
| task_id | bigint | 任务ID |
|
||
| skuid | varchar(100) | SKUID |
|
||
| product_name | varchar(500) | 商品名称 |
|
||
| target_account | varchar(100) | 目标ERP账号 |
|
||
| account_remark | varchar(100) | 账号备注名 |
|
||
| status | int | 发品状态：0待发布 1发布中 2发布成功 3发布失败 4上架中 5已上架 6上架失败 |
|
||
| product_id | bigint | ERP商品ID |
|
||
| product_status | int | 商品状态 |
|
||
| outer_id | varchar(100) | 商家编码 |
|
||
| publish_price | bigint | 发品价格（分） |
|
||
| error_message | varchar(1000) | 失败原因 |
|
||
| publish_time | datetime | 上架时间 |
|
||
| delay_seconds | int | 延迟上架时间（秒） |
|
||
| create_time | datetime | 创建时间 |
|
||
|
||
## API接口
|
||
|
||
### 1. 解析线报消息
|
||
```
|
||
POST /jarvis/batchPublish/parse
|
||
Content-Type: application/json
|
||
|
||
{
|
||
"message": "线报消息内容"
|
||
}
|
||
|
||
返回：
|
||
{
|
||
"code": 200,
|
||
"msg": "操作成功",
|
||
"data": [
|
||
{
|
||
"skuid": "100012345678",
|
||
"productName": "商品名称",
|
||
"price": 199.0,
|
||
"productImage": "http://...",
|
||
"shopName": "店铺名称",
|
||
"shopId": "12345",
|
||
"commissionInfo": "10%"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
### 2. 批量发品
|
||
```
|
||
POST /jarvis/batchPublish/publish
|
||
Content-Type: application/json
|
||
|
||
{
|
||
"taskName": "任务名称",
|
||
"originalMessage": "原始消息",
|
||
"products": [
|
||
{
|
||
"skuid": "100012345678",
|
||
"productName": "商品名称",
|
||
"price": 199.0
|
||
}
|
||
],
|
||
"targetAccounts": ["1016208368633221", "1206879680251333"],
|
||
"delaySeconds": 3,
|
||
"commonParams": {
|
||
"userName": "会员名",
|
||
"province": 110000,
|
||
"city": 110100,
|
||
"district": 110101,
|
||
"itemBizType": 2,
|
||
"spBizType": 3,
|
||
"channelCatId": "12345",
|
||
"expressFee": 0.0,
|
||
"stock": 1,
|
||
"stuffStatus": 100
|
||
}
|
||
}
|
||
|
||
返回：
|
||
{
|
||
"code": 200,
|
||
"msg": "任务已创建",
|
||
"data": 123 // 任务ID
|
||
}
|
||
```
|
||
|
||
### 3. 查询任务列表
|
||
```
|
||
GET /jarvis/batchPublish/task/list?pageNum=1&pageSize=10
|
||
|
||
返回：
|
||
{
|
||
"code": 200,
|
||
"msg": "查询成功",
|
||
"rows": [...],
|
||
"total": 10
|
||
}
|
||
```
|
||
|
||
### 4. 查询任务详情
|
||
```
|
||
GET /jarvis/batchPublish/task/{taskId}
|
||
|
||
返回任务详细信息
|
||
```
|
||
|
||
### 5. 查询任务明细
|
||
```
|
||
GET /jarvis/batchPublish/item/list/{taskId}
|
||
|
||
返回任务所有发品明细
|
||
```
|
||
|
||
## 状态说明
|
||
|
||
### 任务状态
|
||
- 0：待处理
|
||
- 1：处理中
|
||
- 2：已完成
|
||
- 3：失败
|
||
|
||
### 发品状态
|
||
- 0：待发布
|
||
- 1：发布中
|
||
- 2：发布成功
|
||
- 3：发布失败
|
||
- 4：上架中
|
||
- 5：已上架
|
||
- 6：上架失败
|
||
|
||
## 技术实现
|
||
|
||
### 后端
|
||
- **解析工具**：LineReportParser - 正则表达式提取链接和SKUID
|
||
- **Service**：BatchPublishServiceImpl - 核心业务逻辑
|
||
- **异步任务**：@Async注解 + CompletableFuture实现延迟队列
|
||
- **数据库**：MyBatis + MySQL存储任务和明细
|
||
|
||
### 前端
|
||
- **框架**：Vue 2 + Element UI
|
||
- **步骤条**：el-steps实现4步向导
|
||
- **实时刷新**：定时器轮询任务状态
|
||
- **组件**：表格、表单、对话框等
|
||
|
||
## 注意事项
|
||
|
||
1. **线报消息格式**：尽量包含完整的京东商品链接，便于准确识别
|
||
2. **价格获取**：价格从京东API实时查询，可能与线报价格有差异
|
||
3. **账号限制**：请确保ERP账号有足够的发品额度
|
||
4. **延迟上架**：建议设置3-5秒延迟，避免频繁操作
|
||
5. **参数设置**：通用参数会应用到所有商品，请仔细核对
|
||
6. **批量操作**：大批量发品时请分批进行，避免超时
|
||
|
||
## 常见问题
|
||
|
||
### Q1: 解析不到商品怎么办？
|
||
A: 确保线报消息中包含完整的京东商品链接，如：https://item.jd.com/xxxxx.html
|
||
|
||
### Q2: 发品失败是什么原因？
|
||
A: 可能原因：账号额度不足、商品信息不完整、网络异常等，查看错误信息了解详情
|
||
|
||
### Q3: 可以同时发多少个商品？
|
||
A: 理论上无限制，但建议每次不超过50个商品，避免超时
|
||
|
||
### Q4: 延迟上架的作用是什么？
|
||
A: 避免频繁操作触发平台限制，给系统缓冲时间
|
||
|
||
### Q5: 如何查看历史记录？
|
||
A: 点击页面右上角的"历史记录"按钮，可以查看所有批量发品任务
|
||
|
||
## 未来优化方向
|
||
|
||
1. [ ] 集成实际的发品接口（目前为模拟）
|
||
2. [ ] 支持商品价格批量调整
|
||
3. [ ] 支持文案自动生成
|
||
4. [ ] 支持图片批量处理
|
||
5. [ ] 支持发品模板保存
|
||
6. [ ] 支持定时发品
|
||
7. [ ] 支持发品失败自动重试
|
||
8. [ ] 支持发品结果通知（钉钉/企微）
|
||
|
||
## 更新日志
|
||
|
||
### v1.0.0 (2025-01-10)
|
||
- ✅ 初始版本
|
||
- ✅ 实现线报消息解析
|
||
- ✅ 实现批量发品
|
||
- ✅ 实现延迟队列上架
|
||
- ✅ 实现多账号支持
|
||
- ✅ 实现历史记录查询
|
||
|