- 将B2B统一为TOB术语 - 将状态值统一为大写格式 - 优化类型声明,避免使用any - 将float类型替换为decimal以提高精度 - 新增术语标准化文档 - 优化路由结构和菜单分类 - 添加TypeORM实体类 - 增强加密模块安全性 - 重构前端路由结构 - 完善任务模板和验收标准
8.2 KiB
8.2 KiB
📌 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 | 定价与利润决策、核心服务优先级、多店铺管理、商家选择发货、客户/商家押金 |
🔗 闭环依赖关系
核心流程
- 数据采集与处理:运营代理 → 数据采集 → 数据清洗 → 套利/利润评估
- 商品管理:商品主数据 → SKU变体与结构 → 商品刊登 ←→ 素材管理
- 营销与销售:定价与利润决策 → 广告/营销(TOC)/ 企业营销(TOB)
- 订单履约:订单履约(OMS) → 订单拆分与合并 → 异常订单处理
- 物流与库存:物流策略与渠道选择 → 库存 & WMS ←→ 供应链 & 补货
- 售后与财务:售后逆向 → 资金对账 → 利润核算
- 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(大额企业订单、阶梯价审批、信用审批)
详细状态机定义:请参考 状态机文档
💡 说明
- 业务闭环文档是最高层文档,不涉及具体前端或模块实现细节。
- 下层模块功能、接口、算法、UI 都是这个闭环的落地实现。
- 形成从采集 → 决策 → 执行 → 反馈 → 风控的完整业务链。
- 每个闭环都有明确的输入、输出、流程和决策点,确保业务流程的完整性和可控性。
- 各闭环之间通过数据流转和依赖关系形成完整的业务生态系统。
- 所有业务操作均需遵循项目特定规则,确保系统安全和数据一致性。
- "闭环写入规则:只要逻辑上能闭环就写,落地方式后置"
- 系统层级结构:
- L1(业务闭环):交易系统核心流程
- L2(系统决策层):定价、风控、健康度等系统级能力
- L3(数据中台层):商品主数据、成本基准等数据管理能力
- L4(自动化与增长):任务调度、A/B测试、用户资产等高级能力
- 横切能力:账号健康度、任务调度、权限审计等能力贯穿所有业务闭环,确保系统稳定性和安全性。
📚 相关文档
| 文档 | 路径 | 说明 |
|---|---|---|
| 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 | 文档拆分完成