# 📌 Crawlful Hub 业务闭环（TOC + TOB Unified Business Loops）

> **说明**：本闭环文档是战略层业务流程，关注"做什么、为什么做、顺序和决策点"，为下层模块功能和系统实现提供指引。TOC（零售/前端）和 TOB（B2B贸易）共享通用模块，特有流程用 `businessType` 标记。共 **45个业务闭环**。

## 📑 目录

1. [数据采集与清洗闭环](#1️⃣-数据采集与清洗闭环product-data-collection--cleansing)
2. [商品刊登闭环](#2️⃣-商品刊登闭环product-listing-loop)
3. [素材管理闭环](#3️⃣-素材管理闭环media--asset-management-loop)
4. [广告计划与营销闭环](#4️⃣-广告计划与营销闭环marketing--ad-management-loop)
5. [订单履约闭环](#5️⃣-订单履约闭环order-fulfillment-loop--oms)
6. [售后逆向闭环](#6️⃣-售后逆向闭环returns--refunds-loop)
7. [资金对账闭环](#7️⃣-资金对账闭环finance-reconciliation-loop)
8. [库存与仓储管理闭环](#8️⃣-库存与仓储管理闭环inventory--warehouse-management-loop--wms)
9. [供应链与供应商管理闭环](#9️⃣-供应链与供应商管理闭环supply-chain--supplier-management-loop)
10. [B2B / TOB 贸易管理闭环](#🔟-b2b--tob-贸易管理闭环b2b--tob-trade-management-loop)
11. [治理与审批中心闭环](#1️⃣1️⃣-治理与审批中心闭环governance--approval-center-loop)
12. [合规与证书管理闭环](#1️⃣2️⃣-合规与证书管理闭环compliance--certificate-management-loop)
13. [合规与风控闭环](#1️⃣3️⃣-合规与风控闭环compliance--risk-control-loop)
14. [报表与分析闭环](#1️⃣4️⃣-报表与分析闭环reporting--analytics-loop)
15. [定价与利润决策闭环](#1️⃣5️⃣-定价与利润决策闭环pricing--profit-decision-loop)
16. [账号/店铺健康度闭环](#1️⃣6️⃣-账号/店铺健康度闭环accountshop-health-loop)
17. [店铺隔离与自动化闭环](#1️⃣7️⃣-店铺隔离与自动化闭环shop-isolation--automation-loop)
18. [订单集中管理闭环](#1️⃣8️⃣-订单集中管理闭环order-centralized-management-loop)
19. [客户/商家押金与账户管理闭环](#1️⃣9️⃣-客户商家押金与账户管理闭环customer-merchant-deposit--account-management-loop)
20. [商家选择发货闭环](#2️⃣0️⃣-商家选择发货闭环merchant-selective-fulfillment-loop)
21. [回款与财务闭环](#2️⃣1️⃣-回款与财务闭环payment--financial-reconciliation-loop)
22. [海外仓/本土仓 & 多品类支持闭环](#2️⃣2️⃣-海外仓本土仓--多品类支持闭环overseaslocal-warehouse--multi-category-support-loop)
23. [商品主数据闭环](#2️⃣3️⃣-商品主数据闭环product-master-data-loop--mdm)
24. [SKU变体与结构闭环](#2️⃣4️⃣-sku变体与结构闭环sku-variant--structure-loop)
25. [订单拆分与合并闭环](#2️⃣5️⃣-订单拆分与合并闭环order-split--merge-loop)
26. [异常订单处理闭环](#2️⃣6️⃣-异常订单处理闭环exception-order-handling-loop)
27. [物流策略与渠道选择闭环](#2️⃣7️⃣-物流策略与渠道选择闭环logistics-strategy--channel-selection-loop)
28. [利润核算闭环](#2️⃣8️⃣-利润核算闭环profit-calculation-loop)
29. [用户/客户资产闭环](#2️⃣9️⃣-用户客户资产闭环usercustomer-asset-loop)
30. [A/B测试与策略优化闭环](#3️⃣0️⃣-ab测试与策略优化闭环ab-testing--strategy-optimization-loop)
31. [多商户入驻与认证闭环](#3️⃣1️⃣-多商户入驻与认证闭环merchant-registration--authentication-loop)
32. [商户店铺管理闭环](#3️⃣2️⃣-商户店铺管理闭环merchant-store-management-loop)
33. [多商户订单闭环](#3️⃣3️⃣-多商户订单闭环multi-merchant-order-loop)
34. [多商户库存同步闭环](#3️⃣4️⃣-多商户库存同步闭环multi-merchant-inventory-sync-loop)
35. [多商户结算与财务闭环](#3️⃣5️⃣-多商户结算与财务闭环multi-merchant-settlement--finance-loop)
36. [商户权限与角色闭环](#3️⃣6️⃣-商户权限与角色闭环merchant-roles--permissions-loop)
37. [商户数据与分析闭环](#3️⃣7️⃣-商户数据与分析闭环merchant-analytics--reporting-loop)
38. [异常处理闭环](#3️⃣8️⃣-异常处理闭环exception--dispute-loop)
39. [功能模块化与权限控制闭环](#3️⃣9️⃣-功能模块化与权限控制闭环feature-modularization--permission-control-loop)
40. [功能开通与支付闭环](#4️⃣0️⃣-功能开通与支付闭环feature-activation--payment-loop)
41. [恶意买家黑名单闭环](#4️⃣1️⃣-恶意买家黑名单闭环malicious-buyer-blacklist-loop)
42. [高退货率SKU自动下架/改进建议闭环](#4️⃣2️⃣-高退货率sku自动下架改进建议闭环high-return-rate-sku-auto-delist--improvement-loop)
43. [商业化与增长闭环](#4️⃣3️⃣-商业化与增长闭环monetization--growth-loop)
44. [服务编排与执行闭环](#4️⃣4️⃣-服务编排与执行闭环service-orchestration-loop)
45. [增长飞轮闭环](#4️⃣5️⃣-增长飞轮闭环growth-flywheel-loop)
41. [统一闭环依赖](#🔹-统一闭环依赖toc--tob)
42. [闭环依赖关系](#🔗-闭环依赖关系toc--tob)
43. [关键绩效指标](#📊-关键绩效指标kpi)
44. [追踪与审计](#🔍-追踪与审计)
45. [业务审核状态机](#📋-业务审核状态机)
46. [说明](#💡-说明)

***

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

- **目标**：收集多平台商品信息，确保数据完整、有效、可用于盈利分析（TOC）或报价计算（TOB）。
- **采集策略矩阵**：

| 平台类型                              | 采集方式  | 执行位置 | 登录要求     | 反爬策略      |
| --------------------------------- | ----- | ---- | -------- | --------- |
| **有API平台** (Amazon MWS, eBay API) | 官方API | 后端   | OAuth/密钥 | 频率限制      |
| **无API平台** (TikTok Shop, Temu)    | 浏览器插件 | 插件   | 需登录      | 指纹隔离+IP代理 |
| **公开数据** (1688公开页)                | 浏览器插件 | 插件   | 无需登录     | 频率控制      |
| **需登录数据** (供应商后台)                 | 浏览器插件 | 插件   | 需登录      | 店铺隔离      |

- **流程**：
  1. **多平台采集**：
     - **有API平台**（Amazon MWS、eBay API、Shopee Open API）：
       - 后端通过官方API获取数据
       - 使用 `PlatformApiService` 统一对接
       - 支持 OAuth 认证和密钥管理
     - **无API平台**（TikTok Shop、Temu、部分1688页面）：
       - **严禁后端直接爬取**（IP封禁风险、法律合规）
       - 通过浏览器插件在用户端采集
       - 插件使用店铺隔离环境（独立指纹+代理IP）
     - **采集字段**：标题、价格、库存、SKU、图片、描述、评价、供应商信息（TOB）
  2. **数据清洗**：
     - 去重：平台+productId 唯一约束
     - 格式化：统一字段格式和单位
     - 字段标准化：规范属性名和值
     - 剔除无效商品：库存异常、价格异常、描述缺失
  3. **前置套利 / 利润评估**：
     - TOC：评估单件盈利、ROI、定价区间
     - TOB：评估阶梯价利润、批量折扣、信用额度风险
     - 考虑平台费、物流费、税费、汇率、售后成本、广告摊销
- **决策点**：
  - TOC：B2C 利润率 < 20% 触发风控
  - TOB：B2B 利润率 < 15% 禁止报价
- **输入**：平台商品原始数据
- **输出**：清洗后的可售商品/报价数据，包含完整套利/利润分析
- **⚠️ 重要约束**：
  - **后端严禁直接爬取电商平台页面**（IP封禁、法律风险）
  - 所有网页级采集必须通过浏览器插件在用户端执行
  - 插件必须实现店铺隔离（一店一IP一指纹）
- **📋 技术实现指引**：
  | 层级 | 实现模块    | 关键文件                                   | 任务ID                      |
  | -- | ------- | -------------------------------------- | ------------------------- |
  | 后端 | 平台API对接 | `PlatformApiService.ts`                | BE-P005, BE-P006, BE-P007 |
  | 后端 | 数据清洗引擎  | `DataPipelineService.ts`               | DT-P001, DT-P002          |
  | 插件 | 网页采集器   | `crawlerService.ts`                    | PL-C001, PL-C002          |
  | 插件 | DOM解析   | `amazonCrawler.ts`, `tiktokCrawler.ts` | PL-C002                   |
  | AI | 套利分析    | `ArbitrageService.ts`                  | AI-A001                   |

***

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

- **目标**：将可售商品同步到各平台，建立销售基础（TOC）或生成报价单（TOB）。
- **流程**：
  1. **商品准备**：
     - ERP 商品信息完善
     - 平台规则适配：标题、描述、图片、批量折扣（TOB）
     - 价格策略设置：基于套利分析或阶梯价策略
  2. **刊登执行**：
     - 批量或单条刊登，支持失败重试和全链路追踪
     - API 平台：走 Connector Bus
     - 无 API 平台：No-API Bridge + PENDING\_REVIEW
  3. **刊登后管理**：
     - 库存同步、价格更新、商品状态监控
- **决策点**：
  - 必须通过前置套利/利润分析
  - TOB 需遵循阶梯价审批策略
- **输入**：清洗后的可售商品数据
- **输出**：已刊登商品列表 + 平台状态 + 链接

***

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

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

***

## 4️⃣ 广告计划与营销闭环（Marketing & Ad Management Loop）

- **目标**：提升销量和 ROI（TOC）或企业促销效率（TOB）。
- **流程**：
  - 广告计划制定、跨平台投放、效果分析与优化
  - TOB：批量报价、促销方案、邮件/企业营销
- **决策点**：
  - 广告 ROI < 1 停止投放
  - 企业营销需基于信用等级和合同审批
- **输入**：已刊登商品列表、素材
- **输出**：广告报告、优化建议

***

## 5️⃣ 订单履约闭环（Order Fulfillment Loop / OMS）

- **目标**：保证订单从生成到妥投的全链路履约。
- **流程**：
  - **公共流程**：订单获取与审核 → 分仓 → 占库 → 扣库 → 发货 → 物流追踪
  - **TOC**：标准订单处理流程
  - **TOB**：大额企业订单可分批发货、合同条款优先
- **状态机**：`PULLED` → `PENDING_REVIEW` → `CONFIRMED` → `ALLOCATED` → `READY_TO_SHIP` → `SHIPPED` → `DELIVERED` → `CLOSED`
- **输入**：平台订单数据
- **输出**：已发货订单，包含物流跟踪信息

***

## 6️⃣ 售后逆向闭环（Returns & Refunds Loop）

- **目标**：处理退货/退款，保持库存和财务一致。
- **流程**：
  - **公共流程**：售后请求处理 → 退货处理 → 退款处理
  - **TOC**：标准退货流程
  - **TOB**：按合同条款、批量退货、预付款冲抵
- **输入**：售后请求数据
- **输出**：处理完成的售后记录，包含库存和财务调整

***

## 7️⃣ 资金对账闭环（Finance Reconciliation Loop）

- **目标**：财务闭环，兼顾 TOC/TOB。
- **流程**：
  - 数据汇总 → 财务处理（多币种、VAT、汇率） → 差异分析与处理
- **决策点**：
  - 异常需人工复核
  - TOB 账期和信用额度影响结算
- **输出**：对账报告 + 差异处理记录

***

## 8️⃣ 库存与仓储管理闭环（Inventory & Warehouse Management Loop / WMS）

- **目标**：确保库存准确、仓储高效，支持全球供应链运作。
- **流程**：
  - **公共流程**：多仓库存管理 → 进出库管理 → 物流模式管理
  - **TOC**：按店铺和平台库存管理
  - **TOB**：按企业订单、批量调拨、FCL/3PL 管理
- **决策点**：
  - 库存不足时触发补货建议
  - 跨仓调拨决策：基于成本和时效
  - 安全库存预警阈值设置
- **输入**：订单数据、采购数据、物流数据
- **输出**：实时库存状态、仓储操作记录、库存预警

***

## 9️⃣ 供应链与供应商管理闭环（Supply Chain & Supplier Management Loop）

- **目标**：优化供应链流程，降低采购成本，确保供应稳定。
- **流程**：
  - **公共流程**：供应商管理 → 采购管理 → 补货建议
  - **TOC**：基于零售需求的采购计划
  - **TOB**：基于大宗订单生成采购计划
- **决策点**：
  - 供应商选择：基于综合评分
  - 采购价格：低于成本价预警
  - 补货时机：库存周转率优化
- **输入**：销售数据、库存数据、供应商数据
- **输出**：采购计划、供应商评估报告、成本节省分析

***

## 🔟 B2B / TOB 贸易管理闭环（B2B / TOB Trade Management Loop）

- **目标**：企业间交易管理
- **流程**：
  - 报价管理、信用管理、询盘转订单
- **决策点**：
  - 利润率 < 15% 禁止报价
  - 大额订单多级审批
  - 低信用等级客户需预付款
- **输出**：报价单、B2B 订单、信用评估报告

***

## 1️⃣1️⃣ 治理与审批中心闭环（Governance & Approval Center Loop）

- **目标**：敏感操作审批
- **适用**：
  - TOC：大额订单、价格变动、退款
  - TOB：大额企业订单、阶梯价审批、信用审批
- **输出**：审批结果、审计日志

***

## 1️⃣2️⃣ 合规与证书管理闭环（Compliance & Certificate Management Loop）

- **目标**：确保业务合规，自动生成所需证书。
- **流程**：
  - **公共流程**：自动化合规 → 信用分级 → 合规审计
  - **TOC**：商品合规检查和证书生成
  - **TOB**：出口合规、合同合规检查和证书生成
- **决策点**：
  - 不合规商品禁止销售
  - 信用等级低的合作伙伴需要额外审核
- **输入**：订单数据、商品数据、合作伙伴数据
- **输出**：电子证书、合规报告、信用评估

***

## 1️⃣3️⃣ 合规与风控闭环（Compliance & Risk Control Loop）

- **目标**：统一风控
- **输入**：全流程数据（TOC + TOB）
- **输出**：风险处理记录、规则优化

***

## 1️⃣4️⃣ 报表与分析闭环（Reporting & Analytics Loop）

- **目标**：数据可视化 + KPI 支撑 TOC/TOB 决策
- **流程**：
  - 数据汇总 → 指标计算 → 报表生成 → 数据大屏 → 闭环反馈
- **输出**：管理报表、异常预警、优化建议
- **状态机**：`RAW_DATA` → `PROCESSED` → `GENERATED` → `DISTRIBUTED` → `FEEDBACK_APPLIED`

***

## 1️⃣5️⃣ 定价与利润决策闭环（Pricing & Profit Decision Loop）

- **目标**：基于成本、市场和业务目标，自动生成定价策略和利润优化建议。
- **流程**：
  - 成本数据收集 → 市场分析 → 定价策略生成 → 利润预测 → 决策执行
- **决策点**：
  - 利润率红线控制（B2C < 20% 预警，B2B < 15% 禁止）
  - 价格弹性分析
  - 竞争定价策略
- **输入**：商品成本、运费、平台费、广告预估、市场竞争数据
- **输出**：
  - 建议售价
  - 建议 ROI
  - 上架决策（开/关）
  - 广告投放 ROI 区间
  - 最大可承受 CPA

***

## 1️⃣6️⃣ 账号/店铺健康度闭环（Account/Shop Health Loop）

- **目标**：监控和维护店铺健康状态，预防封号、限流等风险。
- **流程**：
  - 数据采集 → 健康度评估 → 风险预警 → 干预措施
- **决策点**：
  - 健康度阈值设定
  - 风险等级划分
  - 干预策略制定
- **输入**：违规记录、发货延迟、差评率、退款率、账号活动数据
- **输出**：
  - 店铺健康评分
  - 风险预警
  - 干预建议（暂停广告、限制上新、下架高风险商品）

***

## 1️⃣7️⃣ 店铺隔离与自动化闭环（Shop Isolation & Automation Loop）

- **目标**：
  1. 确保每个 TOC / TOB 店铺环境隔离，防止账号关联导致封禁
  2. 自动化执行 API 不支持或无 API 的操作（刊登、采集、调价、库存同步等）
  3. 支持多云环境，可灵活选择云服务商（阿里云、腾讯云、AWS、Azure 等）
- **流程**：
  1. **镜像/虚拟机管理**
     - 每个店铺对应独立云镜像或虚拟机（Win/Linux 可选）
     - 云商 API 对接：
       - 镜像购买 / 续费
       - 快照 / 重置
       - 开机 / 关机 / 重启
     - 支持多云商切换，可根据价格、性能、地理位置灵活部署
  2. **预置环境配置**
     - 浏览器、自动化脚本、指纹管理工具、VPN 或固定 IP 配置
     - 自动登录店铺账户，无需人工干预
  3. **任务调度与自动化执行**
     - 脚本调度可使用 JS / Python / 后端 API 方式控制
     - 支持平台无 API 操作（如商品采集、库存更新、手动刊登模拟等）
     - 自动执行任务后状态反馈至任务调度闭环，并记录日志
  4. **监控与异常自愈**
     - 云镜像健康监控（在线状态、资源使用、脚本异常）
     - 自动重启 / 快照恢复 / 切换备用镜像
     - 异常信息反馈至异常检测与自愈闭环
- **决策点**：
  - 店铺隔离等级（独立镜像、不同 IP、不同指纹）
  - 云商选择与成本控制
  - 异常处理策略（自动恢复或人工介入）
- **输入**：
  - 店铺列表、业务需求（采集、刊登、广告等）
  - 云商账户与资源配置
  - 自动化脚本 / 后端控制接口
- **输出**：
  - 各店铺独立镜像环境
  - 自动化执行日志与状态报告
  - 异常修复记录
- **闭环价值**：
  1. 高度隔离，降低账号封禁与关联风险
  2. 自动化落地，提高效率与可扩展性
  3. 支持多云部署，增强业务弹性和成本优化能力
- **📋 技术实现指引**：
  | 层级 | 实现模块    | 关键文件                      | 任务ID             |
  | -- | ------- | ------------------------- | ---------------- |
  | 后端 | 店铺隔离管理  | `ShopIsolationService.ts` | BE-G003          |
  | 后端 | 云镜像管理   | `CloudInstanceService.ts` | BE-G003          |
  | 后端 | 任务调度器   | `TaskScheduler.ts`        | BE-G003          |
  | 插件 | 浏览器指纹管理 | `fingerprintService.ts`   | PL-A001          |
  | 插件 | 代理IP管理  | `proxyService.ts`         | PL-A001          |
  | 插件 | 自动化执行器  | `automationService.ts`    | PL-A001, PL-A002 |
  | 运维 | 健康监控    | `HealthMonitor.ts`        | OP-M001          |
- **🔗 插件管理架构**：
  ```
  ┌─────────────────────────────────────────────────────────────┐
  │                    插件生命周期管理                          │
  ├─────────────────────────────────────────────────────────────┤
  │                                                              │
  │  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐   │
  │  │   安装/更新   │───►│   配置初始化  │───►│   店铺绑定    │   │
  │  └──────────────┘    └──────────────┘    └──────────────┘   │
  │         │                   │                   │          │
  │         ▼                   ▼                   ▼          │
  │  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐   │
  │  │  任务接收    │◄──►│   任务执行    │◄──►│   结果上报    │   │
  │  │  (Backend)   │    │  (Extension) │    │   (Backend)   │   │
  │  └──────────────┘    └──────────────┘    └──────────────┘   │
  │         │                   │                   │          │
  │         ▼                   ▼                   ▼          │
  │  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐   │
  │  │   状态同步   │◄──►│   异常处理    │◄──►│   日志归档    │   │
  │  └──────────────┘    └──────────────┘    └──────────────┘   │
  │                                                              │
  └─────────────────────────────────────────────────────────────┘
  ```
- **📡 插件通讯协议**：
  | 通讯方向    | 协议             | 用途      | 消息类型                           |
  | ------- | -------------- | ------- | ------------------------------ |
  | 后端 → 插件 | WebSocket      | 实时任务下发  | `TASK_ASSIGN`, `CONFIG_UPDATE` |
  | 插件 → 后端 | HTTP POST      | 执行结果上报  | `TASK_COMPLETE`, `TASK_FAILED` |
  | 插件 ↔ 后端 | HTTP GET       | 状态查询/心跳 | `HEARTBEAT`, `STATUS_QUERY`    |
  | 插件内部    | Chrome Message | 组件间通讯   | `CRAWL_DATA`, `AUTO_ACTION`    |

***

## 1️⃣8️⃣ 订单集中管理闭环（Order Centralized Management Loop）

- **目标**：跨平台订单统一抓取、集中展示和管理，支持 TOC/TOB 订单流转。
- **流程**：
  1. **多平台订单采集**
     - 支持 TikTok、Shopee、Temu 等平台订单抓取
     - 通过 API 或自动化脚本采集
  2. **订单集中展示**
     - 产品信息：名称、数量、实收价格、订单时间、状态
     - 支持平台/客户/品类/订单状态筛选
     - 可选漏斗分析：订单流转、发货完成率
  3. **订单状态管理**
     - 状态流转：`available → requested → shipped → completed`
     - 订单分配与跟踪
- **决策点**：
  - 订单抓取频率
  - 订单优先级设置
  - 异常订单处理策略
- **输入**：
  - 多平台订单数据
  - 店铺信息
  - 客户/商家信息
- **输出**：
  - 集中管理的订单数据
  - 订单状态报告
  - 异常订单标记

***

## 1️⃣9️⃣ 客户/商家押金与账户管理闭环（Customer/Merchant Deposit & Account Management Loop）

- **目标**：管理客户预缴押金、账户余额，支持订单抵扣和提现。
- **流程**：
  1. **押金管理**
     - 客户预缴押金（例：100 元抵 2 单）
     - 押金余额、已抵扣订单数量记录
  2. **账户管理**
     - 客户可查看：可申请发货订单、历史回款、押金/余额状态
     - 自动扣减押金或余额完成发货操作
  3. **提现管理**
     - 检查账户余额 → 生成提现单 → 审核 → 打款
- **决策点**：
  - 押金抵扣规则
  - 提现审核流程
  - 余额管理策略
- **输入**：
  - 客户押金信息
  - 订单数据
  - 提现申请
- **输出**：
  - 押金/余额状态
  - 提现处理结果
  - 财务流水记录

***

## 2️⃣0️⃣ 商家选择发货闭环（Merchant Selective Fulfillment Loop）

- **目标**：商家可选择自己有库存的订单发货，剩余由平台/公司发货。
- **流程**：
  1. **订单选择**
     - 商家登录落地页选择自己有货的订单发货
  2. **系统检查**
     - 押金或余额是否足够覆盖订单
     - 时效性（保证订单不过期）
  3. **订单状态更新**
     - 状态流转：`available → requested → shipped → completed`
     - 剩余无货订单由平台/公司自己发货
- **决策点**：
  - 订单分配规则
  - 库存检查策略
  - 时效保证机制
- **输入**：
  - 商家库存信息
  - 订单数据
  - 押金/余额状态
- **输出**：
  - 订单分配结果
  - 发货状态更新
  - 异常订单标记

***

## 2️⃣1️⃣ 回款与财务闭环（Payment & Financial Reconciliation Loop）

- **目标**：管理客户付款、押金抵扣、回款记录和提现，确保财务透明。
- **流程**：
  1. **收款管理**
     - 客户付款到店铺账户或系统自动扣押金/余额
  2. **财务流水记录**
     - 类型（押金/回款/提现）、金额、订单ID、状态
     - 状态流转：`pending → approved → completed`
  3. **财务对账**
     - 店铺收入 ↔ 客户账户余额
     - 异常订单/回款标记 → 自动或人工处理
- **决策点**：
  - 回款确认机制
  - 对账频率
  - 异常处理流程
- **输入**：
  - 客户付款信息
  - 订单数据
  - 押金/余额状态
- **输出**：
  - 财务流水记录
  - 对账结果
  - 提现处理结果

***

## 2️⃣2️⃣ 海外仓/本土仓 & 多品类支持闭环（Overseas/Local Warehouse & Multi-Category Support Loop）

- **目标**：统一管理海外仓和本土仓库存，支持多品类分配和上下游分析。
- **流程**：
  1. **库存管理**
     - 海外仓和本土仓库存统一管理
     - 可按品类、仓库位置、时效性分配发货
  2. **上下游分析**
     - 供应商价格对比
     - 成本/利润/ROI 分析
     - 同行发货/库存策略参考
- **决策点**：
  - 仓库选择策略
  - 品类分配规则
  - 供应链优化策略
- **输入**：
  - 仓库库存数据
  - 供应商信息
  - 订单数据
- **输出**：
  - 库存分配方案
  - 供应链分析报告
  - 成本优化建议

***

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

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

***

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

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

***

## 2️⃣0️⃣ 订单拆分与合并闭环（Order Split & Merge Loop）

- **目标**：处理多仓发货、多订单合并、部分缺货等场景，优化物流成本和时效。
- **流程**：
  - 订单分析 → 拆分/合并决策 → 子订单生成 → 履约执行
- **决策点**：
  - 拆分类型（仓/SKU/库存）
  - 合并条件
  - 优先级策略
- **输入**：订单数据、库存状态、物流成本
- **输出**：
  - 子订单
  - 合并订单
  - 物流方案

***

## 2️⃣1️⃣ 异常订单处理闭环（Exception Order Handling Loop）

- **目标**：处理地址错误、海关卡单、物流丢件、无法发货等履约异常。
- **流程**：
  - 异常检测 → 分类处理 → 解决方案执行 → 结果反馈
- **决策点**：
  - 异常类型识别
  - 处理优先级
  - 人工介入条件
- **输入**：订单数据、物流状态、异常事件
- **输出**：
  - 异常处理结果
  - 售后触发
  - 风控预警

***

## 2️⃣2️⃣ 物流策略与渠道选择闭环（Logistics Strategy & Channel Selection Loop）

- **目标**：基于成本、时效和可靠性，选择最优物流方案。
- **流程**：
  - 订单分析 → 物流渠道评估 → 方案选择 → 执行监控
- **决策点**：
  - 仓选择
  - 物流方式（空运/海运/快递）
  - 渠道选择
- **输入**：订单数据、库存分布、物流成本、时效要求
- **输出**：
  - 物流渠道选择
  - 成本估算
  - 时效承诺

***

## 2️⃣3️⃣ 利润核算闭环（Profit Calculation Loop）

- **目标**：精确计算真实利润，支持定价和决策优化。
- **流程**：
  - 成本汇总 → 收入匹配 → 利润计算 → 分析报告
- **决策点**：
  - 成本分摊规则
  - 汇率处理
  - 利润阈值设定
- **输入**：商品成本、运费、广告费、平台佣金、税费、汇率数据
- **输出**：
  - 订单级利润
  - 商品级利润
  - 店铺级利润
  - 利润分析报告

***

## 2️⃣4️⃣ 用户/客户资产闭环（User/Customer Asset Loop）

- **目标**：沉淀和管理用户资产，支持精准营销和客户价值提升。
- **流程**：
  - 数据采集 → 用户画像构建 → 行为分析 → 资产运营
- **决策点**：
  - 用户分层策略
  - 营销触达规则
  - 客户价值评估
- **输入**：订单数据、浏览行为、购买历史、售后记录
- **输出**：
  - 用户画像
  - 复购行为分析
  - 国家偏好分析
  - 客户价值评估
  - 营销建议

***

## 2️⃣5️⃣ A/B测试与策略优化闭环（A/B Testing & Strategy Optimization Loop）

- **目标**：通过实验验证和数据驱动，持续优化业务策略。
- **流程**：
  - 测试设计 → 实验执行 → 数据收集 → 结果分析 → 策略调整
- **决策点**：
  - 测试假设设定
  - 样本量确定
  - 显著性水平设定
- **输入**：广告策略、商品定价、页面设计、营销文案
- **输出**：
  - 测试结果分析
  - 策略优化建议
  - 最优方案推荐

***

### 🔹 统一闭环依赖（TOC + TOB）

```text
[数据采集]   ↓[数据清洗]   ↓[套利/利润评估]   ↓[商品主数据]   ↓[SKU变体与结构]   ↓[商品刊登] ←→ [素材管理]   ↓[定价与利润决策]   ↓[广告/营销 (TOC) / 企业营销 (TOB)]   ↓[订单履约 (OMS)]   ↓[订单拆分与合并]   ↓[异常订单处理]   ↓[物流策略与渠道选择]   ↓[库存 & WMS] ←→ [供应链 & 补货]   ↓[售后逆向]   ↓[资金对账]   ↓[利润核算]   ↓[B2B/TOB 贸易管理 (TOB)]   ↓[用户/客户资产]   ↓[A/B测试 & 策略优化]   ↓[治理与审批中心]   ↓[合规 & 证书]   ↓[风控]   ↓[报表 & 分析]   ↺（反馈所有环节）

外挂三条线：
用户资产 ← 订单 / 售后 → 广告 / B2B
店铺健康度 ← 所有行为 → 限制商品 / 广告
店铺隔离与自动化 ← 店铺操作 → 所有店铺相关行为
```

**说明**：

- 实线箭头表示核心业务流程
- 括号内标注了TOC/TOB的主要差异点
- B2B/TOB贸易管理为TOB特有闭环
- 横切能力：账号/店铺健康度贯穿所有业务闭环

***

### 🔗 闭环依赖关系（TOC + TOB）

1. **数据采集与清洗闭环** → **商品主数据闭环**：提供原始商品数据
2. **数据采集与清洗闭环** → **素材管理闭环**：提供采集的商品图片和视频素材
3. **数据采集与清洗闭环** → **定价与利润决策闭环**：提供成本和市场数据
4. **商品主数据闭环** → **SKU变体与结构闭环**：提供商品基础信息
5. **SKU变体与结构闭环** → **商品刊登闭环**：提供多SKU结构和平台映射
6. **商品刊登闭环** → **素材管理闭环**：触发素材需求，生成商品主图和详情图
7. **素材管理闭环** → **商品刊登闭环**：提供处理后的商品素材（图片、视频）
8. **素材管理闭环** → **广告计划与营销闭环**：提供广告投放所需的素材库
9. **商品刊登闭环** → **广告计划与营销闭环**：提供已刊登商品列表
10. **商品刊登闭环** → **订单履约闭环**：提供商品库存和状态信息
11. **商品刊登闭环** → **定价与利润决策闭环**：提供商品成本信息
12. **定价与利润决策闭环** → **商品刊登闭环**：提供建议售价和上架决策
13. **定价与利润决策闭环** → **广告计划与营销闭环**：提供可投放 ROI 区间和最大可承受 CPA
14. **订单履约闭环** → **订单拆分与合并闭环**：提供订单数据用于拆分/合并
15. **订单拆分与合并闭环** → **物流策略与渠道选择闭环**：提供拆分/合并后的订单数据
16. **物流策略与渠道选择闭环** → **订单履约闭环**：提供物流方案
17. **订单履约闭环** → **异常订单处理闭环**：提供异常订单数据
18. **异常订单处理闭环** → **售后逆向闭环**：触发售后处理
19. **异常订单处理闭环** → **合规与风控闭环**：提供风控预警
20. **订单履约闭环** → **售后逆向闭环**：提供订单和物流信息
21. **售后逆向闭环** → **资金对账闭环**：提供退款记录
22. **订单履约闭环** → **资金对账闭环**：提供销售记录
23. **广告计划与营销闭环** → **资金对账闭环**：提供广告费用记录
24. **订单履约闭环** → **库存与仓储管理闭环**：触发库存扣减和物流操作
25. **库存与仓储管理闭环** → **订单履约闭环**：提供库存状态和物流信息
26. **库存与仓储管理闭环** → **供应链与供应商管理闭环**：触发补货需求
27. **供应链与供应商管理闭环** → **库存与仓储管理闭环**：提供采购入库信息
28. **供应链与供应商管理闭环** → **商品主数据闭环**：提供供应商商品数据
29. **商品刊登闭环** → **B2B / TOB 贸易管理闭环**：提供商品信息用于报价
30. **B2B / TOB 贸易管理闭环** → **订单履约闭环**：生成 B2B 订单
31. **B2B / TOB 贸易管理闭环** → **资金对账闭环**：提供 B2B 交易记录
32. **资金对账闭环** → **利润核算闭环**：提供收入和成本数据
33. **利润核算闭环** → **报表与分析闭环**：提供利润数据
34. **订单履约闭环** → **用户/客户资产闭环**：提供订单和用户行为数据
35. **售后逆向闭环** → **用户/客户资产闭环**：提供售后记录
36. **用户/客户资产闭环** → **广告计划与营销闭环**：提供用户画像和营销建议
37. **用户/客户资产闭环** → **B2B / TOB 贸易管理闭环**：提供企业客户信息
38. **广告计划与营销闭环** → **A/B测试与策略优化闭环**：提供广告策略数据
39. **商品刊登闭环** → **A/B测试与策略优化闭环**：提供商品定价和展示数据
40. **A/B测试与策略优化闭环** → **报表与分析闭环**：提供测试结果和优化建议
41. **所有敏感操作** → **治理与审批中心闭环**：触发审批流程
42. **治理与审批中心闭环** → **所有业务闭环**：提供审批结果
43. **订单履约闭环** → **合规与证书管理闭环**：触发证书生成
44. **合规与证书管理闭环** → **订单履约闭环**：提供合规证书
45. **所有业务闭环** → **账号/店铺健康度闭环**：提供违规记录、发货延迟、差评率、退款率等数据
46. **账号/店铺健康度闭环** → **广告计划与营销闭环**：提供是否暂停广告、降预算的决策
47. **账号/店铺健康度闭环** → **商品刊登闭环**：提供是否限制上新、下架高风险商品的决策
48. **所有店铺操作** → **店铺隔离与自动化闭环**：提供店铺操作数据
49. **店铺隔离与自动化闭环** → **所有店铺相关行为**：提供隔离环境和自动化执行能力
50. **所有闭环** → **合规与风控闭环**：提供全流程数据用于风险监控
51. **所有业务闭环** → **报表与分析闭环**：提供各闭环的输出数据用于报表生成和分析
52. **报表与分析闭环** → **所有业务闭环**：反馈数据异常、业务波动、优化建议，指导各闭环的操作调整

***

### 📊 关键绩效指标（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 指标   | 描述             | 适用业务类型 |
| -------- | -------------- | ------ |
| 广告 ROI   | 广告投入产出比        | TOC    |
| 点击率（CTR） | 广告点击次数与展示次数的比率 | TOC    |
| 转化率（CVR） | 点击广告后产生订单的比例   | TOC    |
| 企业营销效果   | 企业营销活动的转化率     | TOB    |

#### 订单履约闭环

| KPI 指标 | 描述          | 适用业务类型    |
| ------ | ----------- | --------- |
| 订单处理时效 | 从订单生成到发货的时间 | TOC + TOB |
| 发货准确率  | 正确发货的订单比例   | TOC + TOB |
| 妥投率    | 成功送达的订单比例   | TOC + TOB |
| 分批处理率  | 大额订单分批处理的比例 | TOB       |

#### 售后逆向闭环

| KPI 指标 | 描述            | 适用业务类型    |
| ------ | ------------- | --------- |
| 售后处理时效 | 从售后请求到处理完成的时间 | TOC + TOB |
| 退款成功率  | 成功退款的比例       | TOC + TOB |
| 退货率    | 退货订单占总订单的比例   | TOC + TOB |

#### 资金对账闭环

| KPI 指标 | 描述            | 适用业务类型    |
| ------ | ------------- | --------- |
| 对账准确率  | 对账差异率         | TOC + TOB |
| 对账时效   | 从数据汇总到对账完成的时间 | TOC + TOB |
| 异常处理率  | 需要人工处理的异常比例   | TOC + TOB |
| 账期遵守率  | 按合同约定账期结算的比例  | TOB       |

#### 库存与仓储管理闭环

| KPI 指标 | 描述            | 适用业务类型    |
| ------ | ------------- | --------- |
| 库存准确率  | 系统库存与实际库存的差异率 | TOC + TOB |
| 库存周转率  | 库存周转次数        | TOC + TOB |
| 仓储操作效率 | 每单处理时间        | TOC + TOB |
| 跨仓调拨时效 | 调拨完成时间        | TOC + TOB |

#### 供应链与供应商管理闭环

| KPI 指标   | 描述        | 适用业务类型    |
| -------- | --------- | --------- |
| 供应商准时交付率 | 按时交付的订单比例 | TOC + TOB |
| 采购成本降低率  | 采购成本下降百分比 | TOC + TOB |
| 供应商评分    | 供应商综合评估分数 | TOC + TOB |
| 补货准确率    | 补货计划的准确性  | TOC + TOB |

#### B2B / TOB 贸易管理闭环

| KPI 指标  | 描述         | 适用业务类型 |
| ------- | ---------- | ------ |
| B2B 利润率 | B2B 业务的利润率 | TOB    |
| 报价通过率   | 报价被客户接受的比例 | TOB    |
| 信用违约率   | 客户信用违约的比例  | TOB    |
| 询盘转化率   | 询盘转化为订单的比例 | TOB    |

#### 治理与审批中心闭环

| KPI 指标 | 描述          | 适用业务类型    |
| ------ | ----------- | --------- |
| 审批时效   | 从申请到审批完成的时间 | TOC + TOB |
| 审批准确率  | 审批结果的准确性    | TOC + TOB |
| 待办处理率  | 待办事项的处理比例   | TOC + TOB |

#### 合规与证书管理闭环

| KPI 指标  | 描述        | 适用业务类型    |
| ------- | --------- | --------- |
| 证书生成及时率 | 按时生成证书的比例 | TOC + TOB |
| 合规检查通过率 | 通过合规检查的比例 | TOC + TOB |
| 信用评级准确率 | 信用评级的准确性  | TOC + TOB |

#### 合规与风控闭环

| KPI 指标  | 描述         | 适用业务类型    |
| ------- | ---------- | --------- |
| 风险识别准确率 | 风险识别的准确性   | TOC + TOB |
| 风控处理时效  | 风险处理的时间    | TOC + TOB |
| 合规违规率   | 违规事件的比例    | TOC + TOB |
| 误报率     | 误判为风险的事件比例 | TOC + TOB |

#### 报表与分析闭环

| KPI 指标  | 描述              | 适用业务类型    |
| ------- | --------------- | --------- |
| 报表生成及时率 | 按时生成报表的比例       | TOC + TOB |
| 数据准确率   | 报表数据的准确性        | TOC + TOB |
| 分析洞察价值  | 分析结果对业务决策的价值    | TOC + TOB |
| 异常预警准确率 | 异常预警的准确性        | TOC + TOB |
| 报表生成时效  | 从数据汇总到报表完成的时间   | TOC + TOB |
| 数据完整率   | 报表覆盖业务闭环输出数据的比例 | TOC + TOB |
| KPI 准确率 | 计算指标与实际数据偏差率    | TOC + TOB |
| 异常响应率   | 异常报表触发优化措施的比例   | 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 |

#### 店铺隔离与自动化闭环

| KPI 指标    | 描述            | 适用业务类型    |
| --------- | ------------- | --------- |
| 店铺隔离成功率   | 成功隔离的店铺比例     | TOC + TOB |
| 自动化操作成功率  | 成功执行的自动化操作比例  | TOC + TOB |
| 异常恢复时长    | 异常从发生到恢复的时间   | TOC + TOB |
| 脚本异常率     | 脚本执行异常的比例     | TOC + TOB |
| 功能覆盖率     | 自动化覆盖的业务功能比例  | TOC + TOB |
| 镜像可用性     | 镜像正常运行时间比例    | TOC + TOB |
| 云API调用成功率 | 云服务商API调用成功率  | 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 |

#### 异常订单处理闭环

| KPI 指标 | 描述           | 适用业务类型    |
| ------ | ------------ | --------- |
| 异常处理率  | 成功处理的异常订单比例  | TOC + TOB |
| 异常处理时效 | 异常订单处理的平均时间  | TOC + TOB |
| 异常解决率  | 成功解决的异常订单比例  | TOC + TOB |
| 客户满意度  | 异常订单处理的客户满意度 | TOC + TOB |

#### 物流策略与渠道选择闭环

| KPI 指标  | 描述         | 适用业务类型    |
| ------- | ---------- | --------- |
| 物流成本节约率 | 物流成本节约的比例  | TOC + TOB |
| 物流时效达标率 | 按时送达的订单比例  | TOC + TOB |
| 渠道选择准确率 | 物流渠道选择的准确性 | TOC + TOB |
| 物流跟踪覆盖率 | 可跟踪的物流订单比例 | TOC + TOB |

#### 利润核算闭环

| KPI 指标  | 描述           | 适用业务类型    |
| ------- | ------------ | --------- |
| 利润计算准确率 | 利润计算的准确性     | TOC + TOB |
| 利润核算时效  | 利润核算的平均时间    | TOC + TOB |
| 成本分摊准确性 | 成本分摊的准确性     | TOC + TOB |
| 利润率达标率  | 达到目标利润率的订单比例 | TOC + TOB |

#### 用户/客户资产闭环

| KPI 指标  | 描述            | 适用业务类型    |
| ------- | ------------- | --------- |
| 用户画像准确率 | 用户画像与实际行为的匹配度 | TOC + TOB |
| 客户价值提升率 | 客户平均价值增长比例    | TOC + TOB |
| 复购率     | 客户重复购买比例      | TOC + TOB |
| 客户留存率   | 客户持续活跃的比例     | TOC + TOB |
| 营销转化率   | 营销活动的转化效果     | TOC + TOB |

#### A/B测试与策略优化闭环

| KPI 指标  | 描述           | 适用业务类型    |
| ------- | ------------ | --------- |
| 测试执行效率  | 测试从设计到完成的时间  | TOC + TOB |
| 测试结果显著性 | 测试结果的统计显著性   | TOC + TOB |
| 策略优化效果  | 优化后业务指标的改善程度 | 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 |

#### 功能开通与支付闭环

| KPI 指标  | 描述         | 适用业务类型    |
| ------- | ---------- | --------- |
| 支付成功率   | 支付成功的比例    | TOC + TOB |
| 开通时效    | 从支付到开通的时间  | TOC + TOB |
| 续费率     | 功能到期后续费的比例 | 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 |

#### 恶意买家黑名单闭环

| KPI 指标  | 描述          | 适用业务类型    |
| ------- | ----------- | --------- |
| 黑名单识别准确率 | 正确识别恶意买家的比例 | TOC + TOB |
| 风险评估准确率 | 风险等级评估的准确性  | TOC + TOB |
| 黑名单共享有效率 | 共享黑名单的有效利用比例 | TOC + TOB |
| 风险预警及时率 | 及时发出风险预警的比例 | TOC + TOB |
| 误报率     | 误判为恶意买家的比例  | TOC + TOB |

#### 高退货率SKU自动下架/改进建议闭环

| KPI 指标  | 描述          | 适用业务类型    |
| ------- | ----------- | --------- |
| 退货率监控准确率 | 退货率计算的准确性   | TOC + TOB |
| 自动下架准确率 | 正确下架高风险SKU的比例 | TOC + TOB |
| 改进建议有效性 | 改进建议被采纳并实施的比例 | TOC + TOB |
| 重新上架成功率 | 改进后重新上架的成功比例 | TOC + TOB |
| 退货率改善率 | 改进后退货率下降的比例 | TOC + TOB |

***

## 3️⃣1️⃣ 多商户入驻与认证闭环（Merchant Registration & Authentication Loop）

- **目标**：支持多商户入驻、资质认证、店铺创建，实现平台化运营。
- **流程**：
  1. **商户注册**：
     - 商户自助注册（邮箱/手机/企业信息）
     - 资质文件上传（营业执照、法人身份证等）
     - 账户类型选择（企业/个人）
     - 初始密码设置和安全验证
  2. **资质认证**：
     - 自动审核 + 人工复核
     - 企业信息验证、信用检查
     - 行业资质合规检查
     - 审核进度实时更新
  3. **店铺创建**：
     - 店铺基础信息配置（名称、LOGO、描述）
     - 绑定平台店铺（Amazon、Shopee等）
     - 支付账户配置（收款方式、结算周期）
     - 店铺运营设置（退换货政策、客服信息）
  4. **权限分配**：
     - 初始角色设置（管理员、运营、财务）
     - 权限范围配置（可访问模块、操作权限）
     - 数据隔离设置（商户级数据隔离）
- **决策点**：
  - 资质审核标准（行业合规、信用评级）
  - 商户等级划分（普通/优质/战略）
  - 入驻门槛设置（不同等级商户的要求）
  - 审核通过/拒绝的条件和流程
- **输入**：商户注册信息、资质文件、企业证明
- **输出**：商户ID、认证状态、店铺ID、权限配置
- **状态机**：`SUBMITTED` → `PENDING_REVIEW` → `APPROVED`/`REJECTED` → `ACTIVE`
- **📋 技术实现指引**：
  | 层级 | 实现模块 | 关键文件 | 任务ID |
  | -- | ------- | -------- | ------ |
  | 后端 | 商户管理 | `MerchantService.ts` | BE-M001 |
  | 后端 | 资质验证 | `VerificationService.ts` | BE-M002 |
  | 后端 | 权限管理 | `RBACService.ts` | BE-M003 |
  | 前端 | 注册页面 | `MerchantRegistration.vue` | FE-M001 |
  | 前端 | 状态查询 | `MerchantStatus.vue` | FE-M002 |

***

## 3️⃣2️⃣ 商户店铺管理闭环（Merchant Store Management Loop）

- **目标**：支持商户管理自己的商品、库存、促销活动。
- **流程**：
  1. 商户创建店铺或子店铺。
  2. 前端提供商品管理界面（新增、编辑、上下架）。
  3. 后端管理库存、价格、SKU、分类。
  4. 支持商户自定义促销规则（折扣、满减、优惠券）。
- **决策点**：
  - 库存不足 → 阻止下架或自动提醒。
  - 促销策略冲突 → 系统自动合并或提示调整。
- **输入**：商户店铺信息、商品信息
- **输出**：管理的店铺和商品数据
- **状态机**：`CREATED` → `CONFIGURING` → `ACTIVE` → `INACTIVE`
- **📋 技术实现指引**：
  | 层级 | 实现模块 | 关键文件 | 任务ID |
  | -- | ------- | -------- | ------ |
  | 后端 | 店铺管理 | `StoreService.ts` | BE-S001 |
  | 后端 | 商品管理 | `ProductService.ts` | BE-P001 |
  | 后端 | 库存管理 | `InventoryService.ts` | BE-I001 |
  | 前端 | 店铺管理页面 | `StoreManagement.vue` | FE-S001 |
  | 前端 | 商品管理页面 | `ProductManagement.vue` | FE-P001 |

***

## 3️⃣3️⃣ 多商户订单闭环（Multi-Merchant Order Loop）

- **目标**：支持多个商户订单独立处理，同时平台统一监控。
- **流程**：
  1. 客户下单 → 系统拆分订单至各商户。
  2. 前端商户端显示新订单 → 可确认、拒单、修改发货信息。
  3. 后端记录订单状态（待处理、已发货、完成、异常）。
  4. 平台监控整体订单履约情况。
- **决策点**：
  - 商户拒单 → 系统可触发退款或自动分配给其他商户。
  - 超时未处理 → 系统提醒或自动处理。
- **输入**：客户订单数据
- **输出**：拆分后的商户子订单，包含状态更新
- **状态机**：`PENDING` → `ACCEPTED` → `SHIPPED` → `COMPLETED` → `REFUNDED`
- **📋 技术实现指引**：
  | 层级 | 实现模块 | 关键文件 | 任务ID |
  | -- | ------- | -------- | ------ |
  | 后端 | 订单管理 | `OrderService.ts` | BE-O001 |
  | 后端 | 订单拆分 | `OrderSplitService.ts` | BE-O002 |
  | 前端 | 商户订单页面 | `MerchantOrderPage.vue` | FE-O001 |
  | 前端 | 平台订单监控 | `OrderMonitoringPage.vue` | FE-O002 |

***

## 3️⃣4️⃣ 多商户库存同步闭环（Multi-Merchant Inventory Sync Loop）

- **目标**：确保平台和商户端库存实时同步。
- **流程**：
  1. 商户上传库存信息（API/手动）。
  2. 平台统一汇总并分发给前端展示。
  3. 当客户下单 → 自动扣减对应商户库存。
- **决策点**：
  - 库存不足 → 阻止下单或显示缺货。
  - 库存异常 → 系统报警。
- **输入**：商户库存数据、订单数据
- **输出**：实时同步的库存状态
- **状态机**：`SYNCED` → `UPDATING` → `SYNCED` → `ERROR`
- **📋 技术实现指引**：
  | 层级 | 实现模块 | 关键文件 | 任务ID |
  | -- | ------- | -------- | ------ |
  | 后端 | 库存管理 | `InventoryService.ts` | BE-I001 |
  | 后端 | 库存同步 | `InventorySyncService.ts` | BE-I002 |
  | 前端 | 库存管理页面 | `InventoryManagement.vue` | FE-I001 |

***

## 3️⃣5️⃣ 多商户结算与财务闭环（Multi-Merchant Settlement & Finance Loop）

- **目标**：自动计算商户收入、平台佣金、手续费及结算周期。
- **流程**：
  1. 后端计算订单收入、退款、佣金分成。
  2. 系统生成结算账单 → 商户可查询。
  3. 支持多结算方式（银行、电子钱包）。
  4. 自动发起付款（周期结算或即时结算）。
- **决策点**：
  - 异常订单 → 暂停结算并标记。
  - 多币种结算 → 汇率实时更新。
- **输入**：订单数据、支付数据
- **输出**：结算账单、付款记录
- **状态机**：`PENDING` → `CALCULATED` → `APPROVED` → `PAID`
- **📋 技术实现指引**：
  | 层级 | 实现模块 | 关键文件 | 任务ID |
  | -- | ------- | -------- | ------ |
  | 后端 | 结算服务 | `SettlementService.ts` | BE-S002 |
  | 后端 | 财务管理 | `FinanceService.ts` | BE-F001 |
  | 前端 | 结算管理页面 | `SettlementManagement.vue` | FE-S002 |

***

## 3️⃣6️⃣ 商户权限与角色闭环（Merchant Roles & Permissions Loop）

- **目标**：控制商户内部操作权限，支持多角色管理。
- **流程**：
  1. 商户创建角色（管理员、仓库、客服等）。
  2. 后端配置每个角色的访问权限。
  3. 前端动态显示可操作模块。
- **决策点**：
  - 权限冲突 → 系统提示。
  - 异常操作 → 记录日志和告警。
- **输入**：商户角色配置
- **输出**：权限配置，访问控制
- **📋 技术实现指引**：
  | 层级 | 实现模块 | 关键文件 | 任务ID |
  | -- | ------- | -------- | ------ |
  | 后端 | 权限服务 | `RBACService.ts` | BE-R001 |
  | 前端 | 权限管理页面 | `PermissionManagement.vue` | FE-R001 |

***

## 3️⃣7️⃣ 商户数据与分析闭环（Merchant Analytics & Reporting Loop）

- **目标**：提供独立商户数据分析，同时平台可汇总整体业务指标。
- **流程**：
  1. 后端收集订单、流量、库存、评价数据。
  2. 生成商户专属数据报表和趋势分析。
  3. 平台可生成多商户对比分析。
- **决策点**：
  - 数据异常 → 自动报警。
  - 需要合规报表 → 自动生成符合财务/税务规范的报表。
- **输入**：商户业务数据
- **输出**：商户报表、平台分析报告
- **状态机**：`RAW` → `PROCESSED` → `GENERATED` → `DISTRIBUTED`
- **📋 技术实现指引**：
  | 层级 | 实现模块 | 关键文件 | 任务ID |
  | -- | ------- | -------- | ------ |
  | 后端 | 报表服务 | `ReportService.ts` | BE-R002 |
  | 后端 | 数据分析 | `AnalyticsService.ts` | BE-A002 |
  | 前端 | 商户报表页面 | `MerchantReportPage.vue` | FE-R002 |
  | 前端 | 平台分析页面 | `PlatformAnalyticsPage.vue` | FE-A001 |

***

## 3️⃣8️⃣ 异常处理闭环（Exception & Dispute Loop）

- **目标**：处理商户异常、客户投诉、退款退货。
- **流程**：
  1. 客户发起投诉/退货 → 系统分配给对应商户。
  2. 商户处理 → 平台监控处理时效。
  3. 处理结果同步前端和财务结算。
- **决策点**：
  - 超时未处理 → 系统自动介入。
  - 争议订单 → 暂停结算，人工复核。
- **输入**：投诉/退货请求
- **输出**：处理结果，财务调整
- **状态机**：`SUBMITTED` → `PROCESSING` → `RESOLVED` → `ESCALATED`
- **📋 技术实现指引**：
  | 层级 | 实现模块 | 关键文件 | 任务ID |
  | -- | ------- | -------- | ------ |
  | 后端 | 异常处理 | `ExceptionService.ts` | BE-E001 |
  | 后端 | 争议解决 | `DisputeResolverService.ts` | BE-D001 |
  | 前端 | 异常管理页面 | `ExceptionManagement.vue` | FE-E001 |

***

## 3️⃣9️⃣ 功能模块化与权限控制闭环（Feature Modularization & Permission Control Loop）

- **目标**：将系统功能模块化，支持按商户收费，精细化权限控制。
- **流程**：
  1. **功能模块定义**：
     - 基础功能（商品管理、订单管理）
     - 增值功能（广告投放、数据分析）
     - 高级功能（API对接、定制化开发）
  2. **模块配置**：
     - 功能开关控制
     - 使用配额限制
     - 计费规则配置
  3. **权限体系**：
     - 角色定义（管理员、运营、财务等）
     - 细粒度权限分配
     - 数据隔离（租户/商户/店铺）
- **决策点**：
  - 模块定价策略
  - 权限继承规则
  - 数据隔离级别
- **输入**：商户ID、功能需求、角色配置
- **输出**：功能模块列表、权限配置、数据隔离规则

***

## 3️⃣3️⃣ 功能开通与支付闭环（Feature Activation & Payment Loop）

- **目标**：商户选购功能模块、支付费用、开通服务。
- **流程**：
  1. **功能选购**：
     - 展示功能模块和价格
     - 选择订阅周期（月/季/年）
     - 选择配套服务（培训、技术支持）
  2. **费用计算**：
     - 基础费用 + 增值服务费用
     - 使用量计费（订单数、商品数等）
     - 优惠活动计算
  3. **支付流程**：
     - 在线支付（支付宝、微信、银行卡）
     - 账户余额扣款
     - 发票开具
  4. **服务开通**：
     - 支付成功后自动开通
     - 配置生效通知
     - 服务期开始计时
- **决策点**：
  - 支付方式选择
  - 发票类型（普通/增值税）
  - 续费提醒策略
- **输入**：商户ID、选购功能、支付方式
- **输出**：开通记录、支付凭证、服务状态

***

## 3️⃣4️⃣ 多商户结算与财务闭环（Multi-Merchant Settlement & Finance Loop）

- **目标**：多商户资金结算、收益分润、账务核对，确保资金安全和透明。
- **流程**：
  1. **交易清算**：
     - 订单收入汇总（按商户维度）
     - 平台服务费扣除（根据合同约定）
     - 商户应得收益计算（扣除各项费用后）
     - 税费计算与代扣
  2. **结算周期**：
     - 按日/周/月结算（商户可选择）
     - 自动打款或申请提现
     - 结算单生成（包含明细和汇总）
     - 结算状态跟踪
  3. **分润管理**：
     - 分润规则配置（百分比、固定金额等）
     - 多级分销/代理分润
     - 分润计算与发放
     - 分润报表生成
  4. **财务对账**：
     - 商户账户流水核对
     - 异常交易处理（退款、纠纷等）
     - 财务报表生成（商户级、平台级）
     - 税务报表准备
  5. **资金安全**：
     - 资金流向监控
     - 异常资金预警
     - 资金冻结与解冻
- **决策点**：
  - 结算门槛（最低提现金额）
  - 手续费规则（提现、转账等）
  - 账期调整（根据商户等级）
  - 分润比例设置
  - 异常交易处理流程
- **输入**：交易数据、商户结算规则、分润配置、银行账户信息
- **输出**：结算单、账户余额、财务报表、分润记录
- **状态机**：`PENDING` → `PROCESSING` → `COMPLETED` → `FAILED`
- **📋 技术实现指引**：
  | 层级 | 实现模块 | 关键文件 | 任务ID |
  | -- | ------- | -------- | ------ |
  | 后端 | 结算服务 | `MerchantSettlementService.ts` | BE-F001 |
  | 后端 | 财务管理 | `FinanceService.ts` | BE-F002 |
  | 后端 | 分润管理 | `ProfitSharingService.ts` | BE-F003 |
  | 前端 | 结算管理 | `SettlementManagement.vue` | FE-F001 |
  | 前端 | 财务报表 | `FinanceReport.vue` | FE-F002 |

***

## 3️⃣5️⃣ 多商户商品与订单管理闭环（Multi-Merchant Product & Order Management Loop）

- **目标**：多商户商品上架、订单分配、库存同步管理。
- **流程**：
  1. **商品管理**：
     - 商户自有商品上传
     - 平台商品池共享
     - 商品审核（合规、质量）
  2. **订单分配**：
     - 订单智能分配（有库存优先/距离优先/评分优先）
     - 商户抢单模式
     - 异常订单人工处理
  3. **库存同步**：
     - 多商户库存汇总
     - 实时库存同步
     - 预占/扣减机制
  4. **多商户物流**：
     - 商户自有物流或平台物流
     - 物流轨迹共享
     - 签收确认
- **决策点**：
  - 商品上架审核标准
  - 订单分配策略
  - 库存超卖防护
- **输入**：商品数据、订单数据、库存数据
- **输出**：商品状态、订单分配结果、物流信息

***

## 3️⃣6️⃣ 恶意买家黑名单闭环（Malicious Buyer Blacklist Loop）

- **目标**：识别、管理和共享恶意买家信息，降低交易风险。
- **流程**：
  1. **黑名单管理**
     - 手动添加恶意买家（欺诈、拒付、滥用等）
     - 自动识别高风险买家（基于行为模式）
     - 黑名单等级划分（低/中/高风险）
  2. **风险评估**
     - 基于买家行为的综合风险评分
     - 多维度风险因素分析（退货率、投诉率、拒付率等）
     - 实时风险预警
  3. **黑名单共享**
     - 跨租户黑名单共享机制
     - 共享规则配置（自动接受/人工审核）
     - 共享状态同步
- **决策点**：
  - 黑名单阈值设定
  - 共享范围控制
  - 风险等级判定标准
- **输入**：买家信息、交易记录、行为数据
- **输出**：黑名单记录、风险评分、共享结果
- **状态机**：`SUGGESTED` → `PENDING_REVIEW` → `ACTIVE` / `REJECTED` → `EXPIRED`

***

## 3️⃣7️⃣ 高退货率SKU自动下架/改进建议闭环（High Return Rate SKU Auto-Delist & Improvement Loop）

- **目标**：监控高退货率SKU，自动下架风险商品并提供改进建议。
- **流程**：
  1. **退货率监控**
     - 实时计算SKU退货率
     - 多维度分析（按平台/店铺/类目）
     - 趋势监控和预警
  2. **自动下架**
     - 阈值触发自动下架
     - 多平台下架支持（Amazon/Shopee/Lazada/TikTok）
     - 自动重新上架功能
  3. **改进建议**
     - 基于退货原因的智能分析
     - 分类建议生成（质量/描述/图片/包装/物流等）
     - 实施步骤指导和ROI预估
- **决策点**：
  - 退货率阈值设定
  - 自动下架规则配置
  - 改进优先级排序
- **输入**：订单数据、退货记录、SKU信息
- **输出**：高风险SKU列表、下架结果、改进建议
- **状态机**：`MONITORED` → `HIGH_RISK` → `AUTO_DELISTED` → `IMPROVEMENT_SUGGESTED` → `RE_LISTED`

***

## 3️⃣8️⃣ 商业化与增长闭环（Monetization & Growth Loop）

- **目标**：实现系统持续盈利与收入增长（非SaaS模式）

### 收费模型

#### 1. 功能收费（Feature-based）
- 高级分析
- 自动化能力
- API调用

#### 2. 交易抽成（Transaction-based）
- TOC：订单抽佣（3~10%）
- TOB：大单服务费

#### 3. 服务收费（Service-based）
- 代发货
- 仓储服务
- 数据服务

#### 4. 资金沉淀（Deposit Float）
- 押金沉淀收益
- 账期资金

### 收费触发点

- 功能调用
- 订单完成
- 商家使用服务
- API请求

### 收入放大机制

- ROI分析 → 推荐开功能
- 利润分析 → 推荐加广告
- 订单增长 → 引导升级套餐

### 决策点

- 免费 vs 付费边界
- 抽成比例
- 功能定价策略

### 输入

- 用户行为
- 订单数据
- 利润数据

### 输出

- 收入增长
- 用户付费转化

***

## 3️⃣9️⃣ 服务编排与执行闭环（Service Orchestration Loop）

- **目标**：将业务闭环转化为可执行的后端服务流

### 核心原则

- 每个业务闭环必须对应一个 Service Flow
- 所有逻辑必须走 Service 层

### 执行流程

Frontend
→ Controller
→ Service（核心编排）
→ Repository / External API
→ 返回结果

### 示例

#### 功能开通

Controller
→ FeatureService.openFeature
→ PaymentService.create
→ PaymentCallback
→ PermissionService.grant

### 决策点

- 服务拆分粒度
- 是否异步（消息队列）
- 是否需要补偿机制

### 输出

- 可执行后端服务
- 业务状态流转

***

## 4️⃣0️⃣ 增长飞轮闭环（Growth Flywheel Loop）

- **目标**：让系统自动变强、自动赚钱

### 飞轮逻辑

数据 → 利润分析 → 推荐 → 用户行动 → 收入 → 更多数据

### 核心路径

1. 商品数据 → 利润分析
2. 利润高 → 推广广告
3. 广告带订单
4. 订单产生数据
5. 数据优化策略

### TOB路径

询盘 → 报价 → 成交 → 复购 → 信用提升 → 更大订单

### 决策点

- 推荐策略
- 自动化程度
- AI参与程度

### 输出

- GMV增长
- ROI提升
- 用户粘性

***

### 🔍 追踪与审计

- **追踪五元组**：
  - `tenantId`：租户 ID（业务隔离）
  - `shopId`：店铺 ID（平台/店铺隔离）
  - `taskId`：任务 ID（任务/规则触发归档）
  - `traceId`：链路追踪 ID（全链路唯一标识）
  - `businessType`：业务类型（TOC/TOB）
- **审计要求**：
  - 每一笔操作必须绑定 `traceId` 和 `businessType`
  - 所有功能需通过 Shadow-Test（最小冒烟测试）
  - 关键操作必须生成 AuditLog

***

### 📋 业务审核状态机

- **通用审核流程**：`SUBMITTED` (提交) → `PENDING_REVIEW` (人工审核) → `EXECUTED` / `REJECTED`
- **适用场景**：
  - TOC：大额订单、价格变动、退款
  - TOB：大额企业订单、阶梯价审批、信用审批

***

### 💡 说明

1. 业务闭环文档是**最高层文档**，不涉及具体前端或模块实现细节。
2. 下层模块功能、接口、算法、UI 都是这个闭环的落地实现。
3. 形成从**采集 → 决策 → 执行 → 反馈 → 风控**的完整业务链。
4. 每个闭环都有明确的输入、输出、流程和决策点，确保业务流程的完整性和可控性。
5. 各闭环之间通过数据流转和依赖关系形成完整的业务生态系统。
6. 所有业务操作均需遵循项目特定规则，确保系统安全和数据一致性。
7. **“闭环写入规则：只要逻辑上能闭环就写，落地方式后置”**
8. **系统层级结构**：
   - L1（业务闭环）：交易系统核心流程
   - L2（系统决策层）：定价、风控、健康度等系统级能力
   - L3（数据中台层）：商品主数据、成本基准等数据管理能力
   - L4（自动化与增长）：任务调度、A/B测试、用户资产等高级能力
9. **横切能力**：账号健康度、任务调度、权限审计等能力贯穿所有业务闭环，确保系统稳定性和安全性。

***

### 🗄️ 数据库规范与约束

#### 表命名规范

| 规则       | 要求              | 示例                                      |
| -------- | --------------- | --------------------------------------- |
| **表前缀**  | 所有表必须以 `cf_` 开头 | `cf_product`, `cf_order`, `cf_shop`     |
| **模块标识** | 按模块添加子前缀        | `cf_ai_` (AI模块), `cf_logistics_` (物流)   |
| **命名风格** | 小写 + 下划线分隔      | `cf_consumer_orders`, `cf_ad_campaigns` |

#### 核心表清单

| 表名                   | 模块  | 说明    | 五元组追踪                       |
| -------------------- | --- | ----- | --------------------------- |
| `cf_tenant`          | 租户  | 租户信息  | ✅ tenantId                  |
| `cf_shop`            | 店铺  | 店铺信息  | ✅ tenantId, shopId          |
| `cf_product`         | 商品  | 商品主数据 | ✅ tenantId, shopId, traceId |
| `cf_product_sku`     | 商品  | SKU变体 | ✅ tenantId, shopId, traceId |
| `cf_consumer_orders` | 订单  | C端订单  | ✅ tenantId, shopId, traceId |
| `cf_supplier`        | 供应链 | 供应商信息 | ✅ tenantId, traceId         |
| `cf_inventory`       | 库存  | 库存记录  | ✅ tenantId, shopId, traceId |
| `cf_user`            | 用户  | 系统用户  | ✅ tenantId                  |
| `cf_audit_log`       | 审计  | 操作日志  | ✅ 五元组完整                     |

#### 字段规范

| 字段类型       | 规范                            | 禁止             |
| ---------- | ----------------------------- | -------------- |
| **金额**     | `decimal(10,2)`               | ❌ float/double |
| **物理属性**   | 长度(cm), 重量(kg), 体积(m³)        | -              |
| **JSON数据** | 序列化存储，解析后使用                   | -              |
| **时间戳**    | `created_at`, `updated_at` 必填 | -              |

#### 追踪五元组字段（所有业务表必须）

```typescript
{
  tenantId: string;      // 租户ID - 业务隔离
  shopId: string;        // 店铺ID - 平台/店铺隔离
  taskId: string;        // 任务ID - 任务追踪
  traceId: string;       // 链路追踪ID - 全链路唯一
  businessType: 'TOC' | 'TOB';  // 业务类型
}
```

#### 数据完整性约束

| 约束       | 要求                                          |
| -------- | ------------------------------------------- |
| **唯一约束** | `cf_product` 表必须保证 (platform, productId) 唯一 |
| **外键约束** | 关键关联必须建立外键                                  |
| **幂等性**  | 所有建表语句必须使用 `db.schema.hasTable` 前置校验        |
| **安全约束** | **⚠️ 严禁** 执行 `DROP`, `TRUNCATE` 等破坏性操作      |

***

