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

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

## 📑 目录

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)
46. [技术基础设施闭环](#4️⃣6️⃣-技术基础设施闭环technical-infrastructure-loop)
47. [客户服务闭环](#4️⃣7️⃣-客户服务闭环customer-service-loop)
48. [跨境电商闭环](#4️⃣8️⃣-跨境电商闭环cross-border-e-commerce-loop)
49. [AI驱动智能决策闭环](#4️⃣9️⃣-ai驱动智能决策闭环ai-driven-smart-decision-loop)
50. [核心服务优先级闭环](#5️⃣0️⃣-核心服务优先级闭环core-service-priority-loop)
51. [多商户收益排行榜系统（信任引擎）](#5️⃣1️⃣-多商户收益排行榜系统信任引擎merchant-leaderboard-loop) 🆕
52. [策略市场（Strategy Marketplace）](#5️⃣2️⃣-策略市场strategy-marketplace-loop) 🆕
53. [自动选品+自动上架系统（增长引擎）](#5️⃣3️⃣-自动选品自动上架系统增长引擎auto-product-selection-listing-loop) 🆕
54. [AI店铺托管（AutoPilot）](#5️⃣4️⃣-ai店铺托管autopilot-loop) 🆕
55. [跨平台套利系统](#5️⃣5️⃣-跨平台套利系统cross-platform-arbitrage-loop) 🆕
56. [AI动态定价系统](#5️⃣6️⃣-ai动态定价系统ai-dynamic-pricing-loop) 🆕
57. [多店铺管理闭环](#5️⃣7️⃣-多店铺管理闭环multi-shop-management-loop) 🆕
58. [多租户层级管理闭环](#5️⃣8️⃣-多租户层级管理闭环multi-tenant-hierarchy-loop) 🆕
59. [统一闭环依赖](#🔹-统一闭环依赖toc--tob)
60. [闭环依赖关系](#🔗-闭环依赖关系toc--tob)
61. [关键绩效指标](#📊-关键绩效指标kpi)
62. [追踪与审计](#🔍-追踪与审计)
63. [业务审核状态机](#📋-业务审核状态机)
64. [说明](#💡-说明)

***

## 附录：前端设计规范引用

> **说明**：前端交互设计规范已独立为专门文档，本附录仅提供引用链接。

### 状态机定义

所有状态机定义统一维护在 [STATE_MACHINE.md](../01_Architecture/STATE_MACHINE.md)，包括：
- 商品状态机 (Product State Machine)
- 订单状态机 (Order State Machine)
- 任务状态机 (Task State Machine)
- 商户状态机 (Merchant State Machine)
- 功能状态机 (Feature State Machine)

### 前端设计规范

详细的前端设计规范请参考 [Frontend_Design.md](../03_Frontend/Frontend_Design.md)，包括：
- 页面路由结构
- 组件设计规范
- 状态管理规范
- API交互规范
- 按钮操作规范
- 表单验证规范

### 页面映射

前端页面与业务闭环的映射关系请参考 [Task_Overview.md](./Task_Overview.md) 中的附录部分。

***

**补充说明**：

1. 本附录内容基于参考文档的前端交互设计规范，与现有58个业务闭环保持一致
2. 所有状态机定义统一引用 [STATE_MACHINE.md](../01_Architecture/STATE_MACHINE.md)
3. 页面映射与Task_Overview.md中的前端任务对应
4. 组件规范遵循项目特定规则中的命名和技术约束

## 1️⃣ 数据采集与清洗闭环（Product Data Collection & Cleansing）
        icon: 'DashboardOutlined',
        component: '@/pages/dashboard',
      },
      {
        path: '/products',
        name: '商品中心',
        icon: 'ShoppingOutlined',
        routes: [
          {
            path: '/products/list',
            name: '商品列表',
            component: '@/pages/products/list',
            access: 'product:read',
          },
          {
            path: '/products/detail/:id',
            name: '商品详情',
            component: '@/pages/products/detail',
            hideInMenu: true,
            access: 'product:read',
          },
        ],
      },
      // ...
    ],
  },
];
```

#### 权限控制

```typescript
// src/access.ts
export default function(initialState: InitialState) {
  const { currentUser } = initialState || {};
  const permissions = currentUser?.permissions || [];
  
  return {
    // 商品权限
    'product:read': permissions.includes('product:read'),
    'product:create': permissions.includes('product:create'),
    'product:update': permissions.includes('product:update'),
    'product:delete': permissions.includes('product:delete'),
    'product:sync': permissions.includes('product:sync'),
    
    // 订单权限
    'order:read': permissions.includes('order:read'),
    'order:confirm': permissions.includes('order:confirm'),
    'order:ship': permissions.includes('order:ship'),
    'order:cancel': permissions.includes('order:cancel'),
    
    // ...
  };
}
```

***

**补充说明**：

1. 本附录内容基于参考文档的前端交互设计规范，与现有58个业务闭环保持一致
2. 所有状态机定义与业务闭环中的状态定义对应
3. 页面映射与Task\_Overview\.md中的前端任务对应
4. 组件规范遵循项目特定规则中的命名和技术约束

## 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                   |
- **💰 钱流**：
  - 采集成本：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`

***

## 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

***

## 4️⃣6️⃣ 技术基础设施闭环（Technical Infrastructure Loop）

- **目标**：提供稳定、高效、可扩展的技术基础设施，支撑核心业务流程的运行。
- **流程**：
  1. **服务管理**：
     - 服务注册与发现
     - 服务健康检查与监控
     - 服务版本管理与部署
  2. **数据管理**：
     - 缓存策略与优化
     - 数据库性能优化
     - 数据备份与恢复
  3. **消息处理**：
     - 消息队列管理
     - 异步操作处理
     - 事件总线管理
  4. **安全与合规**：
     - 数据传输加密
     - 访问控制与权限管理
     - 日志审计与追踪
- **决策点**：
  - 服务健康状态评估
  - 性能瓶颈识别与优化
  - 安全风险评估与应对
- **输入**：系统配置、服务状态数据、性能指标
- **输出**：技术基础设施状态报告、优化建议、安全审计报告

***

## 4️⃣7️⃣ 客户服务闭环（Customer Service Loop）

- **目标**：提供高效、专业的客户服务，解决客户问题，提升客户满意度。
- **流程**：
  1. **客户咨询处理**：
     - 咨询接收与分类
     - 智能客服响应
     - 人工客服介入
  2. **争议与投诉处理**：
     - 争议接收与评估
     - 证据收集与分析
     - 解决方案制定与执行
  3. **售后服务**：
     - 退货退款处理
     - 产品质量问题处理
     - 售后跟踪与反馈
  4. **客户反馈管理**：
     - 反馈收集与分析
     - 改进建议生成
     - 服务质量评估
- **决策点**：
  - 争议类型识别与处理策略
  - 退款审批与执行
  - 服务质量评估与改进
- **输入**：客户咨询、争议信息、售后请求、客户反馈
- **输出**：服务响应、争议解决方案、售后处理结果、客户满意度报告

***

## 4️⃣8️⃣ 跨境电商闭环（Cross-Border E-Commerce Loop）

- **目标**：支持跨境电商全流程，解决清关、物流、支付等痛点。
- **流程**：
  1. **跨境商品管理**：
     - 商品合规性检查
     - 关税计算与预估
     - 商品分类与HS编码管理
  2. **清关服务**：
     - 自动生成清关文件
     - 海关申报与追踪
     - 关税和税费处理
  3. **跨境物流**：
     - 国际物流渠道选择
     - 运费计算与优化
     - 物流轨迹追踪
     - 跨境仓储管理
  4. **跨境支付**：
     - 多币种支付支持
     - 汇率管理与优化
     - 跨境支付安全
  5. **合规管理**：
     - 出口/进口法规遵守
     - 税务合规与申报
     - 产品认证与标准
- **决策点**：
  - 物流渠道选择（成本vs时效）
  - 清关策略（自行清关vs代理清关）
  - 支付方式选择（安全性vs便捷性）
  - 合规风险评估
- **输入**：商品信息、订单数据、目的地国家/地区、支付信息
- **输出**：清关文件、物流信息、支付状态、合规报告
- **状态机**：`PENDING` → `PROCESSING` → `CLEARANCE` → `SHIPPING` → `DELIVERED`

***

## 4️⃣9️⃣ AI驱动智能决策闭环（AI-Driven Smart Decision Loop）

- **目标**：利用AI技术提升运营效率和决策准确性，实现"AI主导决策 + 人类验证 + 操作执行 + 日志记录"的智能化运营。
- **核心理念**：
  - **AI建议为主**：AI生成策略、推荐操作、人类只作为参考或最终确认
  - **人类介入可控**：前期可高干预，AI越强介入越低，最后趋近于完全自动
  - **操作可追踪**：每次AI建议、用户操作和系统执行都要有LOG，保证可审计性
  - **节点化设计**：每个决策动作是一个节点，节点间用逻辑流连接，自动推进
  - **数据驱动**：每个节点依赖历史数据 + 实时数据来生成建议

### 流程概览

```
[AI生成决策建议] → [人类确认/修改] → [系统执行操作] → [日志记录]
```

### 节点自动决策体系

#### 节点类型定义

| 节点类型                              | 功能               | 输入数据                   | 输出数据                  |
| --------------------------------- | ---------------- | ---------------------- | --------------------- |
| **决策节点（Decision Node）**           | AI 根据数据生成建议或选择动作 | 历史数据、实时数据、外部数据         | JSON动作方案 + 置信度 + 风险等级 |
| **条件节点（Condition Node）**          | 根据规则或状态判断执行路径    | 决策节点输出 + 实时数据          | 执行路径（自动执行/人工确认/阻止执行）  |
| **执行节点（Action Node）**             | 调用 API、脚本或系统操作   | 确认后的动作方案               | 执行状态（成功/失败）           |
| **人工确认节点（Human Approval Node）**   | 人类对 AI 建议进行修改或确认 | 决策节点输出 + 条件判断结果 + 数据参考 | 最终动作方案                |
| **日志节点（Log Node）**                | 记录整个节点数据、结果      | 所有节点输入输出               | 日志记录（唯一ID，全链路追踪）      |
| **历史数据更新节点**                      | 将执行结果回写历史库       | 执行结果                   | 历史数据库更新               |
| **报表分析节点（Report/Analytics Node）** | 生成报表和趋势分析        | 历史数据 + 节点日志            | 报表、趋势分析、总结            |

#### 数据分类

| 数据类别     | 内容                                      | 用途                   |
| -------- | --------------------------------------- | -------------------- |
| **历史数据** | 广告投放历史（CTR、CVR、ROI）、价格历史、销售历史、TOB批发订单历史 | 预测调价或预算策略、判断调价幅度     |
| **实时数据** | 当前库存、价格、预算、广告状态、实时ROI、异常指标              | 决定节点是否可执行、支持条件节点判断分支 |
| **外部数据** | 节假日、竞品价格、市场趋势、供应链状态、汇率                  | 影响广告投放策略和定价          |

#### 完整节点流程（TOC零售单笔）

```
[输入数据] → [AI决策节点] → [条件判断节点] → [人工确认节点] → [执行节点]
     ↓
[日志节点] → [历史数据更新节点] → [报表分析节点] → [优化反馈节点] → 回到 [AI决策节点]
```

1. **输入数据**：单笔订单、客户历史购买、库存状态、广告数据、市场趋势
2. **决策节点**：AI 生成动作建议（是否调价、是否推荐促销、广告曝光调整）
3. **条件节点**：检查库存、预算、置信度、风险
4. **人工确认节点**（可选）：处理低置信度或高风险动作
5. **执行节点**：系统执行调价、广告调整、库存扣减
6. **日志节点**：记录每个操作和决策过程
7. **历史数据更新节点**：更新库存、销售、广告效果、ROI
8. **报表分析节点**：生成订单收益、库存波动、广告转化报表
9. **优化反馈节点**：AI 根据报表优化下一轮决策

#### 完整节点流程（TOB批发/整柜）

1. **输入数据**：批发订单、客户等级、库存、供应商状态、市场趋势
2. **决策节点**：AI 生成分配方案、价格方案、库存调拨方案
3. **条件节点**：检查库存、供应商能力、风险等级
4. **人工确认节点**：处理库存紧张或低置信度分配
5. **执行节点**：系统生成订单、调拨库存、同步 ERP
6. **日志节点**：全链路记录决策与执行状态
7. **历史数据更新节点**：回写分配结果、客户反馈、库存变化
8. **报表分析节点**：生成分配效率、库存周转率、客户满意度报表
9. **优化反馈节点**：AI 根据历史表现优化分配策略

### 规则引擎（初期备用方案）

在 AI 决策模型尚未充分训练或 token 不可用的情况下，使用规则引擎保证业务自动化运行。

#### 规则引擎与 AI 决策的关系

```
[业务触发] → [规则引擎检查] → [规则命中?]
                                    ├── 是 → [按规则执行] → [日志记录]
                                    └── 否 → [AI决策节点] → [条件判断] → [执行]
```

#### 规则类型

| 规则类型     | 说明        | 示例                          |
| -------- | --------- | --------------------------- |
| **阈值规则** | 基于数值阈值的判断 | 库存 < 安全库存 → 触发补货            |
| **时间规则** | 基于时间周期的判断 | 每日 00:00 检查广告预算             |
| **组合规则** | 多条件组合判断   | ROI > 1.5 且 库存充足 → 自动增加广告预算 |
| **异常规则** | 异常检测与处理   | CTR 下降 > 30% → 触发人工确认       |

#### 规则配置示例

```typescript
interface Rule {
  id: string;
  name: string;
  condition: {
    type: 'threshold' | 'time' | 'composite' | 'anomaly';
    expression: string;
  };
  action: {
    type: 'auto_execute' | 'human_approval' | 'notification';
    payload: object;
  };
  priority: number;
  enabled: boolean;
}

// 示例规则
const rules: Rule[] = [
  {
    id: 'RULE-001',
    name: '库存不足自动补货',
    condition: {
      type: 'threshold',
      expression: 'inventory < safety_stock'
    },
    action: {
      type: 'human_approval',
      payload: { action: 'restock', quantity: 'suggested_amount' }
    },
    priority: 1,
    enabled: true
  },
  {
    id: 'RULE-002',
    name: '高ROI广告自动加预算',
    condition: {
      type: 'composite',
      expression: 'roi > 1.5 AND inventory > min_stock'
    },
    action: {
      type: 'auto_execute',
      payload: { action: 'increase_budget', amount: 100 }
    },
    priority: 2,
    enabled: true
  }
];
```

#### 演进路径

| 阶段     | 规则引擎         | AI决策节点          |
| ------ | ------------ | --------------- |
| **初期** | 主导，处理大部分标准场景 | 辅助，处理复杂场景       |
| **中期** | 处理简单、确定性场景   | 主导，处理需要预测和优化的场景 |
| **后期** | 作为异常处理和兜底机制  | 全链路自动决策         |

### 详细流程

#### 1. AI生成决策建议

- **输入**：历史数据 + 实时数据 + 规则库
- **输出示例**：
  ```json
  {
    "action": "调整价格",
    "params": {"sku": "A123", "new_price": 88.5},
    "confidence": 0.92,
    "risk_level": "low",
    "alternative_solutions": [
      {"action": "促销折扣", "params": {"sku":"A123", "discount":10}, "confidence":0.85}
    ]
  }
  ```
- **设计要点**：
  - 每个建议带 **置信度、风险等级、替代方案**
  - 支持多维度评分（收益、风险、用户体验）

#### 2. 人类确认/修改

- **UI/插件端展示**：
  - 建议动作、参数、风险提示
  - 支持修改参数或拒绝
  - 可选"自动执行模式"，允许置信度高于阈值自动执行
- **记录内容**：
  - 谁确认/修改
  - 修改内容及理由
  - 时间戳

#### 3. 系统执行操作

- **执行方式**：API调用 / 脚本执行 / 自动化任务
- **失败重试策略**：
  - 可配置重试次数
  - 超时或失败记录到日志
- **成功后**：返回执行状态，更新状态数据库

#### 4. 日志记录

- **全链路ID关联**：每条操作有唯一ID，AI建议→人操作→系统执行关联
- **日志结构示例**：
  ```json
  {
    "operation_id": "20260319-001",
    "ai_suggestion": {
      "action": "调整价格",
      "params": {"sku": "A123", "new_price": 88.5},
      "confidence": 0.92,
      "timestamp": "2026-03-19T00:00:00"
    },
    "human_review": {
      "operator": "操作员姓名",
      "modified_params": {"new_price": 89.0},
      "reason": "小幅提升利润",
      "timestamp": "2026-03-19T00:05:00"
    },
    "system_execution": {
      "status": "success",
      "timestamp": "2026-03-19T00:06:00"
    }
  }
  ```

### 自动化程度演进

| 阶段     | AI角色       | 人类角色  | 说明                |
| ------ | ---------- | ----- | ----------------- |
| **初期** | 建议生成       | 审核确认  | 人工操作占主导           |
| **中期** | 自动执行（高置信度） | 异常处理  | 对置信度高、低风险的操作可自动执行 |
| **后期** | 全链路决策      | 仅异常介入 | AI全链路决策 + 自动执行    |

### 角色与权限

| 角色       | 权限             | 备注           |
| -------- | -------------- | ------------ |
| AI Agent | 决策生成、数据分析、风险评估 | 输出建议，带置信度    |
| 人类操作者    | 审核/修改/确认       | 前期高干预，后期可降低  |
| 系统执行层    | 自动化操作执行        | 仅执行经过确认的操作   |
| 日志管理系统   | 全链路记录          | 可回溯，每条操作打时间戳 |

### 智能决策应用场景

1. **智能定价与动态调价**
2. **智能库存预测与补货**
3. **智能广告投放与优化**
4. **智能客户服务与售后**
5. **智能风控与异常检测**

- **决策点**：
  - 模型选择（监督学习vs无监督学习）
  - 预测结果置信度阈值
  - 人工干预时机
  - 模型更新频率
  - 自动执行阈值设定
- **输入**：业务数据、市场数据、用户行为数据
- **输出**：智能决策建议、预测结果、优化方案、执行日志
- **状态机**：`DATA_COLLECTION` → `AI_SUGGESTION` → `HUMAN_REVIEW` → `EXECUTION` → `LOGGING` → `FEEDBACK`
- **关键指标**：
  - AI建议采纳率
  - 自动执行比例
  - 人工干预次数
  - 决策准确率
  - 执行成功率

***

## 5️⃣0️⃣ 核心服务优先级闭环（Core Service Priority Loop）

- **目标**：确定核心业务服务的优先级顺序，确保资源合理分配。
- **流程**：
  1. **服务评估**：
     - 业务价值评估
     - 技术复杂度评估
     - 资源需求评估
     - 风险评估
  2. **优先级排序**：
     - 基于业务价值的排序
     - 基于依赖关系的排序
     - 基于时间窗口的排序
  3. **资源分配**：
     - 人力分配
     - 技术资源分配
     - 时间规划
  4. **执行监控**：
     - 进度跟踪
     - 资源使用监控
     - 风险预警
- **决策点**：
  - 优先级调整时机
  - 资源重新分配决策
  - 项目范围变更管理
- **输入**：服务需求、业务目标、资源状况
- **输出**：优先级排序结果、资源分配计划、执行进度报告
- **状态机**：`ASSESSMENT` → `PRIORITIZATION` → `RESOURCE_ALLOCATION` → `EXECUTION` → `MONITORING`

***

## 5️⃣1️⃣ 多商户收益排行榜系统（信任引擎）（Merchant Leaderboard Loop）🆕

- **目标**：让用户看到"别人赚钱了" → 促进付费，建立信任和转化
- **流程**：
  1. **数据采集**：
     - 收集商户订单数据
     - 收集广告数据
     - 收集ROI数据
     - 收集利润数据
  2. **数据汇总**：
     - 计算总收入
     - 计算总成本
     - 计算净利润
     - 计算ROI
  3. **排行计算**：
     - 收益榜排序
     - ROI榜排序
     - 增长榜排序
  4. **防作弊处理**：
     - 过滤异常订单
     - ROI上限限制
     - 新用户单独榜单
  5. **榜单展示**：
     - TOP 10 商户展示
     - ROI展示
     - 使用策略标签
- **决策点**：
  - 排行计算频率（每10分钟）
  - 防作弊阈值设定
  - 榜单展示策略
- **输入**：商户订单数据、广告数据、ROI数据
- **输出**：排行榜数据、TOP 10 商户、榜单类型
- **状态机**：`DATA_COLLECTION` → `DATA_AGGREGATION` → `RANKING_CALCULATION` → `ANTI_CHEAT` → `LEADERBOARD_DISPLAY`
- **关键指标**：
  - 商户总数
  - 活跃商户数
  - 平均ROI
  - 最高ROI
  - 榜单更新频率
- **数据表**：
  - `cf_merchant_metrics`：商户指标汇总表
  - `cf_leaderboard`：排行榜表
  - `cf_leaderboard_history`：排行榜历史表

***

## 5️⃣2️⃣ 策略市场（Strategy Marketplace Loop）🆕

- **目标**：AI赚钱能力商品化，实现功能收费闭环
- **流程**：
  1. **策略创建**：
     - 策略类型定义（广告/定价/选品）
     - 策略配置schema
     - 策略定价模式
     - 策略ROI预估
  2. **策略发布**：
     - 策略审核
     - 策略上架
     - 策略分类
  3. **策略推荐**：
     - 基于商户数据推荐
     - 基于ROI推荐
     - 基于使用场景推荐
  4. **策略激活**：
     - 商户选择策略
     - 权限验证
     - 费用扣除
     - 策略激活
  5. **策略使用**：
     - 策略执行
     - 使用记录
     - 效果追踪
     - ROI计算
  6. **策略优化**：
     - 使用次数统计
     - ROI统计
     - 策略调整
- **决策点**：
  - 策略定价策略
  - 策略推荐算法
  - 策略使用权限
- **输入**：策略配置、商户数据、使用记录
- **输出**：策略列表、推荐策略、激活状态、使用统计
- **状态机**：`STRATEGY_CREATION` → `STRATEGY_PUBLISH` → `STRATEGY_RECOMMENDATION` → `STRATEGY_ACTIVATION` → `STRATEGY_USAGE` → `STRATEGY_OPTIMIZATION`
- **关键指标**：
  - 策略总数
  - 活跃策略数
  - 策略使用次数
  - 平均ROI
  - 策略收益
- **数据表**：
  - `cf_strategies`：策略表
  - `cf_merchant_strategies`：商户策略关联表
  - `cf_strategy_usage`：策略使用记录表
  - `cf_strategy_metrics`：策略指标表

***

## 5️⃣3️⃣ 自动选品+自动上架系统（增长引擎）（Auto Product Selection & Listing Loop）🆕

- **目标**：自动找到赚钱商品 → 自动卖，实现自动化增长
- **流程**：
  1. **商品采集**：
     - 多平台商品采集（1688/Amazon/TikTok）
     - 商品数据清洗
     - 商品数据标准化
  2. **商品池管理**：
     - 商品入库
     - 商品分类
     - 商品去重
  3. **AI选品**：
     - 商品评分计算
     - ROI预估
     - 市场需求分析
     - 竞争度分析
  4. **选品决策**：
     - ROI阈值判断
     - 评分阈值判断
     - 预算范围判断
  5. **自动上架**：
     - 创建商品任务
     - 商品定价
     - 平台同步
  6. **效果追踪**：
     - 销售数据追踪
     - ROI计算
     - 选品效果评估
- **决策点**：
  - 选品算法参数
  - ROI阈值设定
  - 预算范围设定
  - 自动上架策略
- **输入**：平台商品数据、选品配置、预算范围
- **输出**：选中商品、上架商品、效果报告
- **状态机**：`PRODUCT_COLLECTION` → `PRODUCT_POOL_MANAGEMENT` → `AI_SELECTION` → `SELECTION_DECISION` → `AUTO_LISTING` → `EFFECT_TRACKING`
- **关键指标**：
  - 商品池大小
  - 选品成功率
  - 平均ROI
  - 上架成功率
  - 自动化率
- **数据表**：
  - `cf_products_pool`：商品池表
  - `cf_merchant_products`：商户商品表
  - `cf_product_selection_logs`：选品记录表
  - `cf_product_metrics`：商品指标表

***

## 5️⃣4️⃣ AI店铺托管（AutoPilot Loop）🆕

- **目标**：替用户运营店铺，实现全自动运营
- **流程**：
  1. **托管配置**：
     - 策略选择（选品/定价/广告）
     - 预算设置
     - 风险控制
     - 托管范围设定
  2. **托管启动**：
     - 权限验证
     - 资源分配
     - 托管服务启动
  3. **自动运营**：
     - 自动选品
     - 自动定价
     - 自动广告
     - 自动库存管理
  4. **实时监控**：
     - 销售数据监控
     - ROI监控
     - 风险监控
     - 异常检测
  5. **智能决策**：
     - 策略调整
     - 预算调整
     - 风险控制
     - 紧急停止
  6. **报告生成**：
     - 运营报告
     - ROI报告
     - 决策日志
- **决策点**：
  - 托管策略选择
  - 预算分配策略
  - 风险控制策略
  - 紧急停止条件
- **输入**：托管配置、商户数据、市场数据
- **输出**：运营报告、ROI报告、决策日志
- **状态机**：`AUTOPILOT_CONFIG` → `AUTOPILOT_START` → `AUTO_OPERATION` → `REAL_TIME_MONITORING` → `SMART_DECISION` → `REPORT_GENERATION`
- **关键指标**：
  - 托管商户数
  - 自动化运营率
  - 平均ROI
  - 风险事件数
  - 紧急停止次数
- **数据表**：
  - `cf_autopilot_config`：托管配置表
  - `cf_autopilot_status`：托管状态表
  - `cf_autopilot_logs`：托管日志表
  - `cf_autopilot_decisions`：托管决策表

***

## 5️⃣5️⃣ 跨平台套利系统（Cross-Platform Arbitrage Loop）🆕

- **目标**：低买高卖，实现跨平台套利
- **流程**：
  1. **价格监控**：
     - 多平台价格采集
     - 价格对比分析
     - 价格趋势分析
  2. **套利机会识别**：
     - 价格差计算
     - ROI计算
     - 利润计算
     - 风险评估
  3. **套利决策**：
     - 利润阈值判断
     - ROI阈值判断
     - 风险评估
  4. **自动执行**：
     - 采购下单
     - 平台上架
     - 库存同步
  5. **套利监控**：
     - 订单状态监控
     - 利润追踪
     - 风险监控
  6. **套利结算**：
     - 利润核算
     - 费用扣除
     - 收益分配
- **决策点**：
  - 套利阈值设定
  - 风险控制策略
  - 执行策略（自动/手动）
  - 结算策略
- **输入**：多平台价格数据、套利配置、风险参数
- **输出**：套利机会、套利订单、利润报告
- **状态机**：`PRICE_MONITORING` → `ARBITRAGE_OPPORTUNITY` → `ARBITRAGE_DECISION` → `AUTO_EXECUTION` → `ARBITRAGE_MONITORING` → `ARBITRAGE_SETTLEMENT`
- **关键指标**：
  - 套利机会数
  - 套利成功率
  - 平均利润
  - 平均ROI
  - 风险事件数
- **数据表**：
  - `cf_arbitrage_products`：套利商品表
  - `cf_arbitrage_opportunities`：套利机会表
  - `cf_arbitrage_orders`：套利订单表
  - `cf_arbitrage_profits`：套利利润表

***

## 5️⃣6️⃣ AI动态定价系统（AI Dynamic Pricing Loop）🆕

- **目标**：在竞争中最大化利润，实现博弈级定价
- **流程**：
  1. **市场监控**：
     - 竞争对手价格监控
     - 市场需求分析
     - 库存水平监控
     - 转化率监控
  2. **定价模型**：
     - 需求预测
     - 竞争分析
     - 价格弹性计算
     - 最优价格计算
  3. **定价决策**：
     - 提价策略
     - 降价策略
     - 保持策略
     - A/B测试定价
  4. **价格执行**：
     - 价格更新
     - 平台同步
     - 库存调整
  5. **效果追踪**：
     - 销售数据追踪
     - 利润追踪
     - 转化率追踪
     - ROI计算
  6. **模型优化**：
     - 效果分析
     - 模型调整
     - 策略优化
- **决策点**：
  - 定价策略选择
  - 提价/降价阈值
  - A/B测试策略
  - 模型更新频率
- **输入**：市场数据、竞争对手价格、销售数据
- **输出**：最优价格、定价决策、效果报告
- **状态机**：`MARKET_MONITORING` → `PRICING_MODEL` → `PRICING_DECISION` → `PRICE_EXECUTION` → `EFFECT_TRACKING` → `MODEL_OPTIMIZATION`
- **关键指标**：
  - 价格调整次数
  - 平均利润率
  - 转化率
  - ROI
  - 定价准确率
- **数据表**：
  - `cf_pricing_decisions`：定价决策表
  - `cf_pricing_history`：定价历史表
  - `cf_competitor_prices`：竞争对手价格表
  - `cf_pricing_metrics`：定价指标表

***

## 5️⃣7️⃣ 多店铺管理闭环（Multi-Shop Management Loop）🆕

- **目标**：实现多店铺、多商户、多部门的统一管理与数据隔离，支持独立站/外部独立站/报表等一对多交互
- **层级架构**：
  ```
  商户(Merchant) → 部门(Department) → 店铺(Shop)
       ↓                ↓                ↓
    商户级数据        部门级数据        店铺级数据
  ```
- **流程**：
  1. **店铺注册与配置**：
     - 店铺类型划分（独立站/平台店/外部独立站）
     - 平台账号绑定
     - 店铺基础信息配置
     - 店铺状态管理
  2. **权限配置**：
     - 层级权限继承
     - 数据访问范围控制
     - 操作权限分配
     - 角色管理
  3. **数据隔离**：
     - 店铺级数据隔离
     - 部门级数据聚合
     - 商户级数据汇总
     - 跨店铺数据访问控制
  4. **业务操作**：
     - 商品管理（单店/批量）
     - 订单管理（单店/聚合）
     - 库存管理（单店/同步）
     - 价格管理（单店/批量）
  5. **报表聚合**：
     - 单店报表
     - 部门聚合报表
     - 商户汇总报表
     - 跨店对比分析
- **决策点**：
  - 店铺类型划分标准
  - 数据权限边界定义
  - 报表聚合规则
  - 跨店操作权限
- **输入**：店铺信息、商户信息、部门信息、用户角色
- **输出**：
  - 店铺管理界面
  - 跨店铺数据报表
  - 权限控制策略
  - 数据隔离配置
- **状态机**：`SHOP_REGISTERED` → `SHOP_CONFIGURED` → `SHOP_ACTIVE` → `SHOP_SUSPENDED` → `SHOP_CLOSED`
- **关键指标**：
  - 店铺数量
  - 活跃店铺数
  - 跨店订单量
  - 数据隔离有效性
  - 报表生成效率
- **数据表**：
  - `cf_shop`：店铺主表（含层级关系）
  - `cf_department`：部门表
  - `cf_merchant`：商户表
  - `cf_shop_config`：店铺配置表
  - `cf_shop_permission`：店铺权限表
- **📋 技术实现指引**：
  | 层级 | 实现模块    | 关键文件                                         | 任务ID                           |
  | -- | ------- | -------------------------------------------- | ------------------------------ |
  | 后端 | 数据隔离服务  | `DataIsolationService.ts`                    | BE-MT001                       |
  | 后端 | 层级权限中间件 | `HierarchyAuthMiddleware.ts`                 | BE-MT002                       |
  | 后端 | 订单聚合服务  | `OrderAggregationService.ts`                 | BE-ORDER-MS001                 |
  | 后端 | 报表聚合服务  | `ShopReportAggregationService.ts`            | BE-SHOP-REP001                 |
  | 前端 | 层级选择器组件 | `HierarchySelector.tsx`                      | FE-MT001                       |
  | 前端 | 多店铺管理页面 | `MerchantManage.tsx, ShopManage.tsx`         | FE-MT002                       |
  | 前端 | 订单多店铺页面 | `OrderMultiShopList.tsx, OrderAggregate.tsx` | FE-ORDER-MS001, FE-ORDER-MS002 |
  | 前端 | 多店铺报表页面 | `MultiShopReport.tsx`                        | FE-SHOP-REP001                 |

***

## 5️⃣8️⃣ 多租户层级管理闭环（Multi-Tenant Hierarchy Loop）🆕

- **目标**：实现商户→部门→店铺三层架构的完整管理，确保数据隔离和权限控制
- **层级模型**：
  ```
  ┌─────────────────────────────────────────────────────────┐
  │                      商户(Merchant)                      │
  │  - 商户ID (merchantId)                                  │
  │  - 商户名称、联系方式、认证状态                           │
  │  - 商户级配置、计费信息                                  │
  └────────────────────┬────────────────────────────────────┘
                       │ 1:N
           ┌───────────┴───────────┐
           ▼                       ▼
  ┌─────────────────┐     ┌─────────────────┐
  │   部门(Department)   │     │   部门(Department)   │
  │  - 部门ID (deptId)    │     │  - 部门ID (deptId)    │
  │  - 部门名称、负责人    │     │  - 部门名称、负责人    │
  └────────┬────────┘     └────────┬────────┘
           │ 1:N                   │ 1:N
           ▼                       ▼
  ┌─────────────────┐     ┌─────────────────┐
  │    店铺(Shop)        │     │    店铺(Shop)        │
  │  - 店铺ID (shopId)   │     │  - 店铺ID (shopId)   │
  │  - 平台、店铺类型     │     │  - 平台、店铺类型     │
  └─────────────────┘     └─────────────────┘
  ```
- **流程**：
  1. **商户入驻**：
     - 商户注册与认证
     - 商户信息完善
     - 商户计费配置
     - 商户权限初始化
  2. **部门创建**：
     - 部门信息录入
     - 部门负责人分配
     - 部门权限配置
     - 部门成员管理
  3. **店铺绑定**：
     - 店铺创建/导入
     - 店铺归属部门
     - 店铺类型配置
     - 店铺权限设置
  4. **层级数据隔离**：
     - 商户级：所有下属数据可见
     - 部门级：本部门及下属店铺数据可见
     - 店铺级：仅本店铺数据可见
  5. **跨层级操作**：
     - 上级可查看下级数据
     - 下级不可查看上级数据
     - 同级数据相互隔离
- **决策点**：
  - 层级深度限制
  - 数据继承规则
  - 权限传递规则
  - 跨层级操作审批
- **输入**：商户信息、部门信息、店铺信息、用户角色
- **输出**：
  - 层级结构管理界面
  - 数据隔离配置
  - 权限分配结果
  - 层级报表
- **状态机**：
  - 商户：`MERCHANT_PENDING` → `MERCHANT_VERIFIED` → `MERCHANT_ACTIVE` → `MERCHANT_SUSPENDED`
  - 部门：`DEPT_CREATED` → `DEPT_ACTIVE` → `DEPT_SUSPENDED`
  - 店铺：`SHOP_REGISTERED` → `SHOP_ACTIVE` → `SHOP_SUSPENDED`
- **关键指标**：
  - 商户数量
  - 部门数量
  - 店铺数量
  - 层级数据隔离有效性
  - 权限配置准确性
- **数据表**：
  - `cf_merchant`：商户主表
  - `cf_department`：部门表（含商户ID、父部门ID）
  - `cf_shop`：店铺表（含商户ID、部门ID）
  - `cf_user_hierarchy`：用户层级关系表
- **📋 技术实现指引**：
  | 层级 | 实现模块    | 关键文件                         | 任务ID     |
  | -- | ------- | ---------------------------- | -------- |
  | 后端 | 层级服务    | `HierarchyService.ts`        | BE-MT001 |
  | 后端 | 层级权限中间件 | `HierarchyAuthMiddleware.ts` | BE-MT002 |
  | 前端 | 层级选择器   | `HierarchySelector.tsx`      | FE-MT001 |
  | 前端 | 层级管理页面  | `HierarchyManage.tsx`        | FE-MT002 |

***

### 📋 业务审核状态机

- **通用审核流程**：`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` 等破坏性操作      |

***

### 📚 相关文档

| 文档                       | 路径                                                                                       | 说明                   |
| ------------------------ | ---------------------------------------------------------------------------------------- | -------------------- |
| **Task Overview**        | [Task\_Overview.md](./Task_Overview.md)                                                  | AI开发任务总览，包含所有任务包和状态  |
| **AI Strategy**          | [../05\_AI/AI\_Strategy.md](../05_AI/AI_Strategy.md)                                     | AI协作策略、节点自动决策体系、规则引擎 |
| **System Architecture**  | [../01\_Architecture/System\_Architecture.md](../01_Architecture/System_Architecture.md) | 系统架构设计               |
| **State Machine**        | [../01\_Architecture/STATE\_MACHINE.md](../01_Architecture/STATE_MACHINE.md)             | 状态机定义                |
| **Backend Design**       | [../02\_Backend/Backend\_Design.md](../02_Backend/Backend_Design.md)                     | 后端设计规范               |
| **Frontend Design**      | [../03\_Frontend/Frontend\_Design.md](../03_Frontend/Frontend_Design.md)                 | 前端设计规范               |
| **Governance Standards** | [./Governance\_Standards.md](./Governance_Standards.md)                                  | 治理与审批标准              |

***