chore: 清理归档文件和文档模板

删除不再需要的归档文件和过时的文档模板,包括多个README、安全策略、前端集成蓝图等文件,同时移除了未使用的业务文档和项目结构文件。

优化项目结构,移除冗余文件,保持代码库整洁。主要删除archive/handover目录下的多个文件及doc目录下的部分文档模板。
This commit is contained in:
2026-03-18 01:21:15 +08:00
parent 56b8a2e2f8
commit 72cd7f6f45
147 changed files with 5982 additions and 16716 deletions

View File

@@ -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 全链路**
* 支持多币种采购、整柜成本、平台销售价格统一计算
* 可进行 **利润随汇率波动的敏感性分析**,为定价策略提供数据支持
* 套利模块成为全链路利润智能分析引擎,同时支撑 **零售、批发、整柜、跨国贸易**
---

View File

@@ -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)*

View File

@@ -1,6 +1,6 @@
# 📌 Crawlful Hub 业务闭环TOC + TOB Unified Business Loops
> **说明**:本闭环文档是战略层业务流程,关注做什么、为什么做、顺序和决策点为下层模块功能和系统实现提供指引。TOC零售/前端)和 TOBB2B贸易共享通用模块特有流程用 `businessType` 标记。
> **说明**:本闭环文档是战略层业务流程,关注"做什么、为什么做、顺序和决策点"为下层模块功能和系统实现提供指引。TOC零售/前端)和 TOBB2B贸易共享通用模块特有流程用 `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 @@
- TOBB2B 利润率 < 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` 等破坏性操作 |
***

View File

@@ -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 系统 | 阶梯价、信用池、询盘管理 |
***

View File

@@ -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)

View File

@@ -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% | - | ⏳ 待监控 |