chore: 清理归档文件和文档模板
删除不再需要的归档文件和过时的文档模板,包括多个README、安全策略、前端集成蓝图等文件,同时移除了未使用的业务文档和项目结构文件。 优化项目结构,移除冗余文件,保持代码库整洁。主要删除archive/handover目录下的多个文件及doc目录下的部分文档模板。
This commit is contained in:
@@ -1,77 +0,0 @@
|
||||
|
||||
---
|
||||
|
||||
## 9. 套利与定价分析 (ARB / Pricing) — TOC + TOB + 汇率支持
|
||||
|
||||
### 核心定位
|
||||
|
||||
* **零售(TOC) + 批发/整柜(TOB)套利分析**
|
||||
* 覆盖 **生产 → 拿货 → 平台销售**全链路
|
||||
* 支持 **定价推荐、ROI 模拟、利润预测、汇率自动换算**
|
||||
* 支持跨国、跨仓、多币种利润计算
|
||||
|
||||
### 核心功能
|
||||
|
||||
1. **成本与利润测算**
|
||||
|
||||
* 支持 **固定成本与浮动成本**组合(采购、生产、物流、平台费、广告、关税等)
|
||||
* **汇率换算**:自动获取实时汇率,将外币成本/售价换算成目标结算币种
|
||||
* 输出每 SKU 或整柜商品 **售价/ROI/签收利润**
|
||||
|
||||
2. **定价推荐与模拟**
|
||||
|
||||
* 自动推荐售价区间以满足目标毛利率或 ROI 红线
|
||||
* 支持多币种定价、不同平台价格差异
|
||||
* 可以模拟不同库存、销量、物流方式和汇率波动下的利润
|
||||
|
||||
3. **套利机会发现**
|
||||
|
||||
* **跨平台零售套利**:采集价格或手动录入成本分析价差
|
||||
* **跨阶段 TOB 套利**:生产采购成本 vs 批发/整柜售价
|
||||
* **跨国家 / 跨仓套利**:结合汇率、关税、仓储成本、物流费用计算净利润
|
||||
|
||||
4. **供应链阶段利润分析**
|
||||
|
||||
* **生产阶段**:原材料采购、工厂成本、生产周期成本
|
||||
* **拿货阶段**:整柜成本、运输成本、报关费用、税费(多币种换算)
|
||||
* **零售阶段**:平台费用、广告投入、物流派送、售后成本
|
||||
|
||||
5. **多维度分析报表**
|
||||
|
||||
* 商品维度、阶段维度、平台 / 渠道维度、时间维度
|
||||
* 汇率敏感性分析:利润随汇率变化的浮动曲线
|
||||
|
||||
---
|
||||
|
||||
### 业务流示意(文字版)
|
||||
|
||||
```text
|
||||
生产阶段 / 原材料采购(支持多币种)
|
||||
│
|
||||
▼
|
||||
拿货 / 整柜阶段(FCL/TOB)
|
||||
│
|
||||
▼
|
||||
套利分析模块(TOB + TOC + 汇率换算)
|
||||
├─ 成本测算(固定/浮动/汇率调整)
|
||||
├─ 定价推荐 & ROI 模拟
|
||||
├─ 跨平台 / 跨阶段套利机会
|
||||
└─ 汇率敏感性分析 & 全链路利润报表
|
||||
│
|
||||
▼
|
||||
商品刊登 / 调价执行(多平台 / 多币种)
|
||||
│
|
||||
▼
|
||||
OMS / WMS / 财务 / 营销全链路闭环
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
💡 **特点说明**
|
||||
|
||||
* 汇率处理贯穿 **TOB 和 TOC 全链路**
|
||||
* 支持多币种采购、整柜成本、平台销售价格统一计算
|
||||
* 可进行 **利润随汇率波动的敏感性分析**,为定价策略提供数据支持
|
||||
* 套利模块成为全链路利润智能分析引擎,同时支撑 **零售、批发、整柜、跨国贸易**
|
||||
|
||||
---
|
||||
@@ -1,6 +1,6 @@
|
||||
# 🏢 Business Blueprint (Crawlful Hub)
|
||||
|
||||
> **定位**:Crawlful Hub 业务核心蓝图 - 包含项目目标、技术栈、核心业务模块、状态机及行业标杆参考。
|
||||
> **定位**:Crawlful Hub 业务核心蓝图 - 包含项目目标、技术栈、核心业务模块、功能规格、状态机及行业标杆参考。
|
||||
> **更新日期**: 2026-03-17
|
||||
|
||||
---
|
||||
@@ -23,75 +23,202 @@
|
||||
|
||||
---
|
||||
|
||||
## 2. 核心业务模块 (Core Business Modules)
|
||||
## 2. 核心业务闭环 (Core Business Loops)
|
||||
|
||||
### 2.1 闭环总览 ⭐⭐⭐
|
||||
|
||||
#### 闭环验收标准 (P0)
|
||||
### 2.1 闭环验收标准 (P0)
|
||||
- **商品刊登闭环**: ERP 商品 → 平台可售。要求全链路追踪 (traceId)。
|
||||
- **订单履约闭环**: 平台订单 → 妥投。状态机完整,异常可介入。
|
||||
- **售后逆向闭环**: 售后请求 → 退款完成。状态流转清晰。
|
||||
- **资金对账闭环**: platform 结算流水 → 差异关闭。汇率明确,可回溯。
|
||||
- **合规风控闭环**: 风险信号 → 拦截/复核。审计留痕。
|
||||
|
||||
#### 追踪四元组 (Tracking Quad)
|
||||
### 2.2 追踪五元组 (Tracking Quintuple)
|
||||
- `tenantId`: 租户 ID (业务隔离)
|
||||
- `shopId`: 店铺 ID (平台/店铺隔离)
|
||||
- `taskId`: 任务 ID (任务/规则触发归档)
|
||||
- `traceId`: 链路追踪 ID (全链路唯一标识)
|
||||
- `businessType`: 业务类型 (TOC/TOB)
|
||||
|
||||
### 2.2 模块功能详述
|
||||
---
|
||||
|
||||
#### 1. 商品管理 (PIM) & 跨平台套利 (Arbitrage)
|
||||
## 3. 核心业务模块 (Core Business Modules)
|
||||
|
||||
### 3.1 商品管理 (PIM) & 跨平台套利 (Arbitrage)
|
||||
- **跨平台套利雷达**: 自动识别 1688 (价格洼地) 与 Amazon/Temu/eBay (价格高地) 的利差。支持视觉寻源与多模态匹配。
|
||||
- **套利净利引擎**: 统一计算口径 `售价 - 采购 - 平台费 - 物流 - 税费 - 汇率对冲 - 售后损耗 - 广告摊销`。
|
||||
- **风险门禁**: B2C 利润率 < 20% 触发预警,利润率 < 15% 或 ROI < 20% 标记为高风险,< 5% 强制拦截。
|
||||
- **风险门禁**:
|
||||
- B2C: 利润率 < 20% 触发风控预警
|
||||
- B2B: 利润率 < 15% 禁止报价
|
||||
- ROI < 20% 标记为高风险,< 5% 强制拦截
|
||||
- **SPU/SKU 管理**: 支持独立站 (Shopify/WooCommerce) 与平台电商的多维度属性映射。
|
||||
- **刊登任务**: 支持无 API 平台 (TikTok/Temu) 模拟执行与官方 API 刊登。
|
||||
|
||||
#### 2. 订单管理 (OMS) & TOB 业务
|
||||
### 3.2 订单管理 (OMS) & TOB 业务
|
||||
- **多渠道归集**: 聚合平台订单与独立站 (DTC) 订单。
|
||||
- **自动审单**: 地址、库存、风险验证规则引擎自动审核。
|
||||
- **异常处理**: 缺货、地址异常、支付失败进入异常队列,支持人工介入。
|
||||
- **批量操作**: 审核、发货、标记、打印面单。
|
||||
- **TOB 报价红线**: B2B 利润率 < 15% 严禁报价,支持大宗贸易的阶梯价设置与询盘转化。
|
||||
- **分账引擎**: 针对 TOB 业务支持主权级信用池 (Sovereign Credit Pool) 与跨境结算审计。
|
||||
- **利润核算**: 实时计算单笔订单净利,关联广告支出实现全链路 ROI 溯源。
|
||||
|
||||
#### 3. 库存与仓储 (WMS)
|
||||
### 3.3 库存与仓储 (WMS)
|
||||
- **多仓协同**: 实时同步全球多仓库存,支持独立站与平台库存共享/隔离策略。
|
||||
- **补货算法**: `(销量预测 * 采购周期 + 安全库存 - 在途)`。支持基于利差热力图的智能补货决策。
|
||||
- **入/出库流**: ASN 预报、QC 质检、波次拣货。
|
||||
- **库存老化分析**: 分析周转天数、识别呆滞库存。
|
||||
- **库存预测与补货**: 基于销售预测与仓库健康度制定采购需求池。
|
||||
|
||||
#### 4. 财务与结算
|
||||
### 3.4 财务管理 (FIN)
|
||||
- **成本归集**: 采购、头程/尾程物流、佣金、广告。
|
||||
- **多币种对账**: ZKP 隐私审计,自动差异匹配。
|
||||
- **汇率避险**: 联动多币种汇率避险接口,锁定汇率风险,记录汇兑损益。
|
||||
- **利润实时核算**: 销售收入 - 采购成本 - 物流 - 平台费 - 广告。
|
||||
- **多币种对账**: ZKP 隐私审计,自动差异匹配。支持 VAT 计提,汇率自动同步。
|
||||
- **平台费用监控**: 实时监控平台收取的各类佣金、广告投入与退款流水。
|
||||
- **ROI 看板**: 实时显示业务决策对财务贡献。
|
||||
|
||||
#### 5. 营销与广告 (MKT)
|
||||
### 3.5 营销与广告 (MKT)
|
||||
- **跨平台投放**: 统一管理 Facebook, Google, TikTok 广告。
|
||||
- **独立站 DTC 策略**: 针对独立站流量进行全链路归因分析 (Multi-touch Attribution)。
|
||||
- **动态优化**: 基于 ROAS 自动调整预算,监控盈亏平衡点 (Break-even ROAS)。
|
||||
- **套利闭环回流**: 从选品建议到真实销量回流,持续迭代套利策略。
|
||||
- **广告计划看板**: 跨平台广告投放监控与预算动态优化,ROAS 实时监控、自动调价建议、亏损活动预警。
|
||||
|
||||
### 3.6 供应链与供应商管理 (SCM)
|
||||
- **供应商档案**: 信用分级、联系方式、评分管理。
|
||||
- **采购管理**:
|
||||
- 1688 一键代采、实时比价
|
||||
- 多供应商询价、MOQ、交期对比
|
||||
- **补货建议**: `(销量预测 * 采购周期 + 安全库存 - 在途)` 自动生成。
|
||||
- **供应商产能监控**: 评估供应商交付准时率、质量评分与实时产能状态。
|
||||
|
||||
### 3.7 治理与审批中心
|
||||
- **通用审批中心**: 大额订单、价格变更、退款等敏感操作多级审核。
|
||||
- **UI 布局**: 待办/已办统计,审批日志,核准/拒绝动作。
|
||||
|
||||
### 3.8 合规与证书管理
|
||||
- **自动化合规**: 订单数据生成 CE、FDA、原产地证等电子证书。
|
||||
- **信用分级**: 基于配送员履约率、争议率的信用体系。
|
||||
|
||||
### 3.9 套利与定价分析 (ARB / Pricing) — TOC + TOB 全链路
|
||||
|
||||
#### 核心定位
|
||||
- 支持 **零售(TOC)** 和 **批发/整柜(TOB)** 套利分析。
|
||||
- 覆盖 **从生产/采购阶段 → 拿货/整柜阶段 → 零售/平台销售阶段** 的利润分析。
|
||||
- 提供 **定价推荐、ROI 模拟、利润预测和风险提示**。
|
||||
|
||||
#### 核心功能
|
||||
|
||||
1. **成本与利润测算**
|
||||
- **TOC**:单件商品成本 + 平台费 + 物流 + 广告 → 售价 / ROI / 利润预测
|
||||
- **TOB**:整柜成本、批量采购成本、关税、物流 → 单件拆算利润、ROI
|
||||
- 支持 **固定成本与浮动成本**组合计算(如汇率、运费波动、关税变化)
|
||||
|
||||
2. **定价推荐与模拟**
|
||||
- 自动推荐售价区间以满足目标毛利率或 ROI 红线
|
||||
- 支持批量调价、不同平台定价差异、整柜与零售拆算定价
|
||||
- 可模拟不同库存、销量、物流方式下的利润变化
|
||||
|
||||
3. **套利机会发现**
|
||||
- **跨平台零售套利**:基于采集价格或手动录入的成本分析价差
|
||||
- **跨阶段 TOB 套利**:生产采购成本 vs 平台/批发售价,输出净利和 ROI
|
||||
- **跨国家/跨仓套利**:考虑关税、仓储成本、物流方式的最优利润路径
|
||||
|
||||
4. **供应链阶段利润分析**
|
||||
- **生产阶段**:原材料采购、工厂成本、生产周期成本
|
||||
- **拿货阶段**:整柜成本、运输成本、报关费用、税费
|
||||
- **零售阶段**:平台费用、广告投入、物流派送、售后成本
|
||||
- 支持全链路可视化报表,显示每个环节对利润的贡献
|
||||
|
||||
5. **多维度分析报表**
|
||||
- **商品维度**:每 SKU/整柜商品成本、售价、ROI、利润预测
|
||||
- **阶段维度**:生产 → 拿货 → 零售,每阶段成本、利润占比
|
||||
- **平台 / 渠道维度**:各平台毛利率、利润贡献度、风险提示
|
||||
- **时间维度**:预测未来收益、库存消耗、套利机会变化
|
||||
|
||||
#### 业务流示意
|
||||
```text
|
||||
生产阶段 / 原材料采购
|
||||
│
|
||||
▼
|
||||
拿货 / 整柜阶段
|
||||
│
|
||||
▼
|
||||
套利分析模块(TOB + TOC)
|
||||
├─ 成本测算(固定/浮动)
|
||||
├─ 定价推荐 & ROI 模拟
|
||||
├─ 跨平台 / 跨阶段套利机会
|
||||
└─ 全链路利润分析报表
|
||||
│
|
||||
▼
|
||||
商品刊登 / 调价执行
|
||||
│
|
||||
▼
|
||||
OMS / WMS / 财务 / 营销全链路闭环
|
||||
```
|
||||
|
||||
### 3.10 B2B / TOB 贸易管理
|
||||
- **报价红线控制**: 利润率低于阈值自动拦截,支持多级审批。
|
||||
- **阶梯价策略**: 采购数量触发阶梯折扣。
|
||||
- **信用池**: 基于历史履约记录的结算额度与审计。
|
||||
- **询盘管理**: 多渠道整合询盘,支持跟进与转化。
|
||||
|
||||
### 3.11 产品采集与数据分析
|
||||
- **多平台采集**: Amazon, eBay, Shopee, 1688 等平台商品信息抓取。
|
||||
- **数据标准化**: SKU 属性、价格、库存统一格式化。
|
||||
- **分析支持**: ARB、PIM、营销调价、库存补货预测的数据基础。
|
||||
|
||||
### 3.12 物流策略与渠道选择
|
||||
- **物流模式管理**:
|
||||
- 整柜出海 (FCL Shipping)
|
||||
- 自有仓出货
|
||||
- 第三方仓出货 (3PL)
|
||||
- 直发客户 (D2C / Dropship)
|
||||
- **物流健康状态**: 多渠道实时轨迹遥测、异常节点告警 (48h+ 停留)。
|
||||
|
||||
### 3.13 客户管理 (CRM)
|
||||
- **客户 360 视图**: 订单历史、客诉记录与信用分级。
|
||||
- **押金与账户管理**: 客户/商家押金管理、账户资产统计。
|
||||
|
||||
---
|
||||
|
||||
## 3. 关键业务状态机 (State Machines)
|
||||
## 4. 关键业务状态机 (State Machines)
|
||||
|
||||
### 3.1 订单状态机
|
||||
- `PULLED` → `PENDING_REVIEW` → `CONFIRMED` → `ALLOCATED` → `READY_TO_SHIP` → `SHIPPED` → `DELIVERED` → `CLOSED`
|
||||
### 4.1 订单状态机
|
||||
```
|
||||
PULLED → PENDING_REVIEW → CONFIRMED → ALLOCATED → READY_TO_SHIP → SHIPPED → DELIVERED → CLOSED
|
||||
```
|
||||
|
||||
### 3.2 业务审核状态机
|
||||
- `SUBMITTED` (提交) → `PENDING_REVIEW` (人工审核) → `EXECUTED` / `REJECTED`
|
||||
### 4.2 业务审核状态机
|
||||
```
|
||||
SUBMITTED (提交) → PENDING_REVIEW (人工审核) → EXECUTED / REJECTED
|
||||
```
|
||||
|
||||
### 4.3 售后状态机
|
||||
```
|
||||
REQUESTED → PENDING_REVIEW → APPROVED → RETURN_IN_TRANSIT → QC_INSPECTION → REFUNDED / REJECTED
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. 行业标杆复刻方案 (Benchmarks)
|
||||
## 5. 行业标杆复刻方案 (Benchmarks)
|
||||
|
||||
- **ERP 系统**: 像素级还原易仓、店小秘核心逻辑。
|
||||
- **TikTok 运营**: 实现 91 妙手同级的无 API 履约与采集能力。
|
||||
- **数据分析**: 船长 BI 级的数据归集与可视化看板。
|
||||
| 业务领域 | 标杆参考 | 核心复刻重点 |
|
||||
|:------------|:--------------------|:--------------|
|
||||
| **商品 (PIM)** | 91妙手、店小秘 | 多平台刊登与库存统一 |
|
||||
| **套利 (ARB)** | 船长BI、Helium 10 | 跨平台寻源与实时利润测算 |
|
||||
| **订单 (OMS)** | 易仓、积加 | 多源归集与自动化审单 |
|
||||
| **独立站 (DTC)** | Shopify | 流量归因与多租户隔离 |
|
||||
| **仓储 (WMS)** | Flexport | 路径规划与多仓协同 |
|
||||
| **财务 (FIN)** | 出海匠 | 全口径利润审计与回款跟踪 |
|
||||
| **营销 (MKT)** | 蝉妈妈 | 趋势分析与数据可视化 |
|
||||
| **供应链 / 采购** | 1688 + 供应商管理工具 | 补货建议、采购比价、供应商信用 |
|
||||
| **物流模式** | FCL / Own / 3PL / D2C | 全球物流路径、调拨、直发客户 |
|
||||
| **审批与合规** | 内部审批 & 电子证书 | 敏感操作审核、证书生成 |
|
||||
| **B2B 贸易管理** | 内部 TOB 系统 | 阶梯价、信用池、询盘管理 |
|
||||
|
||||
---
|
||||
|
||||
## 5. 项目结构与目录映射 (Directory Map)
|
||||
## 6. 项目结构与目录映射 (Directory Map)
|
||||
|
||||
```
|
||||
project
|
||||
@@ -104,12 +231,16 @@ project
|
||||
|
||||
---
|
||||
|
||||
## 6. 实施指南摘要 (Implementation Guides)
|
||||
## 7. 实施指南摘要 (Implementation Guides)
|
||||
|
||||
### 6.1 TOC 加速架构
|
||||
### 7.1 TOC 加速架构
|
||||
- **快速上线**: 提供 Amazon/AliExpress 基础订单同步。
|
||||
- **ConsumerOrderService**: 专责 TOC 订单流。
|
||||
|
||||
### 6.2 非 SaaS 多租户隔离
|
||||
### 7.2 非 SaaS 多租户隔离
|
||||
- **数据独占**: `tenant_id` 逻辑隔离,行级安全校验。
|
||||
- **资源配额**: 严格限制并发 Worker 与 API 速率。
|
||||
|
||||
---
|
||||
|
||||
*本蓝图整合了业务功能规格,详细闭环流程请查阅 [Business_ClosedLoops.md](./Business_ClosedLoops.md)*
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 📌 Crawlful Hub 业务闭环(TOC + TOB Unified Business Loops)
|
||||
|
||||
> **说明**:本闭环文档是战略层业务流程,关注“做什么、为什么做、顺序和决策点”,为下层模块功能和系统实现提供指引。TOC(零售/前端)和 TOB(B2B贸易)共享通用模块,特有流程用 `businessType` 标记。
|
||||
> **说明**:本闭环文档是战略层业务流程,关注"做什么、为什么做、顺序和决策点",为下层模块功能和系统实现提供指引。TOC(零售/前端)和 TOB(B2B贸易)共享通用模块,特有流程用 `businessType` 标记。共 **35个业务闭环**。
|
||||
|
||||
## 📑 目录
|
||||
|
||||
@@ -34,6 +34,11 @@
|
||||
28. [利润核算闭环](#2️⃣8️⃣-利润核算闭环profit-calculation-loop)
|
||||
29. [用户/客户资产闭环](#2️⃣9️⃣-用户客户资产闭环usercustomer-asset-loop)
|
||||
30. [A/B测试与策略优化闭环](#3️⃣0️⃣-ab测试与策略优化闭环ab-testing--strategy-optimization-loop)
|
||||
31. [多商户入驻与认证闭环](#3️⃣1️⃣-多商户入驻与认证闭环merchant-registration--authentication-loop)
|
||||
32. [功能模块化与权限控制闭环](#3️⃣2️⃣-功能模块化与权限控制闭环feature-modularization--permission-control-loop)
|
||||
33. [功能开通与支付闭环](#3️⃣3️⃣-功能开通与支付闭环feature-activation--payment-loop)
|
||||
34. [多商户结算与财务闭环](#3️⃣4️⃣-多商户结算与财务闭环multi-merchant-settlement--finance-loop)
|
||||
35. [多商户商品与订单管理闭环](#3️⃣5️⃣-多商户商品与订单管理闭环multi-merchant-product--order-management-loop)
|
||||
31. [统一闭环依赖](#🔹-统一闭环依赖toc--tob)
|
||||
32. [闭环依赖关系](#🔗-闭环依赖关系toc--tob)
|
||||
33. [关键绩效指标](#📊-关键绩效指标kpi)
|
||||
@@ -46,12 +51,26 @@
|
||||
## 1️⃣ 数据采集与清洗闭环(Product Data Collection & Cleansing)
|
||||
|
||||
- **目标**:收集多平台商品信息,确保数据完整、有效、可用于盈利分析(TOC)或报价计算(TOB)。
|
||||
- **采集策略矩阵**:
|
||||
|
||||
| 平台类型 | 采集方式 | 执行位置 | 登录要求 | 反爬策略 |
|
||||
|----------|----------|----------|----------|----------|
|
||||
| **有API平台** (Amazon MWS, eBay API) | 官方API | 后端 | OAuth/密钥 | 频率限制 |
|
||||
| **无API平台** (TikTok Shop, Temu) | 浏览器插件 | 插件 | 需登录 | 指纹隔离+IP代理 |
|
||||
| **公开数据** (1688公开页) | 浏览器插件 | 插件 | 无需登录 | 频率控制 |
|
||||
| **需登录数据** (供应商后台) | 浏览器插件 | 插件 | 需登录 | 店铺隔离 |
|
||||
|
||||
- **流程**:
|
||||
1. **多平台采集**:
|
||||
- TOC:抓取 Amazon、eBay、Shopee、1688 等平台商品信息。
|
||||
- TOB:抓取供应商报价、批发价格、企业定制产品信息。
|
||||
- 支持 API 对接和爬虫采集。
|
||||
- 采集字段:标题、价格、库存、SKU、图片、描述、评价、供应商信息(TOB)。
|
||||
- **有API平台**(Amazon MWS、eBay API、Shopee Open API):
|
||||
- 后端通过官方API获取数据
|
||||
- 使用 `PlatformApiService` 统一对接
|
||||
- 支持 OAuth 认证和密钥管理
|
||||
- **无API平台**(TikTok Shop、Temu、部分1688页面):
|
||||
- **严禁后端直接爬取**(IP封禁风险、法律合规)
|
||||
- 通过浏览器插件在用户端采集
|
||||
- 插件使用店铺隔离环境(独立指纹+代理IP)
|
||||
- **采集字段**:标题、价格、库存、SKU、图片、描述、评价、供应商信息(TOB)
|
||||
2. **数据清洗**:
|
||||
- 去重:平台+productId 唯一约束
|
||||
- 格式化:统一字段格式和单位
|
||||
@@ -66,6 +85,19 @@
|
||||
- TOB:B2B 利润率 < 15% 禁止报价
|
||||
- **输入**:平台商品原始数据
|
||||
- **输出**:清洗后的可售商品/报价数据,包含完整套利/利润分析
|
||||
- **⚠️ 重要约束**:
|
||||
- **后端严禁直接爬取电商平台页面**(IP封禁、法律风险)
|
||||
- 所有网页级采集必须通过浏览器插件在用户端执行
|
||||
- 插件必须实现店铺隔离(一店一IP一指纹)
|
||||
|
||||
- **📋 技术实现指引**:
|
||||
| 层级 | 实现模块 | 关键文件 | 任务ID |
|
||||
|------|----------|----------|--------|
|
||||
| 后端 | 平台API对接 | `PlatformApiService.ts` | BE-P005, BE-P006, BE-P007 |
|
||||
| 后端 | 数据清洗引擎 | `DataPipelineService.ts` | DT-P001, DT-P002 |
|
||||
| 插件 | 网页采集器 | `crawlerService.ts` | PL-C001, PL-C002 |
|
||||
| 插件 | DOM解析 | `amazonCrawler.ts`, `tiktokCrawler.ts` | PL-C002 |
|
||||
| AI | 套利分析 | `ArbitrageService.ts` | AI-A001 |
|
||||
|
||||
***
|
||||
|
||||
@@ -322,6 +354,49 @@
|
||||
2. 自动化落地,提高效率与可扩展性
|
||||
3. 支持多云部署,增强业务弹性和成本优化能力
|
||||
|
||||
- **📋 技术实现指引**:
|
||||
| 层级 | 实现模块 | 关键文件 | 任务ID |
|
||||
|------|----------|----------|--------|
|
||||
| 后端 | 店铺隔离管理 | `ShopIsolationService.ts` | BE-G003 |
|
||||
| 后端 | 云镜像管理 | `CloudInstanceService.ts` | BE-G003 |
|
||||
| 后端 | 任务调度器 | `TaskScheduler.ts` | BE-G003 |
|
||||
| 插件 | 浏览器指纹管理 | `fingerprintService.ts` | PL-A001 |
|
||||
| 插件 | 代理IP管理 | `proxyService.ts` | PL-A001 |
|
||||
| 插件 | 自动化执行器 | `automationService.ts` | PL-A001, PL-A002 |
|
||||
| 运维 | 健康监控 | `HealthMonitor.ts` | OP-M001 |
|
||||
|
||||
- **🔗 插件管理架构**:
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 插件生命周期管理 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
|
||||
│ │ 安装/更新 │───►│ 配置初始化 │───►│ 店铺绑定 │ │
|
||||
│ └──────────────┘ └──────────────┘ └──────────────┘ │
|
||||
│ │ │ │ │
|
||||
│ ▼ ▼ ▼ │
|
||||
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
|
||||
│ │ 任务接收 │◄──►│ 任务执行 │◄──►│ 结果上报 │ │
|
||||
│ │ (Backend) │ │ (Extension) │ │ (Backend) │ │
|
||||
│ └──────────────┘ └──────────────┘ └──────────────┘ │
|
||||
│ │ │ │ │
|
||||
│ ▼ ▼ ▼ │
|
||||
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
|
||||
│ │ 状态同步 │◄──►│ 异常处理 │◄──►│ 日志归档 │ │
|
||||
│ └──────────────┘ └──────────────┘ └──────────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
- **📡 插件通讯协议**:
|
||||
| 通讯方向 | 协议 | 用途 | 消息类型 |
|
||||
|----------|------|------|----------|
|
||||
| 后端 → 插件 | WebSocket | 实时任务下发 | `TASK_ASSIGN`, `CONFIG_UPDATE` |
|
||||
| 插件 → 后端 | HTTP POST | 执行结果上报 | `TASK_COMPLETE`, `TASK_FAILED` |
|
||||
| 插件 ↔ 后端 | HTTP GET | 状态查询/心跳 | `HEARTBEAT`, `STATUS_QUERY` |
|
||||
| 插件内部 | Chrome Message | 组件间通讯 | `CRAWL_DATA`, `AUTO_ACTION` |
|
||||
|
||||
***
|
||||
|
||||
## 1️⃣8️⃣ 订单集中管理闭环(Order Centralized Management Loop)
|
||||
@@ -918,11 +993,198 @@
|
||||
| 测试覆盖率 | 覆盖的业务策略比例 | TOC + TOB |
|
||||
| 决策支持准确率 | 测试结果对决策的支持程度 | TOC + TOB |
|
||||
|
||||
#### 多商户入驻与认证闭环
|
||||
|
||||
| KPI 指标 | 描述 | 适用业务类型 |
|
||||
| -------- | ------------ | --------- |
|
||||
| 入驻转化率 | 注册到入驻成功的比例 | TOC + TOB |
|
||||
| 资质审核时效 | 资质审核的平均时间 | TOC + TOB |
|
||||
| 认证通过率 | 通过认证的商户比例 | TOC + TOB |
|
||||
| 店铺绑定成功率 | 成功绑定平台店铺的比例 | TOC + TOB |
|
||||
| 商户活跃度 | 商户月活跃比例 | TOC + TOB |
|
||||
|
||||
#### 功能模块化与权限控制闭环
|
||||
|
||||
| KPI 指标 | 描述 | 适用业务类型 |
|
||||
| -------- | ------------ | --------- |
|
||||
| 模块使用率 | 各功能模块的使用比例 | TOC + TOB |
|
||||
| 权限配置准确率 | 权限配置的准确性 | TOC + TOB |
|
||||
| 数据隔离有效性 | 数据隔离的成功率 | TOC + TOB |
|
||||
| 功能开关响应时效 | 功能开关生效的时间 | TOC + TOB |
|
||||
| 配额利用率 | 商户使用配额的比例 | TOC + TOB |
|
||||
|
||||
#### 功能开通与支付闭环
|
||||
|
||||
| KPI 指标 | 描述 | 适用业务类型 |
|
||||
| ------- | ------------ | --------- |
|
||||
| 支付成功率 | 支付成功的比例 | TOC + TOB |
|
||||
| 开通时效 | 从支付到开通的时间 | TOC + TOB |
|
||||
| 续费率 | 功能到期后续费的比例 | TOC + TOB |
|
||||
| 退款率 | 申请退款的比例 | TOC + TOB |
|
||||
| 发票开具及时率 | 发票按时开具的比例 | TOC + TOB |
|
||||
|
||||
#### 多商户结算与财务闭环
|
||||
|
||||
| KPI 指标 | 描述 | 适用业务类型 |
|
||||
| ------- | ------------ | --------- |
|
||||
| 结算准确率 | 结算金额的准确性 | TOC + TOB |
|
||||
| 结算时效 | 从交易到结算的时间 | TOC + TOB |
|
||||
| 分润准确率 | 分润计算的准确性 | TOC + TOB |
|
||||
| 提现成功率 | 提现申请成功的比例 | TOC + TOB |
|
||||
| 对账差异率 | 财务对账的差异比例 | TOC + TOB |
|
||||
|
||||
#### 多商户商品与订单管理闭环
|
||||
|
||||
| KPI 指标 | 描述 | 适用业务类型 |
|
||||
| -------- | ------------ | --------- |
|
||||
| 商品审核通过率 | 通过审核的商品比例 | TOC + TOB |
|
||||
| 订单分配准确率 | 订单分配的准确性 | TOC + TOB |
|
||||
| 库存同步准确率 | 多商户库存同步的准确性 | TOC + TOB |
|
||||
| 超卖率 | 库存超卖的比例 | TOC + TOB |
|
||||
| 物流轨迹覆盖率 | 可追踪物流的订单比例 | TOC + TOB |
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣1️⃣ 多商户入驻与认证闭环(Merchant Registration & Authentication Loop)
|
||||
|
||||
- **目标**:支持多商户入驻、资质认证、店铺创建,实现平台化运营。
|
||||
- **流程**:
|
||||
1. **商户注册**:
|
||||
- 商户自助注册(邮箱/手机/企业信息)
|
||||
- 资质文件上传(营业执照、法人身份证等)
|
||||
- 账户类型选择(企业/个人)
|
||||
2. **资质认证**:
|
||||
- 自动审核 + 人工复核
|
||||
- 企业信息验证、信用检查
|
||||
- 行业资质合规检查
|
||||
3. **店铺创建**:
|
||||
- 店铺基础信息配置
|
||||
- 绑定平台店铺(Amazon、Shopee等)
|
||||
- 支付账户配置
|
||||
- **决策点**:
|
||||
- 资质审核标准(行业合规、信用评级)
|
||||
- 商户等级划分(普通/优质/战略)
|
||||
- 入驻门槛设置
|
||||
- **输入**:商户注册信息、资质文件、企业证明
|
||||
- **输出**:商户ID、认证状态、店铺ID
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣2️⃣ 功能模块化与权限控制闭环(Feature Modularization & Permission Control Loop)
|
||||
|
||||
- **目标**:将系统功能模块化,支持按商户收费,精细化权限控制。
|
||||
- **流程**:
|
||||
1. **功能模块定义**:
|
||||
- 基础功能(商品管理、订单管理)
|
||||
- 增值功能(广告投放、数据分析)
|
||||
- 高级功能(API对接、定制化开发)
|
||||
2. **模块配置**:
|
||||
- 功能开关控制
|
||||
- 使用配额限制
|
||||
- 计费规则配置
|
||||
3. **权限体系**:
|
||||
- 角色定义(管理员、运营、财务等)
|
||||
- 细粒度权限分配
|
||||
- 数据隔离(租户/商户/店铺)
|
||||
- **决策点**:
|
||||
- 模块定价策略
|
||||
- 权限继承规则
|
||||
- 数据隔离级别
|
||||
- **输入**:商户ID、功能需求、角色配置
|
||||
- **输出**:功能模块列表、权限配置、数据隔离规则
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣3️⃣ 功能开通与支付闭环(Feature Activation & Payment Loop)
|
||||
|
||||
- **目标**:商户选购功能模块、支付费用、开通服务。
|
||||
- **流程**:
|
||||
1. **功能选购**:
|
||||
- 展示功能模块和价格
|
||||
- 选择订阅周期(月/季/年)
|
||||
- 选择配套服务(培训、技术支持)
|
||||
2. **费用计算**:
|
||||
- 基础费用 + 增值服务费用
|
||||
- 使用量计费(订单数、商品数等)
|
||||
- 优惠活动计算
|
||||
3. **支付流程**:
|
||||
- 在线支付(支付宝、微信、银行卡)
|
||||
- 账户余额扣款
|
||||
- 发票开具
|
||||
4. **服务开通**:
|
||||
- 支付成功后自动开通
|
||||
- 配置生效通知
|
||||
- 服务期开始计时
|
||||
- **决策点**:
|
||||
- 支付方式选择
|
||||
- 发票类型(普通/增值税)
|
||||
- 续费提醒策略
|
||||
- **输入**:商户ID、选购功能、支付方式
|
||||
- **输出**:开通记录、支付凭证、服务状态
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣4️⃣ 多商户结算与财务闭环(Multi-Merchant Settlement & Finance Loop)
|
||||
|
||||
- **目标**:多商户资金结算、收益分润、账务核对。
|
||||
- **流程**:
|
||||
1. **交易清算**:
|
||||
- 订单收入汇总
|
||||
- 平台服务费扣除
|
||||
- 商户应得收益计算
|
||||
2. **结算周期**:
|
||||
- 按日/周/月结算
|
||||
- 自动打款或申请提现
|
||||
- 结算单生成
|
||||
3. **分润管理**:
|
||||
- 分润规则配置
|
||||
- 多级分销/代理分润
|
||||
- 分润计算与发放
|
||||
4. **财务对账**:
|
||||
- 商户账户流水核对
|
||||
- 异常交易处理
|
||||
- 财务报表生成
|
||||
- **决策点**:
|
||||
- 结算门槛(最低提现金额)
|
||||
- 手续费规则
|
||||
- 账期调整
|
||||
- **输入**:交易数据、商户结算规则、分润配置
|
||||
- **输出**:结算单、账户余额、财务报表
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣5️⃣ 多商户商品与订单管理闭环(Multi-Merchant Product & Order Management Loop)
|
||||
|
||||
- **目标**:多商户商品上架、订单分配、库存同步管理。
|
||||
- **流程**:
|
||||
1. **商品管理**:
|
||||
- 商户自有商品上传
|
||||
- 平台商品池共享
|
||||
- 商品审核(合规、质量)
|
||||
2. **订单分配**:
|
||||
- 订单智能分配(有库存优先/距离优先/评分优先)
|
||||
- 商户抢单模式
|
||||
- 异常订单人工处理
|
||||
3. **库存同步**:
|
||||
- 多商户库存汇总
|
||||
- 实时库存同步
|
||||
- 预占/扣减机制
|
||||
4. **多商户物流**:
|
||||
- 商户自有物流或平台物流
|
||||
- 物流轨迹共享
|
||||
- 签收确认
|
||||
- **决策点**:
|
||||
- 商品上架审核标准
|
||||
- 订单分配策略
|
||||
- 库存超卖防护
|
||||
- **输入**:商品数据、订单数据、库存数据
|
||||
- **输出**:商品状态、订单分配结果、物流信息
|
||||
|
||||
***
|
||||
|
||||
### 🔍 追踪与审计
|
||||
|
||||
- **追踪四元组**:
|
||||
- **追踪五元组**:
|
||||
- `tenantId`:租户 ID(业务隔离)
|
||||
- `shopId`:店铺 ID(平台/店铺隔离)
|
||||
- `taskId`:任务 ID(任务/规则触发归档)
|
||||
@@ -962,3 +1224,59 @@
|
||||
|
||||
***
|
||||
|
||||
### 🗄️ 数据库规范与约束
|
||||
|
||||
#### 表命名规范
|
||||
|
||||
| 规则 | 要求 | 示例 |
|
||||
|------|------|------|
|
||||
| **表前缀** | 所有表必须以 `cf_` 开头 | `cf_product`, `cf_order`, `cf_shop` |
|
||||
| **模块标识** | 按模块添加子前缀 | `cf_ai_` (AI模块), `cf_logistics_` (物流) |
|
||||
| **命名风格** | 小写 + 下划线分隔 | `cf_consumer_orders`, `cf_ad_campaigns` |
|
||||
|
||||
#### 核心表清单
|
||||
|
||||
| 表名 | 模块 | 说明 | 五元组追踪 |
|
||||
|------|------|------|------------|
|
||||
| `cf_tenant` | 租户 | 租户信息 | ✅ tenantId |
|
||||
| `cf_shop` | 店铺 | 店铺信息 | ✅ tenantId, shopId |
|
||||
| `cf_product` | 商品 | 商品主数据 | ✅ tenantId, shopId, traceId |
|
||||
| `cf_product_sku` | 商品 | SKU变体 | ✅ tenantId, shopId, traceId |
|
||||
| `cf_consumer_orders` | 订单 | C端订单 | ✅ tenantId, shopId, traceId |
|
||||
| `cf_supplier` | 供应链 | 供应商信息 | ✅ tenantId, traceId |
|
||||
| `cf_inventory` | 库存 | 库存记录 | ✅ tenantId, shopId, traceId |
|
||||
| `cf_user` | 用户 | 系统用户 | ✅ tenantId |
|
||||
| `cf_audit_log` | 审计 | 操作日志 | ✅ 五元组完整 |
|
||||
|
||||
#### 字段规范
|
||||
|
||||
| 字段类型 | 规范 | 禁止 |
|
||||
|----------|------|------|
|
||||
| **金额** | `decimal(10,2)` | ❌ float/double |
|
||||
| **物理属性** | 长度(cm), 重量(kg), 体积(m³) | - |
|
||||
| **JSON数据** | 序列化存储,解析后使用 | - |
|
||||
| **时间戳** | `created_at`, `updated_at` 必填 | - |
|
||||
|
||||
#### 追踪五元组字段(所有业务表必须)
|
||||
|
||||
```typescript
|
||||
{
|
||||
tenantId: string; // 租户ID - 业务隔离
|
||||
shopId: string; // 店铺ID - 平台/店铺隔离
|
||||
taskId: string; // 任务ID - 任务追踪
|
||||
traceId: string; // 链路追踪ID - 全链路唯一
|
||||
businessType: 'TOC' | 'TOB'; // 业务类型
|
||||
}
|
||||
```
|
||||
|
||||
#### 数据完整性约束
|
||||
|
||||
| 约束 | 要求 |
|
||||
|------|------|
|
||||
| **唯一约束** | `cf_product` 表必须保证 (platform, productId) 唯一 |
|
||||
| **外键约束** | 关键关联必须建立外键 |
|
||||
| **幂等性** | 所有建表语句必须使用 `db.schema.hasTable` 前置校验 |
|
||||
| **安全约束** | **⚠️ 严禁** 执行 `DROP`, `TRUNCATE` 等破坏性操作 |
|
||||
|
||||
***
|
||||
|
||||
|
||||
@@ -1,195 +0,0 @@
|
||||
# 📦 Crawlful Hub 业务功能汇总(Business Functions)
|
||||
|
||||
> **定位**:核心业务功能规格书,整合了各模块及操作逻辑,排除 AGI 技术架构,仅保留业务逻辑。
|
||||
|
||||
***
|
||||
|
||||
## 1. 核心业务闭环 (Business Loops)
|
||||
|
||||
- **商品刊登闭环**: ERP 商品 (SPU/SKU) → 平台可售。支持刊登任务重试、失败定位、全链路追踪。
|
||||
- **订单履约闭环**: 平台订单拉取 → 妥投/关闭。支持分仓/占库/扣库、发货回传、异常人工介入。
|
||||
- **售后逆向闭环**: 售后请求 → 退款完成。包含退货入仓、质检、库存流水调整、退款门禁审核。
|
||||
- **资金对账闭环**: 平台结算/费用/退款流水 → 差异关闭。汇率换算明确,可回溯到订单/费用明细。
|
||||
- **合规风控闭环**: 风险信号 → 放行/拦截/复核。全链路审计,门禁状态可视化。
|
||||
|
||||
***
|
||||
|
||||
## 2. 订单管理系统 (OMS)
|
||||
|
||||
- **多源订单归集**: 跨平台订单统一归集,按 `tenantId` 隔离。
|
||||
- **自动审单**: 地址、库存、风险验证规则引擎自动审核。
|
||||
- **异常处理**: 缺货、地址异常、支付失败进入异常队列,支持人工介入。
|
||||
- **批量操作**: 审核、发货、标记、打印面单。
|
||||
|
||||
***
|
||||
|
||||
## 3. 库存与仓储管理 (WMS)
|
||||
|
||||
- **多仓库存管理**: 多仓库库存统一视角,支持仓际调拨。
|
||||
- **全球仓储管理**: 多国仓、在途库存、跨仓调拨、安全库存预警。
|
||||
- **实时同步**: 平台库存实时对账,乐观锁防止超卖。
|
||||
- **进出库流水**: ASN 预报、盲收/点收、QC 质检、循环盘点、报损记录。
|
||||
- **物流模式管理**:
|
||||
- 整柜出海 (FCL Shipping)
|
||||
- 自有仓出货
|
||||
- 第三方仓出货 (3PL)
|
||||
- 直发客户 (D2C / Dropship)
|
||||
|
||||
***
|
||||
|
||||
## 4. 财务管理 (FIN)
|
||||
|
||||
- **利润实时核算**: 销售收入 - 采购成本 - 物流 - 平台费 - 广告。
|
||||
- **成本归集**: 头程/尾程物流、平台佣金、广告投入。
|
||||
- **多币种对账**: 支持 VAT 计提,汇率自动同步。
|
||||
- **ROI 看板**: 实时显示业务决策对财务贡献。
|
||||
|
||||
***
|
||||
|
||||
## 5. 供应链与供应商管理
|
||||
|
||||
- **供应商档案**: 信用分级、联系方式、评分管理。
|
||||
- **采购管理**:
|
||||
- 1688 一键代采、实时比价
|
||||
- 多供应商询价、MOQ、交期对比
|
||||
- **补货建议**: `(销量预测 * 采购周期 + 安全库存 - 在途)` 自动生成。
|
||||
|
||||
***
|
||||
|
||||
## 6. 营销与调价建议 (MKT)
|
||||
|
||||
- **智能调价 (Dynamic Pricing)**: 市场竞争响应,推荐最优价格。
|
||||
- **广告计划管理**: 跨平台广告统一管理,动态预算调优,健康度监控,ROI 精准核算。
|
||||
- **全链路归因**: 广告投放 → 流量 → 订单转化。
|
||||
|
||||
***
|
||||
|
||||
## 7. 治理与审批中心
|
||||
|
||||
- **通用审批中心**: 大额订单、价格变更、退款等敏感操作多级审核。
|
||||
- **UI 布局**: 待办/已办统计,审批日志,核准/拒绝动作。
|
||||
|
||||
***
|
||||
|
||||
## 8. 合规与证书管理
|
||||
|
||||
- **自动化合规**: 订单数据生成 CE、FDA、原产地证等电子证书。
|
||||
- **信用分级**: 基于配送员履约率、争议率的信用体系。
|
||||
|
||||
***
|
||||
|
||||
|
||||
|
||||
## 9. 套利与定价分析 (ARB / Pricing) — TOC + TOB 全链路
|
||||
|
||||
### 核心定位
|
||||
|
||||
* 支持 **零售(TOC)** 和 **批发/整柜(TOB)** 套利分析。
|
||||
* 覆盖 **从生产/采购阶段 → 拿货/整柜阶段 → 零售/平台销售阶段** 的利润分析。
|
||||
* 提供 **定价推荐、ROI 模拟、利润预测和风险提示**。
|
||||
|
||||
### 核心功能
|
||||
|
||||
1. **成本与利润测算**
|
||||
|
||||
* **TOC**:单件商品成本 + 平台费 + 物流 + 广告 → 售价 / ROI / 利润预测
|
||||
* **TOB**:整柜成本、批量采购成本、关税、物流 → 单件拆算利润、ROI
|
||||
* 支持 **固定成本与浮动成本**组合计算(如汇率、运费波动、关税变化)
|
||||
|
||||
2. **定价推荐与模拟**
|
||||
|
||||
* 自动推荐售价区间以满足目标毛利率或 ROI 红线
|
||||
* 支持批量调价、不同平台定价差异、整柜与零售拆算定价
|
||||
* 可模拟不同库存、销量、物流方式下的利润变化
|
||||
|
||||
3. **套利机会发现**
|
||||
|
||||
* **跨平台零售套利**:基于采集价格或手动录入的成本分析价差
|
||||
* **跨阶段 TOB 套利**:生产采购成本 vs 平台/批发售价,输出净利和 ROI
|
||||
* **跨国家/跨仓套利**:考虑关税、仓储成本、物流方式的最优利润路径
|
||||
|
||||
4. **供应链阶段利润分析**
|
||||
|
||||
* **生产阶段**:原材料采购、工厂成本、生产周期成本
|
||||
* **拿货阶段**:整柜成本、运输成本、报关费用、税费
|
||||
* **零售阶段**:平台费用、广告投入、物流派送、售后成本
|
||||
* 支持全链路可视化报表,显示每个环节对利润的贡献
|
||||
|
||||
5. **多维度分析报表**
|
||||
|
||||
* **商品维度**:每 SKU/整柜商品成本、售价、ROI、利润预测
|
||||
* **阶段维度**:生产 → 拿货 → 零售,每阶段成本、利润占比
|
||||
* **平台 / 渠道维度**:各平台毛利率、利润贡献度、风险提示
|
||||
* **时间维度**:预测未来收益、库存消耗、套利机会变化
|
||||
|
||||
---
|
||||
|
||||
### 业务流示意(文字版)
|
||||
|
||||
```text
|
||||
生产阶段 / 原材料采购
|
||||
│
|
||||
▼
|
||||
拿货 / 整柜阶段
|
||||
│
|
||||
▼
|
||||
套利分析模块(TOB + TOC)
|
||||
├─ 成本测算(固定/浮动)
|
||||
├─ 定价推荐 & ROI 模拟
|
||||
├─ 跨平台 / 跨阶段套利机会
|
||||
└─ 全链路利润分析报表
|
||||
│
|
||||
▼
|
||||
商品刊登 / 调价执行
|
||||
│
|
||||
▼
|
||||
OMS / WMS / 财务 / 营销全链路闭环
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
💡 **说明**:
|
||||
|
||||
* 套利模块不再仅局限于零售价格分析,而是 **全链路利润智能分析引擎**
|
||||
* TOB & TOC 都可用同一个套利模块,只是输入数据和分析粒度不同
|
||||
* 定价推荐和 ROI 模拟可以贯穿 **生产、拿货、整柜、零售**每个环节
|
||||
* 为全链路决策提供支持:采购、库存、销售、物流、营销
|
||||
|
||||
---
|
||||
|
||||
|
||||
## 10. B2B / TOB 贸易管理
|
||||
|
||||
- **报价红线控制**: 利润率低于阈值自动拦截,支持多级审批。
|
||||
- **阶梯价策略**: 采购数量触发阶梯折扣。
|
||||
- **信用池**: 基于历史履约记录的结算额度与审计。
|
||||
- **询盘管理**: 多渠道整合询盘,支持跟进与转化。
|
||||
|
||||
***
|
||||
|
||||
## 11. 产品采集与数据分析
|
||||
|
||||
- **多平台采集**: Amazon, eBay, Shopee, 1688 等平台商品信息抓取。
|
||||
- **数据标准化**: SKU 属性、价格、库存统一格式化。
|
||||
- **分析支持**: ARB、PIM、营销调价、库存补货预测的数据基础。
|
||||
|
||||
***
|
||||
|
||||
## 12. 行业标杆映射
|
||||
|
||||
| 业务领域 | 标杆参考 | 核心复刻重点 |
|
||||
| :------------ | :-------------------- | :-------------- |
|
||||
| **商品 (PIM)** | 91妙手、店小秘 | 多平台刊登与库存统一 |
|
||||
| **套利 (ARB)** | 船长BI、Helium 10 | 跨平台寻源与实时利润测算 |
|
||||
| **订单 (OMS)** | 易仓、积加 | 多源归集与自动化审单 |
|
||||
| **独立站 (DTC)** | Shopify | 流量归因与多租户隔离 |
|
||||
| **仓储 (WMS)** | Flexport | 路径规划与多仓协同 |
|
||||
| **财务 (FIN)** | 出海匠 | 全口径利润审计与回款跟踪 |
|
||||
| **营销 (MKT)** | 蝉妈妈 | 趋势分析与数据可视化 |
|
||||
| **供应链 / 采购** | 1688 + 供应商管理工具 | 补货建议、采购比价、供应商信用 |
|
||||
| **物流模式** | FCL / Own / 3PL / D2C | 全球物流路径、调拨、直发客户 |
|
||||
| **审批与合规** | 内部审批 & 电子证书 | 敏感操作审核、证书生成 |
|
||||
| **B2B 贸易管理** | 内部 TOB 系统 | 阶梯价、信用池、询盘管理 |
|
||||
|
||||
***
|
||||
|
||||
@@ -22,7 +22,9 @@
|
||||
## 2. 任务规格与代码注释 (Task & JSDoc)
|
||||
|
||||
### 2.1 任务规格模板 (Task Template)
|
||||
- **ID**: `[FE/BE/EX]_[序号]` (FE: 前端, BE: 后端, EX: 插件)。
|
||||
- **ID**: `[模块]-[子模块][序号]` (如 `BE-P001`, `FE-O001`, `PL-C001`)
|
||||
- 模块: FE(前端), BE(后端), PL(插件), AI(AI), DT(数据), OP(运维)
|
||||
- 子模块: P(商品), O(订单), F(财务), I(库存), C(采集), A(广告) 等
|
||||
- **验收**: 功能测试通过、符合规范、文档同步更新。
|
||||
|
||||
### 2.2 代码注释 (JSDoc)
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 🗂 Crawlful Hub AI开发任务总览(Task Overview)
|
||||
|
||||
> **说明**:本任务表基于30个业务闭环拆解,专为100% AI开发设计,包含完整的任务依赖、数据流、触发条件和状态管理。
|
||||
> **说明**:本任务表基于35个业务闭环拆解,专为100% AI开发设计,包含完整的任务依赖、数据流、触发条件和状态管理。
|
||||
|
||||
---
|
||||
|
||||
@@ -33,13 +33,13 @@
|
||||
|
||||
| 模块 | 总任务数 | 已完成 | 进行中 | 待处理 | 失败 | 完成率 |
|
||||
|------|----------|--------|--------|--------|------|--------|
|
||||
| 前端模块 | 20 | 2 | 1 | 17 | 0 | 10% |
|
||||
| 后端模块 | 33 | 15 | 2 | 16 | 0 | 45% |
|
||||
| 插件模块 | 14 | 1 | 1 | 12 | 0 | 7% |
|
||||
| AI模块 | 15 | 2 | 0 | 13 | 0 | 13% |
|
||||
| 前端模块 | 30 | 2 | 0 | 28 | 0 | 7% |
|
||||
| 后端模块 | 53 | 23 | 0 | 30 | 0 | 43% |
|
||||
| 插件模块 | 14 | 1 | 0 | 13 | 0 | 7% |
|
||||
| AI模块 | 17 | 3 | 0 | 14 | 0 | 18% |
|
||||
| 数据模块 | 10 | 2 | 0 | 8 | 0 | 20% |
|
||||
| 运维模块 | 3 | 2 | 0 | 1 | 0 | 67% |
|
||||
| **总计** | **95** | **24** | **4** | **67** | **0** | **25%** |
|
||||
| **总计** | **127** | **33** | **0** | **94** | **0** | **26%** |
|
||||
|
||||
---
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
|---------|----------|----------|------|------|----------|------|--------|------|----------|--------|
|
||||
| FE-O001 | 订单履约闭环 | 渲染订单列表页面 | 用户ID, 筛选条件 | 订单列表数据 | 页面加载 | 🟡 in_progress | P0 | - | 3h | AI-Frontend-1 |
|
||||
| FE-O001 | 订单履约闭环 | 渲染订单列表页面 | 用户ID, 筛选条件 | 订单列表数据 | 页面加载 | ⏳ pending | P0 | - | 3h | AI-Frontend-1 |
|
||||
| FE-O002 | 订单履约闭环 | 渲染订单详情页面 | 订单ID | 订单详情数据 | 点击订单 | ⏳ pending | P1 | FE-O001 | 2.5h | AI-Frontend-2 |
|
||||
| FE-O003 | 订单集中管理闭环 | 多平台订单聚合展示 | 平台ID, 时间范围 | 聚合订单数据 | 页面加载 | ⏳ pending | P1 | FE-O001 | 2h | AI-Frontend-3 |
|
||||
| FE-O004 | 异常订单处理闭环 | 异常订单处理界面 | 订单ID | 处理结果 | 点击处理 | ⏳ pending | P1 | FE-O002 | 2h | AI-Frontend-3 |
|
||||
@@ -138,6 +138,10 @@
|
||||
| BE-P002 | SKU变体与结构闭环 | SKU变体管理接口 | 商品ID, 变体属性 | SKU ID, 库存 | 前端提交 | ✅ completed | P1 | BE-P001 | 1.5h | AI-Backend-1 |
|
||||
| BE-P003 | 商品刊登闭环 | 商品刊登接口 | 商品ID, 平台ID | 刊登结果 | 前端提交 | ✅ completed | P0 | BE-P001 | 2h | AI-Backend-2 |
|
||||
| BE-P004 | 定价与利润决策闭环 | 动态定价计算接口 | 商品ID, 市场数据 | 建议售价 | 定时触发 | ✅ completed | P1 | BE-P001 | 2.5h | AI-Backend-2 |
|
||||
| BE-P005 | 数据采集与清洗闭环 | 平台API对接服务(Amazon MWS) | API凭证, 商品ASIN | 商品数据 | 定时任务 | ✅ completed | P0 | BE-P001 | 8h | AI-Backend-2 |
|
||||
| BE-P006 | 数据采集与清洗闭环 | 平台API对接服务(eBay API) | OAuth令牌, 商品ID | 商品数据 | 定时任务 | ⏳ pending | P0 | BE-P001 | 8h | AI-Backend-2 |
|
||||
| BE-P007 | 数据采集与清洗闭环 | 平台API对接服务(Shopee API) | API密钥, 商品ID | 商品数据 | 定时任务 | ⏳ pending | P0 | BE-P001 | 8h | AI-Backend-3 |
|
||||
| BE-P008 | 数据采集与清洗闭环 | 平台同步Worker(BullMQ) | 同步任务, 五元组 | 同步结果 | 队列触发 | ✅ completed | P0 | BE-P005 | 4h | AI-Backend-2 |
|
||||
|
||||
### 2.2 订单管理后端
|
||||
|
||||
@@ -243,25 +247,65 @@
|
||||
| BE-AUTH002 | 认证服务 | 权限管理 | 用户ID, 权限 | 权限列表 | 前端请求 | ⏳ pending | P2 | BE-AUTH001 | 8h | AI-Backend-11 |
|
||||
| BE-AUTH003 | 认证服务 | 会话管理 | 用户ID, 令牌 | 会话信息 | 请求验证 | ⏳ pending | P2 | BE-AUTH001 | 8h | AI-Backend-11 |
|
||||
|
||||
### 2.15 多商户功能收费后端【P1 高优先级 - 新增】
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
|---------|----------|----------|------|------|----------|------|--------|------|----------|--------|
|
||||
| BE-MV001 | 多商户入驻闭环 | 商户注册与认证接口 | 商户信息, 资质文件 | 商户ID, 状态 | 前端提交 | ⏳ pending | P1 | - | 12h | AI-Backend-12 |
|
||||
| BE-MV002 | 多商户入驻闭环 | 商户店铺管理 | 商户ID, 店铺信息 | 店铺ID | 前端提交 | ⏳ pending | P1 | BE-MV001 | 10h | AI-Backend-12 |
|
||||
| BE-MV003 | 功能模块化闭环 | 功能模块管理 | 模块ID, 配置 | 模块状态 | 系统配置 | ⏳ pending | P1 | BE-MV001 | 8h | AI-Backend-12 |
|
||||
| BE-MV004 | 功能开通与支付闭环 | 功能开通接口 | 商户ID, 模块ID | 开通记录 | 前端提交 | ⏳ pending | P1 | BE-MV003 | 10h | AI-Backend-12 |
|
||||
| BE-MV005 | 功能开通与支付闭环 | 功能费用计算 | 商户ID, 使用数据 | 费用明细 | 定时任务 | ⏳ pending | P1 | BE-MV004 | 8h | AI-Backend-12 |
|
||||
| BE-MV006 | 多商户结算闭环 | 商户结算引擎 | 商户ID, 结算周期 | 结算单 | 定时任务 | ⏳ pending | P1 | BE-MV005 | 12h | AI-Backend-12 |
|
||||
| BE-MV007 | 多商户订单闭环 | 多商户订单拆分 | 订单ID, 商户列表 | 子订单列表 | 订单创建 | ⏳ pending | P1 | BE-MV002 | 10h | AI-Backend-12 |
|
||||
| BE-MV008 | 多商户库存闭环 | 多商户库存同步 | 商户ID, 库存数据 | 同步状态 | 库存变化 | ⏳ pending | P1 | BE-MV002 | 8h | AI-Backend-12 |
|
||||
|
||||
---
|
||||
|
||||
## 🔌 3️⃣ 插件模块(外部平台操作 / 调度)
|
||||
|
||||
### 3.1 平台采集插件
|
||||
|
||||
**对应业务闭环**: [1️⃣ 数据采集与清洗闭环](./Business_ClosedLoops.md#1️⃣-数据采集与清洗闭环product-data-collection--cleansing)
|
||||
|
||||
**采集策略**: 仅处理无API平台(TikTok Shop, Temu, 1688部分页面),有API平台由后端处理
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
|---------|----------|----------|------|------|----------|------|--------|------|----------|--------|
|
||||
| PL-C001 | 数据采集与清洗闭环 | 多平台商品采集 | 平台账号, 采集配置 | 原始商品数据 | 定时任务 | ✅ completed | P0 | - | 3h | AI-Plugin-1 |
|
||||
| PL-C002 | 数据采集与清洗闭环 | DOM解析逻辑 | HTML内容 | 结构化数据 | 采集完成 | <EFBFBD> in_progress | P1 | PL-C001 | 2h | AI-Plugin-2 |
|
||||
| PL-C003 | 订单集中管理闭环 | 多平台订单采集 | 平台账号, 时间范围 | 订单数据 | 定时任务 | ⏳ pending | P0 | PL-C001 | 3h | AI-Plugin-1 |
|
||||
| PL-C001 | 数据采集与清洗闭环 | 无API平台商品采集引擎 | 店铺ID, 平台类型, 采集配置, 指纹配置, 代理IP | 原始商品数据(JSON) | 定时任务/后端指令 | ✅ completed | P0 | - | 3h | AI-Plugin-1 |
|
||||
| PL-C002 | 数据采集与清洗闭环 | DOM解析与数据提取 | HTML内容, CSS选择器配置 | 结构化商品数据 | 采集完成 | ⏳ pending | P1 | PL-C001 | 2h | AI-Plugin-2 |
|
||||
| PL-C003 | 订单集中管理闭环 | 无API平台订单采集 | 店铺ID, 平台账号, 时间范围, 登录状态 | 订单数据(JSON) | 定时任务/后端指令 | ⏳ pending | P0 | PL-C001 | 3h | AI-Plugin-1 |
|
||||
|
||||
**技术约束**:
|
||||
- 必须通过店铺隔离环境执行(独立指纹+代理IP)
|
||||
- 采集频率受平台反爬限制,需实现自适应频率控制
|
||||
- 数据通过HTTP POST上报后端,携带traceId和shopId
|
||||
|
||||
### 3.2 自动化操作插件
|
||||
|
||||
**对应业务闭环**: [1️⃣7️⃣ 店铺隔离与自动化闭环](./Business_ClosedLoops.md#1️⃣7️⃣-店铺隔离与自动化闭环shop-isolation--automation-loop)
|
||||
|
||||
**核心功能**: 店铺环境隔离 + 无API平台自动化操作
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
|---------|----------|----------|------|------|----------|------|--------|------|----------|--------|
|
||||
| PL-A001 | 店铺隔离与自动化闭环 | 自动化登录与操作 | 店铺ID, 操作类型 | 操作结果 | 任务触发 | ⏳ pending | P1 | PL-C001 | 2.5h | AI-Plugin-2 |
|
||||
| PL-A002 | 商家选择发货闭环 | 商家发货操作 | 订单ID, 发货信息 | 发货状态 | 商家操作 | ⏳ pending | P1 | PL-C003 | 2h | AI-Plugin-3 |
|
||||
| PL-A003 | 物流策略与渠道选择闭环 | 物流状态同步 | 订单ID | 物流信息 | 定时任务 | ⏳ pending | P2 | PL-A002 | 1.5h | AI-Plugin-3 |
|
||||
| PL-A001 | 店铺隔离与自动化闭环 | 浏览器指纹与代理管理 | 店铺ID, 指纹配置, 代理IP | 隔离环境上下文 | 店铺初始化 | ⏳ pending | P1 | PL-C001 | 2.5h | AI-Plugin-2 |
|
||||
| PL-A002 | 商家选择发货闭环 | 无API平台自动化发货 | 订单ID, 发货信息, 店铺凭证 | 发货状态, 物流单号 | 后端指令 | ⏳ pending | P1 | PL-C003 | 2h | AI-Plugin-3 |
|
||||
| PL-A003 | 物流策略与渠道选择闭环 | 物流状态同步 | 订单ID, 物流单号, 平台类型 | 物流轨迹数据 | 定时任务 | ⏳ pending | P2 | PL-A002 | 1.5h | AI-Plugin-3 |
|
||||
|
||||
**插件管理架构**:
|
||||
```
|
||||
后端(TaskScheduler) ──WebSocket──► 插件(Background) ──Chrome Message──► 内容脚本(Content)
|
||||
▲ │
|
||||
└────────────────── HTTP POST ─────────────────────────────────┘
|
||||
```
|
||||
|
||||
**通讯协议**:
|
||||
| 方向 | 协议 | 消息类型 | 用途 |
|
||||
|------|------|----------|------|
|
||||
| 后端→插件 | WebSocket | `TASK_ASSIGN` | 任务下发 |
|
||||
| 插件→后端 | HTTP POST | `TASK_COMPLETE` | 结果上报 |
|
||||
| 插件→后端 | HTTP POST | `HEARTBEAT` | 心跳保活 |
|
||||
|
||||
### 3.3 售后逆向插件【P0 阻塞核心业务】
|
||||
|
||||
@@ -409,10 +453,10 @@
|
||||
|----------|------|----------|----------|----------|------|
|
||||
| createProduct | 后端 | 商品基础信息 | 商品ID, 状态 | 用户提交 | ✅ completed |
|
||||
| getProductList | 后端 | 筛选条件, 分页 | 商品列表 | 页面加载 | ✅ completed |
|
||||
| createOrder | 后端 | 用户ID, 商品ID, 数量 | 订单ID, 状态 | 用户提交 | 🟡 in_progress |
|
||||
| getOrderList | 后端 | 用户ID, 筛选条件 | 订单列表 | 页面加载 | 🟡 in_progress |
|
||||
| createOrder | 后端 | 用户ID, 商品ID, 数量 | 订单ID, 状态 | 用户提交 | ✅ completed |
|
||||
| getOrderList | 后端 | 用户ID, 筛选条件 | 订单列表 | 页面加载 | ✅ completed |
|
||||
| syncInventory | 后端 | 商品ID, 库存变化 | 库存状态 | 库存变化 | ✅ completed |
|
||||
| reconcileFinance | 后端 | 时间范围, 平台ID | 对账结果 | 定时任务 | 🟡 in_progress |
|
||||
| reconcileFinance | 后端 | 时间范围, 平台ID | 对账结果 | 定时任务 | ✅ completed |
|
||||
| fetchPlatformData | 插件 | 平台账号, 配置 | 原始数据 | 定时任务 | ✅ completed |
|
||||
| analyzeArbitrage | AI | 商品价格, 成本 | 套利建议 | 数据更新 | ⏳ pending |
|
||||
| createAdPlan | 后端 | 广告参数 | 广告ID | 前端提交 | ⏳ pending |
|
||||
@@ -470,13 +514,19 @@
|
||||
- ⏳ 测试用例与质量保证【P3】
|
||||
- ⏳ 系统监控与告警优化
|
||||
|
||||
### Phase 5: 多商户功能收费(Week 9-10)【新增】
|
||||
- ⏳ 商户注册与入驻闭环
|
||||
- ⏳ 功能模块化与权限控制
|
||||
- ⏳ 功能开通与支付闭环
|
||||
- ⏳ 多商户结算与财务闭环
|
||||
|
||||
---
|
||||
|
||||
## 🎯 质量指标
|
||||
|
||||
| 指标 | 目标值 | 当前值 | 状态 |
|
||||
|------|--------|--------|------|
|
||||
| 任务完成率 | 100% | 25% | 🟡 需提升 |
|
||||
| 任务完成率 | 100% | 21% | 🟡 需提升 |
|
||||
| 代码测试覆盖率 | 80% | 30% | 🟡 需提升 |
|
||||
| 接口响应时间 | <200ms | - | ⏳ 待测试 |
|
||||
| 系统可用性 | 99.9% | - | ⏳ 待监控 |
|
||||
|
||||
Reference in New Issue
Block a user