Files
makemd/docs/00_Business/Business_ClosedLoops/01_Product.md
wurenzhi 48a78137c5 refactor(terminology): 统一术语标准并优化代码类型安全
- 将B2B统一为TOB术语
- 将状态值统一为大写格式
- 优化类型声明,避免使用any
- 将float类型替换为decimal以提高精度
- 新增术语标准化文档
- 优化路由结构和菜单分类
- 添加TypeORM实体类
- 增强加密模块安全性
- 重构前端路由结构
- 完善任务模板和验收标准
2026-03-20 09:43:50 +08:00

7.1 KiB
Raw Blame History

01 商品域业务闭环

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


1 数据采集与清洗闭环Product Data Collection & Cleansing

  • 💰 钱流
    • 采集成本API调用费用、代理IP费用、云服务费用
    • 利润评估:采购成本 → 平台费用 → 物流费用 → 税费 → 广告费用 → 净利润
  • 🔄 状态变化
    • RAW_DATACLEANEDANALYZEDREADY_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_LISTINGLISTING_IN_PROGRESSLISTEDMONITORINGNEED_UPDATEUPDATED
  • 🔥 触发条件
    • 手动触发:用户手动发起刊登任务
    • 事件触发:商品信息更新、价格变动、库存变动
    • 定时任务:定期检查商品状态,更新价格和库存

3 素材管理闭环Media & Asset Management Loop

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

23 商品主数据闭环Product Master Data Loop / MDM

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

24 SKU变体与结构闭环SKU Variant & Structure Loop

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

72 多平台商品管理闭环Multi-Platform Product Management Loop

  • 目标:统一管理多平台商品,实现批量操作和跨平台同步,提高运营效率。
  • 流程
    1. 多平台商品整合
      • 统一商品信息管理
      • 多平台商品关联映射
      • 商品状态集中监控
    2. 批量商品操作
      • 批量上架/下架
      • 批量价格调整
      • 批量信息优化
    3. 跨平台库存同步
      • 实时库存数据同步
      • 库存预警和分配
      • 多平台库存一致性保障
  • 决策点
    • 平台选择与优先级
    • 同步策略与频率
    • 冲突处理机制
  • 输入:商品信息、平台数据、库存数据
  • 输出
    • 统一商品管理界面
    • 跨平台同步状态
    • 批量操作结果
  • 状态机PRODUCT_CREATEDPLATFORM_MAPPEDSYNCHRONIZEDUPDATED

相关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

多平台商品管理闭环

KPI 指标 描述 适用业务类型
多平台同步准确率 跨平台商品信息同步的准确性 TOC + TOB
批量操作成功率 批量商品操作的成功比例 TOC + TOB
库存同步时效 库存数据同步的平均时间 TOC + TOB
平台覆盖度 已管理平台占目标平台的比例 TOC + TOB
操作效率提升率 相比手动操作的效率提升比例 TOC + TOB