docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档 补充前端集成蓝图、多租户实施清单、上线红线检查清单 添加质量保障文档与早期业务规格书
This commit is contained in:
69
docs/blueprints/arch-overview-v30.md
Normal file
69
docs/blueprints/arch-overview-v30.md
Normal file
@@ -0,0 +1,69 @@
|
||||
# 🏢 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
|
||||
Reference in New Issue
Block a user