# 01 商品域业务闭环

> 本文档包含与商品相关的业务闭环：数据采集、商品刊登、素材管理、商品主数据、SKU变体

---

## 1️⃣ 数据采集与清洗闭环（Product Data Collection & Cleansing）

- **💰 钱流**：
  - 采集成本：API调用费用、代理IP费用、云服务费用
  - 利润评估：采购成本 → 平台费用 → 物流费用 → 税费 → 广告费用 → 净利润
- **🔄 状态变化**：
  - `RAW_DATA` → `CLEANED` → `ANALYZED` → `READY_FOR_LISTING`
- **🔥 触发条件**：
  - 定时任务：按配置的采集频率自动触发
  - 手动触发：用户手动发起采集任务
  - 事件触发：商品价格变动、库存变动等事件触发重新采集

***

## 2️⃣ 商品刊登闭环（Product Listing Loop）

- **目标**：将可售商品同步到各平台，建立销售基础（TOC）或生成报价单（TOB）。
- **流程**：
  1. **商品准备**：
     - ERP 商品信息完善
     - 平台规则适配：标题、描述、图片、批量折扣（TOB）
     - 价格策略设置：基于套利分析或阶梯价策略
  2. **刊登执行**：
     - 批量或单条刊登，支持失败重试和全链路追踪
     - API 平台：走 Connector Bus
     - 无 API 平台：No-API Bridge + PENDING_REVIEW
  3. **刊登后管理**：
     - 库存同步、价格更新、商品状态监控
- **决策点**：
  - 必须通过前置套利/利润分析
  - TOB 需遵循阶梯价审批策略
- **输入**：清洗后的可售商品数据
- **输出**：已刊登商品列表 + 平台状态 + 链接
- **💰 钱流**：
  - 刊登成本：平台费用、图片处理费用、人工费用
  - 定价策略：成本价 → 平台费用 → 物流费用 → 预期利润 → 最终售价
- **🔄 状态变化**：
  - `READY_FOR_LISTING` → `LISTING_IN_PROGRESS` → `LISTED` → `MONITORING` → `NEED_UPDATE` → `UPDATED`
- **🔥 触发条件**：
  - 手动触发：用户手动发起刊登任务
  - 事件触发：商品信息更新、价格变动、库存变动
  - 定时任务：定期检查商品状态，更新价格和库存

***

## 3️⃣ 素材管理闭环（Media & Asset Management Loop）

- **目标**：统一管理商品、广告、营销所需素材，支持 TOC 广告投放和 TOB 企业报价资料。
- **流程**：
  - 素材采集、处理、审核、分发
  - TOC：图片/视频用于广告和商品展示
  - TOB：商品资料、合同模板、报价单模板
- **决策点**：
  - 版权合规、平台规则、素材质量
- **输出**：素材库 + 元数据 + 使用统计
- **状态机**：`UPLOADED` → `PROCESSING` → `PENDING_REVIEW` → `APPROVED` → `IN_USE` → `ARCHIVED`/`REJECTED`

***

## 2️⃣3️⃣ 商品主数据闭环（Product Master Data Loop / MDM）

- **目标**：建立统一的商品主数据管理体系，确保数据一致性。
- **流程**：
  - 数据采集 → 标准化处理 → 主数据维护 → 数据分发
- **决策点**：
  - 数据标准制定
  - 数据质量评估
  - 数据同步策略
- **输入**：来自采集、供应链、刊登等闭环的商品数据
- **输出**：
  - 统一 SPU/SKU 体系
  - 标准化类目和属性结构
  - 多语言支持
  - 多平台映射关系

***

## 2️⃣4️⃣ SKU变体与结构闭环（SKU Variant & Structure Loop）

- **目标**：管理商品的变体和多平台SKU映射，确保库存和订单的一致性。
- **流程**：
  - SPU创建 → SKU生成 → 平台SKU映射 → 同步管理
- **决策点**：
  - 变体属性定义
  - 多平台SKU规则适配
  - 库存同步策略
- **输入**：商品主数据、平台SKU规则
- **输出**：
  - 多SKU结构（颜色/尺寸/套装）
  - 各平台SKU映射
  - 统一库存管理

***

## 相关KPI

### 数据采集与清洗闭环

| KPI 指标  | 描述         | 适用业务类型    |
| ------- | ---------- | --------- |
| 采集覆盖率   | 目标平台商品覆盖率  | TOC + TOB |
| 数据准确率   | 清洗后数据的准确性  | TOC + TOB |
| 套利分析准确率 | 前置套利计算的准确性 | TOC + TOB |

### 商品刊登闭环

| KPI 指标  | 描述          | 适用业务类型    |
| ------- | ----------- | --------- |
| 刊登成功率   | 成功刊登的商品比例   | TOC + TOB |
| 刊登时效    | 从准备到刊登完成的时间 | TOC + TOB |
| 平台审核通过率 | 平台审核通过的商品比例 | TOC + TOB |

### 素材管理闭环

| KPI 指标  | 描述           | 适用业务类型    |
| ------- | ------------ | --------- |
| 素材处理时效  | 从上传到可用的平均时间  | TOC + TOB |
| 素材审核通过率 | 通过审核的素材比例    | TOC + TOB |
| 素材转化率   | 使用素材带来的订单转化率 | TOC + TOB |
| 素材复用率   | 被多次使用的素材比例   | TOC + TOB |
| 版权合规率   | 无版权风险的素材比例   | TOC + TOB |

### 商品主数据闭环

| KPI 指标 | 描述           | 适用业务类型    |
| ------ | ------------ | --------- |
| 数据标准化率 | 标准化处理的商品数据比例 | TOC + TOB |
| 数据一致性  | 多平台数据一致性程度   | TOC + TOB |
| 主数据准确率 | 商品主数据的准确性    | TOC + TOB |
| 数据同步时效 | 数据从采集到同步的时间  | TOC + TOB |
| 数据质量评分 | 商品数据质量综合评分   | TOC + TOB |

### SKU变体与结构闭环

| KPI 指标   | 描述           | 适用业务类型    |
| -------- | ------------ | --------- |
| SKU映射准确率 | 多平台SKU映射的准确性 | TOC + TOB |
| SKU生成时效  | SKU生成的平均时间   | TOC + TOB |
| 变体管理效率   | 变体属性管理的效率    | TOC + TOB |
| 库存同步准确率  | 多SKU库存同步的准确性 | TOC + TOB |
