wurenzhi
22308fe042
- 删除无用的文件和错误日志 - 创建统一的 imports 模块集中管理依赖 - 重构组件使用新的 imports 方式 - 修复文档路径大小写问题 - 优化类型定义和接口导出 - 更新依赖版本 - 改进错误处理和API配置 - 统一组件导出方式
131 lines
7.6 KiB
Markdown
131 lines
7.6 KiB
Markdown
# 📌 Crawlful Hub 业务闭环总览
|
||
|
||
> **说明**：本文档为业务闭环总索引，详细内容请查看各子文档。TOC（零售/前端）和 TOB（企业/后端）共享通用模块，特有流程用 `businessType` 标记。
|
||
|
||
## 🧠 系统核心架构
|
||
|
||
### 系统层级
|
||
```
|
||
前端控制台 → 后端服务 → 运营代理 → 平台适配器 → 第三方平台
|
||
↓ ↑
|
||
←-------------- 数据回传 -------------
|
||
```
|
||
|
||
### 核心组件
|
||
- **前端控制台**：操作入口、状态展示、多店铺管理、数据可视化
|
||
- **后端服务**：数据存储、业务逻辑、AI策略、报表系统
|
||
- **系统大脑**：全局决策、信号处理、执行编排
|
||
- **任务依赖引擎**：DAG管理、自动执行、状态管理、失败重试
|
||
- **运营代理**：轻量化守护进程、核心操作、平台适配、监控能力
|
||
- **平台适配器**：模块化设计、操作封装、数据标准化、异常处理
|
||
|
||
> **详细架构设计**：请参考 [系统架构文档](../01_Architecture/01_System.md)
|
||
|
||
---
|
||
|
||
## 📑 业务域目录
|
||
|
||
| 业务域 | 文档 | 包含闭环 |
|
||
|--------|------|---------|
|
||
| 🛍️ 商品域 | [01_Product.md](../loops/01_Product.md) | 数据采集、商品刊登、素材管理、商品主数据、SKU变体、多平台商品管理 |
|
||
| 📦 订单域 | [02_Order.md](../loops/02_Order.md) | 订单履约、售后逆向、订单集中管理、订单拆分合并、异常订单处理、一站式订单履约 |
|
||
| 📢 营销域 | [03_Marketing.md](../loops/03_Marketing.md) | 广告计划与营销、A/B测试与策略优化、全渠道营销整合 |
|
||
| 💰 财务域 | [04_Finance.md](../loops/04_Finance.md) | 资金对账、回款与财务、利润核算、支付与结算 |
|
||
| 📦 库存域 | [05_Inventory.md](../loops/05_Inventory.md) | 库存与仓储管理、海外仓/本土仓 |
|
||
| 🚚 供应链域 | [06_SupplyChain.md](../loops/06_SupplyChain.md) | 供应链与供应商管理、物流策略与渠道选择 |
|
||
| 🏢 TOB贸易域 | [07_TOBTrade.md](../loops/07_TOBTrade.md) | TOB贸易管理 |
|
||
| 👥 商户域 | [08_Merchant.md](../loops/08_Merchant.md) | 多商户入驻、商户店铺、多商户订单、多商户库存、多商户结算、商户权限、商户数据 |
|
||
| ⚙️ 平台基础域 | [09_Platform.md](../loops/09_Platform.md) | 治理与审批、功能模块化、功能开通、用户/客户资产、客户服务、货币管理、运营代理（Agent）、全渠道客户沟通、快速建站与品牌化运营 |
|
||
| 🤖 AI与自动化域 | [10_AI_Automation.md](../loops/10_AI_Automation.md) | AI驱动智能决策、自动选品+上架、AI店铺托管、AI动态定价、跨平台套利、策略市场 |
|
||
| 🛡️ 治理与合规域 | [11_Governance.md](../loops/11_Governance.md) | 合规与证书、合规与风控、异常处理、恶意买家黑名单、高退货率SKU |
|
||
| 📈 增长与商业化域 | [12_Growth.md](../loops/12_Growth.md) | 商业化与增长、增长飞轮、多商户收益排行榜、首页商业化 |
|
||
| 🔧 技术基础设施域 | [13_Technical.md](../loops/13_Technical.md) | 技术基础设施、报表与分析、API文档、系统监控、技术债务、用户教育 |
|
||
| 🌍 跨境电商域 | [14_CrossBorder.md](../loops/14_CrossBorder.md) | 跨境电商、多语言业务 |
|
||
| 🔒 安全与风控域 | [15_Security.md](../loops/15_Security.md) | 安全与风控、用户管理与权限、多租户隔离、多租户层级、账号/店铺健康、店铺隔离 |
|
||
| 📋 其他独立闭环 | [16_Others.md](../loops/16_Others.md) | 定价与利润决策、核心服务优先级、多店铺管理、商家选择发货、客户/商家押金 |
|
||
|
||
---
|
||
|
||
## 🔗 闭环依赖关系
|
||
|
||
### 核心流程
|
||
1. **数据采集与处理**：运营代理 → 数据采集 → 数据清洗 → 套利/利润评估
|
||
2. **商品管理**：商品主数据 → SKU变体与结构 → 商品刊登 ←→ 素材管理
|
||
3. **营销与销售**：定价与利润决策 → 广告/营销（TOC）/ 企业营销（TOB）
|
||
4. **订单履约**：订单履约（OMS） → 订单拆分与合并 → 异常订单处理
|
||
5. **物流与库存**：物流策略与渠道选择 → 库存 & WMS ←→ 供应链 & 补货
|
||
6. **售后与财务**：售后逆向 → 资金对账 → 利润核算
|
||
7. **TOB业务**：TOB 贸易管理 → 用户/客户资产
|
||
8. **优化与治理**：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（大额企业订单、阶梯价审批、信用审批）
|
||
|
||
> **详细状态机定义**：请参考 [状态机文档](../01_Architecture/06_State_Machine.md)
|
||
|
||
---
|
||
|
||
## 💡 说明
|
||
|
||
1. 业务闭环文档是**最高层文档**，不涉及具体前端或模块实现细节。
|
||
2. 下层模块功能、接口、算法、UI 都是这个闭环的落地实现。
|
||
3. 形成从**采集 → 决策 → 执行 → 反馈 → 风控**的完整业务链。
|
||
4. 每个闭环都有明确的输入、输出、流程和决策点，确保业务流程的完整性和可控性。
|
||
5. 各闭环之间通过数据流转和依赖关系形成完整的业务生态系统。
|
||
6. 所有业务操作均需遵循项目特定规则，确保系统安全和数据一致性。
|
||
7. **"闭环写入规则：只要逻辑上能闭环就写，落地方式后置"**
|
||
|
||
---
|
||
|
||
## 📚 相关文档
|
||
|
||
| 文档 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| **Task Overview** | [Task_Overview.md](../tasks/Task_Overview.md) | AI开发任务总览，包含所有任务包和状态 |
|
||
| **AI Strategy** | [../../05_AI/01_Strategy.md](../../05_AI/01_Strategy.md) | AI协作策略、节点自动决策体系、规则引擎 |
|
||
| **System Architecture** | [../../01_Architecture/01_System.md](../../01_Architecture/01_System.md) | 系统架构设计 |
|
||
| **State Machine** | [../../01_Architecture/06_State_Machine.md](../../01_Architecture/06_State_Machine.md) | 状态机定义 |
|
||
| **Backend Design** | [../../02_Backend/01_Design.md](../../02_Backend/01_Design.md) | 后端设计规范 |
|
||
| **Frontend Design** | [../../03_Frontend/01_Design.md](../../03_Frontend/01_Design.md) | 前端设计规范 |
|
||
| **Governance Standards** | [./Governance_Standards.md](./Governance_Standards.md) | 治理与审批标准 |
|
||
|
||
---
|
||
|
||
*最后更新：2026-03-19 | 文档拆分完成*
|