Files
makemd/docs/00_Business/Business_ClosedLoops.md
wurenzhi 48a78137c5 refactor(terminology): 统一术语标准并优化代码类型安全
- 将B2B统一为TOB术语
- 将状态值统一为大写格式
- 优化类型声明,避免使用any
- 将float类型替换为decimal以提高精度
- 新增术语标准化文档
- 优化路由结构和菜单分类
- 添加TypeORM实体类
- 增强加密模块安全性
- 重构前端路由结构
- 完善任务模板和验收标准
2026-03-20 09:43:50 +08:00

8.2 KiB
Raw Blame History

📌 Crawlful Hub 业务闭环总览

说明本文档为业务闭环总索引详细内容请查看各子文档。TOC零售/前端)和 TOB企业/后端)共享通用模块,特有流程用 businessType 标记。

🧠 系统核心架构

系统层级

前端控制台 → 后端服务 → 运营代理 → 平台适配器 → 第三方平台
           ↓                                   ↑
           ←-------------- 数据回传 -------------

核心组件

  • 前端控制台:操作入口、状态展示、多店铺管理、数据可视化
  • 后端服务数据存储、业务逻辑、AI策略、报表系统
  • 系统大脑:全局决策、信号处理、执行编排
  • 任务依赖引擎DAG管理、自动执行、状态管理、失败重试
  • 运营代理:轻量化守护进程、核心操作、平台适配、监控能力
  • 平台适配器:模块化设计、操作封装、数据标准化、异常处理

详细架构设计:请参考 系统架构文档


📑 业务域目录

业务域 文档 包含闭环
🛍️ 商品域 01_Product.md 数据采集、商品刊登、素材管理、商品主数据、SKU变体、多平台商品管理
📦 订单域 02_Order.md 订单履约、售后逆向、订单集中管理、订单拆分合并、异常订单处理、一站式订单履约
📢 营销域 03_Marketing.md 广告计划与营销、A/B测试与策略优化、全渠道营销整合
💰 财务域 04_Finance.md 资金对账、回款与财务、利润核算、支付与结算
📦 库存域 05_Inventory.md 库存与仓储管理、海外仓/本土仓
🚚 供应链域 06_SupplyChain.md 供应链与供应商管理、物流策略与渠道选择
🏢 TOB贸易域 07_TOBTrade.md TOB贸易管理
👥 商户域 08_Merchant.md 多商户入驻、商户店铺、多商户订单、多商户库存、多商户结算、商户权限、商户数据
⚙️ 平台基础域 09_Platform.md 治理与审批、功能模块化、功能开通、用户/客户资产、客户服务、货币管理、运营代理Agent、全渠道客户沟通、快速建站与品牌化运营
🤖 AI与自动化域 10_AI_Automation.md AI驱动智能决策、自动选品+上架、AI店铺托管、AI动态定价、跨平台套利、策略市场
🛡️ 治理与合规域 11_Governance.md 合规与证书、合规与风控、异常处理、恶意买家黑名单、高退货率SKU
📈 增长与商业化域 12_Growth.md 商业化与增长、增长飞轮、多商户收益排行榜、首页商业化
🔧 技术基础设施域 13_Technical.md 技术基础设施、报表与分析、API文档、系统监控、技术债务、用户教育
🌍 跨境电商域 14_CrossBorder.md 跨境电商、多语言业务
🔒 安全与风控域 15_Security.md 安全与风控、用户管理与权限、多租户隔离、多租户层级、账号/店铺健康、店铺隔离
📋 其他独立闭环 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
  • 审计要求
    • 每一笔操作必须绑定 traceIdbusinessType
    • 所有功能需通过 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 AI开发任务总览包含所有任务包和状态
AI Strategy ../05_AI/01_Strategy.md AI协作策略、节点自动决策体系、规则引擎
System Architecture ../01_Architecture/01_System.md 系统架构设计
State Machine ../01_Architecture/06_State_Machine.md 状态机定义
Backend Design ../02_Backend/01_Design.md 后端设计规范
Frontend Design ../03_Frontend/01_Design.md 前端设计规范
Governance Standards ./Governance_Standards.md 治理与审批标准

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