70 lines
3.9 KiB
Markdown
70 lines
3.9 KiB
Markdown
# 🏢 Crawlful Hub 架构总览 (V1.0 - Enterprise Trade ERP)
|
||
|
||
## 1. 文档导航 (V1.0 体系)
|
||
- **最高业务蓝图**：[global-business-blueprint.md](global-business-blueprint.md)
|
||
- **全局状态机与任务归属**：[collaboration-board.md](../governance/collaboration-board.md)
|
||
- **原子规格与实施标准**：[task-specifications.md](../governance/task-specifications.md)
|
||
- **全量文档索引**：[doc-index.md](../doc-index.md)
|
||
|
||
### 1.1 核心分类索引
|
||
- **质量保障**：[golive-redline-checklist.md](../quality/golive-redline-checklist.md) | [frontend-delivery-standard.md](../quality/frontend-delivery-standard.md)
|
||
- **设计规格**：[server-initiation.md](../design/server-initiation.md) | [extension-initiation.md](../design/extension-initiation.md) | [console-pipeline-log-design.md](../design/console-pipeline-log-design.md)
|
||
- **实施指南**：[server-readme.md](../guides/server-readme.md) | [toc-early-stage-spec.md](../guides/toc-early-stage-spec.md) | [non-saas-multi-tenant-checklist.md](../guides/non-saas-multi-tenant-checklist.md)
|
||
- **行业标杆**：[eccang-functional-breakdown.md](../benchmarks/eccang-functional-breakdown.md) | [91miaoshou-spec.md](../benchmarks/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%` 触发预警并要求人工确认。
|
||
|
||
---
|
||
|
||
## 6. 企业级商业能力 (Enterprise Capabilities)
|
||
- **要素构成**：
|
||
- **多租户模型**：`Tenant -> Organization -> Shop -> User` 四层级隔离。
|
||
- **权限与审计**：基于 RBAC 的颗粒度权限，全量操作流水线日志（审计追踪）。
|
||
- **商业化计费**：支持席位、店铺、节点、任务量的四维配额治理。
|
||
- **SLA 与运维**：提供 99.9% 可用性保障、成功率遥测与故障告警。
|
||
- **企业集成**：支持 SSO (OIDC/SAML)、Webhook 事件总线、标准 OpenAPI 套件。
|
||
|
||
---
|
||
|
||
## 7. 技术成熟度评估 (V1.0)
|
||
- **技术成熟度**：后端服务与前端控制台已完成基础功能开发，具备生产使用条件。
|
||
- **业务成熟度**：订单、库存、财务三大核心模块已闭环，企业级计费与集成底座正在完善。
|
||
- **核心优势**：务实的产品设计、稳定的核心功能、企业级的安全与审计能力。
|
||
|
||
---
|
||
|
||
**规格维护者**：Crawlful Hub 团队 | **当前版本**：V1.0
|