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

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

## 📑 目录

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)
41. [统一闭环依赖](#🔹-统一闭环依赖toc--tob)
42. [闭环依赖关系](#🔗-闭环依赖关系toc--tob)
43. [关键绩效指标](#📊-关键绩效指标kpi)
44. [追踪与审计](#🔍-追踪与审计)
45. [业务审核状态机](#📋-业务审核状态机)
46. [说明](#💡-说明)

***

## 附录A：前端交互设计规范

> **说明**：本附录补充前端交互设计规范，定义全局状态机、页面路由、按钮操作等交互标准，确保前端实现与业务闭环一致。

### A.1 全局状态机定义

#### 商品状态机（Product State Machine）

| 状态 | 含义 | 可操作按钮 | 状态颜色 |
|------|------|-----------|---------|
| **DRAFT** | 草稿 | 编辑、定价、删除 | 灰色 |
| **PRICED** | 已定价 | 查看、定价、上架 | 蓝色 |
| **LISTED** | 已上架 | 查看、下架、同步 | 绿色 |
| **SYNCING** | 同步中 | 查看（其他禁用） | 黄色 |
| **LIVE** | 已在线 | 查看、下架、同步 | 绿色 |
| **SYNC_FAILED** | 同步失败 | 查看、重试同步 | 红色 |
| **OFFLINE** | 已下架 | 查看、重新上架 | 灰色 |

**状态流转图**：
```
DRAFT → PRICED → LISTED → SYNCING → LIVE → OFFLINE
  ↓       ↓        ↓          ↑
删除    定价     上架      重试同步
              ↓ SYNC_FAILED ↑
```

**状态流转规则**：
- DRAFT → PRICED：完成定价后自动转换
- PRICED → LISTED：点击上架按钮后转换
- LISTED → SYNCING：点击同步按钮后转换
- SYNCING → LIVE：同步成功后自动转换
- SYNCING → SYNC_FAILED：同步失败后转换
- LISTED/LIVE → OFFLINE：点击下架按钮后转换
- OFFLINE → LISTED：点击重新上架后转换

#### 任务状态机（Task State Machine）

| 状态 | 含义 | 可操作按钮 | 状态颜色 |
|------|------|-----------|---------|
| **PENDING** | 待执行 | 取消 | 灰色 |
| **RUNNING** | 执行中 | 查看日志 | 蓝色 |
| **SUCCESS** | 执行成功 | 查看结果 | 绿色 |
| **FAILED** | 执行失败 | 重试、查看日志 | 红色 |

**状态流转图**：
```
PENDING → RUNNING → SUCCESS
    ↓         ↓
  取消      FAILED → 重试 → RUNNING
```

#### 订单状态机（Order State Machine）

| 状态 | 含义 | 可操作按钮 | 适用场景 |
|------|------|-----------|---------|
| **PENDING** | 待处理 | 确认、取消 | 新订单 |
| **CONFIRMED** | 已确认 | 发货、取消 | 确认后 |
| **SHIPPED** | 已发货 | 查看物流 | 发货后 |
| **DELIVERED** | 已送达 | 完成、售后 | 送达后 |
| **COMPLETED** | 已完成 | 查看详情 | 完成后 |
| **CANCELLED** | 已取消 | 查看详情 | 取消后 |
| **REFUNDING** | 退款中 | 查看进度 | 售后中 |
| **REFUNDED** | 已退款 | 查看详情 | 退款完成 |

### A.2 页面路由结构

#### 全局路由定义

```typescript
// 路由配置
const routes = [
  // 工作台
  { path: '/dashboard', component: 'Dashboard' },
  
  // 商品中心
  { path: '/products', component: 'ProductLayout', routes: [
    { path: '/products/list', component: 'ProductList' },
    { path: '/products/detail/:id', component: 'ProductDetail' },
    { path: '/products/create', component: 'ProductCreate' },
    { path: '/products/edit/:id', component: 'ProductEdit' },
  ]},
  
  // 订单中心
  { path: '/orders', component: 'OrderLayout', routes: [
    { path: '/orders/list', component: 'OrderList' },
    { path: '/orders/detail/:id', component: 'OrderDetail' },
    { path: '/orders/exception', component: 'ExceptionOrder' },
  ]},
  
  // 执行中心
  { path: '/tasks', component: 'TaskLayout', routes: [
    { path: '/tasks/list', component: 'TaskList' },
    { path: '/tasks/detail/:id', component: 'TaskDetail' },
    { path: '/tasks/logs', component: 'TaskLogs' },
  ]},
  
  // 数据中心
  { path: '/analytics', component: 'AnalyticsLayout', routes: [
    { path: '/analytics/overview', component: 'AnalyticsOverview' },
    { path: '/analytics/products', component: 'ProductAnalytics' },
    { path: '/analytics/orders', component: 'OrderAnalytics' },
    { path: '/analytics/profit', component: 'ProfitAnalytics' },
  ]},
  
  // 合规中心
  { path: '/compliance', component: 'ComplianceLayout', routes: [
    { path: '/compliance/certificates', component: 'CertificateManage' },
    { path: '/compliance/check', component: 'ComplianceCheck' },
    { path: '/compliance/risk', component: 'RiskMonitor' },
  ]},
  
  // 系统设置
  { path: '/settings', component: 'SettingsLayout', routes: [
    { path: '/settings/platform', component: 'PlatformSettings' },
    { path: '/settings/currency', component: 'CurrencySettings' },
    { path: '/settings/cost-template', component: 'CostTemplateSettings' },
    { path: '/settings/win-node', component: 'WinNodeSettings' },
  ]},
];
```

#### 路由权限控制

| 路由 | 所需权限 | 角色 |
|------|---------|------|
| /products/* | product:read | ADMIN, MANAGER, OPERATOR |
| /products/create | product:create | ADMIN, MANAGER |
| /products/edit/* | product:update | ADMIN, MANAGER |
| /orders/* | order:read | ADMIN, MANAGER, OPERATOR |
| /orders/exception | order:exception | ADMIN, MANAGER |
| /tasks/* | task:read | ADMIN, MANAGER, OPERATOR |
| /analytics/* | analytics:read | ADMIN, MANAGER, ANALYST |
| /compliance/* | compliance:read | ADMIN, MANAGER |
| /settings/* | settings:read | ADMIN |

### A.3 按钮操作规范

#### 商品列表页操作按钮

| 按钮 | 显示条件 | 点击行为 | 状态变更 | 权限要求 |
|------|---------|---------|---------|---------|
| **新增商品** | 始终显示 | 打开创建弹窗 | 创建新商品(DRAFT) | product:create |
| **编辑** | 状态=DRAFT | 打开编辑弹窗 | 更新商品信息 | product:update |
| **定价** | 状态=DRAFT/PRICED | 打开定价抽屉 | 状态→PRICED | product:update |
| **上架** | 状态=PRICED | 确认弹窗→上架 | 状态→LISTED | product:update |
| **同步** | 状态=LISTED/LIVE | 触发同步任务 | 状态→SYNCING | product:sync |
| **下架** | 状态=LISTED/LIVE | 确认弹窗→下架 | 状态→OFFLINE | product:update |
| **重试同步** | 状态=SYNC_FAILED | 重新触发同步 | 状态→SYNCING | product:sync |
| **重新上架** | 状态=OFFLINE | 确认弹窗→上架 | 状态→LISTED | product:update |
| **删除** | 状态=DRAFT | 确认弹窗→删除 | 删除商品 | product:delete |

#### 订单列表页操作按钮

| 按钮 | 显示条件 | 点击行为 | 状态变更 | 权限要求 |
|------|---------|---------|---------|---------|
| **确认订单** | 状态=PENDING | 确认弹窗→确认 | 状态→CONFIRMED | order:confirm |
| **发货** | 状态=CONFIRMED | 打开发货弹窗 | 状态→SHIPPED | order:ship |
| **查看物流** | 状态=SHIPPED | 打开物流追踪 | - | order:read |
| **完成订单** | 状态=DELIVERED | 确认弹窗→完成 | 状态→COMPLETED | order:complete |
| **取消订单** | 状态=PENDING/CONFIRMED | 确认弹窗→取消 | 状态→CANCELLED | order:cancel |
| **售后处理** | 状态=COMPLETED/DELIVERED | 打开售后弹窗 | 状态→REFUNDING | order:refund |

#### 任务列表页操作按钮

| 按钮 | 显示条件 | 点击行为 | 状态变更 | 权限要求 |
|------|---------|---------|---------|---------|
| **重试** | 状态=FAILED | 重新执行任务 | 状态→PENDING | task:retry |
| **取消** | 状态=PENDING | 取消任务 | 任务取消 | task:cancel |
| **查看日志** | 始终显示 | 打开日志详情 | - | task:read |
| **查看结果** | 状态=SUCCESS | 打开结果详情 | - | task:read |

### A.4 用户操作流程

#### 商品上架完整流程

```
Step 1: 进入商品列表页
  → 查看现有商品列表
  → 使用筛选条件查找商品

Step 2: 新增/编辑商品
  → 点击【新增商品】或【编辑】
  → 填写商品基础信息（标题、SKU、图片等）
  → 填写供应信息（供应商、成本等）
  → 保存后状态=DRAFT

Step 3: 商品定价
  → 点击【定价】按钮
  → 输入成本信息（进货价、运费、汇率）
  → 系统自动计算建议售价、利润、ROI
  → 确认后状态=PRICED

Step 4: 商品上架
  → 点击【上架】按钮
  → 确认上架信息
  → 状态变为LISTED

Step 5: 同步到平台
  → 点击【同步】按钮
  → 创建同步任务
  → 状态变为SYNCING
  → 同步成功后状态=LIVE

Step 6: 监控与调整
  → 查看同步记录
  → 如需调整，点击【定价】或【下架】
```

#### 订单处理完整流程

```
Step 1: 订单获取
  → 系统自动从平台拉取订单
  → 订单状态=PENDING

Step 2: 订单确认
  → 查看订单详情
  → 检查库存和地址
  → 点击【确认订单】
  → 状态=CONFIRMED

Step 3: 订单发货
  → 点击【发货】按钮
  → 选择物流方式
  → 填写物流单号
  → 状态=SHIPPED

Step 4: 物流追踪
  → 点击【查看物流】
  → 实时追踪物流状态

Step 5: 订单完成
  → 客户签收后
  → 状态=DELIVERED
  → 点击【完成订单】
  → 状态=COMPLETED
```

#### 售后处理完整流程

```
Step 1: 接收售后申请
  → 客户提交退货/退款申请
  → 创建售后工单

Step 2: 审核售后申请
  → 查看订单信息和售后原因
  → 判断是否同意售后

Step 3: 处理退货
  → 客户寄回商品
  → 确认收货并检查商品

Step 4: 处理退款
  → 确认退款金额
  → 执行退款操作
  → 状态=REFUNDED

Step 5: 库存调整
  → 退货商品重新入库
  → 更新库存数量
```

## 附录B：前端页面映射

> **说明**：本附录定义各业务闭环对应的前端页面结构，为前端开发提供明确的页面组织指导。

### B.1 商品中心页面映射

对应闭环：**数据采集与清洗闭环**、**商品刊登闭环**、**定价与利润决策闭环**

#### 商品列表页 (/products/list)

**页面目标**：商品管理的核心入口，支持商品的增删改查和批量操作

**页面结构**：
```
ProductListPage
├─ PageHeader (页面标题)
│   └─ 标题：商品管理
│   └─ 副标题：管理您的所有商品
├─ FilterBar (筛选区)
│   ├─ 关键词搜索 (输入框)
│   ├─ 状态筛选 (下拉选择：全部/草稿/已定价/已上架/已在线/已下架)
│   ├─ 平台筛选 (下拉选择：Amazon/eBay/Shopee/TikTok/全部)
│   ├─ ROI区间 (范围选择器)
│   └─ 重置筛选 (按钮)
├─ ActionBar (操作区)
│   ├─ 新增商品 (主按钮)
│   ├─ 批量导入 (按钮)
│   └─ 采集导入 (按钮)
├─ ProductTable (商品表格)
│   ├─ 选择列 (复选框)
│   ├─ 商品信息列 (图片+标题+SKU)
│   ├─ 成本列 (进货价+运费)
│   ├─ 售价列 (建议售价+实际售价)
│   ├─ ROI列 (ROI百分比+利润)
│   ├─ 状态列 (状态标签)
│   ├─ 平台状态列 (各平台状态图标)
│   └─ 操作列 (按钮组)
└─ BatchActionBar (批量操作栏，选中后显示)
    ├─ 已选中X项 (文本)
    ├─ 批量定价 (按钮)
    ├─ 批量上架 (按钮)
    ├─ 批量同步 (按钮)
    └─ 批量删除 (按钮)
```

**数据字段**：
| 字段 | 类型 | 说明 | 来源 |
|------|------|------|------|
| id | string | 商品ID | cf_product.id |
| title | string | 商品标题 | cf_product.title |
| sku | string | SKU编码 | cf_product.sku |
| image | string | 主图URL | cf_product.images[0] |
| cost_price | decimal | 成本价 | cf_product.cost_price |
| shipping_cost | decimal | 运费 | cf_product.shipping_cost |
| sale_price | decimal | 售价 | cf_product.sale_price |
| profit | decimal | 利润 | 计算字段 |
| roi | decimal | ROI | 计算字段 |
| status | enum | 状态 | cf_product.status |
| platform_status | json | 各平台状态 | cf_product.platform_status |

#### 商品详情页 (/products/detail/:id)

**页面目标**：展示商品全生命周期信息，支持商品信息查看和编辑

**页面结构**：
```
ProductDetailPage
├─ PageHeader
│   ├─ 返回按钮
│   ├─ 商品标题
│   └─ 操作按钮组 (编辑、上架/下架、同步)
├─ Tabs (标签页)
│   ├─ Tab: 概览
│   │   ├─ 基础信息卡片
│   │   │   ├─ 商品图片 (轮播)
│   │   │   ├─ 商品标题
│   │   │   ├─ SKU信息
│   │   │   ├─ 商品描述
│   │   │   └─ 供应信息
│   │   ├─ 定价信息卡片
│   │   │   ├─ 成本结构 (进货价、运费、其他成本)
│   │   │   ├─ 售价信息 (建议售价、实际售价)
│   │   │   ├─ 利润分析 (利润额、利润率、ROI)
│   │   │   └─ 定价策略 (保守/激进)
│   │   └─ 快捷操作卡片
│   │       ├─ 定价按钮
│   │       ├─ 上架/下架按钮
│   │       └─ 同步按钮
│   ├─ Tab: 平台状态
│   │   ├─ 平台列表
│   │   │   ├─ 平台名称
│   │   │   ├─ 平台商品ID
│   │   │   ├─ 平台状态
│   │   │   ├─ 平台售价
│   │   │   └─ 同步时间
│   │   └─ 同步操作按钮
│   └─ Tab: 同步记录
│       ├─ 同步历史表格
│       │   ├─ 同步时间
│       │   ├─ 平台
│       │   ├─ 操作类型
│       │   ├─ 状态
│       │   ├─ 日志摘要
│       │   └─ 查看详情
│       └─ 分页器
```

#### 商品编辑弹窗 (ProductEditModal)

**页面目标**：创建或编辑商品基础信息

**页面结构**：
```
ProductEditModal
├─ ModalHeader
│   ├─ 标题：新增商品/编辑商品
│   └─ 关闭按钮
├─ Form (表单)
│   ├─ 基本信息
│   │   ├─ 商品标题 (输入框，必填)
│   │   ├─ SKU编码 (输入框，必填)
│   │   ├─ 商品图片 (上传组件)
│   │   └─ 商品描述 (富文本编辑器)
│   ├─ 供应信息
│   │   ├─ 供应商 (选择器)
│   │   ├─ 进货价 (数字输入，必填)
│   │   ├─ 运费 (数字输入)
│   │   └─ 其他成本 (数字输入)
│   └─ 平台信息
│       ├─ 目标平台 (多选)
│       └─ 平台特定字段 (动态)
├─ ModalFooter
│   ├─ 取消按钮
│   └─ 保存按钮
```

#### 定价抽屉 (PricingDrawer)

**页面目标**：为商品设置价格和查看利润分析

**页面结构**：
```
PricingDrawer
├─ DrawerHeader
│   ├─ 标题：商品定价
│   └─ 关闭按钮
├─ DrawerContent
│   ├─ 成本输入区
│   │   ├─ 进货价 (数字输入)
│   │   ├─ 运费 (数字输入)
│   │   ├─ 汇率 (数字输入，可自动获取)
│   │   └─ 其他成本 (数字输入)
│   ├─ 实时计算区
│   │   ├─ 总成本 (自动计算)
│   │   ├─ 建议售价 (自动计算)
│   │   ├─ 预计利润 (自动计算)
│   │   ├─ 利润率 (自动计算)
│   │   └─ ROI (自动计算)
│   ├─ 策略选择区
│   │   ├─ 定价策略 (单选：保守/均衡/激进)
│   │   └─ 策略说明 (文本)
│   └─ 售价调整区
│       ├─ 实际售价 (数字输入，默认建议售价)
│       └─ 调整后的利润预览
└─ DrawerFooter
    ├─ 取消按钮
    └─ 保存定价按钮
```

### B.2 订单中心页面映射

对应闭环：**订单履约闭环**、**订单集中管理闭环**、**售后逆向闭环**

#### 订单列表页 (/orders/list)

**页面目标**：订单管理的核心入口，支持订单的查看、确认、发货等操作

**页面结构**：
```
OrderListPage
├─ PageHeader
│   ├─ 标题：订单管理
│   └─ 副标题：管理所有平台订单
├─ FilterBar
│   ├─ 订单号搜索
│   ├─ 平台筛选
│   ├─ 状态筛选
│   ├─ 时间范围
│   └─ 金额范围
├─ OrderTable
│   ├─ 订单号
│   ├─ 平台
│   ├─ 商品信息
│   ├─ 买家信息
│   ├─ 金额
│   ├─ 状态
│   ├─ 下单时间
│   └─ 操作列
└─ Pagination
```

#### 订单详情页 (/orders/detail/:id)

**页面目标**：展示订单完整信息和处理历史

**页面结构**：
```
OrderDetailPage
├─ PageHeader
│   ├─ 返回按钮
│   ├─ 订单号
│   └─ 状态标签
├─ OrderInfo
│   ├─ 买家信息
│   ├─ 收货地址
│   ├─ 商品列表
│   ├─ 金额明细
│   └─ 操作按钮组
├─ Timeline
│   └─ 订单处理时间线
└─ ActionLog
    └─ 操作日志列表
```

### B.3 执行中心页面映射

对应闭环：**服务编排与执行闭环**

#### 任务列表页 (/tasks/list)

**页面目标**：查看和管理所有执行任务

**页面结构**：
```
TaskListPage
├─ PageHeader
│   ├─ 标题：执行中心
│   └─ 副标题：管理所有自动化任务
├─ FilterBar
│   ├─ 任务类型筛选
│   ├─ 状态筛选
│   ├─ 平台筛选
│   └─ 时间范围
├─ TaskTable
│   ├─ 任务ID
│   ├─ 任务类型
│   ├─ 关联商品/订单
│   ├─ 平台
│   ├─ 状态
│   ├─ 创建时间
│   ├─ 完成时间
│   └─ 操作列
└─ Pagination
```

#### 任务详情页 (/tasks/detail/:id)

**页面目标**：查看任务执行详情和日志

**页面结构**：
```
TaskDetailPage
├─ PageHeader
│   ├─ 返回按钮
│   ├─ 任务ID
│   └─ 状态标签
├─ TaskInfo
│   ├─ 任务类型
│   ├─ 关联对象
│   ├─ 平台
│   ├─ 创建时间
│   ├─ 开始时间
│   ├─ 完成时间
│   └─ 执行时长
├─ ExecutionLog
│   └─ 执行日志 (代码块展示)
└─ ResultInfo
    └─ 执行结果 (成功/失败详情)
```

### B.4 数据中心页面映射

对应闭环：**报表与分析闭环**

#### 数据概览页 (/analytics/overview)

**页面目标**：展示核心业务指标和数据趋势

**页面结构**：
```
AnalyticsOverviewPage
├─ PageHeader
│   ├─ 标题：数据中心
│   └─ 时间范围选择器
├─ KPI Cards
│   ├─ 总销售额
│   ├─ 总利润
│   ├─ 平均ROI
│   ├─ 订单数量
│   └─ 商品数量
├─ Charts
│   ├─ 销售趋势图
│   ├─ 利润趋势图
│   └─ 平台分布图
└─ TopLists
    ├─ 热销商品TOP10
    └─ 高利润商品TOP10
```

### B.5 合规中心页面映射

对应闭环：**合规与证书管理闭环**、**合规与风控闭环**

#### 证书管理页 (/compliance/certificates)

**页面目标**：管理商品合规证书

**页面结构**：
```
CertificateManagePage
├─ PageHeader
│   ├─ 标题：证书管理
│   └─ 上传证书按钮
├─ FilterBar
│   ├─ 证书类型筛选
│   ├─ 状态筛选
│   └─ 到期时间筛选
├─ CertificateTable
│   ├─ 证书名称
│   ├─ 证书类型
│   ├─ 关联商品
│   ├─ 有效期
│   ├─ 状态
│   └─ 操作列
└─ Pagination
```

### B.6 系统设置页面映射

#### 平台账号设置页 (/settings/platform)

**页面目标**：管理各电商平台账号

**页面结构**：
```
PlatformSettingsPage
├─ PageHeader
│   ├─ 标题：平台账号设置
│   └─ 添加账号按钮
├─ PlatformList
│   └─ 平台卡片列表
│       ├─ 平台Logo
│       ├─ 平台名称
│       ├─ 账号状态
│       ├─ 店铺数量
│       └─ 操作按钮
```

## 附录C：前端组件规范

> **说明**：本附录定义前端组件的设计规范，包括组件分类、命名规范、状态管理和API交互规范。

### C.1 组件分类与命名

#### 组件分类

| 分类 | 说明 | 示例 | 存放路径 |
|------|------|------|---------|
| **页面组件** | 完整页面 | ProductList, OrderDetail | src/pages/ |
| **布局组件** | 页面布局 | PageHeader, Sidebar | src/layouts/ |
| **业务组件** | 业务相关 | ProductTable, OrderForm | src/components/business/ |
| **通用组件** | 通用UI | StatusTag, ConfirmModal | src/components/common/ |
| **图表组件** | 数据可视化 | SalesChart, ProfitChart | src/components/charts/ |

#### 命名规范

| 类型 | 命名规则 | 示例 |
|------|---------|------|
| **组件文件** | PascalCase | ProductList.tsx |
| **组件名** | PascalCase | ProductList |
| **Props类型** | 组件名+Props | ProductListProps |
| **State类型** | 组件名+State | ProductListState |
| **样式文件** | 组件名.module.less | ProductList.module.less |
| **Hook** | use+功能 | useProductList |

### C.2 状态管理规范

#### 全局状态

```typescript
// src/models/product.ts
export interface ProductState {
  list: Product[];
  detail: Product | null;
  loading: boolean;
  pagination: {
    current: number;
    pageSize: number;
    total: number;
  };
  filters: ProductFilters;
}

export default {
  namespace: 'product',
  state: {
    list: [],
    detail: null,
    loading: false,
    pagination: { current: 1, pageSize: 20, total: 0 },
    filters: {},
  },
  effects: {
    *fetchList({ payload }, { call, put }) {
      yield put({ type: 'setLoading', payload: true });
      const response = yield call(getProductList, payload);
      yield put({ type: 'setList', payload: response.data });
      yield put({ type: 'setPagination', payload: response.pagination });
      yield put({ type: 'setLoading', payload: false });
    },
  },
  reducers: {
    setList(state, { payload }) {
      return { ...state, list: payload };
    },
    setLoading(state, { payload }) {
      return { ...state, loading: payload };
    },
  },
};
```

#### 页面级状态

```typescript
// src/pages/products/list/index.tsx
const ProductListPage: React.FC = () => {
  // 页面级状态
  const [selectedRows, setSelectedRows] = useState<Product[]>([]);
  const [modalVisible, setModalVisible] = useState(false);
  const [drawerVisible, setDrawerVisible] = useState(false);
  const [currentProduct, setCurrentProduct] = useState<Product | null>(null);
  
  // 全局状态
  const { list, loading, pagination } = useSelector((state: RootState) => state.product);
  const dispatch = useDispatch();
  
  // ...
};
```

### C.3 API交互规范

#### 请求封装

```typescript
// src/services/product.ts
import request from '@/utils/request';

export async function getProductList(params: ProductListParams) {
  return request('/api/products', {
    method: 'GET',
    params,
  });
}

export async function getProductDetail(id: string) {
  return request(`/api/products/${id}`, {
    method: 'GET',
  });
}

export async function createProduct(data: CreateProductData) {
  return request('/api/products', {
    method: 'POST',
    data,
  });
}

export async function updateProduct(id: string, data: UpdateProductData) {
  return request(`/api/products/${id}`, {
    method: 'PUT',
    data,
  });
}

export async function deleteProduct(id: string) {
  return request(`/api/products/${id}`, {
    method: 'DELETE',
  });
}

export async function updateProductPrice(id: string, data: PricingData) {
  return request(`/api/products/${id}/price`, {
    method: 'POST',
    data,
  });
}

export async function syncProductToPlatform(id: string, platform: string) {
  return request(`/api/products/${id}/sync`, {
    method: 'POST',
    data: { platform },
  });
}
```

#### 错误处理

```typescript
// src/utils/request.ts
import { notification } from 'antd';

const request = extend({
  errorHandler: (error: ResponseError) => {
    const { response, data } = error;
    
    if (response && response.status) {
      const errorText = data?.message || codeMessage[response.status];
      
      notification.error({
        message: `请求错误 ${response.status}`,
        description: errorText,
      });
      
      // 401 未授权，跳转到登录页
      if (response.status === 401) {
        window.location.href = '/login';
      }
    }
    
    throw error;
  },
});
```

### C.4 路由与权限规范

#### 路由配置

```typescript
// config/routes.ts
export default [
  {
    path: '/',
    component: '@/layouts/BasicLayout',
    routes: [
      { path: '/', redirect: '/dashboard' },
      {
        path: '/dashboard',
        name: '工作台',
        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. 本附录内容基于参考文档的前端交互设计规范，与现有50个业务闭环保持一致
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技术提升运营效率和决策准确性，实现智能化运营。
- **流程**：
  1. **数据采集与处理**：
     - 多源数据整合
     - 数据清洗与预处理
     - 特征工程与选择
  2. **AI模型训练与部署**：
     - 模型选择与训练
     - 模型评估与优化
     - 模型部署与监控
  3. **智能决策应用**：
     - 智能定价与动态调价
     - 智能库存预测与补货
     - 智能广告投放与优化
     - 智能客户服务与售后
     - 智能风控与异常检测
  4. **决策执行与反馈**：
     - 决策执行与监控
     - 效果评估与分析
     - 模型迭代与优化
- **决策点**：
  - 模型选择（监督学习vs无监督学习）
  - 预测结果置信度阈值
  - 人工干预时机
  - 模型更新频率
- **输入**：业务数据、市场数据、用户行为数据
- **输出**：智能决策建议、预测结果、优化方案
- **状态机**：`DATA_COLLECTION` → `MODEL_TRAINING` → `DECISION_MAKING` → `EXECUTION` → `FEEDBACK`

***

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

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

***

### 📋 业务审核状态机

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

***