# 📌 Crawlful Hub 业务闭环总览

> **说明**：本文档为业务闭环总索引，详细内容请查看各子文档。TOC（零售/前端）和 TOB（B2B贸易）共享通用模块，特有流程用 `businessType` 标记。

## 🧠 系统核心架构

### 系统层级
```
前端管理面板 → 后端服务 → Operation-Agent → 平台 Adapter → 外部平台
      ↓                                    ↑
      ←---------- 数据回传 -----------------
```

### 核心组件

#### 1. 前端管理面板
- **操作入口**：商品采集、上架/下架、调价、店铺管理
- **状态展示**：实时操作状态、执行日志、截图回传
- **多店铺管理**：统一面板展示，独立操作流程
- **数据可视化**：销售报表、ROI分析、库存监控

#### 2. 后端服务
- **数据存储**：统一接收Operation-Agent回传数据
- **业务逻辑**：服务编排、状态管理、权限控制
- **AI策略**：定价策略、选品推荐、套利分析
- **报表系统**：多维度数据分析、导出功能

#### 3. SystemOrchestrator（系统大脑）
- **全局决策**：资源分配、任务优先级、风险控制
- **信号层**：接收店铺、商品、财务、风控等指标
- **决策层**：多目标优化，生成Action建议
- **执行层**：通过TaskGraph执行决策
- **反馈层**：收集执行结果，优化决策模型

#### 4. TaskGraph（任务依赖引擎）
- **DAG（有向无环图）**：任务依赖关系管理
- **自动执行**：选品 → 定价 → 上架 → 广告 → 监控
- **状态管理**：pending → waiting_approval → ready → running → success/failed
- **失败重试**：异常处理、指数退避

#### 5. Operation-Agent（操作代理）
- **轻量化守护进程**：运行在VPS/客户端
- **核心操作**：采集、上架、调价、数据回传
- **平台适配**：模块化Adapter，支持多平台
- **监控能力**：关键位置截图、状态心跳
- **安全边界**：只执行业务操作，禁止系统级操作

#### 6. 平台Adapter
- **模块化设计**：每个平台独立实现
- **操作封装**：模拟浏览器或调用API
- **数据标准化**：统一输出格式，便于后端处理
- **异常处理**：捕获错误，触发截图回传

---

## 📑 业务域目录

| 业务域 | 文档 | 包含闭环 |
|--------|------|---------|
| 🛍️ 商品域 | [01_Product.md](./Business_ClosedLoops/01_Product.md) | 数据采集、商品刊登、素材管理、商品主数据、SKU变体 |
| 📦 订单域 | [02_Order.md](./Business_ClosedLoops/02_Order.md) | 订单履约、售后逆向、订单集中管理、订单拆分合并、异常订单处理 |
| 📢 营销域 | [03_Marketing.md](./Business_ClosedLoops/03_Marketing.md) | 广告计划与营销、A/B测试与策略优化 |
| 💰 财务域 | [04_Finance.md](./Business_ClosedLoops/04_Finance.md) | 资金对账、回款与财务、利润核算、支付与结算 |
| 📦 库存域 | [05_Inventory.md](./Business_ClosedLoops/05_Inventory.md) | 库存与仓储管理、海外仓/本土仓 |
| 🚚 供应链域 | [06_SupplyChain.md](./Business_ClosedLoops/06_SupplyChain.md) | 供应链与供应商管理、物流策略与渠道选择 |
| 🏢 B2B贸易域 | [07_B2BTrade.md](./Business_ClosedLoops/07_B2BTrade.md) | B2B/TOB贸易管理 |
| 👥 商户域 | [08_Merchant.md](./Business_ClosedLoops/08_Merchant.md) | 多商户入驻、商户店铺、多商户订单、多商户库存、多商户结算、商户权限、商户数据 |
| ⚙️ 平台基础域 | [09_Platform.md](./Business_ClosedLoops/09_Platform.md) | 治理与审批、功能模块化、功能开通、用户/客户资产、客户服务、货币管理、Operation-Agent |
| 🤖 AI与自动化域 | [10_AI_Automation.md](./Business_ClosedLoops/10_AI_Automation.md) | AI驱动智能决策、自动选品+上架、AI店铺托管、AI动态定价、跨平台套利、策略市场 |
| 🛡️ 治理与合规域 | [11_Governance.md](./Business_ClosedLoops/11_Governance.md) | 合规与证书、合规与风控、异常处理、恶意买家黑名单、高退货率SKU |
| 📈 增长与商业化域 | [12_Growth.md](./Business_ClosedLoops/12_Growth.md) | 商业化与增长、增长飞轮、多商户收益排行榜、首页商业化 |
| 🔧 技术基础设施域 | [13_Technical.md](./Business_ClosedLoops/13_Technical.md) | 技术基础设施、报表与分析、API文档、系统监控、技术债务、用户教育 |
| 🌍 跨境电商域 | [14_CrossBorder.md](./Business_ClosedLoops/14_CrossBorder.md) | 跨境电商、多语言业务 |
| 🔒 安全与风控域 | [15_Security.md](./Business_ClosedLoops/15_Security.md) | 安全与风控、用户管理与权限、多租户隔离、多租户层级、账号/店铺健康、店铺隔离 |
| 📋 其他独立闭环 | [16_Others.md](./Business_ClosedLoops/16_Others.md) | 定价与利润决策、核心服务优先级、多店铺管理、商家选择发货、客户/商家押金 |

---

## 🔗 闭环依赖关系

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

---

## 📊 关键绩效指标（KPI）汇总

各业务闭环的详细KPI请查看对应子文档，以下是核心指标概览：

| 指标类别 | 核心指标 | 目标值 |
|---------|---------|--------|
| **商品** | 刊登成功率、数据准确率 | > 95% |
| **订单** | 订单处理时效、发货准确率 | < 24h, > 98% |
| **财务** | 对账准确率、结算时效 | > 99%, < 24h |
| **库存** | 库存准确率、库存周转率 | > 99%, 优化中 |
| **风控** | 风险识别准确率、风控处理时效 | > 90%, < 1h |
| **AI决策** | AI建议采纳率、自动执行比例 | > 80%, > 60% |

---

## 🔍 追踪与审计

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

---

## 📋 业务审核状态机

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

---

## 💡 说明

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

---

## 📚 相关文档

| 文档 | 路径 | 说明 |
|------|------|------|
| **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) | 治理与审批标准 |

---

*最后更新：2026-03-19 | 文档拆分完成*
