3.9 KiB
3.9 KiB
🏢 Crawlful Hub 架构总览 (V1.0 - Enterprise Trade ERP)
1. 文档导航 (V1.0 体系)
- 最高业务蓝图：global-business-blueprint.md
- 全局状态机与任务归属：collaboration-board.md
- 原子规格与实施标准：task-specifications.md
- 全量文档索引：doc-index.md
1.1 核心分类索引
- 质量保障：golive-redline-checklist.md | frontend-delivery-standard.md
- 设计规格：server-initiation.md | extension-initiation.md | console-pipeline-log-design.md
- 实施指南：server-readme.md | toc-early-stage-spec.md | non-saas-multi-tenant-checklist.md
- 行业标杆：eccang-functional-breakdown.md | 91miaoshou-spec.md
2. 三层系统架构 (V1.0)
- Console (前端中控台)：统一登录、订单审核、发货操作、财务对账、经营报表。
- Hub (后端服务层)：业务逻辑处理、数据持久化、任务调度、消息通知。
- Extension / Win Node (边缘执行层)：
- 插件负责轻量采集触发、DOM 解析与状态展示；
- Win Node Agent 负责无 API 平台执行、指纹隔离与环境自检。
3. 平台接入策略 (Hybrid Logic)
- 有 API 平台 (如 TK Shop API / Amazon SP-API)：走
Connector Bus标准协议，实现毫秒级同步。 - 无 API 平台 (对标 91miaoshou)：走
No-API Bridge，采用Collect -> Clean -> Review -> Publish流程。 - 统一发布编排：由
PublishOrchestrator统一管理状态机，确保跨平台操作的原子性与幂等性。
4. Win 节点执行隔离 (Execution Isolation)
- 执行模型：
Hub (Control Plane) -> Win Node Agent -> Browser Worker (Isolated)。 - 隔离原则：一店一执行上下文（
profileDir/proxy/fingerprintPolicy），任务严格串行，规避关联风险。 - 心跳与遥测：节点主动注册与维持心跳，异步拉取任务，实时回传任务执行日志。
5. 业务闭环 (Business Loop)
- 核心目标：实现从"商品上架"到"订单履约"到"财务核算"的完整业务闭环。
- 闭环链路：
商品采集->审核上架->订单归集->发货履约->财务对账->利润分析
- 净利模型 (ROI-First)：
- 必须包含：采购成本、平台费、物流、税费、汇率边际、售后摊销、广告投入。
- 红线控制：
- B2B 净利率
<15%强制拦截； - B2C 净利率
<20%触发预警并要求人工确认。
- B2B 净利率
6. 企业级商业能力 (Enterprise Capabilities)
- 要素构成：
- 多租户模型：
Tenant -> Organization -> Shop -> User四层级隔离。 - 权限与审计：基于 RBAC 的颗粒度权限，全量操作流水线日志（审计追踪）。
- 商业化计费：支持席位、店铺、节点、任务量的四维配额治理。
- SLA 与运维：提供 99.9% 可用性保障、成功率遥测与故障告警。
- 企业集成：支持 SSO (OIDC/SAML)、Webhook 事件总线、标准 OpenAPI 套件。
- 多租户模型：
7. 技术成熟度评估 (V1.0)
- 技术成熟度：后端服务与前端控制台已完成基础功能开发，具备生产使用条件。
- 业务成熟度：订单、库存、财务三大核心模块已闭环，企业级计费与集成底座正在完善。
- 核心优势：务实的产品设计、稳定的核心功能、企业级的安全与审计能力。
规格维护者：Crawlful Hub 团队 | 当前版本：V1.0