wurenzhi/makemd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
eafa1bbe94c2c3d68e79fb360470f7209e8d2c43
makemd/docs/00_Business/Business_ClosedLoops.md
wurenzhi eafa1bbe94 feat: 添加货币和汇率管理功能 
refactor: 重构前端路由和登录逻辑

docs: 更新业务闭环、任务和架构文档

style: 调整代码格式和文件结构

chore: 更新依赖项和配置文件
2026-03-19 19:08:15 +08:00

9.0 KiB
Raw Blame History

📌 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 数据采集、商品刊登、素材管理、商品主数据、SKU变体
📦 订单域 02_Order.md 订单履约、售后逆向、订单集中管理、订单拆分合并、异常订单处理
📢 营销域 03_Marketing.md 广告计划与营销、A/B测试与策略优化
💰 财务域 04_Finance.md 资金对账、回款与财务、利润核算、支付与结算
📦 库存域 05_Inventory.md 库存与仓储管理、海外仓/本土仓
🚚 供应链域 06_SupplyChain.md 供应链与供应商管理、物流策略与渠道选择
🏢 B2B贸易域 07_B2BTrade.md B2B/TOB贸易管理
👥 商户域 08_Merchant.md 多商户入驻、商户店铺、多商户订单、多商户库存、多商户结算、商户权限、商户数据
⚙️ 平台基础域 09_Platform.md 治理与审批、功能模块化、功能开通、用户/客户资产、客户服务、货币管理、Operation-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 定价与利润决策、核心服务优先级、多店铺管理、商家选择发货、客户/商家押金

🔗 闭环依赖关系

[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 AI开发任务总览，包含所有任务包和状态
AI Strategy ../05_AI/AI_Strategy.md AI协作策略、节点自动决策体系、规则引擎
System Architecture ../01_Architecture/System_Architecture.md 系统架构设计
State Machine ../01_Architecture/STATE_MACHINE.md 状态机定义
Backend Design ../02_Backend/Backend_Design.md 后端设计规范
Frontend Design ../03_Frontend/Frontend_Design.md 前端设计规范
Governance Standards ./Governance_Standards.md 治理与审批标准

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

Reference in New Issue View Git Blame Copy Permalink