diff --git a/docs/00_Business/Business_9.md b/docs/00_Business/Business_9.md new file mode 100644 index 0000000..1e06095 --- /dev/null +++ b/docs/00_Business/Business_9.md @@ -0,0 +1,77 @@ + +--- + +## 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 全链路** +* 支持多币种采购、整柜成本、平台销售价格统一计算 +* 可进行 **利润随汇率波动的敏感性分析**,为定价策略提供数据支持 +* 套利模块成为全链路利润智能分析引擎,同时支撑 **零售、批发、整柜、跨国贸易** + +--- diff --git a/docs/00_Business/Business_Blueprint.md b/docs/00_Business/Business_Blueprint.md new file mode 100644 index 0000000..786975e --- /dev/null +++ b/docs/00_Business/Business_Blueprint.md @@ -0,0 +1,115 @@ +# 🏢 Business Blueprint (Crawlful Hub) + +> **定位**:Crawlful Hub 业务核心蓝图 - 包含项目目标、技术栈、核心业务模块、状态机及行业标杆参考。 +> **更新日期**: 2026-03-17 + +--- + +## 1. 项目概述 (Project Overview) + +**项目名称**: Crawlful Hub (跨境电商增长中台) + +**项目目标**: +- 实现多渠道电商运营管理(TOC/TOB)。 +- 提供从商品采集到财务对账的完整业务闭环。 +- 提升跨境贸易运营效率与利差套利能力。 + +**主要技术栈**: +- **语言**: TypeScript +- **前端框架**: UmiJS 4.x, Ant Design 5.x +- **后端框架**: Node.js 20+ +- **数据库**: MySQL 8.0 (cf_ 前缀) +- **缓存**: Redis 6.0 + +--- + +## 2. 核心业务模块 (Core Business Modules) + +### 2.1 闭环总览 ⭐⭐⭐ + +#### 闭环验收标准 (P0) +- **商品刊登闭环**: ERP 商品 → 平台可售。要求全链路追踪 (traceId)。 +- **订单履约闭环**: 平台订单 → 妥投。状态机完整,异常可介入。 +- **售后逆向闭环**: 售后请求 → 退款完成。状态流转清晰。 +- **资金对账闭环**: platform 结算流水 → 差异关闭。汇率明确,可回溯。 +- **合规风控闭环**: 风险信号 → 拦截/复核。审计留痕。 + +#### 追踪四元组 (Tracking Quad) +- `tenantId`: 租户 ID (业务隔离) +- `shopId`: 店铺 ID (平台/店铺隔离) +- `taskId`: 任务 ID (任务/规则触发归档) +- `traceId`: 链路追踪 ID (全链路唯一标识) + +### 2.2 模块功能详述 + +#### 1. 商品管理 (PIM) & 跨平台套利 (Arbitrage) +- **跨平台套利雷达**: 自动识别 1688 (价格洼地) 与 Amazon/Temu/eBay (价格高地) 的利差。支持视觉寻源与多模态匹配。 +- **套利净利引擎**: 统一计算口径 `售价 - 采购 - 平台费 - 物流 - 税费 - 汇率对冲 - 售后损耗 - 广告摊销`。 +- **风险门禁**: B2C 利润率 < 20% 触发预警,利润率 < 15% 或 ROI < 20% 标记为高风险,< 5% 强制拦截。 +- **SPU/SKU 管理**: 支持独立站 (Shopify/WooCommerce) 与平台电商的多维度属性映射。 +- **刊登任务**: 支持无 API 平台 (TikTok/Temu) 模拟执行与官方 API 刊登。 + +#### 2. 订单管理 (OMS) & TOB 业务 +- **多渠道归集**: 聚合平台订单与独立站 (DTC) 订单。 +- **TOB 报价红线**: B2B 利润率 < 15% 严禁报价,支持大宗贸易的阶梯价设置与询盘转化。 +- **分账引擎**: 针对 TOB 业务支持主权级信用池 (Sovereign Credit Pool) 与跨境结算审计。 +- **利润核算**: 实时计算单笔订单净利,关联广告支出实现全链路 ROI 溯源。 + +#### 3. 库存与仓储 (WMS) +- **多仓协同**: 实时同步全球多仓库存,支持独立站与平台库存共享/隔离策略。 +- **补货算法**: `(销量预测 * 采购周期 + 安全库存 - 在途)`。支持基于利差热力图的智能补货决策。 +- **入/出库流**: ASN 预报、QC 质检、波次拣货。 + +#### 4. 财务与结算 +- **成本归集**: 采购、头程/尾程物流、佣金、广告。 +- **多币种对账**: ZKP 隐私审计,自动差异匹配。 +- **汇率避险**: 联动多币种汇率避险接口,锁定汇率风险,记录汇兑损益。 + +#### 5. 营销与广告 (MKT) +- **跨平台投放**: 统一管理 Facebook, Google, TikTok 广告。 +- **独立站 DTC 策略**: 针对独立站流量进行全链路归因分析 (Multi-touch Attribution)。 +- **动态优化**: 基于 ROAS 自动调整预算,监控盈亏平衡点 (Break-even ROAS)。 +- **套利闭环回流**: 从选品建议到真实销量回流,持续迭代套利策略。 + +--- + +## 3. 关键业务状态机 (State Machines) + +### 3.1 订单状态机 +- `PULLED` → `PENDING_REVIEW` → `CONFIRMED` → `ALLOCATED` → `READY_TO_SHIP` → `SHIPPED` → `DELIVERED` → `CLOSED` + +### 3.2 业务审核状态机 +- `SUBMITTED` (提交) → `PENDING_REVIEW` (人工审核) → `EXECUTED` / `REJECTED` + +--- + +## 4. 行业标杆复刻方案 (Benchmarks) + +- **ERP 系统**: 像素级还原易仓、店小秘核心逻辑。 +- **TikTok 运营**: 实现 91 妙手同级的无 API 履约与采集能力。 +- **数据分析**: 船长 BI 级的数据归集与可视化看板。 + +--- + +## 5. 项目结构与目录映射 (Directory Map) + +``` +project + ├─ .trae/rules/ # 编码与项目特定规则 + ├─ docs/ # 分类文档 (业务、数据、架构、规范、质量) + ├─ server/src/ # 后端服务 (api, service, repository, domains, workers) + ├─ extension/src/ # 浏览器插件 (background, content) + ├─ console/src/ # 前端控制台 (pages, components, services, stores) +``` + +--- + +## 6. 实施指南摘要 (Implementation Guides) + +### 6.1 TOC 加速架构 +- **快速上线**: 提供 Amazon/AliExpress 基础订单同步。 +- **ConsumerOrderService**: 专责 TOC 订单流。 + +### 6.2 非 SaaS 多租户隔离 +- **数据独占**: `tenant_id` 逻辑隔离,行级安全校验。 +- **资源配额**: 严格限制并发 Worker 与 API 速率。 diff --git a/docs/00_Business/Business_ClosedLoops.md b/docs/00_Business/Business_ClosedLoops.md new file mode 100644 index 0000000..b0070b1 --- /dev/null +++ b/docs/00_Business/Business_ClosedLoops.md @@ -0,0 +1,964 @@ +# 📌 Crawlful Hub 业务闭环(TOC + TOB Unified Business Loops) + +> **说明**:本闭环文档是战略层业务流程,关注“做什么、为什么做、顺序和决策点”,为下层模块功能和系统实现提供指引。TOC(零售/前端)和 TOB(B2B贸易)共享通用模块,特有流程用 `businessType` 标记。 + +## 📑 目录 + +1. [数据采集与清洗闭环](#1️⃣-数据采集与清洗闭环product-data-collection--cleansing) +2. [商品刊登闭环](#2️⃣-商品刊登闭环product-listing-loop) +3. [素材管理闭环](#3️⃣-素材管理闭环media--asset-management-loop) +4. [广告计划与营销闭环](#4️⃣-广告计划与营销闭环marketing--ad-management-loop) +5. [订单履约闭环](#5️⃣-订单履约闭环order-fulfillment-loop--oms) +6. [售后逆向闭环](#6️⃣-售后逆向闭环returns--refunds-loop) +7. [资金对账闭环](#7️⃣-资金对账闭环finance-reconciliation-loop) +8. [库存与仓储管理闭环](#8️⃣-库存与仓储管理闭环inventory--warehouse-management-loop--wms) +9. [供应链与供应商管理闭环](#9️⃣-供应链与供应商管理闭环supply-chain--supplier-management-loop) +10. [B2B / TOB 贸易管理闭环](#🔟-b2b--tob-贸易管理闭环b2b--tob-trade-management-loop) +11. [治理与审批中心闭环](#1️⃣1️⃣-治理与审批中心闭环governance--approval-center-loop) +12. [合规与证书管理闭环](#1️⃣2️⃣-合规与证书管理闭环compliance--certificate-management-loop) +13. [合规与风控闭环](#1️⃣3️⃣-合规与风控闭环compliance--risk-control-loop) +14. [报表与分析闭环](#1️⃣4️⃣-报表与分析闭环reporting--analytics-loop) +15. [定价与利润决策闭环](#1️⃣5️⃣-定价与利润决策闭环pricing--profit-decision-loop) +16. [账号/店铺健康度闭环](#1️⃣6️⃣-账号/店铺健康度闭环accountshop-health-loop) +17. [店铺隔离与自动化闭环](#1️⃣7️⃣-店铺隔离与自动化闭环shop-isolation--automation-loop) +18. [订单集中管理闭环](#1️⃣8️⃣-订单集中管理闭环order-centralized-management-loop) +19. [客户/商家押金与账户管理闭环](#1️⃣9️⃣-客户商家押金与账户管理闭环customer-merchant-deposit--account-management-loop) +20. [商家选择发货闭环](#2️⃣0️⃣-商家选择发货闭环merchant-selective-fulfillment-loop) +21. [回款与财务闭环](#2️⃣1️⃣-回款与财务闭环payment--financial-reconciliation-loop) +22. [海外仓/本土仓 & 多品类支持闭环](#2️⃣2️⃣-海外仓本土仓--多品类支持闭环overseaslocal-warehouse--multi-category-support-loop) +23. [商品主数据闭环](#2️⃣3️⃣-商品主数据闭环product-master-data-loop--mdm) +24. [SKU变体与结构闭环](#2️⃣4️⃣-sku变体与结构闭环sku-variant--structure-loop) +25. [订单拆分与合并闭环](#2️⃣5️⃣-订单拆分与合并闭环order-split--merge-loop) +26. [异常订单处理闭环](#2️⃣6️⃣-异常订单处理闭环exception-order-handling-loop) +27. [物流策略与渠道选择闭环](#2️⃣7️⃣-物流策略与渠道选择闭环logistics-strategy--channel-selection-loop) +28. [利润核算闭环](#2️⃣8️⃣-利润核算闭环profit-calculation-loop) +29. [用户/客户资产闭环](#2️⃣9️⃣-用户客户资产闭环usercustomer-asset-loop) +30. [A/B测试与策略优化闭环](#3️⃣0️⃣-ab测试与策略优化闭环ab-testing--strategy-optimization-loop) +31. [统一闭环依赖](#🔹-统一闭环依赖toc--tob) +32. [闭环依赖关系](#🔗-闭环依赖关系toc--tob) +33. [关键绩效指标](#📊-关键绩效指标kpi) +34. [追踪与审计](#🔍-追踪与审计) +35. [业务审核状态机](#📋-业务审核状态机) +36. [说明](#💡-说明) + +*** + +## 1️⃣ 数据采集与清洗闭环(Product Data Collection & Cleansing) + +- **目标**:收集多平台商品信息,确保数据完整、有效、可用于盈利分析(TOC)或报价计算(TOB)。 +- **流程**: + 1. **多平台采集**: + - TOC:抓取 Amazon、eBay、Shopee、1688 等平台商品信息。 + - TOB:抓取供应商报价、批发价格、企业定制产品信息。 + - 支持 API 对接和爬虫采集。 + - 采集字段:标题、价格、库存、SKU、图片、描述、评价、供应商信息(TOB)。 + 2. **数据清洗**: + - 去重:平台+productId 唯一约束 + - 格式化:统一字段格式和单位 + - 字段标准化:规范属性名和值 + - 剔除无效商品:库存异常、价格异常、描述缺失 + 3. **前置套利 / 利润评估**: + - TOC:评估单件盈利、ROI、定价区间 + - TOB:评估阶梯价利润、批量折扣、信用额度风险 + - 考虑平台费、物流费、税费、汇率、售后成本、广告摊销 +- **决策点**: + - TOC:B2C 利润率 < 20% 触发风控 + - TOB:B2B 利润率 < 15% 禁止报价 +- **输入**:平台商品原始数据 +- **输出**:清洗后的可售商品/报价数据,包含完整套利/利润分析 + +*** + +## 2️⃣ 商品刊登闭环(Product Listing Loop) + +- **目标**:将可售商品同步到各平台,建立销售基础(TOC)或生成报价单(TOB)。 +- **流程**: + 1. **商品准备**: + - ERP 商品信息完善 + - 平台规则适配:标题、描述、图片、批量折扣(TOB) + - 价格策略设置:基于套利分析或阶梯价策略 + 2. **刊登执行**: + - 批量或单条刊登,支持失败重试和全链路追踪 + - API 平台:走 Connector Bus + - 无 API 平台:No-API Bridge + PENDING\_REVIEW + 3. **刊登后管理**: + - 库存同步、价格更新、商品状态监控 +- **决策点**: + - 必须通过前置套利/利润分析 + - TOB 需遵循阶梯价审批策略 +- **输入**:清洗后的可售商品数据 +- **输出**:已刊登商品列表 + 平台状态 + 链接 + +*** + +## 3️⃣ 素材管理闭环(Media & Asset Management Loop) + +- **目标**:统一管理商品、广告、营销所需素材,支持 TOC 广告投放和 TOB 企业报价资料。 +- **流程**: + - 素材采集、处理、审核、分发 + - TOC:图片/视频用于广告和商品展示 + - TOB:商品资料、合同模板、报价单模板 +- **决策点**: + - 版权合规、平台规则、素材质量 +- **输出**:素材库 + 元数据 + 使用统计 +- **状态机**:`UPLOADED` → `PROCESSING` → `PENDING_REVIEW` → `APPROVED` → `IN_USE` → `ARCHIVED`/`REJECTED` + +*** + +## 4️⃣ 广告计划与营销闭环(Marketing & Ad Management Loop) + +- **目标**:提升销量和 ROI(TOC)或企业促销效率(TOB)。 +- **流程**: + - 广告计划制定、跨平台投放、效果分析与优化 + - TOB:批量报价、促销方案、邮件/企业营销 +- **决策点**: + - 广告 ROI < 1 停止投放 + - 企业营销需基于信用等级和合同审批 +- **输入**:已刊登商品列表、素材 +- **输出**:广告报告、优化建议 + +*** + +## 5️⃣ 订单履约闭环(Order Fulfillment Loop / OMS) + +- **目标**:保证订单从生成到妥投的全链路履约。 +- **流程**: + - **公共流程**:订单获取与审核 → 分仓 → 占库 → 扣库 → 发货 → 物流追踪 + - **TOC**:标准订单处理流程 + - **TOB**:大额企业订单可分批发货、合同条款优先 +- **状态机**:`PULLED` → `PENDING_REVIEW` → `CONFIRMED` → `ALLOCATED` → `READY_TO_SHIP` → `SHIPPED` → `DELIVERED` → `CLOSED` +- **输入**:平台订单数据 +- **输出**:已发货订单,包含物流跟踪信息 + +*** + +## 6️⃣ 售后逆向闭环(Returns & Refunds Loop) + +- **目标**:处理退货/退款,保持库存和财务一致。 +- **流程**: + - **公共流程**:售后请求处理 → 退货处理 → 退款处理 + - **TOC**:标准退货流程 + - **TOB**:按合同条款、批量退货、预付款冲抵 +- **输入**:售后请求数据 +- **输出**:处理完成的售后记录,包含库存和财务调整 + +*** + +## 7️⃣ 资金对账闭环(Finance Reconciliation Loop) + +- **目标**:财务闭环,兼顾 TOC/TOB。 +- **流程**: + - 数据汇总 → 财务处理(多币种、VAT、汇率) → 差异分析与处理 +- **决策点**: + - 异常需人工复核 + - TOB 账期和信用额度影响结算 +- **输出**:对账报告 + 差异处理记录 + +*** + +## 8️⃣ 库存与仓储管理闭环(Inventory & Warehouse Management Loop / WMS) + +- **目标**:确保库存准确、仓储高效,支持全球供应链运作。 +- **流程**: + - **公共流程**:多仓库存管理 → 进出库管理 → 物流模式管理 + - **TOC**:按店铺和平台库存管理 + - **TOB**:按企业订单、批量调拨、FCL/3PL 管理 +- **决策点**: + - 库存不足时触发补货建议 + - 跨仓调拨决策:基于成本和时效 + - 安全库存预警阈值设置 +- **输入**:订单数据、采购数据、物流数据 +- **输出**:实时库存状态、仓储操作记录、库存预警 + +*** + +## 9️⃣ 供应链与供应商管理闭环(Supply Chain & Supplier Management Loop) + +- **目标**:优化供应链流程,降低采购成本,确保供应稳定。 +- **流程**: + - **公共流程**:供应商管理 → 采购管理 → 补货建议 + - **TOC**:基于零售需求的采购计划 + - **TOB**:基于大宗订单生成采购计划 +- **决策点**: + - 供应商选择:基于综合评分 + - 采购价格:低于成本价预警 + - 补货时机:库存周转率优化 +- **输入**:销售数据、库存数据、供应商数据 +- **输出**:采购计划、供应商评估报告、成本节省分析 + +*** + +## 🔟 B2B / TOB 贸易管理闭环(B2B / TOB Trade Management Loop) + +- **目标**:企业间交易管理 +- **流程**: + - 报价管理、信用管理、询盘转订单 +- **决策点**: + - 利润率 < 15% 禁止报价 + - 大额订单多级审批 + - 低信用等级客户需预付款 +- **输出**:报价单、B2B 订单、信用评估报告 + +*** + +## 1️⃣1️⃣ 治理与审批中心闭环(Governance & Approval Center Loop) + +- **目标**:敏感操作审批 +- **适用**: + - TOC:大额订单、价格变动、退款 + - TOB:大额企业订单、阶梯价审批、信用审批 +- **输出**:审批结果、审计日志 + +*** + +## 1️⃣2️⃣ 合规与证书管理闭环(Compliance & Certificate Management Loop) + +- **目标**:确保业务合规,自动生成所需证书。 +- **流程**: + - **公共流程**:自动化合规 → 信用分级 → 合规审计 + - **TOC**:商品合规检查和证书生成 + - **TOB**:出口合规、合同合规检查和证书生成 +- **决策点**: + - 不合规商品禁止销售 + - 信用等级低的合作伙伴需要额外审核 +- **输入**:订单数据、商品数据、合作伙伴数据 +- **输出**:电子证书、合规报告、信用评估 + +*** + +## 1️⃣3️⃣ 合规与风控闭环(Compliance & Risk Control Loop) + +- **目标**:统一风控 +- **输入**:全流程数据(TOC + TOB) +- **输出**:风险处理记录、规则优化 + +*** + +## 1️⃣4️⃣ 报表与分析闭环(Reporting & Analytics Loop) + +- **目标**:数据可视化 + KPI 支撑 TOC/TOB 决策 +- **流程**: + - 数据汇总 → 指标计算 → 报表生成 → 数据大屏 → 闭环反馈 +- **输出**:管理报表、异常预警、优化建议 +- **状态机**:`RAW_DATA` → `PROCESSED` → `GENERATED` → `DISTRIBUTED` → `FEEDBACK_APPLIED` + +*** + +## 1️⃣5️⃣ 定价与利润决策闭环(Pricing & Profit Decision Loop) + +- **目标**:基于成本、市场和业务目标,自动生成定价策略和利润优化建议。 +- **流程**: + - 成本数据收集 → 市场分析 → 定价策略生成 → 利润预测 → 决策执行 +- **决策点**: + - 利润率红线控制(B2C < 20% 预警,B2B < 15% 禁止) + - 价格弹性分析 + - 竞争定价策略 +- **输入**:商品成本、运费、平台费、广告预估、市场竞争数据 +- **输出**: + - 建议售价 + - 建议 ROI + - 上架决策(开/关) + - 广告投放 ROI 区间 + - 最大可承受 CPA + +*** + +## 1️⃣6️⃣ 账号/店铺健康度闭环(Account/Shop Health Loop) + +- **目标**:监控和维护店铺健康状态,预防封号、限流等风险。 +- **流程**: + - 数据采集 → 健康度评估 → 风险预警 → 干预措施 +- **决策点**: + - 健康度阈值设定 + - 风险等级划分 + - 干预策略制定 +- **输入**:违规记录、发货延迟、差评率、退款率、账号活动数据 +- **输出**: + - 店铺健康评分 + - 风险预警 + - 干预建议(暂停广告、限制上新、下架高风险商品) + +*** + +## 1️⃣7️⃣ 店铺隔离与自动化闭环(Shop Isolation & Automation Loop) + +- **目标**: + 1. 确保每个 TOC / TOB 店铺环境隔离,防止账号关联导致封禁 + 2. 自动化执行 API 不支持或无 API 的操作(刊登、采集、调价、库存同步等) + 3. 支持多云环境,可灵活选择云服务商(阿里云、腾讯云、AWS、Azure 等) +- **流程**: + 1. **镜像/虚拟机管理** + - 每个店铺对应独立云镜像或虚拟机(Win/Linux 可选) + - 云商 API 对接: + - 镜像购买 / 续费 + - 快照 / 重置 + - 开机 / 关机 / 重启 + - 支持多云商切换,可根据价格、性能、地理位置灵活部署 + 2. **预置环境配置** + - 浏览器、自动化脚本、指纹管理工具、VPN 或固定 IP 配置 + - 自动登录店铺账户,无需人工干预 + 3. **任务调度与自动化执行** + - 脚本调度可使用 JS / Python / 后端 API 方式控制 + - 支持平台无 API 操作(如商品采集、库存更新、手动刊登模拟等) + - 自动执行任务后状态反馈至任务调度闭环,并记录日志 + 4. **监控与异常自愈** + - 云镜像健康监控(在线状态、资源使用、脚本异常) + - 自动重启 / 快照恢复 / 切换备用镜像 + - 异常信息反馈至异常检测与自愈闭环 +- **决策点**: + - 店铺隔离等级(独立镜像、不同 IP、不同指纹) + - 云商选择与成本控制 + - 异常处理策略(自动恢复或人工介入) +- **输入**: + - 店铺列表、业务需求(采集、刊登、广告等) + - 云商账户与资源配置 + - 自动化脚本 / 后端控制接口 +- **输出**: + - 各店铺独立镜像环境 + - 自动化执行日志与状态报告 + - 异常修复记录 +- **闭环价值**: + 1. 高度隔离,降低账号封禁与关联风险 + 2. 自动化落地,提高效率与可扩展性 + 3. 支持多云部署,增强业务弹性和成本优化能力 + +*** + +## 1️⃣8️⃣ 订单集中管理闭环(Order Centralized Management Loop) + +- **目标**:跨平台订单统一抓取、集中展示和管理,支持 TOC/TOB 订单流转。 +- **流程**: + 1. **多平台订单采集** + - 支持 TikTok、Shopee、Temu 等平台订单抓取 + - 通过 API 或自动化脚本采集 + 2. **订单集中展示** + - 产品信息:名称、数量、实收价格、订单时间、状态 + - 支持平台/客户/品类/订单状态筛选 + - 可选漏斗分析:订单流转、发货完成率 + 3. **订单状态管理** + - 状态流转:`available → requested → shipped → completed` + - 订单分配与跟踪 +- **决策点**: + - 订单抓取频率 + - 订单优先级设置 + - 异常订单处理策略 +- **输入**: + - 多平台订单数据 + - 店铺信息 + - 客户/商家信息 +- **输出**: + - 集中管理的订单数据 + - 订单状态报告 + - 异常订单标记 + +*** + +## 1️⃣9️⃣ 客户/商家押金与账户管理闭环(Customer/Merchant Deposit & Account Management Loop) + +- **目标**:管理客户预缴押金、账户余额,支持订单抵扣和提现。 +- **流程**: + 1. **押金管理** + - 客户预缴押金(例:100 元抵 2 单) + - 押金余额、已抵扣订单数量记录 + 2. **账户管理** + - 客户可查看:可申请发货订单、历史回款、押金/余额状态 + - 自动扣减押金或余额完成发货操作 + 3. **提现管理** + - 检查账户余额 → 生成提现单 → 审核 → 打款 +- **决策点**: + - 押金抵扣规则 + - 提现审核流程 + - 余额管理策略 +- **输入**: + - 客户押金信息 + - 订单数据 + - 提现申请 +- **输出**: + - 押金/余额状态 + - 提现处理结果 + - 财务流水记录 + +*** + +## 2️⃣0️⃣ 商家选择发货闭环(Merchant Selective Fulfillment Loop) + +- **目标**:商家可选择自己有库存的订单发货,剩余由平台/公司发货。 +- **流程**: + 1. **订单选择** + - 商家登录落地页选择自己有货的订单发货 + 2. **系统检查** + - 押金或余额是否足够覆盖订单 + - 时效性(保证订单不过期) + 3. **订单状态更新** + - 状态流转:`available → requested → shipped → completed` + - 剩余无货订单由平台/公司自己发货 +- **决策点**: + - 订单分配规则 + - 库存检查策略 + - 时效保证机制 +- **输入**: + - 商家库存信息 + - 订单数据 + - 押金/余额状态 +- **输出**: + - 订单分配结果 + - 发货状态更新 + - 异常订单标记 + +*** + +## 2️⃣1️⃣ 回款与财务闭环(Payment & Financial Reconciliation Loop) + +- **目标**:管理客户付款、押金抵扣、回款记录和提现,确保财务透明。 +- **流程**: + 1. **收款管理** + - 客户付款到店铺账户或系统自动扣押金/余额 + 2. **财务流水记录** + - 类型(押金/回款/提现)、金额、订单ID、状态 + - 状态流转:`pending → approved → completed` + 3. **财务对账** + - 店铺收入 ↔ 客户账户余额 + - 异常订单/回款标记 → 自动或人工处理 +- **决策点**: + - 回款确认机制 + - 对账频率 + - 异常处理流程 +- **输入**: + - 客户付款信息 + - 订单数据 + - 押金/余额状态 +- **输出**: + - 财务流水记录 + - 对账结果 + - 提现处理结果 + +*** + +## 2️⃣2️⃣ 海外仓/本土仓 & 多品类支持闭环(Overseas/Local Warehouse & Multi-Category Support Loop) + +- **目标**:统一管理海外仓和本土仓库存,支持多品类分配和上下游分析。 +- **流程**: + 1. **库存管理** + - 海外仓和本土仓库存统一管理 + - 可按品类、仓库位置、时效性分配发货 + 2. **上下游分析** + - 供应商价格对比 + - 成本/利润/ROI 分析 + - 同行发货/库存策略参考 +- **决策点**: + - 仓库选择策略 + - 品类分配规则 + - 供应链优化策略 +- **输入**: + - 仓库库存数据 + - 供应商信息 + - 订单数据 +- **输出**: + - 库存分配方案 + - 供应链分析报告 + - 成本优化建议 + +*** + +## 2️⃣3️⃣ 商品主数据闭环(Product Master Data Loop / MDM) + +- **目标**:建立统一的商品主数据管理体系,确保数据一致性。 +- **流程**: + - 数据采集 → 标准化处理 → 主数据维护 → 数据分发 +- **决策点**: + - 数据标准制定 + - 数据质量评估 + - 数据同步策略 +- **输入**:来自采集、供应链、刊登等闭环的商品数据 +- **输出**: + - 统一 SPU/SKU 体系 + - 标准化类目和属性结构 + - 多语言支持 + - 多平台映射关系 + +*** + +## 1️⃣9️⃣ SKU变体与结构闭环(SKU Variant & Structure Loop) + +- **目标**:管理商品的变体和多平台SKU映射,确保库存和订单的一致性。 +- **流程**: + - SPU创建 → SKU生成 → 平台SKU映射 → 同步管理 +- **决策点**: + - 变体属性定义 + - 多平台SKU规则适配 + - 库存同步策略 +- **输入**:商品主数据、平台SKU规则 +- **输出**: + - 多SKU结构(颜色/尺寸/套装) + - 各平台SKU映射 + - 统一库存管理 + +*** + +## 2️⃣0️⃣ 订单拆分与合并闭环(Order Split & Merge Loop) + +- **目标**:处理多仓发货、多订单合并、部分缺货等场景,优化物流成本和时效。 +- **流程**: + - 订单分析 → 拆分/合并决策 → 子订单生成 → 履约执行 +- **决策点**: + - 拆分类型(仓/SKU/库存) + - 合并条件 + - 优先级策略 +- **输入**:订单数据、库存状态、物流成本 +- **输出**: + - 子订单 + - 合并订单 + - 物流方案 + +*** + +## 2️⃣1️⃣ 异常订单处理闭环(Exception Order Handling Loop) + +- **目标**:处理地址错误、海关卡单、物流丢件、无法发货等履约异常。 +- **流程**: + - 异常检测 → 分类处理 → 解决方案执行 → 结果反馈 +- **决策点**: + - 异常类型识别 + - 处理优先级 + - 人工介入条件 +- **输入**:订单数据、物流状态、异常事件 +- **输出**: + - 异常处理结果 + - 售后触发 + - 风控预警 + +*** + +## 2️⃣2️⃣ 物流策略与渠道选择闭环(Logistics Strategy & Channel Selection Loop) + +- **目标**:基于成本、时效和可靠性,选择最优物流方案。 +- **流程**: + - 订单分析 → 物流渠道评估 → 方案选择 → 执行监控 +- **决策点**: + - 仓选择 + - 物流方式(空运/海运/快递) + - 渠道选择 +- **输入**:订单数据、库存分布、物流成本、时效要求 +- **输出**: + - 物流渠道选择 + - 成本估算 + - 时效承诺 + +*** + +## 2️⃣3️⃣ 利润核算闭环(Profit Calculation Loop) + +- **目标**:精确计算真实利润,支持定价和决策优化。 +- **流程**: + - 成本汇总 → 收入匹配 → 利润计算 → 分析报告 +- **决策点**: + - 成本分摊规则 + - 汇率处理 + - 利润阈值设定 +- **输入**:商品成本、运费、广告费、平台佣金、税费、汇率数据 +- **输出**: + - 订单级利润 + - 商品级利润 + - 店铺级利润 + - 利润分析报告 + +*** + +## 2️⃣4️⃣ 用户/客户资产闭环(User/Customer Asset Loop) + +- **目标**:沉淀和管理用户资产,支持精准营销和客户价值提升。 +- **流程**: + - 数据采集 → 用户画像构建 → 行为分析 → 资产运营 +- **决策点**: + - 用户分层策略 + - 营销触达规则 + - 客户价值评估 +- **输入**:订单数据、浏览行为、购买历史、售后记录 +- **输出**: + - 用户画像 + - 复购行为分析 + - 国家偏好分析 + - 客户价值评估 + - 营销建议 + +*** + +## 2️⃣5️⃣ A/B测试与策略优化闭环(A/B Testing & Strategy Optimization Loop) + +- **目标**:通过实验验证和数据驱动,持续优化业务策略。 +- **流程**: + - 测试设计 → 实验执行 → 数据收集 → 结果分析 → 策略调整 +- **决策点**: + - 测试假设设定 + - 样本量确定 + - 显著性水平设定 +- **输入**:广告策略、商品定价、页面设计、营销文案 +- **输出**: + - 测试结果分析 + - 策略优化建议 + - 最优方案推荐 + +*** + +### 🔹 统一闭环依赖(TOC + TOB) + +```text +[数据采集] ↓[数据清洗] ↓[套利/利润评估] ↓[商品主数据] ↓[SKU变体与结构] ↓[商品刊登] ←→ [素材管理] ↓[定价与利润决策] ↓[广告/营销 (TOC) / 企业营销 (TOB)] ↓[订单履约 (OMS)] ↓[订单拆分与合并] ↓[异常订单处理] ↓[物流策略与渠道选择] ↓[库存 & WMS] ←→ [供应链 & 补货] ↓[售后逆向] ↓[资金对账] ↓[利润核算] ↓[B2B/TOB 贸易管理 (TOB)] ↓[用户/客户资产] ↓[A/B测试 & 策略优化] ↓[治理与审批中心] ↓[合规 & 证书] ↓[风控] ↓[报表 & 分析] ↺(反馈所有环节) + +外挂三条线: +用户资产 ← 订单 / 售后 → 广告 / B2B +店铺健康度 ← 所有行为 → 限制商品 / 广告 +店铺隔离与自动化 ← 店铺操作 → 所有店铺相关行为 +``` + +**说明**: + +- 实线箭头表示核心业务流程 +- 括号内标注了TOC/TOB的主要差异点 +- B2B/TOB贸易管理为TOB特有闭环 +- 横切能力:账号/店铺健康度贯穿所有业务闭环 + +*** + +### 🔗 闭环依赖关系(TOC + TOB) + +1. **数据采集与清洗闭环** → **商品主数据闭环**:提供原始商品数据 +2. **数据采集与清洗闭环** → **素材管理闭环**:提供采集的商品图片和视频素材 +3. **数据采集与清洗闭环** → **定价与利润决策闭环**:提供成本和市场数据 +4. **商品主数据闭环** → **SKU变体与结构闭环**:提供商品基础信息 +5. **SKU变体与结构闭环** → **商品刊登闭环**:提供多SKU结构和平台映射 +6. **商品刊登闭环** → **素材管理闭环**:触发素材需求,生成商品主图和详情图 +7. **素材管理闭环** → **商品刊登闭环**:提供处理后的商品素材(图片、视频) +8. **素材管理闭环** → **广告计划与营销闭环**:提供广告投放所需的素材库 +9. **商品刊登闭环** → **广告计划与营销闭环**:提供已刊登商品列表 +10. **商品刊登闭环** → **订单履约闭环**:提供商品库存和状态信息 +11. **商品刊登闭环** → **定价与利润决策闭环**:提供商品成本信息 +12. **定价与利润决策闭环** → **商品刊登闭环**:提供建议售价和上架决策 +13. **定价与利润决策闭环** → **广告计划与营销闭环**:提供可投放 ROI 区间和最大可承受 CPA +14. **订单履约闭环** → **订单拆分与合并闭环**:提供订单数据用于拆分/合并 +15. **订单拆分与合并闭环** → **物流策略与渠道选择闭环**:提供拆分/合并后的订单数据 +16. **物流策略与渠道选择闭环** → **订单履约闭环**:提供物流方案 +17. **订单履约闭环** → **异常订单处理闭环**:提供异常订单数据 +18. **异常订单处理闭环** → **售后逆向闭环**:触发售后处理 +19. **异常订单处理闭环** → **合规与风控闭环**:提供风控预警 +20. **订单履约闭环** → **售后逆向闭环**:提供订单和物流信息 +21. **售后逆向闭环** → **资金对账闭环**:提供退款记录 +22. **订单履约闭环** → **资金对账闭环**:提供销售记录 +23. **广告计划与营销闭环** → **资金对账闭环**:提供广告费用记录 +24. **订单履约闭环** → **库存与仓储管理闭环**:触发库存扣减和物流操作 +25. **库存与仓储管理闭环** → **订单履约闭环**:提供库存状态和物流信息 +26. **库存与仓储管理闭环** → **供应链与供应商管理闭环**:触发补货需求 +27. **供应链与供应商管理闭环** → **库存与仓储管理闭环**:提供采购入库信息 +28. **供应链与供应商管理闭环** → **商品主数据闭环**:提供供应商商品数据 +29. **商品刊登闭环** → **B2B / TOB 贸易管理闭环**:提供商品信息用于报价 +30. **B2B / TOB 贸易管理闭环** → **订单履约闭环**:生成 B2B 订单 +31. **B2B / TOB 贸易管理闭环** → **资金对账闭环**:提供 B2B 交易记录 +32. **资金对账闭环** → **利润核算闭环**:提供收入和成本数据 +33. **利润核算闭环** → **报表与分析闭环**:提供利润数据 +34. **订单履约闭环** → **用户/客户资产闭环**:提供订单和用户行为数据 +35. **售后逆向闭环** → **用户/客户资产闭环**:提供售后记录 +36. **用户/客户资产闭环** → **广告计划与营销闭环**:提供用户画像和营销建议 +37. **用户/客户资产闭环** → **B2B / TOB 贸易管理闭环**:提供企业客户信息 +38. **广告计划与营销闭环** → **A/B测试与策略优化闭环**:提供广告策略数据 +39. **商品刊登闭环** → **A/B测试与策略优化闭环**:提供商品定价和展示数据 +40. **A/B测试与策略优化闭环** → **报表与分析闭环**:提供测试结果和优化建议 +41. **所有敏感操作** → **治理与审批中心闭环**:触发审批流程 +42. **治理与审批中心闭环** → **所有业务闭环**:提供审批结果 +43. **订单履约闭环** → **合规与证书管理闭环**:触发证书生成 +44. **合规与证书管理闭环** → **订单履约闭环**:提供合规证书 +45. **所有业务闭环** → **账号/店铺健康度闭环**:提供违规记录、发货延迟、差评率、退款率等数据 +46. **账号/店铺健康度闭环** → **广告计划与营销闭环**:提供是否暂停广告、降预算的决策 +47. **账号/店铺健康度闭环** → **商品刊登闭环**:提供是否限制上新、下架高风险商品的决策 +48. **所有店铺操作** → **店铺隔离与自动化闭环**:提供店铺操作数据 +49. **店铺隔离与自动化闭环** → **所有店铺相关行为**:提供隔离环境和自动化执行能力 +50. **所有闭环** → **合规与风控闭环**:提供全流程数据用于风险监控 +51. **所有业务闭环** → **报表与分析闭环**:提供各闭环的输出数据用于报表生成和分析 +52. **报表与分析闭环** → **所有业务闭环**:反馈数据异常、业务波动、优化建议,指导各闭环的操作调整 + +*** + +### 📊 关键绩效指标(KPI) + +#### 数据采集与清洗闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ---------- | --------- | +| 采集覆盖率 | 目标平台商品覆盖率 | TOC + TOB | +| 数据准确率 | 清洗后数据的准确性 | TOC + TOB | +| 套利分析准确率 | 前置套利计算的准确性 | TOC + TOB | + +#### 商品刊登闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ----------- | --------- | +| 刊登成功率 | 成功刊登的商品比例 | TOC + TOB | +| 刊登时效 | 从准备到刊登完成的时间 | TOC + TOB | +| 平台审核通过率 | 平台审核通过的商品比例 | TOC + TOB | + +#### 素材管理闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ------------ | --------- | +| 素材处理时效 | 从上传到可用的平均时间 | TOC + TOB | +| 素材审核通过率 | 通过审核的素材比例 | TOC + TOB | +| 素材转化率 | 使用素材带来的订单转化率 | TOC + TOB | +| 素材复用率 | 被多次使用的素材比例 | TOC + TOB | +| 版权合规率 | 无版权风险的素材比例 | TOC + TOB | + +#### 广告计划与营销闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| -------- | -------------- | ------ | +| 广告 ROI | 广告投入产出比 | TOC | +| 点击率(CTR) | 广告点击次数与展示次数的比率 | TOC | +| 转化率(CVR) | 点击广告后产生订单的比例 | TOC | +| 企业营销效果 | 企业营销活动的转化率 | TOB | + +#### 订单履约闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------ | ----------- | --------- | +| 订单处理时效 | 从订单生成到发货的时间 | TOC + TOB | +| 发货准确率 | 正确发货的订单比例 | TOC + TOB | +| 妥投率 | 成功送达的订单比例 | TOC + TOB | +| 分批处理率 | 大额订单分批处理的比例 | TOB | + +#### 售后逆向闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------ | ------------- | --------- | +| 售后处理时效 | 从售后请求到处理完成的时间 | TOC + TOB | +| 退款成功率 | 成功退款的比例 | TOC + TOB | +| 退货率 | 退货订单占总订单的比例 | TOC + TOB | + +#### 资金对账闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------ | ------------- | --------- | +| 对账准确率 | 对账差异率 | TOC + TOB | +| 对账时效 | 从数据汇总到对账完成的时间 | TOC + TOB | +| 异常处理率 | 需要人工处理的异常比例 | TOC + TOB | +| 账期遵守率 | 按合同约定账期结算的比例 | TOB | + +#### 库存与仓储管理闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------ | ------------- | --------- | +| 库存准确率 | 系统库存与实际库存的差异率 | TOC + TOB | +| 库存周转率 | 库存周转次数 | TOC + TOB | +| 仓储操作效率 | 每单处理时间 | TOC + TOB | +| 跨仓调拨时效 | 调拨完成时间 | TOC + TOB | + +#### 供应链与供应商管理闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| -------- | --------- | --------- | +| 供应商准时交付率 | 按时交付的订单比例 | TOC + TOB | +| 采购成本降低率 | 采购成本下降百分比 | TOC + TOB | +| 供应商评分 | 供应商综合评估分数 | TOC + TOB | +| 补货准确率 | 补货计划的准确性 | TOC + TOB | + +#### B2B / TOB 贸易管理闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ---------- | ------ | +| B2B 利润率 | B2B 业务的利润率 | TOB | +| 报价通过率 | 报价被客户接受的比例 | TOB | +| 信用违约率 | 客户信用违约的比例 | TOB | +| 询盘转化率 | 询盘转化为订单的比例 | TOB | + +#### 治理与审批中心闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------ | ----------- | --------- | +| 审批时效 | 从申请到审批完成的时间 | TOC + TOB | +| 审批准确率 | 审批结果的准确性 | TOC + TOB | +| 待办处理率 | 待办事项的处理比例 | TOC + TOB | + +#### 合规与证书管理闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | --------- | --------- | +| 证书生成及时率 | 按时生成证书的比例 | TOC + TOB | +| 合规检查通过率 | 通过合规检查的比例 | TOC + TOB | +| 信用评级准确率 | 信用评级的准确性 | TOC + TOB | + +#### 合规与风控闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ---------- | --------- | +| 风险识别准确率 | 风险识别的准确性 | TOC + TOB | +| 风控处理时效 | 风险处理的时间 | TOC + TOB | +| 合规违规率 | 违规事件的比例 | TOC + TOB | +| 误报率 | 误判为风险的事件比例 | TOC + TOB | + +#### 报表与分析闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | --------------- | --------- | +| 报表生成及时率 | 按时生成报表的比例 | TOC + TOB | +| 数据准确率 | 报表数据的准确性 | TOC + TOB | +| 分析洞察价值 | 分析结果对业务决策的价值 | TOC + TOB | +| 异常预警准确率 | 异常预警的准确性 | TOC + TOB | +| 报表生成时效 | 从数据汇总到报表完成的时间 | TOC + TOB | +| 数据完整率 | 报表覆盖业务闭环输出数据的比例 | TOC + TOB | +| KPI 准确率 | 计算指标与实际数据偏差率 | 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 | +| 镜像可用性 | 镜像正常运行时间比例 | TOC + TOB | +| 云API调用成功率 | 云服务商API调用成功率 | TOC + TOB | +| 资源利用率 | 镜像资源使用效率 | TOC + TOB | +| 自动登录成功率 | 镜像自动登录成功率 | TOC + TOB | +| 多云切换成功率 | 云服务商切换成功率 | TOC + TOB | +| 成本优化率 | 多云部署带来的成本优化比例 | TOC + TOB | + +#### 商品主数据闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------ | ------------ | --------- | +| 数据标准化率 | 标准化处理的商品数据比例 | TOC + TOB | +| 数据一致性 | 多平台数据一致性程度 | TOC + TOB | +| 主数据准确率 | 商品主数据的准确性 | TOC + TOB | +| 数据同步时效 | 数据从采集到同步的时间 | TOC + TOB | +| 数据质量评分 | 商品数据质量综合评分 | TOC + TOB | + +#### SKU变体与结构闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| -------- | ------------ | --------- | +| SKU映射准确率 | 多平台SKU映射的准确性 | TOC + TOB | +| SKU生成时效 | SKU生成的平均时间 | TOC + TOB | +| 变体管理效率 | 变体属性管理的效率 | TOC + TOB | +| 库存同步准确率 | 多SKU库存同步的准确性 | TOC + TOB | + +#### 订单拆分与合并闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| -------- | -------------- | --------- | +| 拆分/合并准确率 | 订单拆分/合并的准确性 | TOC + TOB | +| 拆分/合并时效 | 订单拆分/合并的处理时间 | TOC + TOB | +| 物流成本优化率 | 拆分/合并带来的物流成本节约 | TOC + TOB | +| 客户满意度 | 拆分/合并订单的客户满意度 | TOC + TOB | + +#### 异常订单处理闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------ | ------------ | --------- | +| 异常处理率 | 成功处理的异常订单比例 | TOC + TOB | +| 异常处理时效 | 异常订单处理的平均时间 | TOC + TOB | +| 异常解决率 | 成功解决的异常订单比例 | TOC + TOB | +| 客户满意度 | 异常订单处理的客户满意度 | TOC + TOB | + +#### 物流策略与渠道选择闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ---------- | --------- | +| 物流成本节约率 | 物流成本节约的比例 | TOC + TOB | +| 物流时效达标率 | 按时送达的订单比例 | TOC + TOB | +| 渠道选择准确率 | 物流渠道选择的准确性 | TOC + TOB | +| 物流跟踪覆盖率 | 可跟踪的物流订单比例 | TOC + TOB | + +#### 利润核算闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ------------ | --------- | +| 利润计算准确率 | 利润计算的准确性 | TOC + TOB | +| 利润核算时效 | 利润核算的平均时间 | TOC + TOB | +| 成本分摊准确性 | 成本分摊的准确性 | TOC + TOB | +| 利润率达标率 | 达到目标利润率的订单比例 | TOC + TOB | + +#### 用户/客户资产闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ------------- | --------- | +| 用户画像准确率 | 用户画像与实际行为的匹配度 | TOC + TOB | +| 客户价值提升率 | 客户平均价值增长比例 | TOC + TOB | +| 复购率 | 客户重复购买比例 | TOC + TOB | +| 客户留存率 | 客户持续活跃的比例 | TOC + TOB | +| 营销转化率 | 营销活动的转化效果 | TOC + TOB | + +#### A/B测试与策略优化闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ------------ | --------- | +| 测试执行效率 | 测试从设计到完成的时间 | TOC + TOB | +| 测试结果显著性 | 测试结果的统计显著性 | TOC + TOB | +| 策略优化效果 | 优化后业务指标的改善程度 | TOC + TOB | +| 测试覆盖率 | 覆盖的业务策略比例 | TOC + TOB | +| 决策支持准确率 | 测试结果对决策的支持程度 | TOC + TOB | + +*** + +### 🔍 追踪与审计 + +- **追踪四元组**: + - `tenantId`:租户 ID(业务隔离) + - `shopId`:店铺 ID(平台/店铺隔离) + - `taskId`:任务 ID(任务/规则触发归档) + - `traceId`:链路追踪 ID(全链路唯一标识) + - `businessType`:业务类型(TOC/TOB) +- **审计要求**: + - 每一笔操作必须绑定 `traceId` 和 `businessType` + - 所有功能需通过 Shadow-Test(最小冒烟测试) + - 关键操作必须生成 AuditLog + +*** + +### 📋 业务审核状态机 + +- **通用审核流程**:`SUBMITTED` (提交) → `PENDING_REVIEW` (人工审核) → `EXECUTED` / `REJECTED` +- **适用场景**: + - TOC:大额订单、价格变动、退款 + - TOB:大额企业订单、阶梯价审批、信用审批 + +*** + +### 💡 说明 + +1. 业务闭环文档是**最高层文档**,不涉及具体前端或模块实现细节。 +2. 下层模块功能、接口、算法、UI 都是这个闭环的落地实现。 +3. 形成从**采集 → 决策 → 执行 → 反馈 → 风控**的完整业务链。 +4. 每个闭环都有明确的输入、输出、流程和决策点,确保业务流程的完整性和可控性。 +5. 各闭环之间通过数据流转和依赖关系形成完整的业务生态系统。 +6. 所有业务操作均需遵循项目特定规则,确保系统安全和数据一致性。 +7. **“闭环写入规则:只要逻辑上能闭环就写,落地方式后置”** +8. **系统层级结构**: + - L1(业务闭环):交易系统核心流程 + - L2(系统决策层):定价、风控、健康度等系统级能力 + - L3(数据中台层):商品主数据、成本基准等数据管理能力 + - L4(自动化与增长):任务调度、A/B测试、用户资产等高级能力 +9. **横切能力**:账号健康度、任务调度、权限审计等能力贯穿所有业务闭环,确保系统稳定性和安全性。 + +*** + diff --git a/docs/00_Business/Business_Features.md b/docs/00_Business/Business_Features.md new file mode 100644 index 0000000..0f3f7fa --- /dev/null +++ b/docs/00_Business/Business_Features.md @@ -0,0 +1,195 @@ +# 📦 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 系统 | 阶梯价、信用池、询盘管理 | + +*** + diff --git a/docs/00_Business/Governance_Standards.md b/docs/00_Business/Governance_Standards.md new file mode 100644 index 0000000..0f48f04 --- /dev/null +++ b/docs/00_Business/Governance_Standards.md @@ -0,0 +1,63 @@ +# 📋 Governance & Standards (Crawlful Hub) + +> **定位**:Crawlful Hub 治理与开发规范 - 包含开发风格、协作协议、任务规格及运维治理。 +> **更新日期**: 2026-03-17 + +--- + +## 1. 开发规范 (Development Standards) + +### 1.1 核心准则 +- **职责单一**: 一个文件只包含一个类或一组高度相关的函数。 +- **Zero-Mock**: 严禁在生产代码中使用硬编码的模拟数据。 +- **契约优先**: 接口定义应先于实现。 + +### 1.2 代码风格与规模限制 +- **命名**: 文件使用 `kebab-case`,组件 `PascalCase`,变量 `camelCase`。 +- **严格模式**: 开启 TypeScript `strict: true`,严禁使用 `any`。 +- **限制**: 单文件 ≤ 1500 行,单函数 ≤ 120 行,UI 组件 ≤ 300 行。 + +--- + +## 2. 任务规格与代码注释 (Task & JSDoc) + +### 2.1 任务规格模板 (Task Template) +- **ID**: `[FE/BE/EX]_[序号]` (FE: 前端, BE: 后端, EX: 插件)。 +- **验收**: 功能测试通过、符合规范、文档同步更新。 + +### 2.2 代码注释 (JSDoc) +每个服务类必须包含完整的 JSDoc,明确标注任务 ID: +```typescript +/** + * [BE_60] 订单自动对账服务 (Order Reconciliation) + * @description 核心逻辑:比对平台结算单与系统订单差异。 + * @version 1.0 + */ +export class ReconciliationService { ... } +``` + +--- + +## 3. 协作协议 (Collaboration Protocol) + +### 3.1 核心原则 +- **原子性认领**: 认领前必须先修改状态,防止并发冲突。 +- **超时释放**: 2 小时未更新进度,任务自动释放。 +- **状态定义**: ⏳ `pending` (待办), 🔒 `claimed` (已认领), 🚧 `in_progress` (进行中), ✅ `completed` (已完成)。 + +### 3.2 协作流程 +1. **检查**: 确认任务状态为 `pending`。 +2. **锁定**: 修改状态为 `claimed [负责人] @ HH:MM`。 +3. **归档**: 完成后更新看板与相关文档。 + +--- + +## 4. 运维治理与风险 (Ops & Governance) + +### 4.1 上线前检查 (Deployment Checklist) +- 数据库表初始化 (cf_ 前缀)。 +- 核心逻辑闭环、通过代码校验。 +- 产出配套的最小冒烟测试。 + +### 4.2 风险登记 (Risk Registry) +- 记录系统风险、缓解措施与负责人。 diff --git a/docs/00_Business/Task_Overview.md b/docs/00_Business/Task_Overview.md new file mode 100644 index 0000000..21e3efb --- /dev/null +++ b/docs/00_Business/Task_Overview.md @@ -0,0 +1,509 @@ +# 🗂 Crawlful Hub AI开发任务总览(Task Overview) + +> **说明**:本任务表基于30个业务闭环拆解,专为100% AI开发设计,包含完整的任务依赖、数据流、触发条件和状态管理。 + +--- + +## 📋 状态定义 + +| 状态 | 图标 | 描述 | 适用场景 | +|------|------|------|----------| +| pending | ⏳ | 未认领任务 | 新创建的任务 | +| claimed | 🔒 | AI已认领,生成代码/配置中 | AI正在处理任务 | +| in_progress | 🟡 | 运行/部署中 | 任务正在执行 | +| completed | ✅ | 执行成功 | 任务完成并通过验证 | +| failed | ❌ | 失败,触发自动修复或回滚 | 任务执行失败 | +| blocked | 🚫 | 被依赖任务阻塞 | 等待前置任务完成 | +| retry | 🔄 | 重试中 | 失败后正在重试 | + +--- + +## 🎯 优先级定义 + +| 优先级 | 图标 | 描述 | 处理时效 | +|--------|------|------|----------| +| P0 - 紧急 | 🔴 | 阻塞核心业务流程 | 立即处理 | +| P1 - 高 | 🟠 | 影响重要功能 | 4小时内 | +| P2 - 中 | 🟡 | 功能增强或优化 | 24小时内 | +| P3 - 低 | 🟢 | 非关键功能 | 48小时内 | + +--- + +## 📊 任务统计 + +| 模块 | 总任务数 | 已完成 | 进行中 | 待处理 | 失败 | 完成率 | +|------|----------|--------|--------|--------|------|--------| +| 前端模块 | 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% | +| 数据模块 | 10 | 2 | 0 | 8 | 0 | 20% | +| 运维模块 | 3 | 2 | 0 | 1 | 0 | 67% | +| **总计** | **95** | **24** | **4** | **67** | **0** | **25%** | + +--- + +## 🚀 1️⃣ 前端模块(用户交互 / 状态展示) + +### 1.1 商品管理前端 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-P001 | 商品刊登闭环 | 渲染商品列表页面 | 用户ID, 筛选条件 | 商品列表数据 | 页面加载 | ✅ completed | P1 | - | 4h | AI-Frontend-1 | +| FE-P002 | 商品刊登闭环 | 渲染商品详情页面 | 商品ID | 商品详情数据 | 点击商品 | ⏳ pending | P1 | FE-P001 | 3h | AI-Frontend-1 | +| FE-P003 | 商品刊登闭环 | 商品上架表单 | 商品基础信息 | 上架请求 | 点击上架 | ⏳ pending | P1 | FE-P002 | 2h | AI-Frontend-2 | +| FE-P004 | 素材管理闭环 | 素材上传组件 | 文件对象 | 素材URL | 选择文件 | ⏳ pending | P2 | FE-P002 | 1.5h | AI-Frontend-2 | + +### 1.2 订单管理前端 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-O001 | 订单履约闭环 | 渲染订单列表页面 | 用户ID, 筛选条件 | 订单列表数据 | 页面加载 | 🟡 in_progress | 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 | + +### 1.3 广告计划与营销前端【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-AD001 | 广告计划与营销闭环 | 广告计划管理页面 | 广告ID, 筛选条件 | 广告计划列表 | 页面加载 | ⏳ pending | P0 | - | 12h | AI-Frontend-4 | +| FE-AD002 | 广告计划与营销闭环 | 广告投放界面 | 广告ID, 投放参数 | 投放结果 | 点击投放 | ⏳ pending | P0 | FE-AD001 | 10h | AI-Frontend-4 | +| FE-AD003 | 广告计划与营销闭环 | ROI分析页面 | 广告ID, 时间范围 | ROI报告 | 点击查看 | ⏳ pending | P0 | FE-AD001 | 8h | AI-Frontend-4 | + +### 1.4 售后逆向前端【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-SR001 | 售后逆向闭环 | 退货申请页面 | 订单ID, 退货原因 | 退货申请 | 点击退货 | ⏳ pending | P0 | - | 10h | AI-Frontend-5 | +| FE-SR002 | 售后逆向闭环 | 退款处理界面 | 退款ID, 处理结果 | 退款记录 | 点击处理 | ⏳ pending | P0 | FE-SR001 | 8h | AI-Frontend-5 | +| FE-SR003 | 售后逆向闭环 | 售后客服界面 | 工单ID, 客服消息 | 客服记录 | 点击查看 | ⏳ pending | P0 | FE-SR001 | 12h | AI-Frontend-5 | + +### 1.5 B2B / TOB 贸易前端【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-TOB001 | B2B / TOB 贸易管理闭环 | 企业报价页面 | 客户ID, 商品ID | 报价单 | 点击报价 | ⏳ pending | P0 | - | 12h | AI-Frontend-6 | +| FE-TOB002 | B2B / TOB 贸易管理闭环 | 批量订单界面 | 客户ID, 商品列表 | 批量订单 | 点击提交 | ⏳ pending | P0 | FE-TOB001 | 10h | AI-Frontend-6 | +| FE-TOB003 | B2B / TOB 贸易管理闭环 | 合同管理页面 | 合同ID, 状态 | 合同详情 | 点击查看 | ⏳ pending | P0 | FE-TOB001 | 8h | AI-Frontend-6 | + +### 1.6 合规与证书管理前端【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-COM001 | 合规与证书管理闭环 | 证书管理页面 | 证书ID, 筛选条件 | 证书列表 | 页面加载 | ⏳ pending | P1 | - | 10h | AI-Frontend-7 | +| FE-COM002 | 合规与证书管理闭环 | 合规检查界面 | 商品ID, 平台ID | 合规结果 | 点击检查 | ⏳ pending | P1 | FE-COM001 | 8h | AI-Frontend-7 | +| FE-COM003 | 合规与证书管理闭环 | 证书到期提醒 | 证书ID, 到期时间 | 提醒通知 | 定时触发 | ⏳ pending | P1 | FE-COM001 | 6h | AI-Frontend-7 | + +### 1.7 物流策略与渠道选择前端【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-LOG001 | 物流策略与渠道选择闭环 | 物流选择界面 | 订单ID, 目的地 | 物流方案 | 点击选择 | ⏳ pending | P1 | - | 8h | AI-Frontend-8 | +| FE-LOG002 | 物流策略与渠道选择闭环 | 物流跟踪页面 | 订单ID, 物流单号 | 物流信息 | 点击跟踪 | ⏳ pending | P1 | FE-LOG001 | 6h | AI-Frontend-8 | +| FE-LOG003 | 物流策略与渠道选择闭环 | 运费计算页面 | 商品ID, 数量, 目的地 | 运费报价 | 点击计算 | ⏳ pending | P1 | FE-LOG001 | 6h | AI-Frontend-8 | + +### 1.8 用户/客户资产前端【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-UA001 | 用户/客户资产闭环 | 用户资产页面 | 用户ID, 筛选条件 | 资产数据 | 页面加载 | ⏳ pending | P1 | - | 8h | AI-Frontend-9 | +| FE-UA002 | 用户/客户资产闭环 | 积分管理界面 | 用户ID, 积分操作 | 积分记录 | 点击操作 | ⏳ pending | P1 | FE-UA001 | 6h | AI-Frontend-9 | +| FE-UA003 | 用户/客户资产闭环 | 会员等级页面 | 用户ID, 等级 | 会员权益 | 点击查看 | ⏳ pending | P1 | FE-UA001 | 6h | AI-Frontend-9 | + +### 1.9 A/B测试与策略优化前端【P2 中优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-AB001 | A/B测试与策略优化闭环 | A/B测试配置页面 | 测试ID, 参数 | 配置结果 | 点击配置 | ⏳ pending | P2 | - | 6h | AI-Frontend-10 | +| FE-AB002 | A/B测试与策略优化闭环 | 测试结果展示 | 测试ID, 时间范围 | 测试报告 | 点击查看 | ⏳ pending | P2 | FE-AB001 | 6h | AI-Frontend-10 | + +### 1.10 认证服务前端【P2 中优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-AUTH001 | 认证服务 | 登录页面 | 用户名, 密码 | 登录结果 | 点击登录 | ⏳ pending | P2 | - | 6h | AI-Frontend-11 | +| FE-AUTH002 | 认证服务 | 注册页面 | 用户信息 | 注册结果 | 点击注册 | ⏳ pending | P2 | FE-AUTH001 | 6h | AI-Frontend-11 | +| FE-AUTH003 | 认证服务 | 密码重置页面 | 用户名, 新密码 | 重置结果 | 点击重置 | ⏳ pending | P2 | FE-AUTH001 | 4h | AI-Frontend-11 | + +--- + +## 🔧 2️⃣ 后端模块(业务逻辑 / 数据处理) + +### 2.1 商品管理后端 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-P001 | 商品主数据闭环 | 商品主数据管理接口 | 商品基础信息 | 商品ID, 状态 | 前端提交 | ✅ completed | P0 | - | 2h | AI-Backend-1 | +| 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 | + +### 2.2 订单管理后端 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-O001 | 订单履约闭环 | 订单创建接口 | 用户ID, 商品ID, 数量 | 订单ID, 状态 | 前端提交 | ✅ completed | P0 | BE-P001 | 2h | AI-Backend-1 | +| BE-O002 | 订单集中管理闭环 | 多平台订单归集接口 | 平台账号, 时间范围 | 订单数据 | 定时任务 | ✅ completed | P0 | BE-O001 | 3h | AI-Backend-3 | +| BE-O003 | 订单拆分与合并闭环 | 订单拆分逻辑 | 订单ID, 拆分规则 | 子订单列表 | 库存不足 | ✅ completed | P1 | BE-O001 | 2h | AI-Backend-3 | +| BE-O004 | 异常订单处理闭环 | 异常订单识别与处理 | 订单ID | 处理结果 | 定时扫描 | ✅ completed | P1 | BE-O001 | 2.5h | AI-Backend-2 | + +### 2.3 财务管理后端 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-F001 | 资金对账闭环 | 对账接口 | 时间范围, 平台ID | 对账结果 | 定时任务 | ✅ completed | P0 | BE-O001 | 2h | AI-Backend-2 | +| BE-F002 | 回款与财务闭环 | 回款管理接口 | 订单ID, 回款金额 | 回款记录 | 回款事件 | ✅ completed | P1 | BE-F001 | 1.5h | AI-Backend-2 | +| BE-F003 | 利润核算闭环 | 利润计算接口 | 订单ID, 成本数据 | 利润数据 | 订单完成 | ✅ completed | P1 | BE-F001 | 2h | AI-Backend-3 | + +### 2.4 库存管理后端 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-I001 | 库存与仓储管理闭环 | 库存同步引擎 | 商品ID, 库存变化 | 库存状态 | 库存变化事件 | ✅ completed | P0 | BE-P001 | 2h | AI-Backend-1 | +| BE-I002 | 海外仓/本土仓闭环 | 多仓库库存分配 | 订单ID, 仓库列表 | 分配方案 | 订单创建 | ✅ completed | P1 | BE-I001 | 2.5h | AI-Backend-3 | +| BE-I003 | 供应链与供应商管理闭环 | 补货建议生成 | 商品ID, 库存阈值 | 补货建议 | 库存预警 | ✅ completed | P2 | BE-I001 | 2h | AI-Backend-3 | + +### 2.5 用户与账户管理后端 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-U001 | 客户/商家押金闭环 | 押金管理接口 | 客户ID, 金额 | 押金余额 | 押金操作 | ✅ completed | P1 | BE-O001 | 1.5h | AI-Backend-2 | +| BE-U002 | 用户/客户资产闭环 | 用户资产统计 | 用户ID | 资产数据 | 定时任务 | ✅ completed | P2 | BE-U001 | 2h | AI-Backend-2 | + +### 2.6 治理与风控后端 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-G001 | 治理与审批中心闭环 | 审批流程引擎 | 审批类型, 数据 | 审批结果 | 审批请求 | ✅ completed | P1 | BE-O001 | 2.5h | AI-Backend-3 | +| BE-G002 | 合规与风控闭环 | 风控规则引擎 | 订单ID, 用户ID | 风险评分 | 订单创建 | ✅ completed | P0 | BE-O001 | 2h | AI-Backend-2 | +| BE-G003 | 账号/店铺健康度闭环 | 健康度监控 | 店铺ID | 健康度评分 | 定时任务 | ✅ completed | P1 | BE-G002 | 2h | AI-Backend-3 | + +### 2.7 广告计划与营销后端【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-AD001 | 广告计划与营销闭环 | 广告计划创建接口 | 广告参数 | 广告ID | 前端提交 | ⏳ pending | P0 | - | 12h | AI-Backend-4 | +| BE-AD002 | 广告计划与营销闭环 | 广告投放引擎 | 广告ID, 投放参数 | 投放状态 | 定时任务 | ⏳ pending | P0 | BE-AD001 | 16h | AI-Backend-4 | +| BE-AD003 | 广告计划与营销闭环 | ROI计算接口 | 广告ID, 时间范围 | ROI数据 | 定时任务 | ⏳ pending | P0 | BE-AD001 | 10h | AI-Backend-4 | + +### 2.8 售后逆向后端【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-SR001 | 售后逆向闭环 | 退货处理接口 | 订单ID, 退货原因 | 退货ID | 前端提交 | ⏳ pending | P0 | - | 12h | AI-Backend-5 | +| BE-SR002 | 售后逆向闭环 | 退款流程引擎 | 退货ID, 审批结果 | 退款状态 | 审批完成 | ⏳ pending | P0 | BE-SR001 | 14h | AI-Backend-5 | +| BE-SR003 | 售后逆向闭环 | 售后工单系统 | 退货ID, 工单信息 | 工单ID | 退货创建 | ⏳ pending | P0 | BE-SR001 | 16h | AI-Backend-5 | + +### 2.9 B2B / TOB 贸易后端【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-TOB001 | B2B / TOB 贸易管理闭环 | 阶梯价计算接口 | 商品ID, 数量 | 阶梯价 | 前端请求 | ⏳ pending | P0 | - | 12h | AI-Backend-6 | +| BE-TOB002 | B2B / TOB 贸易管理闭环 | 批量订单处理 | 客户ID, 商品列表 | 批量订单ID | 前端提交 | ⏳ pending | P0 | BE-TOB001 | 16h | AI-Backend-6 | +| BE-TOB003 | B2B / TOB 贸易管理闭环 | 账期管理 | 客户ID, 账期设置 | 账期记录 | 前端提交 | ⏳ pending | P0 | BE-TOB001 | 10h | AI-Backend-6 | + +### 2.10 合规与证书管理后端【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-COM001 | 合规与证书管理闭环 | 证书存储接口 | 证书信息 | 证书ID | 前端提交 | ⏳ pending | P1 | - | 12h | AI-Backend-7 | +| BE-COM002 | 合规与证书管理闭环 | 合规检查引擎 | 商品ID, 平台ID | 合规结果 | 前端请求 | ⏳ pending | P1 | BE-COM001 | 14h | AI-Backend-7 | +| BE-COM003 | 合规与证书管理闭环 | 证书更新提醒 | 证书ID, 到期时间 | 提醒通知 | 定时任务 | ⏳ pending | P1 | BE-COM001 | 8h | AI-Backend-7 | + +### 2.11 物流策略与渠道选择后端【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-LOG001 | 物流策略与渠道选择闭环 | 物流策略引擎 | 订单ID, 目的地 | 物流方案 | 订单创建 | ⏳ pending | P1 | - | 14h | AI-Backend-8 | +| BE-LOG002 | 物流策略与渠道选择闭环 | 渠道选择算法 | 订单ID, 物流方案 | 渠道ID | 订单创建 | ⏳ pending | P1 | BE-LOG001 | 12h | AI-Backend-8 | +| BE-LOG003 | 物流策略与渠道选择闭环 | 运费计算接口 | 商品ID, 数量, 目的地 | 运费 | 前端请求 | ⏳ pending | P1 | BE-LOG001 | 10h | AI-Backend-8 | + +### 2.12 用户/客户资产后端【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-UA001 | 用户/客户资产闭环 | 用户资产计算接口 | 用户ID | 资产数据 | 前端请求 | ⏳ pending | P1 | - | 10h | AI-Backend-9 | +| BE-UA002 | 用户/客户资产闭环 | 积分管理引擎 | 用户ID, 积分操作 | 积分记录 | 前端提交 | ⏳ pending | P1 | BE-UA001 | 10h | AI-Backend-9 | +| BE-UA003 | 用户/客户资产闭环 | 会员等级系统 | 用户ID, 等级规则 | 等级信息 | 定时任务 | ⏳ pending | P1 | BE-UA001 | 12h | AI-Backend-9 | + +### 2.13 A/B测试与策略优化后端【P2 中优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-AB001 | A/B测试与策略优化闭环 | A/B测试引擎 | 测试ID, 参数 | 测试实例 | 前端提交 | ⏳ pending | P2 | - | 12h | AI-Backend-10 | +| BE-AB002 | A/B测试与策略优化闭环 | 流量分配算法 | 测试ID, 用户ID | 实验组 | 用户访问 | ⏳ pending | P2 | BE-AB001 | 10h | AI-Backend-10 | +| BE-AB003 | A/B测试与策略优化闭环 | 效果统计接口 | 测试ID, 时间范围 | 统计结果 | 定时任务 | ⏳ pending | P2 | BE-AB001 | 8h | AI-Backend-10 | + +### 2.14 认证服务后端【P2 中优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-AUTH001 | 认证服务 | 用户认证接口 | 用户名, 密码 | 认证令牌 | 前端提交 | ⏳ pending | P2 | - | 10h | AI-Backend-11 | +| BE-AUTH002 | 认证服务 | 权限管理 | 用户ID, 权限 | 权限列表 | 前端请求 | ⏳ pending | P2 | BE-AUTH001 | 8h | AI-Backend-11 | +| BE-AUTH003 | 认证服务 | 会话管理 | 用户ID, 令牌 | 会话信息 | 请求验证 | ⏳ pending | P2 | BE-AUTH001 | 8h | AI-Backend-11 | + +--- + +## 🔌 3️⃣ 插件模块(外部平台操作 / 调度) + +### 3.1 平台采集插件 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| PL-C001 | 数据采集与清洗闭环 | 多平台商品采集 | 平台账号, 采集配置 | 原始商品数据 | 定时任务 | ✅ completed | P0 | - | 3h | AI-Plugin-1 | +| PL-C002 | 数据采集与清洗闭环 | DOM解析逻辑 | HTML内容 | 结构化数据 | 采集完成 | � in_progress | P1 | PL-C001 | 2h | AI-Plugin-2 | +| PL-C003 | 订单集中管理闭环 | 多平台订单采集 | 平台账号, 时间范围 | 订单数据 | 定时任务 | ⏳ pending | P0 | PL-C001 | 3h | AI-Plugin-1 | + +### 3.2 自动化操作插件 + +| 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 | + +### 3.3 售后逆向插件【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| PL-SR001 | 售后逆向闭环 | 平台退货同步 | 平台账号, 退货ID | 退货数据 | 定时任务 | ⏳ pending | P0 | PL-C003 | 8h | AI-Plugin-4 | +| PL-SR002 | 售后逆向闭环 | 退款状态查询 | 平台账号, 退款ID | 退款状态 | 定时任务 | ⏳ pending | P0 | PL-SR001 | 6h | AI-Plugin-4 | + +### 3.4 物流策略插件【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| PL-LOG001 | 物流策略与渠道选择闭环 | 物流状态同步 | 订单ID, 物流单号 | 物流信息 | 定时任务 | ⏳ pending | P1 | PL-A002 | 6h | AI-Plugin-5 | +| PL-LOG002 | 物流策略与渠道选择闭环 | 物流API对接 | 物流商, API配置 | 对接结果 | 配置更新 | ⏳ pending | P1 | PL-LOG001 | 8h | AI-Plugin-5 | + +### 3.5 广告计划插件【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| PL-AD001 | 广告计划与营销闭环 | 广告投放操作 | 平台账号, 广告ID | 投放结果 | 定时任务 | ⏳ pending | P0 | PL-C001 | 10h | AI-Plugin-6 | +| PL-AD002 | 广告计划与营销闭环 | 广告数据同步 | 平台账号, 广告ID | 广告数据 | 定时任务 | ⏳ pending | P0 | PL-AD001 | 8h | AI-Plugin-6 | + +### 3.6 B2B / TOB 贸易插件【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| PL-TOB001 | B2B / TOB 贸易管理闭环 | 批量订单提交 | 平台账号, 订单列表 | 提交结果 | 定时任务 | ⏳ pending | P0 | PL-C003 | 12h | AI-Plugin-7 | +| PL-TOB002 | B2B / TOB 贸易管理闭环 | 合同状态同步 | 平台账号, 合同ID | 合同状态 | 定时任务 | ⏳ pending | P0 | PL-TOB001 | 8h | AI-Plugin-7 | + +--- + +## 🤖 4️⃣ AI模块(智能决策 / 自动化) + +### 4.1 智能分析AI + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| AI-A001 | 定价与利润决策闭环 | 套利机会识别 | 商品价格, 成本数据 | 套利建议 | 数据更新 | ✅ completed | P1 | BE-P001 | 3h | AI-Analysis-1 | +| AI-A002 | 广告计划与营销闭环 | 广告ROI分析 | 广告数据, 销售数据 | ROI报告 | 定时任务 | ✅ completed | P2 | BE-O001 | 2.5h | AI-Analysis-1 | +| AI-A003 | 报表与分析闭环 | 数据大屏分析 | 业务数据 | 分析报告 | 定时任务 | ✅ completed | P2 | BE-F001 | 2h | AI-Analysis-2 | + +### 4.2 自动化决策AI + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| AI-D001 | 定价与利润决策闭环 | 自动调价决策 | 套利建议 | 调价指令 | 套利机会生成 | ⏳ pending | P1 | AI-A001 | 2h | AI-Decision-1 | +| AI-D002 | 异常订单处理闭环 | 异常自动修复 | 失败任务ID | 修复结果 | 任务失败 | ⏳ pending | P1 | BE-O004 | 2.5h | AI-Decision-1 | + +### 4.3 广告计划与营销AI【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| AI-AD001 | 广告计划与营销闭环 | 广告智能优化 | 广告数据, 市场数据 | 优化建议 | 定时任务 | ⏳ pending | P0 | BE-AD001 | 14h | AI-Analysis-3 | +| AI-AD002 | 广告计划与营销闭环 | 自动出价策略 | 广告ID, 竞争数据 | 出价建议 | 定时任务 | ⏳ pending | P0 | AI-AD001 | 12h | AI-Analysis-3 | +| AI-AD003 | 广告计划与营销闭环 | 广告效果预测 | 广告ID, 历史数据 | 预测结果 | 定时任务 | ⏳ pending | P0 | AI-AD001 | 14h | AI-Analysis-3 | + +### 4.4 B2B / TOB 贸易AI【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| AI-TOB001 | B2B / TOB 贸易管理闭环 | B2B客户分析 | 客户ID, 交易数据 | 客户画像 | 定时任务 | ⏳ pending | P0 | BE-TOB001 | 14h | AI-Analysis-4 | +| AI-TOB002 | B2B / TOB 贸易管理闭环 | 批量折扣策略 | 客户ID, 商品ID | 折扣建议 | 定时任务 | ⏳ pending | P0 | AI-TOB001 | 12h | AI-Analysis-4 | +| AI-TOB003 | B2B / TOB 贸易管理闭环 | 信用风险评估 | 客户ID, 交易数据 | 风险评分 | 定时任务 | ⏳ pending | P0 | AI-TOB001 | 14h | AI-Analysis-4 | + +### 4.5 用户/客户资产AI【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| AI-UA001 | 用户/客户资产闭环 | 用户价值分析 | 用户ID, 行为数据 | 价值评分 | 定时任务 | ⏳ pending | P1 | BE-UA001 | 12h | AI-Analysis-5 | +| AI-UA002 | 用户/客户资产闭环 | 个性化推荐 | 用户ID, 商品数据 | 推荐列表 | 用户访问 | ⏳ pending | P1 | AI-UA001 | 12h | AI-Analysis-5 | + +### 4.6 A/B测试与策略优化AI【P2 中优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| AI-AB001 | A/B测试与策略优化闭环 | 测试策略推荐 | 测试目标, 数据 | 策略建议 | 测试创建 | ⏳ pending | P2 | BE-AB001 | 10h | AI-Analysis-6 | +| AI-AB002 | A/B测试与策略优化闭环 | 自动优化算法 | 测试结果, 优化目标 | 优化建议 | 测试完成 | ⏳ pending | P2 | AI-AB001 | 12h | AI-Analysis-6 | + +--- + +## 📊 5️⃣ 数据模块(数据采集 / 清洗 / 分析) + +### 5.1 数据处理 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| DT-P001 | 数据采集与清洗闭环 | 数据清洗引擎 | 原始数据 | 清洗后数据 | 采集完成 | ✅ completed | P0 | PL-C001 | 2h | AI-Data-1 | +| DT-P002 | 数据采集与清洗闭环 | 数据标准化 | 清洗后数据 | 标准化数据 | 清洗完成 | ✅ completed | P1 | DT-P001 | 1.5h | AI-Data-1 | + +### 5.2 数据分析 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| DT-A001 | 报表与分析闭环 | 核心报表生成 | 业务数据 | 报表数据 | 定时任务 | ⏳ pending | P2 | BE-F001 | 2h | AI-Data-2 | +| DT-A002 | A/B测试与策略优化闭环 | A/B测试分析 | 测试数据 | 测试结果 | 测试完成 | ⏳ pending | P3 | DT-A001 | 2.5h | AI-Data-2 | + +### 5.3 合规与证书数据【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| DT-COM001 | 合规与证书管理闭环 | 证书数据库 | 证书信息 | 证书记录 | 证书创建 | ⏳ pending | P1 | BE-COM001 | 10h | AI-Data-3 | +| DT-COM002 | 合规与证书管理闭环 | 合规规则库 | 规则配置 | 规则记录 | 规则更新 | ⏳ pending | P1 | BE-COM002 | 10h | AI-Data-3 | + +### 5.4 数据库设计与表定义【P3 低优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| DT-DB001 | 数据库设计 | 核心表结构定义 | 表结构定义 | SQL脚本 | 设计完成 | ⏳ pending | P3 | - | 12h | AI-Data-4 | +| DT-DB002 | 数据库设计 | 数据库ERD图 | 表关系 | ERD图 | 设计完成 | ⏳ pending | P3 | DT-DB001 | 8h | AI-Data-4 | +| DT-DB003 | 数据库设计 | 索引设计文档 | 表结构, 查询模式 | 索引设计 | 设计完成 | ⏳ pending | P3 | DT-DB001 | 6h | AI-Data-4 | + +### 5.5 测试用例与质量保证【P3 低优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| DT-QA001 | 测试用例与质量保证 | 单元测试用例 | 代码模块 | 测试用例 | 代码完成 | ⏳ pending | P3 | - | 12h | AI-Data-5 | +| DT-QA002 | 测试用例与质量保证 | 集成测试用例 | 业务流程 | 测试用例 | 功能完成 | ⏳ pending | P3 | DT-QA001 | 14h | AI-Data-5 | +| DT-QA003 | 测试用例与质量保证 | 测试报告模板 | 测试结果 | 测试报告 | 测试完成 | ⏳ pending | P3 | DT-QA002 | 8h | AI-Data-5 | + +--- + +## 🛠️ 6️⃣ 运维模块(监控 / 部署 / 维护) + +### 6.1 系统监控 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| OP-M001 | 账号/店铺健康度闭环 | 系统健康监控 | 系统指标 | 健康状态 | 定时任务 | ✅ completed | P1 | - | 2h | AI-Ops-1 | +| OP-M002 | 合规与风控闭环 | 异常告警系统 | 异常事件 | 告警通知 | 异常发生 | ✅ completed | P0 | BE-G002 | 1.5h | AI-Ops-1 | + +### 6.2 部署与维护 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| OP-D001 | 店铺隔离与自动化闭环 | 自动部署脚本 | 代码版本 | 部署结果 | 代码提交 | ⏳ pending | P2 | - | 2h | AI-Ops-2 | +| OP-D002 | 系统维护 | 数据备份与恢复 | 备份配置 | 备份文件 | 定时任务 | ⏳ pending | P1 | - | 1.5h | AI-Ops-2 | + +--- + +## 🔗 全局依赖与接口定义 + +### 核心接口列表 + +| 接口名称 | 模块 | 输入参数 | 输出参数 | 调用频率 | 状态 | +|----------|------|----------|----------|----------|------| +| createProduct | 后端 | 商品基础信息 | 商品ID, 状态 | 用户提交 | ✅ completed | +| getProductList | 后端 | 筛选条件, 分页 | 商品列表 | 页面加载 | ✅ completed | +| createOrder | 后端 | 用户ID, 商品ID, 数量 | 订单ID, 状态 | 用户提交 | 🟡 in_progress | +| getOrderList | 后端 | 用户ID, 筛选条件 | 订单列表 | 页面加载 | 🟡 in_progress | +| syncInventory | 后端 | 商品ID, 库存变化 | 库存状态 | 库存变化 | ✅ completed | +| reconcileFinance | 后端 | 时间范围, 平台ID | 对账结果 | 定时任务 | 🟡 in_progress | +| fetchPlatformData | 插件 | 平台账号, 配置 | 原始数据 | 定时任务 | ✅ completed | +| analyzeArbitrage | AI | 商品价格, 成本 | 套利建议 | 数据更新 | ⏳ pending | +| createAdPlan | 后端 | 广告参数 | 广告ID | 前端提交 | ⏳ pending | +| executeAdCampaign | 后端 | 广告ID, 投放参数 | 投放状态 | 定时任务 | ⏳ pending | +| calculateAdROI | 后端 | 广告ID, 时间范围 | ROI数据 | 定时任务 | ⏳ pending | +| processReturn | 后端 | 订单ID, 退货原因 | 退货ID | 前端提交 | ⏳ pending | +| processRefund | 后端 | 退货ID, 审批结果 | 退款状态 | 审批完成 | ⏳ pending | +| calculateTieredPrice | 后端 | 商品ID, 数量 | 阶梯价 | 前端请求 | ⏳ pending | +| processBatchOrder | 后端 | 客户ID, 商品列表 | 批量订单ID | 前端提交 | ⏳ pending | +| manageCreditPeriod | 后端 | 客户ID, 账期设置 | 账期记录 | 前端提交 | ⏳ pending | +| storeCertificate | 后端 | 证书信息 | 证书ID | 前端提交 | ⏳ pending | +| checkCompliance | 后端 | 商品ID, 平台ID | 合规结果 | 前端请求 | ⏳ pending | +| selectLogisticsStrategy | 后端 | 订单ID, 目的地 | 物流方案 | 订单创建 | ⏳ pending | +| calculateShippingFee | 后端 | 商品ID, 数量, 目的地 | 运费 | 前端请求 | ⏳ pending | +| calculateUserAssets | 后端 | 用户ID | 资产数据 | 前端请求 | ⏳ pending | +| manageUserPoints | 后端 | 用户ID, 积分操作 | 积分记录 | 前端提交 | ⏳ pending | +| manageMembershipLevel | 后端 | 用户ID, 等级规则 | 等级信息 | 定时任务 | ⏳ pending | +| createABTest | 后端 | 测试ID, 参数 | 测试实例 | 前端提交 | ⏳ pending | +| allocateTraffic | 后端 | 测试ID, 用户ID | 实验组 | 用户访问 | ⏳ pending | +| authenticateUser | 后端 | 用户名, 密码 | 认证令牌 | 前端提交 | ⏳ pending | +| managePermissions | 后端 | 用户ID, 权限 | 权限列表 | 前端请求 | ⏳ pending | +| manageSession | 后端 | 用户ID, 令牌 | 会话信息 | 请求验证 | ⏳ pending | + +--- + +## 📈 里程碑与关键路径 + +### Phase 1: 核心功能(Week 1-2) +- ✅ 商品管理基础功能 +- 🟡 订单管理基础功能 +- ⏳ 库存管理基础功能 +- ⏳ 基础财务对账 +- ⏳ 广告计划与营销闭环【P0】 +- ⏳ 售后逆向闭环【P0】 +- ⏳ B2B / TOB 贸易管理闭环【P0】 + +### Phase 2: 扩展功能(Week 3-4) +- ⏳ 多平台订单集中管理 +- ⏳ 素材管理系统 +- ⏳ AI智能定价 +- ⏳ 风控系统 +- ⏳ 合规与证书管理闭环【P1】 +- ⏳ 物流策略与渠道选择闭环【P1】 +- ⏳ 用户/客户资产闭环【P1】 + +### Phase 3: 高级功能(Week 5-6) +- ⏳ 海外仓管理 +- ⏳ 数据大屏与分析 +- ⏳ 自动化运维 +- ⏳ A/B测试与策略优化闭环【P2】 +- ⏳ 认证服务模块【P2】 + +### Phase 4: 基础设施(Week 7-8) +- ⏳ 数据库设计与表定义【P3】 +- ⏳ 测试用例与质量保证【P3】 +- ⏳ 系统监控与告警优化 + +--- + +## 🎯 质量指标 + +| 指标 | 目标值 | 当前值 | 状态 | +|------|--------|--------|------| +| 任务完成率 | 100% | 25% | 🟡 需提升 | +| 代码测试覆盖率 | 80% | 30% | 🟡 需提升 | +| 接口响应时间 | <200ms | - | ⏳ 待测试 | +| 系统可用性 | 99.9% | - | ⏳ 待监控 | +| AI决策准确率 | 95% | - | ⏳ 待验证 | + +--- + +## 📝 使用说明 + +### AI Agent使用流程 +1. **任务认领**:AI Agent从pending任务中选择符合能力的任务 +2. **状态更新**:认领后更新为claimed,开始生成代码 +3. **执行部署**:代码生成后更新为in_progress,开始执行 +4. **完成验证**:执行成功后更新为completed,失败则更新为failed +5. **依赖检查**:检查依赖任务状态,确保执行顺序正确 + +### 任务依赖规则 +- **直接依赖**:任务必须在依赖任务完成后才能开始 +- **间接依赖**:通过依赖链传递,确保整体流程正确 +- **循环依赖**:禁止任务间存在循环依赖 + +### 失败处理机制 +- **自动重试**:失败任务自动重试3次 +- **人工干预**:重试失败后标记为failed,等待人工处理 +- **回滚机制**:关键任务失败时自动回滚相关操作 + +--- + +**最后更新时间**:2026-03-18 +**维护者**:Crawlful Hub AI Team \ No newline at end of file diff --git a/docs/01_Architecture/Module_Blueprints.md b/docs/01_Architecture/Module_Blueprints.md new file mode 100644 index 0000000..18b95a5 --- /dev/null +++ b/docs/01_Architecture/Module_Blueprints.md @@ -0,0 +1,72 @@ +# 🎨 Module Blueprints (Crawlful Hub) + +> **定位**:Crawlful Hub 业务模块前端集成蓝图 - 包含核心业务功能的前端实现与交互设计。 +> **更新日期**: 2026-03-17 + +--- + +## 1. 订单管理模块 (OMS) + +### 1.1 订单工作台 (oms-workbench.md) +- **场景**: 统一订单归集、分润与基础状态流转。 +- **功能**: 多渠道筛选、批量审核/发货、异常标记。 + +### 1.2 订单利润分析 (order-profit-analysis.md) +- **核心逻辑**: 销售收入 - 采购成本 - 平台费 - 物流 - 税费。 +- **交互**: 订单列表下钻、利润红线预警。 + +### 1.3 物流健康状态 (logistics-health-ui.md) +- **监控**: 多渠道实时轨迹遥测、异常节点告警 (48h+ 停留)。 + +--- + +## 2. 财务管理模块 (FIN) + +### 2.1 财务对账 (finance-recon.md) +- **场景**: 平台账单拉取、自动差异匹配、对账差异关闭。 +- **机制**: ZKP 隐私审计,差异项可回溯到订单明细。 + +### 2.2 多币种对账 (multi-currency-recon.md) +- **功能**: 多币种换算口径、汇率自动同步。 + +### 2.3 平台费用监控 (platform-fee-watcher-ui.md) +- **场景**: 实时监控平台收取的各类佣金、广告投入与退款流水。 + +--- + +## 3. 库存管理模块 (WMS) + +### 3.1 库存老化分析 (inventory-aging-ui.md) +- **功能**: 分析周转天数、识别呆滞库存。 + +### 3.2 库存预测与补货 (inventory-forecast-replenishment.md) +- **算法**: `(销量预测 * 采购周期 + 安全库存 - 在途)`。 + +### 3.3 库存计划 (stock-planner-ui.md) +- **场景**: 基于销售预测与仓库健康度制定采购需求池。 + +--- + +## 4. 供应商与客户管理 (SCM/CRM) + +### 4.1 供应商产能监控 (supplier-capacity-watch.md) +- **场景**: 评估供应商交付准时率、质量评分与实时产能状态。 + +### 4.2 CRM 客户管理 (crm-hub.md) +- **功能**: 客户 360 视图、订单历史、客诉记录与信用分级。 + +--- + +## 5. 营销与广告管理 (MKT) + +### 5.1 广告计划看板 (ad-campaign-dashboard.md) +- **场景**: 跨平台广告投放监控与预算动态优化。 +- **功能**: ROAS 实时监控、自动调价建议、亏损活动预警。 + +--- + +## 6. 交付标准 (Delivery Standards) + +- **UI/UX**: 符合 Ant Design 5.x 规范,具备加载状态与错误处理。 +- **API**: 每一个按钮点击必须生成 `AuditLog`,携带 `traceId`。 +- **校验**: 所有功能需通过 Shadow-Test (最小冒烟测试)。 diff --git a/docs/01_Architecture/System_Architecture.md b/docs/01_Architecture/System_Architecture.md new file mode 100644 index 0000000..99fea57 --- /dev/null +++ b/docs/01_Architecture/System_Architecture.md @@ -0,0 +1,69 @@ +# 🏗 System Architecture (Crawlful Hub) + +> **定位**:Crawlful Hub 系统架构与设计蓝图 - 包含后端、前端、插件、事件总线及项目依赖规则。 +> **更新日期**: 2026-03-17 + +--- + +## 1. 架构总览 (Architecture Overview) + +### 1.1 核心目标 +- **业务闭环**:构建完整的跨境电商贸易管理系统。 +- **高可用性**:确保多渠道订单与库存同步的准确性与稳定性。 + +### 1.2 三层系统架构 +- **Console (前端中控台)**:统一登录、订单管理、商品刊登、财务对账、经营报表。 +- **Hub (后端服务层)**:业务逻辑处理、数据持久化、任务调度、消息通知。 +- **Extension (边缘执行层)**: + - 插件负责轻量采集、DOM 解析与自动化执行; + - 负责指纹隔离与环境自检。 + +--- + +## 2. 后端技术架构 (Backend Infra) + +### 2.1 技术栈与目录 +- **Runtime**: Node.js v20+, TypeScript (Strict Mode). +- **Domains (领域)**: Trade, Finance, Product, Logistics, Supplier. +- **Service (逻辑)**: 领域操作、仓储协调、定价计算。 +- **Repository (存储)**: 数据库查询 (Knex.js)、缓存策略 (Redis)。 + +### 2.2 事件总线架构 (Event Bus) +- **机制**: 异步通信、削峰填谷、系统解耦。 +- **应用**: 跨域同步(如:订单创建后触发库存预留、财务预记账)。 + +--- + +## 3. 前端与插件设计 (Frontend & Extension) + +### 3.1 前端控制台 (Console) +- **核心模式**: 业务审核工作流 (Business-Review-Workflow)。 +- **状态管理**: **Zustand** (全局状态) + **TanStack Query** (服务端缓存)。 +- **全链路溯源**: 每一笔操作必须绑定 `traceId`,UI 可视化操作链路。 + +### 3.2 插件端 (Extension) +- **采集引擎**: 多平台适配器 (1688, Amazon, Shopee)。 +- **执行逻辑**: 接收 Hub 指令,在浏览器侧模拟点击、填充表单。 +- **安全**: 独立 Proxy 配置、指纹隔离、速率限制。 + +--- + +## 4. 项目结构与依赖规则 (Project Structure) + +### 4.1 允许的依赖方向 (Allowed) +- `API` → `Service` → `Repository` → `Models` +- `Service` → `Utils` +- `Domains` → `Service` + +### 4.2 禁止的依赖方向 (Forbidden) +- **Repository ✗ Service**: 下层不能依赖上层。 +- **API ✗ Repository**: 接口层严禁直接操作数据库。 +- **Service ✗ API**: 业务逻辑层不应感知 HTTP 请求。 + +--- + +## 5. 关键状态机与流程 (State Machines) + +- **有 API 平台**: 走 `Connector Bus` 标准协议。 +- **无 API 平台**: 走 `No-API Bridge`,采用 `Collect -> Clean -> Review -> Publish` 流程。 +- **统一发布编排**: 由 `PublishOrchestrator` 统一管理。 diff --git a/docs/02_Backend/API_Specs/Data_API_Specs.md b/docs/02_Backend/API_Specs/Data_API_Specs.md new file mode 100644 index 0000000..b859a2f --- /dev/null +++ b/docs/02_Backend/API_Specs/Data_API_Specs.md @@ -0,0 +1,88 @@ +# 📊 Data & API Specifications (Crawlful Hub) + +> **定位**:Crawlful Hub 数据架构与接口规格书 - 包含数据库 Schema、核心业务流程及全量 API 定义。 +> **更新日期**: 2026-03-17 + +--- + +## 1. 数据库结构 (Data Schema) + +### 1.1 命名规范 +- **表前缀**: `cf_` (crawlful) +- **字段命名**: snake_case +- **金額字段**: `decimal(10,2)` 或更高精度。 +- **物理单位**: 长度 (cm), 重量 (kg), 体积 (m³)。 + +### 1.2 核心表定义 + +#### 租户与用户 +- `cf_tenant`: 租户 ID、名称、配额、状态。 +- `cf_user`: 邮箱、密码哈希、角色 (ADMIN/MANAGER 等)、租户 ID。 + +#### 店铺与商品 +- `cf_shop`: 租户 ID、平台 (AMAZON/TIKTOK 等)、授权 Token。 +- `cf_product`: 租户 ID、源平台 ID、标题、描述、JSON 图片列表。 +- `cf_product_sku`: SKU 编码、属性 JSON、成本价、零售价、重量/尺寸。 + +#### 订单与库存 +- `cf_inventory`: SKU ID、仓库 ID、总数量、可用/预留数量。 +- `cf_order`: 平台订单号、总金额、货币、利润/利润率、状态。 +- `cf_order_item`: 订单项、SKU ID、单价、数量。 + +#### 供应链与财务 +- `cf_supplier`: 供应商名称、联系方式、评分、状态。 +- `cf_purchase_order`: 采购单号、供应商 ID、总金额、状态。 +- `cf_finance_reconciliation`: 对账周期、总销售/利润、差异状态。 + +--- + +## 2. 核心业务流程 (Business Processes) + +### 2.1 商品采集与刊登 (Collection & Listing) +1. **采集**: 用户输入 URL → Extension 解析 DOM → 发送至 Hub 草稿箱。 +2. **刊登**: 选择草稿 → 平台适配器转换字段 → 调用平台 API 发布 → 记录刊登历史。 + +### 2.2 订单履约与财务 (Fulfillment & Finance) +1. **订单**: 平台 Webhook 推送 → 解析并入库 → 利润审计 (红线校验) → 状态流转。 +2. **库存**: 平台同步 → 更新本地库存 → 低于阈值自动触发补货提醒。 +3. **对账**: 拉取平台账单 → 自动差异匹配 → 生成报告 → 人工审核异常项。 + +--- + +## 3. 全量 API 端点映射 (API Map) + +### 3.1 基础管理 +- `POST /api/auth/login`: 用户登录。 +- `GET /api/users`: 获取用户列表。 +- `GET /api/shops`: 获取授权店铺。 + +### 3.2 商品与库存 (Product & Inventory) +- `GET /api/products`: 获取商品列表。 +- `POST /api/products/publish`: 发布商品到平台。 +- `GET /api/inventory/aging`: 库存老化分析。 +- `GET /api/inventory/forecast`: 库存预测。 + +### 3.3 订单与支付 (Order & Payment) +- `GET /api/orders`: 获取订单列表。 +- `PUT /api/orders/:id/status`: 更新订单状态。 +- `POST /api/payments`: 创建支付订单。 +- `POST /api/payments/callback`: 处理支付回调。 + +### 3.4 财务管理 (Finance) +- `GET /api/finance/reconciliation`: 财务对账。 + +--- + +## 4. 通用响应与状态码 + +### 响应格式 +```typescript +{ + "success": true, + "data": { ... }, + "error": "optional error message" +} +``` + +### 常用状态码 +- `200`: 成功 | `401`: 未授权 | `403`: 禁止访问 | `404`: 资源不存在 | `500`: 服务器错误。 diff --git a/docs/07_Testing/Quality_Optimization.md b/docs/07_Testing/Quality_Optimization.md new file mode 100644 index 0000000..077730c --- /dev/null +++ b/docs/07_Testing/Quality_Optimization.md @@ -0,0 +1,44 @@ +# 💎 Quality & Optimization (Crawlful Hub) + +> **定位**:Crawlful Hub 质量保障与内容优化 - 包含前端交付标准、UX 检查清单及文档内容分析报告。 +> **更新日期**: 2026-03-17 + +--- + +## 1. 前端交付质量标准 (Frontend Delivery) + +### 1.1 UI/UX 规范 +- **框架**: UmiJS 4.x, Ant Design 5.x. +- **交互模式**: 业务审核工作流 (Business-Review-Workflow). +- **Red Lines (严禁事项)**: 严禁 Mock 数据、严禁越权修改、严禁敏感数据暴露。 + +### 1.2 性能优化 +- **加载**: Code Splitting, Lazy Loading. +- **请求**: TanStack Query 缓存, 减少重渲染. + +--- + +## 2. 用户体验检查清单 (UX Checklist) + +### 2.1 加载与响应 +- [ ] 异步操作展示 Loading 状态。 +- [ ] 长时操作展示进度。 +- [ ] 按钮点击反馈即时。 + +### 2.2 错误与异常 +- [ ] 4xx 错误展示具体根因分析,而非模糊的“系统错误”。 +- [ ] 5xx 错误展示友好提示并记录 `traceId`。 + +--- + +## 3. 文档内容分析报告 (Document Review) + +### 3.1 质量与优化 +- **命名规范**: 文件名必须使用小写短横线 (kebab-case)。 +- **分类存放**: `docs/blueprints/`, `docs/quality/` 等。 +- **引用闭环**: 文档内引用必须使用完整 Markdown 链接。 +- **原子化更新**: 每次功能变更必须同步更新对应蓝图。 + +### 3.2 文档地图 +- 建议维护 `doc-index.md` 索引,确保全量文档导航。 +- 定期审查文档结构,确保与物理文件系统保持一致。 diff --git a/docs/10_Documents_Global/DOC_INDEX.md b/docs/10_Documents_Global/DOC_INDEX.md new file mode 100644 index 0000000..cd98ae6 --- /dev/null +++ b/docs/10_Documents_Global/DOC_INDEX.md @@ -0,0 +1,56 @@ +# 📚 Crawlful Hub Documentation Index + +> **说明**: 本文件是项目的深度索引,将全量文档聚合为核心蓝图与规格书,帮助开发者快速定位。 +> **核心任务表**: [Crawlful_Hub_Task_Overview_Full_v1.md](Crawlful_Hub_Task_Overview_Full_v1.md) (唯一业务到模块任务表) + +--- + +## 1️⃣ 业务核心 (01-business-core) +> 业务战略、功能蓝图、行业标杆 + +| 文件 | 说明 | +|------|------| +| [business-blueprint.md](01-business-core/business-blueprint.md) | **核心蓝图**: 包含项目目标、业务闭环、模块功能及标杆参考 (Merged) | +| [业务功能.md](业务功能.md) | **功能详述**: 聚合了订单、库存、财务、调价、广告等全量业务操作细节 (Updated) | + +--- + +## 2️⃣ 数据与 API (02-data-api) +> 数据 Schema、业务流程、接口规格 + +| 文件 | 说明 | +|------|------| +| [data-api-specs.md](02-data-api/data-api-specs.md) | **数据接口规格**: 包含数据库 Schema、核心业务流程图及全量 API 映射 (Merged) | + +--- + +## 3️⃣ 架构与技术 (03-architecture-tech) +> 系统架构、模块蓝图、技术栈 + +| 文件 | 说明 | +|------|------| +| [system-architecture.md](03-architecture-tech/system-architecture.md) | **系统架构**: 包含后端、前端、插件架构设计及依赖规则 (Merged) | +| [module-blueprints.md](03-architecture-tech/module-blueprints.md) | **功能蓝图**: 包含 OMS, WMS, Finance, MKT 等模块的前端集成蓝图 (Merged) | + +--- + +## 4️⃣ 规范与治理 (04-standards-governance) +> 开发标准、协作协议、运维治理 + +| 文件 | 说明 | +|------|------| +| [governance-standards.md](04-standards-governance/governance-standards.md) | **治理规范**: 包含开发标准、JSDoc 规范、协作协议及风险治理 (Refactored) | + +--- + +## 5️⃣ 质量与优化 (05-quality-optimization) +> 交付标准、体验检查、文档报告 + +| 文件 | 说明 | +|------|------| +| [quality-optimization.md](05-quality-optimization/quality-optimization.md) | **质量标准**: 包含前端交付质量标准、UX 检查清单及文档优化报告 (Merged) | + +--- + +### 📂 归档 (Archive) +- [archive/](archive/) - 历史方案、旧版任务记录 diff --git a/docs/10_Documents_Global/PROJECT_MAP.md b/docs/10_Documents_Global/PROJECT_MAP.md new file mode 100644 index 0000000..0096f2a --- /dev/null +++ b/docs/10_Documents_Global/PROJECT_MAP.md @@ -0,0 +1,192 @@ +# Crawlful Hub 文档结构图 + +## 完整目录树 + +``` +Crawlful_Hub/ +│ +├─ 00_Business/ # 业务层文档 +│ ├─ Business_ClosedLoops.md # 业务闭环文档(核心) +│ ├─ Business_Blueprint.md # 业务蓝图 +│ ├─ Business_Features.md # 业务功能说明 +│ ├─ Business_9.md # 业务9 +│ ├─ Governance_Standards.md # 治理标准 +│ └─ Task_Overview.md # 任务概览 +│ +├─ 01_Architecture/ # 架构层文档 +│ ├─ System_Architecture.md # 系统架构 +│ ├─ Module_Blueprints.md # 模块蓝图 +│ ├─ Module_Responsibilities.md # 模块职责(待创建) +│ ├─ AI_Agent_Interaction.md # AI Agent 交互(待创建) +│ ├─ Data_Flow_Diagrams/ # 数据流图 +│ └─ Sequence_Flow_Diagrams/ # 业务流程图 +│ +├─ 02_Backend/ # 后端文档 +│ ├─ Backend_Design.md # 后端设计(待创建) +│ ├─ API_Specs/ # API 规范 +│ │ ├─ Data_API_Specs.md # 数据 API 规范 +│ │ ├─ Product_API.md # 商品 API(待创建) +│ │ ├─ Order_API.md # 订单 API(待创建) +│ │ └─ Finance_API.md # 财务 API(待创建) +│ ├─ Database/ # 数据库文档 +│ │ ├─ ERD.md # 数据库设计图(待创建) +│ │ └─ Table_Definitions.md # 表定义(待创建) +│ ├─ Services/ # 服务模块说明(待创建) +│ └─ Backend_Automation.md # 后端自动化(待创建) +│ +├─ 03_Frontend/ # 前端文档 +│ ├─ Frontend_Design.md # 前端设计(待创建) +│ ├─ UI_Components.md # UI 组件(待创建) +│ ├─ Pages_Flow.md # 页面流转(待创建) +│ ├─ API_Consumption.md # API 调用(待创建) +│ └─ Frontend_Automation.md # 前端自动化(待创建) +│ +├─ 04_Plugin/ # 插件文档 +│ ├─ Plugin_Design.md # 插件设计(待创建) +│ ├─ DOM_Interaction.md # DOM 交互(待创建) +│ ├─ Automation_Scripts.md # 自动化脚本(待创建) +│ └─ Plugin_Agent_Integration.md # 插件集成(待创建) +│ +├─ 05_AI/ # AI 文档 +│ ├─ AI_Strategy.md # AI 策略(待创建) +│ ├─ AI_Context.md # AI 上下文(待创建) +│ ├─ AI_Tasks.md # AI 任务(待创建) +│ ├─ AI_Training_Data/ # AI 训练数据 +│ └─ AI_Model_Integration.md # AI 模型集成(待创建) +│ +├─ 06_ETL/ # ETL 文档 +│ ├─ ETL_Pipelines.md # ETL 流程(待创建) +│ ├─ ETL_Scripts/ # ETL 脚本 +│ └─ ETL_Data_Samples/ # ETL 样例数据 +│ +├─ 07_Testing/ # 测试文档 +│ ├─ Test_Strategy.md # 测试策略(待创建) +│ ├─ Quality_Optimization.md # 质量优化 +│ ├─ Unit_Tests/ # 单元测试 +│ ├─ Integration_Tests/ # 集成测试 +│ └─ Test_Reports/ # 测试报告 +│ +├─ 08_Deployment/ # 部署文档 +│ ├─ Deployment_Guide.md # 部署指南(待创建) +│ ├─ CI_CD_Pipelines.md # CI/CD 流程(待创建) +│ └─ Environment_Configs/ # 环境配置 +│ +├─ 09_Operations/ # 运维文档 +│ ├─ Monitoring.md # 监控(待创建) +│ ├─ Logging.md # 日志(待创建) +│ ├─ Exception_Handling.md # 异常处理(待创建) +│ └─ Maintenance_Guide.md # 维护指南(待创建) +│ +├─ 10_Documents_Global/ # 全局文档 +│ ├─ PROJECT_MAP.md # 项目地图(待创建) +│ ├─ README.md # 项目总览(待创建) +│ ├─ Changelog.md # 变更日志(待创建) +│ └─ DOC_INDEX.md # 文档索引 +│ +└─ 11_References/ # 参考资料 + ├─ Platform_API_Docs/ # 平台 API 文档 + ├─ Regulatory_Requirements.md # 合规要求(待创建) + └─ Glossary.md # 术语表(待创建) +``` + +## 模块依赖关系 + +``` +00_Business (业务层) + ↓ +01_Architecture (架构层) + ↓ +02_Backend (后端层) + 03_Frontend (前端层) + 04_Plugin (插件层) + ↓ +05_AI (AI 层) + 06_ETL (ETL 层) + ↓ +07_Testing (测试层) + 08_Deployment (部署层) + 09_Operations (运维层) + ↓ +10_Documents_Global (全局文档) + 11_References (参考资料) +``` + +## 文档状态说明 + +### 已创建文档 +- ✅ 00_Business/Business_ClosedLoops.md +- ✅ 00_Business/Business_Blueprint.md +- ✅ 00_Business/Business_Features.md +- ✅ 00_Business/Business_9.md +- ✅ 00_Business/Governance_Standards.md +- ✅ 00_Business/Task_Overview.md +- ✅ 01_Architecture/System_Architecture.md +- ✅ 01_Architecture/Module_Blueprints.md +- ✅ 02_Backend/API_Specs/Data_API_Specs.md +- ✅ 07_Testing/Quality_Optimization.md +- ✅ 10_Documents_Global/DOC_INDEX.md + +### 待创建文档 +- ❌ 01_Architecture/Module_Responsibilities.md +- ❌ 01_Architecture/AI_Agent_Interaction.md +- ❌ 02_Backend/Backend_Design.md +- ❌ 02_Backend/API_Specs/Product_API.md +- ❌ 02_Backend/API_Specs/Order_API.md +- ❌ 02_Backend/API_Specs/Finance_API.md +- ❌ 02_Backend/Database/ERD.md +- ❌ 02_Backend/Database/Table_Definitions.md +- ❌ 02_Backend/Services/* +- ❌ 02_Backend/Backend_Automation.md +- ❌ 03_Frontend/* +- ❌ 04_Plugin/* +- ❌ 05_AI/* +- ❌ 06_ETL/ETL_Pipelines.md +- ❌ 07_Testing/Test_Strategy.md +- ❌ 08_Deployment/* +- ❌ 09_Operations/* +- ❌ 10_Documents_Global/PROJECT_MAP.md +- ❌ 10_Documents_Global/README.md +- ❌ 10_Documents_Global/Changelog.md +- ❌ 11_References/Regulatory_Requirements.md +- ❌ 11_References/Glossary.md + +## 文档优先级 + +### P0 - 核心文档(必须创建) +- 00_Business/Business_ClosedLoops.md ✅ +- 01_Architecture/System_Architecture.md ✅ +- 02_Backend/API_Specs/* (至少包含核心 API) +- 10_Documents_Global/README.md + +### P1 - 重要文档(应该创建) +- 00_Business/Business_Blueprint.md ✅ +- 01_Architecture/Module_Blueprints.md ✅ +- 02_Backend/Database/ERD.md +- 02_Backend/Database/Table_Definitions.md +- 07_Testing/Test_Strategy.md +- 08_Deployment/Deployment_Guide.md + +### P2 - 辅助文档(可以创建) +- 03_Frontend/* +- 04_Plugin/* +- 05_AI/* +- 06_ETL/* +- 09_Operations/* +- 11_References/* + +## 文档迁移记录 + +### 从 docs11 迁移到 docs + +| 原路径 | 新路径 | 状态 | +|--------|--------|------| +| docs11/00-documentation-layer.md | docs/00_Business/Business_ClosedLoops.md | ✅ 已迁移 | +| docs11/业务功能.md | docs/00_Business/Business_Features.md | ✅ 已迁移 | +| docs11/doc-index.md | docs/10_Documents_Global/DOC_INDEX.md | ✅ 已迁移 | +| docs11/Crawlful_Hub_Task_Overview_Full_v1.md | docs/00_Business/Task_Overview.md | ✅ 已迁移 | +| docs11/01-business-core/business-blueprint.md | docs/00_Business/Business_Blueprint.md | ✅ 已迁移 | +| docs11/01-business-core/业务9.md | docs/00_Business/Business_9.md | ✅ 已迁移 | +| docs11/02-data-api/data-api-specs.md | docs/02_Backend/API_Specs/Data_API_Specs.md | ✅ 已迁移 | +| docs11/03-architecture-tech/module-blueprints.md | docs/01_Architecture/Module_Blueprints.md | ✅ 已迁移 | +| docs11/03-architecture-tech/system-architecture.md | docs/01_Architecture/System_Architecture.md | ✅ 已迁移 | +| docs11/04-standards-governance/governance-standards.md | docs/00_Business/Governance_Standards.md | ✅ 已迁移 | +| docs11/05-quality-optimization/quality-optimization.md | docs/07_Testing/Quality_Optimization.md | ✅ 已迁移 | + +--- + +**最后更新时间**:2026-03-17 +**维护者**:Crawlful Hub 团队 \ No newline at end of file diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..d69d4e0 --- /dev/null +++ b/docs/README.md @@ -0,0 +1,195 @@ +# Crawlful Hub 文档结构 + +本文档描述了 Crawlful Hub 项目的文档组织结构,便于团队成员快速定位和理解各个文档的用途。 + +## 📁 目录结构 + +``` +docs/ +├─ 00_Business/ # 业务层文档 +│ ├─ Business_ClosedLoops.md # 业务闭环文档(核心) +│ ├─ Business_Blueprint.md # 业务蓝图 +│ ├─ Business_Features.md # 业务功能说明 +│ ├─ Business_9.md # 业务9 +│ ├─ Governance_Standards.md # 治理标准 +│ └─ Task_Overview.md # 任务概览 +│ +├─ 01_Architecture/ # 架构层文档 +│ ├─ System_Architecture.md # 系统架构 +│ ├─ Module_Blueprints.md # 模块蓝图 +│ ├─ Module_Responsibilities.md # 模块职责(待创建) +│ ├─ AI_Agent_Interaction.md # AI Agent 交互(待创建) +│ ├─ Data_Flow_Diagrams/ # 数据流图 +│ └─ Sequence_Flow_Diagrams/ # 业务流程图 +│ +├─ 02_Backend/ # 后端文档 +│ ├─ Backend_Design.md # 后端设计(待创建) +│ ├─ API_Specs/ # API 规范 +│ │ ├─ Data_API_Specs.md # 数据 API 规范 +│ │ ├─ Product_API.md # 商品 API(待创建) +│ │ ├─ Order_API.md # 订单 API(待创建) +│ │ └─ Finance_API.md # 财务 API(待创建) +│ ├─ Database/ # 数据库文档 +│ │ ├─ ERD.md # 数据库设计图(待创建) +│ │ └─ Table_Definitions.md # 表定义(待创建) +│ ├─ Services/ # 服务模块说明(待创建) +│ └─ Backend_Automation.md # 后端自动化(待创建) +│ +├─ 03_Frontend/ # 前端文档 +│ ├─ Frontend_Design.md # 前端设计(待创建) +│ ├─ UI_Components.md # UI 组件(待创建) +│ ├─ Pages_Flow.md # 页面流转(待创建) +│ ├─ API_Consumption.md # API 调用(待创建) +│ └─ Frontend_Automation.md # 前端自动化(待创建) +│ +├─ 04_Plugin/ # 插件文档 +│ ├─ Plugin_Design.md # 插件设计(待创建) +│ ├─ DOM_Interaction.md # DOM 交互(待创建) +│ ├─ Automation_Scripts.md # 自动化脚本(待创建) +│ └─ Plugin_Agent_Integration.md # 插件集成(待创建) +│ +├─ 05_AI/ # AI 文档 +│ ├─ AI_Strategy.md # AI 策略(待创建) +│ ├─ AI_Context.md # AI 上下文(待创建) +│ ├─ AI_Tasks.md # AI 任务(待创建) +│ ├─ AI_Training_Data/ # AI 训练数据 +│ └─ AI_Model_Integration.md # AI 模型集成(待创建) +│ +├─ 06_ETL/ # ETL 文档 +│ ├─ ETL_Pipelines.md # ETL 流程(待创建) +│ ├─ ETL_Scripts/ # ETL 脚本 +│ └─ ETL_Data_Samples/ # ETL 样例数据 +│ +├─ 07_Testing/ # 测试文档 +│ ├─ Test_Strategy.md # 测试策略(待创建) +│ ├─ Quality_Optimization.md # 质量优化 +│ ├─ Unit_Tests/ # 单元测试 +│ ├─ Integration_Tests/ # 集成测试 +│ └─ Test_Reports/ # 测试报告 +│ +├─ 08_Deployment/ # 部署文档 +│ ├─ Deployment_Guide.md # 部署指南(待创建) +│ ├─ CI_CD_Pipelines.md # CI/CD 流程(待创建) +│ └─ Environment_Configs/ # 环境配置 +│ +├─ 09_Operations/ # 运维文档 +│ ├─ Monitoring.md # 监控(待创建) +│ ├─ Logging.md # 日志(待创建) +│ ├─ Exception_Handling.md # 异常处理(待创建) +│ └─ Maintenance_Guide.md # 维护指南(待创建) +│ +├─ 10_Documents_Global/ # 全局文档 +│ ├─ PROJECT_MAP.md # 项目地图(待创建) +│ ├─ README.md # 项目总览(待创建) +│ ├─ Changelog.md # 变更日志(待创建) +│ └─ DOC_INDEX.md # 文档索引 +│ +└─ 11_References/ # 参考资料 + ├─ Platform_API_Docs/ # 平台 API 文档 + ├─ Regulatory_Requirements.md # 合规要求(待创建) + └─ Glossary.md # 术语表(待创建) +``` + +## 📋 文档分类说明 + +### 00_Business/ - 业务层 +包含所有业务相关的文档,是理解项目业务逻辑的核心。 + +**核心文档**: +- `Business_ClosedLoops.md` - 完整的业务闭环文档,涵盖 TOC/TOB 双向闭环 +- `Business_Blueprint.md` - 业务蓝图,描述整体业务架构 +- `Business_Features.md` - 详细的功能说明 + +### 01_Architecture/ - 架构层 +描述系统的技术架构和模块设计。 + +**核心文档**: +- `System_Architecture.md` - 系统总体架构 +- `Module_Blueprints.md` - 各模块的详细设计 + +### 02_Backend/ - 后端层 +后端技术实现文档,包括 API、数据库、服务等。 + +**核心文档**: +- `API_Specs/` - 所有 API 的详细规范 +- `Database/` - 数据库设计和表结构 + +### 03_Frontend/ - 前端层 +前端技术实现文档,包括 UI 组件、页面流转等。 + +### 04_Plugin/ - 插件层 +浏览器插件的设计和实现文档。 + +### 05_AI/ - AI 层 +AI 相关的文档,包括策略、上下文、任务等。 + +### 06_ETL/ - ETL 层 +数据采集、清洗、处理的流程和脚本。 + +### 07_Testing/ - 测试层 +测试策略、用例、报告等文档。 + +### 08_Deployment/ - 部署层 +部署指南、CI/CD 流程、环境配置等。 + +### 09_Operations/ - 运维层 +监控、日志、异常处理、维护指南等。 + +### 10_Documents_Global/ - 全局文档 +项目级别的文档,包括总览、索引、变更日志等。 + +### 11_References/ - 参考资料 +外部参考文档,如平台 API、合规要求、术语表等。 + +## 🎯 快速导航 + +### 新人入门 +1. 阅读 `00_Business/Business_ClosedLoops.md` 了解业务闭环 +2. 阅读 `01_Architecture/System_Architecture.md` 了解系统架构 +3. 阅读 `10_Documents_Global/DOC_INDEX.md` 查看文档索引 + +### 开发人员 +1. 阅读 `01_Architecture/` 下的架构文档 +2. 阅读 `02_Backend/` 或 `03_Frontend/` 下的技术文档 +3. 参考 `11_References/` 下的平台 API 文档 + +### 测试人员 +1. 阅读 `07_Testing/Test_Strategy.md` 了解测试策略 +2. 查看 `07_Testing/` 下的测试文档 + +### 运维人员 +1. 阅读 `08_Deployment/Deployment_Guide.md` 了解部署流程 +2. 阅读 `09_Operations/` 下的运维文档 + +## 📝 文档规范 + +### 命名规范 +- 文件名使用大驼峰命名法(PascalCase) +- 文件扩展名为 `.md` +- 避免使用特殊字符和空格 + +### 内容规范 +- 使用 Markdown 格式 +- 包含清晰的标题层级 +- 适当使用表格、代码块、流程图等 +- 标注文档最后更新时间 + +### 版本控制 +- 所有文档纳入 Git 版本控制 +- 重要变更记录在 `10_Documents_Global/Changelog.md` +- 遵循项目的 Git 工作流程 + +## 🔗 相关资源 + +- 项目根目录:`d:\trae_projects\makemd\makemd` +- 原文档目录:`d:\trae_projects\makemd\makemd\docs11` +- 项目规则:`d:\trae_projects\makemd\makemd\.trae\rules\project-specific-rules.md` + +## 📞 联系方式 + +如有文档相关问题,请联系项目维护者。 + +--- + +**最后更新时间**:2026-03-17 +**维护者**:Crawlful Hub 团队 \ No newline at end of file diff --git a/docs1/Business_ClosedLoops.md b/docs1/Business_ClosedLoops.md new file mode 100644 index 0000000..b0070b1 --- /dev/null +++ b/docs1/Business_ClosedLoops.md @@ -0,0 +1,964 @@ +# 📌 Crawlful Hub 业务闭环(TOC + TOB Unified Business Loops) + +> **说明**:本闭环文档是战略层业务流程,关注“做什么、为什么做、顺序和决策点”,为下层模块功能和系统实现提供指引。TOC(零售/前端)和 TOB(B2B贸易)共享通用模块,特有流程用 `businessType` 标记。 + +## 📑 目录 + +1. [数据采集与清洗闭环](#1️⃣-数据采集与清洗闭环product-data-collection--cleansing) +2. [商品刊登闭环](#2️⃣-商品刊登闭环product-listing-loop) +3. [素材管理闭环](#3️⃣-素材管理闭环media--asset-management-loop) +4. [广告计划与营销闭环](#4️⃣-广告计划与营销闭环marketing--ad-management-loop) +5. [订单履约闭环](#5️⃣-订单履约闭环order-fulfillment-loop--oms) +6. [售后逆向闭环](#6️⃣-售后逆向闭环returns--refunds-loop) +7. [资金对账闭环](#7️⃣-资金对账闭环finance-reconciliation-loop) +8. [库存与仓储管理闭环](#8️⃣-库存与仓储管理闭环inventory--warehouse-management-loop--wms) +9. [供应链与供应商管理闭环](#9️⃣-供应链与供应商管理闭环supply-chain--supplier-management-loop) +10. [B2B / TOB 贸易管理闭环](#🔟-b2b--tob-贸易管理闭环b2b--tob-trade-management-loop) +11. [治理与审批中心闭环](#1️⃣1️⃣-治理与审批中心闭环governance--approval-center-loop) +12. [合规与证书管理闭环](#1️⃣2️⃣-合规与证书管理闭环compliance--certificate-management-loop) +13. [合规与风控闭环](#1️⃣3️⃣-合规与风控闭环compliance--risk-control-loop) +14. [报表与分析闭环](#1️⃣4️⃣-报表与分析闭环reporting--analytics-loop) +15. [定价与利润决策闭环](#1️⃣5️⃣-定价与利润决策闭环pricing--profit-decision-loop) +16. [账号/店铺健康度闭环](#1️⃣6️⃣-账号/店铺健康度闭环accountshop-health-loop) +17. [店铺隔离与自动化闭环](#1️⃣7️⃣-店铺隔离与自动化闭环shop-isolation--automation-loop) +18. [订单集中管理闭环](#1️⃣8️⃣-订单集中管理闭环order-centralized-management-loop) +19. [客户/商家押金与账户管理闭环](#1️⃣9️⃣-客户商家押金与账户管理闭环customer-merchant-deposit--account-management-loop) +20. [商家选择发货闭环](#2️⃣0️⃣-商家选择发货闭环merchant-selective-fulfillment-loop) +21. [回款与财务闭环](#2️⃣1️⃣-回款与财务闭环payment--financial-reconciliation-loop) +22. [海外仓/本土仓 & 多品类支持闭环](#2️⃣2️⃣-海外仓本土仓--多品类支持闭环overseaslocal-warehouse--multi-category-support-loop) +23. [商品主数据闭环](#2️⃣3️⃣-商品主数据闭环product-master-data-loop--mdm) +24. [SKU变体与结构闭环](#2️⃣4️⃣-sku变体与结构闭环sku-variant--structure-loop) +25. [订单拆分与合并闭环](#2️⃣5️⃣-订单拆分与合并闭环order-split--merge-loop) +26. [异常订单处理闭环](#2️⃣6️⃣-异常订单处理闭环exception-order-handling-loop) +27. [物流策略与渠道选择闭环](#2️⃣7️⃣-物流策略与渠道选择闭环logistics-strategy--channel-selection-loop) +28. [利润核算闭环](#2️⃣8️⃣-利润核算闭环profit-calculation-loop) +29. [用户/客户资产闭环](#2️⃣9️⃣-用户客户资产闭环usercustomer-asset-loop) +30. [A/B测试与策略优化闭环](#3️⃣0️⃣-ab测试与策略优化闭环ab-testing--strategy-optimization-loop) +31. [统一闭环依赖](#🔹-统一闭环依赖toc--tob) +32. [闭环依赖关系](#🔗-闭环依赖关系toc--tob) +33. [关键绩效指标](#📊-关键绩效指标kpi) +34. [追踪与审计](#🔍-追踪与审计) +35. [业务审核状态机](#📋-业务审核状态机) +36. [说明](#💡-说明) + +*** + +## 1️⃣ 数据采集与清洗闭环(Product Data Collection & Cleansing) + +- **目标**:收集多平台商品信息,确保数据完整、有效、可用于盈利分析(TOC)或报价计算(TOB)。 +- **流程**: + 1. **多平台采集**: + - TOC:抓取 Amazon、eBay、Shopee、1688 等平台商品信息。 + - TOB:抓取供应商报价、批发价格、企业定制产品信息。 + - 支持 API 对接和爬虫采集。 + - 采集字段:标题、价格、库存、SKU、图片、描述、评价、供应商信息(TOB)。 + 2. **数据清洗**: + - 去重:平台+productId 唯一约束 + - 格式化:统一字段格式和单位 + - 字段标准化:规范属性名和值 + - 剔除无效商品:库存异常、价格异常、描述缺失 + 3. **前置套利 / 利润评估**: + - TOC:评估单件盈利、ROI、定价区间 + - TOB:评估阶梯价利润、批量折扣、信用额度风险 + - 考虑平台费、物流费、税费、汇率、售后成本、广告摊销 +- **决策点**: + - TOC:B2C 利润率 < 20% 触发风控 + - TOB:B2B 利润率 < 15% 禁止报价 +- **输入**:平台商品原始数据 +- **输出**:清洗后的可售商品/报价数据,包含完整套利/利润分析 + +*** + +## 2️⃣ 商品刊登闭环(Product Listing Loop) + +- **目标**:将可售商品同步到各平台,建立销售基础(TOC)或生成报价单(TOB)。 +- **流程**: + 1. **商品准备**: + - ERP 商品信息完善 + - 平台规则适配:标题、描述、图片、批量折扣(TOB) + - 价格策略设置:基于套利分析或阶梯价策略 + 2. **刊登执行**: + - 批量或单条刊登,支持失败重试和全链路追踪 + - API 平台:走 Connector Bus + - 无 API 平台:No-API Bridge + PENDING\_REVIEW + 3. **刊登后管理**: + - 库存同步、价格更新、商品状态监控 +- **决策点**: + - 必须通过前置套利/利润分析 + - TOB 需遵循阶梯价审批策略 +- **输入**:清洗后的可售商品数据 +- **输出**:已刊登商品列表 + 平台状态 + 链接 + +*** + +## 3️⃣ 素材管理闭环(Media & Asset Management Loop) + +- **目标**:统一管理商品、广告、营销所需素材,支持 TOC 广告投放和 TOB 企业报价资料。 +- **流程**: + - 素材采集、处理、审核、分发 + - TOC:图片/视频用于广告和商品展示 + - TOB:商品资料、合同模板、报价单模板 +- **决策点**: + - 版权合规、平台规则、素材质量 +- **输出**:素材库 + 元数据 + 使用统计 +- **状态机**:`UPLOADED` → `PROCESSING` → `PENDING_REVIEW` → `APPROVED` → `IN_USE` → `ARCHIVED`/`REJECTED` + +*** + +## 4️⃣ 广告计划与营销闭环(Marketing & Ad Management Loop) + +- **目标**:提升销量和 ROI(TOC)或企业促销效率(TOB)。 +- **流程**: + - 广告计划制定、跨平台投放、效果分析与优化 + - TOB:批量报价、促销方案、邮件/企业营销 +- **决策点**: + - 广告 ROI < 1 停止投放 + - 企业营销需基于信用等级和合同审批 +- **输入**:已刊登商品列表、素材 +- **输出**:广告报告、优化建议 + +*** + +## 5️⃣ 订单履约闭环(Order Fulfillment Loop / OMS) + +- **目标**:保证订单从生成到妥投的全链路履约。 +- **流程**: + - **公共流程**:订单获取与审核 → 分仓 → 占库 → 扣库 → 发货 → 物流追踪 + - **TOC**:标准订单处理流程 + - **TOB**:大额企业订单可分批发货、合同条款优先 +- **状态机**:`PULLED` → `PENDING_REVIEW` → `CONFIRMED` → `ALLOCATED` → `READY_TO_SHIP` → `SHIPPED` → `DELIVERED` → `CLOSED` +- **输入**:平台订单数据 +- **输出**:已发货订单,包含物流跟踪信息 + +*** + +## 6️⃣ 售后逆向闭环(Returns & Refunds Loop) + +- **目标**:处理退货/退款,保持库存和财务一致。 +- **流程**: + - **公共流程**:售后请求处理 → 退货处理 → 退款处理 + - **TOC**:标准退货流程 + - **TOB**:按合同条款、批量退货、预付款冲抵 +- **输入**:售后请求数据 +- **输出**:处理完成的售后记录,包含库存和财务调整 + +*** + +## 7️⃣ 资金对账闭环(Finance Reconciliation Loop) + +- **目标**:财务闭环,兼顾 TOC/TOB。 +- **流程**: + - 数据汇总 → 财务处理(多币种、VAT、汇率) → 差异分析与处理 +- **决策点**: + - 异常需人工复核 + - TOB 账期和信用额度影响结算 +- **输出**:对账报告 + 差异处理记录 + +*** + +## 8️⃣ 库存与仓储管理闭环(Inventory & Warehouse Management Loop / WMS) + +- **目标**:确保库存准确、仓储高效,支持全球供应链运作。 +- **流程**: + - **公共流程**:多仓库存管理 → 进出库管理 → 物流模式管理 + - **TOC**:按店铺和平台库存管理 + - **TOB**:按企业订单、批量调拨、FCL/3PL 管理 +- **决策点**: + - 库存不足时触发补货建议 + - 跨仓调拨决策:基于成本和时效 + - 安全库存预警阈值设置 +- **输入**:订单数据、采购数据、物流数据 +- **输出**:实时库存状态、仓储操作记录、库存预警 + +*** + +## 9️⃣ 供应链与供应商管理闭环(Supply Chain & Supplier Management Loop) + +- **目标**:优化供应链流程,降低采购成本,确保供应稳定。 +- **流程**: + - **公共流程**:供应商管理 → 采购管理 → 补货建议 + - **TOC**:基于零售需求的采购计划 + - **TOB**:基于大宗订单生成采购计划 +- **决策点**: + - 供应商选择:基于综合评分 + - 采购价格:低于成本价预警 + - 补货时机:库存周转率优化 +- **输入**:销售数据、库存数据、供应商数据 +- **输出**:采购计划、供应商评估报告、成本节省分析 + +*** + +## 🔟 B2B / TOB 贸易管理闭环(B2B / TOB Trade Management Loop) + +- **目标**:企业间交易管理 +- **流程**: + - 报价管理、信用管理、询盘转订单 +- **决策点**: + - 利润率 < 15% 禁止报价 + - 大额订单多级审批 + - 低信用等级客户需预付款 +- **输出**:报价单、B2B 订单、信用评估报告 + +*** + +## 1️⃣1️⃣ 治理与审批中心闭环(Governance & Approval Center Loop) + +- **目标**:敏感操作审批 +- **适用**: + - TOC:大额订单、价格变动、退款 + - TOB:大额企业订单、阶梯价审批、信用审批 +- **输出**:审批结果、审计日志 + +*** + +## 1️⃣2️⃣ 合规与证书管理闭环(Compliance & Certificate Management Loop) + +- **目标**:确保业务合规,自动生成所需证书。 +- **流程**: + - **公共流程**:自动化合规 → 信用分级 → 合规审计 + - **TOC**:商品合规检查和证书生成 + - **TOB**:出口合规、合同合规检查和证书生成 +- **决策点**: + - 不合规商品禁止销售 + - 信用等级低的合作伙伴需要额外审核 +- **输入**:订单数据、商品数据、合作伙伴数据 +- **输出**:电子证书、合规报告、信用评估 + +*** + +## 1️⃣3️⃣ 合规与风控闭环(Compliance & Risk Control Loop) + +- **目标**:统一风控 +- **输入**:全流程数据(TOC + TOB) +- **输出**:风险处理记录、规则优化 + +*** + +## 1️⃣4️⃣ 报表与分析闭环(Reporting & Analytics Loop) + +- **目标**:数据可视化 + KPI 支撑 TOC/TOB 决策 +- **流程**: + - 数据汇总 → 指标计算 → 报表生成 → 数据大屏 → 闭环反馈 +- **输出**:管理报表、异常预警、优化建议 +- **状态机**:`RAW_DATA` → `PROCESSED` → `GENERATED` → `DISTRIBUTED` → `FEEDBACK_APPLIED` + +*** + +## 1️⃣5️⃣ 定价与利润决策闭环(Pricing & Profit Decision Loop) + +- **目标**:基于成本、市场和业务目标,自动生成定价策略和利润优化建议。 +- **流程**: + - 成本数据收集 → 市场分析 → 定价策略生成 → 利润预测 → 决策执行 +- **决策点**: + - 利润率红线控制(B2C < 20% 预警,B2B < 15% 禁止) + - 价格弹性分析 + - 竞争定价策略 +- **输入**:商品成本、运费、平台费、广告预估、市场竞争数据 +- **输出**: + - 建议售价 + - 建议 ROI + - 上架决策(开/关) + - 广告投放 ROI 区间 + - 最大可承受 CPA + +*** + +## 1️⃣6️⃣ 账号/店铺健康度闭环(Account/Shop Health Loop) + +- **目标**:监控和维护店铺健康状态,预防封号、限流等风险。 +- **流程**: + - 数据采集 → 健康度评估 → 风险预警 → 干预措施 +- **决策点**: + - 健康度阈值设定 + - 风险等级划分 + - 干预策略制定 +- **输入**:违规记录、发货延迟、差评率、退款率、账号活动数据 +- **输出**: + - 店铺健康评分 + - 风险预警 + - 干预建议(暂停广告、限制上新、下架高风险商品) + +*** + +## 1️⃣7️⃣ 店铺隔离与自动化闭环(Shop Isolation & Automation Loop) + +- **目标**: + 1. 确保每个 TOC / TOB 店铺环境隔离,防止账号关联导致封禁 + 2. 自动化执行 API 不支持或无 API 的操作(刊登、采集、调价、库存同步等) + 3. 支持多云环境,可灵活选择云服务商(阿里云、腾讯云、AWS、Azure 等) +- **流程**: + 1. **镜像/虚拟机管理** + - 每个店铺对应独立云镜像或虚拟机(Win/Linux 可选) + - 云商 API 对接: + - 镜像购买 / 续费 + - 快照 / 重置 + - 开机 / 关机 / 重启 + - 支持多云商切换,可根据价格、性能、地理位置灵活部署 + 2. **预置环境配置** + - 浏览器、自动化脚本、指纹管理工具、VPN 或固定 IP 配置 + - 自动登录店铺账户,无需人工干预 + 3. **任务调度与自动化执行** + - 脚本调度可使用 JS / Python / 后端 API 方式控制 + - 支持平台无 API 操作(如商品采集、库存更新、手动刊登模拟等) + - 自动执行任务后状态反馈至任务调度闭环,并记录日志 + 4. **监控与异常自愈** + - 云镜像健康监控(在线状态、资源使用、脚本异常) + - 自动重启 / 快照恢复 / 切换备用镜像 + - 异常信息反馈至异常检测与自愈闭环 +- **决策点**: + - 店铺隔离等级(独立镜像、不同 IP、不同指纹) + - 云商选择与成本控制 + - 异常处理策略(自动恢复或人工介入) +- **输入**: + - 店铺列表、业务需求(采集、刊登、广告等) + - 云商账户与资源配置 + - 自动化脚本 / 后端控制接口 +- **输出**: + - 各店铺独立镜像环境 + - 自动化执行日志与状态报告 + - 异常修复记录 +- **闭环价值**: + 1. 高度隔离,降低账号封禁与关联风险 + 2. 自动化落地,提高效率与可扩展性 + 3. 支持多云部署,增强业务弹性和成本优化能力 + +*** + +## 1️⃣8️⃣ 订单集中管理闭环(Order Centralized Management Loop) + +- **目标**:跨平台订单统一抓取、集中展示和管理,支持 TOC/TOB 订单流转。 +- **流程**: + 1. **多平台订单采集** + - 支持 TikTok、Shopee、Temu 等平台订单抓取 + - 通过 API 或自动化脚本采集 + 2. **订单集中展示** + - 产品信息:名称、数量、实收价格、订单时间、状态 + - 支持平台/客户/品类/订单状态筛选 + - 可选漏斗分析:订单流转、发货完成率 + 3. **订单状态管理** + - 状态流转:`available → requested → shipped → completed` + - 订单分配与跟踪 +- **决策点**: + - 订单抓取频率 + - 订单优先级设置 + - 异常订单处理策略 +- **输入**: + - 多平台订单数据 + - 店铺信息 + - 客户/商家信息 +- **输出**: + - 集中管理的订单数据 + - 订单状态报告 + - 异常订单标记 + +*** + +## 1️⃣9️⃣ 客户/商家押金与账户管理闭环(Customer/Merchant Deposit & Account Management Loop) + +- **目标**:管理客户预缴押金、账户余额,支持订单抵扣和提现。 +- **流程**: + 1. **押金管理** + - 客户预缴押金(例:100 元抵 2 单) + - 押金余额、已抵扣订单数量记录 + 2. **账户管理** + - 客户可查看:可申请发货订单、历史回款、押金/余额状态 + - 自动扣减押金或余额完成发货操作 + 3. **提现管理** + - 检查账户余额 → 生成提现单 → 审核 → 打款 +- **决策点**: + - 押金抵扣规则 + - 提现审核流程 + - 余额管理策略 +- **输入**: + - 客户押金信息 + - 订单数据 + - 提现申请 +- **输出**: + - 押金/余额状态 + - 提现处理结果 + - 财务流水记录 + +*** + +## 2️⃣0️⃣ 商家选择发货闭环(Merchant Selective Fulfillment Loop) + +- **目标**:商家可选择自己有库存的订单发货,剩余由平台/公司发货。 +- **流程**: + 1. **订单选择** + - 商家登录落地页选择自己有货的订单发货 + 2. **系统检查** + - 押金或余额是否足够覆盖订单 + - 时效性(保证订单不过期) + 3. **订单状态更新** + - 状态流转:`available → requested → shipped → completed` + - 剩余无货订单由平台/公司自己发货 +- **决策点**: + - 订单分配规则 + - 库存检查策略 + - 时效保证机制 +- **输入**: + - 商家库存信息 + - 订单数据 + - 押金/余额状态 +- **输出**: + - 订单分配结果 + - 发货状态更新 + - 异常订单标记 + +*** + +## 2️⃣1️⃣ 回款与财务闭环(Payment & Financial Reconciliation Loop) + +- **目标**:管理客户付款、押金抵扣、回款记录和提现,确保财务透明。 +- **流程**: + 1. **收款管理** + - 客户付款到店铺账户或系统自动扣押金/余额 + 2. **财务流水记录** + - 类型(押金/回款/提现)、金额、订单ID、状态 + - 状态流转:`pending → approved → completed` + 3. **财务对账** + - 店铺收入 ↔ 客户账户余额 + - 异常订单/回款标记 → 自动或人工处理 +- **决策点**: + - 回款确认机制 + - 对账频率 + - 异常处理流程 +- **输入**: + - 客户付款信息 + - 订单数据 + - 押金/余额状态 +- **输出**: + - 财务流水记录 + - 对账结果 + - 提现处理结果 + +*** + +## 2️⃣2️⃣ 海外仓/本土仓 & 多品类支持闭环(Overseas/Local Warehouse & Multi-Category Support Loop) + +- **目标**:统一管理海外仓和本土仓库存,支持多品类分配和上下游分析。 +- **流程**: + 1. **库存管理** + - 海外仓和本土仓库存统一管理 + - 可按品类、仓库位置、时效性分配发货 + 2. **上下游分析** + - 供应商价格对比 + - 成本/利润/ROI 分析 + - 同行发货/库存策略参考 +- **决策点**: + - 仓库选择策略 + - 品类分配规则 + - 供应链优化策略 +- **输入**: + - 仓库库存数据 + - 供应商信息 + - 订单数据 +- **输出**: + - 库存分配方案 + - 供应链分析报告 + - 成本优化建议 + +*** + +## 2️⃣3️⃣ 商品主数据闭环(Product Master Data Loop / MDM) + +- **目标**:建立统一的商品主数据管理体系,确保数据一致性。 +- **流程**: + - 数据采集 → 标准化处理 → 主数据维护 → 数据分发 +- **决策点**: + - 数据标准制定 + - 数据质量评估 + - 数据同步策略 +- **输入**:来自采集、供应链、刊登等闭环的商品数据 +- **输出**: + - 统一 SPU/SKU 体系 + - 标准化类目和属性结构 + - 多语言支持 + - 多平台映射关系 + +*** + +## 1️⃣9️⃣ SKU变体与结构闭环(SKU Variant & Structure Loop) + +- **目标**:管理商品的变体和多平台SKU映射,确保库存和订单的一致性。 +- **流程**: + - SPU创建 → SKU生成 → 平台SKU映射 → 同步管理 +- **决策点**: + - 变体属性定义 + - 多平台SKU规则适配 + - 库存同步策略 +- **输入**:商品主数据、平台SKU规则 +- **输出**: + - 多SKU结构(颜色/尺寸/套装) + - 各平台SKU映射 + - 统一库存管理 + +*** + +## 2️⃣0️⃣ 订单拆分与合并闭环(Order Split & Merge Loop) + +- **目标**:处理多仓发货、多订单合并、部分缺货等场景,优化物流成本和时效。 +- **流程**: + - 订单分析 → 拆分/合并决策 → 子订单生成 → 履约执行 +- **决策点**: + - 拆分类型(仓/SKU/库存) + - 合并条件 + - 优先级策略 +- **输入**:订单数据、库存状态、物流成本 +- **输出**: + - 子订单 + - 合并订单 + - 物流方案 + +*** + +## 2️⃣1️⃣ 异常订单处理闭环(Exception Order Handling Loop) + +- **目标**:处理地址错误、海关卡单、物流丢件、无法发货等履约异常。 +- **流程**: + - 异常检测 → 分类处理 → 解决方案执行 → 结果反馈 +- **决策点**: + - 异常类型识别 + - 处理优先级 + - 人工介入条件 +- **输入**:订单数据、物流状态、异常事件 +- **输出**: + - 异常处理结果 + - 售后触发 + - 风控预警 + +*** + +## 2️⃣2️⃣ 物流策略与渠道选择闭环(Logistics Strategy & Channel Selection Loop) + +- **目标**:基于成本、时效和可靠性,选择最优物流方案。 +- **流程**: + - 订单分析 → 物流渠道评估 → 方案选择 → 执行监控 +- **决策点**: + - 仓选择 + - 物流方式(空运/海运/快递) + - 渠道选择 +- **输入**:订单数据、库存分布、物流成本、时效要求 +- **输出**: + - 物流渠道选择 + - 成本估算 + - 时效承诺 + +*** + +## 2️⃣3️⃣ 利润核算闭环(Profit Calculation Loop) + +- **目标**:精确计算真实利润,支持定价和决策优化。 +- **流程**: + - 成本汇总 → 收入匹配 → 利润计算 → 分析报告 +- **决策点**: + - 成本分摊规则 + - 汇率处理 + - 利润阈值设定 +- **输入**:商品成本、运费、广告费、平台佣金、税费、汇率数据 +- **输出**: + - 订单级利润 + - 商品级利润 + - 店铺级利润 + - 利润分析报告 + +*** + +## 2️⃣4️⃣ 用户/客户资产闭环(User/Customer Asset Loop) + +- **目标**:沉淀和管理用户资产,支持精准营销和客户价值提升。 +- **流程**: + - 数据采集 → 用户画像构建 → 行为分析 → 资产运营 +- **决策点**: + - 用户分层策略 + - 营销触达规则 + - 客户价值评估 +- **输入**:订单数据、浏览行为、购买历史、售后记录 +- **输出**: + - 用户画像 + - 复购行为分析 + - 国家偏好分析 + - 客户价值评估 + - 营销建议 + +*** + +## 2️⃣5️⃣ A/B测试与策略优化闭环(A/B Testing & Strategy Optimization Loop) + +- **目标**:通过实验验证和数据驱动,持续优化业务策略。 +- **流程**: + - 测试设计 → 实验执行 → 数据收集 → 结果分析 → 策略调整 +- **决策点**: + - 测试假设设定 + - 样本量确定 + - 显著性水平设定 +- **输入**:广告策略、商品定价、页面设计、营销文案 +- **输出**: + - 测试结果分析 + - 策略优化建议 + - 最优方案推荐 + +*** + +### 🔹 统一闭环依赖(TOC + TOB) + +```text +[数据采集] ↓[数据清洗] ↓[套利/利润评估] ↓[商品主数据] ↓[SKU变体与结构] ↓[商品刊登] ←→ [素材管理] ↓[定价与利润决策] ↓[广告/营销 (TOC) / 企业营销 (TOB)] ↓[订单履约 (OMS)] ↓[订单拆分与合并] ↓[异常订单处理] ↓[物流策略与渠道选择] ↓[库存 & WMS] ←→ [供应链 & 补货] ↓[售后逆向] ↓[资金对账] ↓[利润核算] ↓[B2B/TOB 贸易管理 (TOB)] ↓[用户/客户资产] ↓[A/B测试 & 策略优化] ↓[治理与审批中心] ↓[合规 & 证书] ↓[风控] ↓[报表 & 分析] ↺(反馈所有环节) + +外挂三条线: +用户资产 ← 订单 / 售后 → 广告 / B2B +店铺健康度 ← 所有行为 → 限制商品 / 广告 +店铺隔离与自动化 ← 店铺操作 → 所有店铺相关行为 +``` + +**说明**: + +- 实线箭头表示核心业务流程 +- 括号内标注了TOC/TOB的主要差异点 +- B2B/TOB贸易管理为TOB特有闭环 +- 横切能力:账号/店铺健康度贯穿所有业务闭环 + +*** + +### 🔗 闭环依赖关系(TOC + TOB) + +1. **数据采集与清洗闭环** → **商品主数据闭环**:提供原始商品数据 +2. **数据采集与清洗闭环** → **素材管理闭环**:提供采集的商品图片和视频素材 +3. **数据采集与清洗闭环** → **定价与利润决策闭环**:提供成本和市场数据 +4. **商品主数据闭环** → **SKU变体与结构闭环**:提供商品基础信息 +5. **SKU变体与结构闭环** → **商品刊登闭环**:提供多SKU结构和平台映射 +6. **商品刊登闭环** → **素材管理闭环**:触发素材需求,生成商品主图和详情图 +7. **素材管理闭环** → **商品刊登闭环**:提供处理后的商品素材(图片、视频) +8. **素材管理闭环** → **广告计划与营销闭环**:提供广告投放所需的素材库 +9. **商品刊登闭环** → **广告计划与营销闭环**:提供已刊登商品列表 +10. **商品刊登闭环** → **订单履约闭环**:提供商品库存和状态信息 +11. **商品刊登闭环** → **定价与利润决策闭环**:提供商品成本信息 +12. **定价与利润决策闭环** → **商品刊登闭环**:提供建议售价和上架决策 +13. **定价与利润决策闭环** → **广告计划与营销闭环**:提供可投放 ROI 区间和最大可承受 CPA +14. **订单履约闭环** → **订单拆分与合并闭环**:提供订单数据用于拆分/合并 +15. **订单拆分与合并闭环** → **物流策略与渠道选择闭环**:提供拆分/合并后的订单数据 +16. **物流策略与渠道选择闭环** → **订单履约闭环**:提供物流方案 +17. **订单履约闭环** → **异常订单处理闭环**:提供异常订单数据 +18. **异常订单处理闭环** → **售后逆向闭环**:触发售后处理 +19. **异常订单处理闭环** → **合规与风控闭环**:提供风控预警 +20. **订单履约闭环** → **售后逆向闭环**:提供订单和物流信息 +21. **售后逆向闭环** → **资金对账闭环**:提供退款记录 +22. **订单履约闭环** → **资金对账闭环**:提供销售记录 +23. **广告计划与营销闭环** → **资金对账闭环**:提供广告费用记录 +24. **订单履约闭环** → **库存与仓储管理闭环**:触发库存扣减和物流操作 +25. **库存与仓储管理闭环** → **订单履约闭环**:提供库存状态和物流信息 +26. **库存与仓储管理闭环** → **供应链与供应商管理闭环**:触发补货需求 +27. **供应链与供应商管理闭环** → **库存与仓储管理闭环**:提供采购入库信息 +28. **供应链与供应商管理闭环** → **商品主数据闭环**:提供供应商商品数据 +29. **商品刊登闭环** → **B2B / TOB 贸易管理闭环**:提供商品信息用于报价 +30. **B2B / TOB 贸易管理闭环** → **订单履约闭环**:生成 B2B 订单 +31. **B2B / TOB 贸易管理闭环** → **资金对账闭环**:提供 B2B 交易记录 +32. **资金对账闭环** → **利润核算闭环**:提供收入和成本数据 +33. **利润核算闭环** → **报表与分析闭环**:提供利润数据 +34. **订单履约闭环** → **用户/客户资产闭环**:提供订单和用户行为数据 +35. **售后逆向闭环** → **用户/客户资产闭环**:提供售后记录 +36. **用户/客户资产闭环** → **广告计划与营销闭环**:提供用户画像和营销建议 +37. **用户/客户资产闭环** → **B2B / TOB 贸易管理闭环**:提供企业客户信息 +38. **广告计划与营销闭环** → **A/B测试与策略优化闭环**:提供广告策略数据 +39. **商品刊登闭环** → **A/B测试与策略优化闭环**:提供商品定价和展示数据 +40. **A/B测试与策略优化闭环** → **报表与分析闭环**:提供测试结果和优化建议 +41. **所有敏感操作** → **治理与审批中心闭环**:触发审批流程 +42. **治理与审批中心闭环** → **所有业务闭环**:提供审批结果 +43. **订单履约闭环** → **合规与证书管理闭环**:触发证书生成 +44. **合规与证书管理闭环** → **订单履约闭环**:提供合规证书 +45. **所有业务闭环** → **账号/店铺健康度闭环**:提供违规记录、发货延迟、差评率、退款率等数据 +46. **账号/店铺健康度闭环** → **广告计划与营销闭环**:提供是否暂停广告、降预算的决策 +47. **账号/店铺健康度闭环** → **商品刊登闭环**:提供是否限制上新、下架高风险商品的决策 +48. **所有店铺操作** → **店铺隔离与自动化闭环**:提供店铺操作数据 +49. **店铺隔离与自动化闭环** → **所有店铺相关行为**:提供隔离环境和自动化执行能力 +50. **所有闭环** → **合规与风控闭环**:提供全流程数据用于风险监控 +51. **所有业务闭环** → **报表与分析闭环**:提供各闭环的输出数据用于报表生成和分析 +52. **报表与分析闭环** → **所有业务闭环**:反馈数据异常、业务波动、优化建议,指导各闭环的操作调整 + +*** + +### 📊 关键绩效指标(KPI) + +#### 数据采集与清洗闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ---------- | --------- | +| 采集覆盖率 | 目标平台商品覆盖率 | TOC + TOB | +| 数据准确率 | 清洗后数据的准确性 | TOC + TOB | +| 套利分析准确率 | 前置套利计算的准确性 | TOC + TOB | + +#### 商品刊登闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ----------- | --------- | +| 刊登成功率 | 成功刊登的商品比例 | TOC + TOB | +| 刊登时效 | 从准备到刊登完成的时间 | TOC + TOB | +| 平台审核通过率 | 平台审核通过的商品比例 | TOC + TOB | + +#### 素材管理闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ------------ | --------- | +| 素材处理时效 | 从上传到可用的平均时间 | TOC + TOB | +| 素材审核通过率 | 通过审核的素材比例 | TOC + TOB | +| 素材转化率 | 使用素材带来的订单转化率 | TOC + TOB | +| 素材复用率 | 被多次使用的素材比例 | TOC + TOB | +| 版权合规率 | 无版权风险的素材比例 | TOC + TOB | + +#### 广告计划与营销闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| -------- | -------------- | ------ | +| 广告 ROI | 广告投入产出比 | TOC | +| 点击率(CTR) | 广告点击次数与展示次数的比率 | TOC | +| 转化率(CVR) | 点击广告后产生订单的比例 | TOC | +| 企业营销效果 | 企业营销活动的转化率 | TOB | + +#### 订单履约闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------ | ----------- | --------- | +| 订单处理时效 | 从订单生成到发货的时间 | TOC + TOB | +| 发货准确率 | 正确发货的订单比例 | TOC + TOB | +| 妥投率 | 成功送达的订单比例 | TOC + TOB | +| 分批处理率 | 大额订单分批处理的比例 | TOB | + +#### 售后逆向闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------ | ------------- | --------- | +| 售后处理时效 | 从售后请求到处理完成的时间 | TOC + TOB | +| 退款成功率 | 成功退款的比例 | TOC + TOB | +| 退货率 | 退货订单占总订单的比例 | TOC + TOB | + +#### 资金对账闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------ | ------------- | --------- | +| 对账准确率 | 对账差异率 | TOC + TOB | +| 对账时效 | 从数据汇总到对账完成的时间 | TOC + TOB | +| 异常处理率 | 需要人工处理的异常比例 | TOC + TOB | +| 账期遵守率 | 按合同约定账期结算的比例 | TOB | + +#### 库存与仓储管理闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------ | ------------- | --------- | +| 库存准确率 | 系统库存与实际库存的差异率 | TOC + TOB | +| 库存周转率 | 库存周转次数 | TOC + TOB | +| 仓储操作效率 | 每单处理时间 | TOC + TOB | +| 跨仓调拨时效 | 调拨完成时间 | TOC + TOB | + +#### 供应链与供应商管理闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| -------- | --------- | --------- | +| 供应商准时交付率 | 按时交付的订单比例 | TOC + TOB | +| 采购成本降低率 | 采购成本下降百分比 | TOC + TOB | +| 供应商评分 | 供应商综合评估分数 | TOC + TOB | +| 补货准确率 | 补货计划的准确性 | TOC + TOB | + +#### B2B / TOB 贸易管理闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ---------- | ------ | +| B2B 利润率 | B2B 业务的利润率 | TOB | +| 报价通过率 | 报价被客户接受的比例 | TOB | +| 信用违约率 | 客户信用违约的比例 | TOB | +| 询盘转化率 | 询盘转化为订单的比例 | TOB | + +#### 治理与审批中心闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------ | ----------- | --------- | +| 审批时效 | 从申请到审批完成的时间 | TOC + TOB | +| 审批准确率 | 审批结果的准确性 | TOC + TOB | +| 待办处理率 | 待办事项的处理比例 | TOC + TOB | + +#### 合规与证书管理闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | --------- | --------- | +| 证书生成及时率 | 按时生成证书的比例 | TOC + TOB | +| 合规检查通过率 | 通过合规检查的比例 | TOC + TOB | +| 信用评级准确率 | 信用评级的准确性 | TOC + TOB | + +#### 合规与风控闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ---------- | --------- | +| 风险识别准确率 | 风险识别的准确性 | TOC + TOB | +| 风控处理时效 | 风险处理的时间 | TOC + TOB | +| 合规违规率 | 违规事件的比例 | TOC + TOB | +| 误报率 | 误判为风险的事件比例 | TOC + TOB | + +#### 报表与分析闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | --------------- | --------- | +| 报表生成及时率 | 按时生成报表的比例 | TOC + TOB | +| 数据准确率 | 报表数据的准确性 | TOC + TOB | +| 分析洞察价值 | 分析结果对业务决策的价值 | TOC + TOB | +| 异常预警准确率 | 异常预警的准确性 | TOC + TOB | +| 报表生成时效 | 从数据汇总到报表完成的时间 | TOC + TOB | +| 数据完整率 | 报表覆盖业务闭环输出数据的比例 | TOC + TOB | +| KPI 准确率 | 计算指标与实际数据偏差率 | 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 | +| 镜像可用性 | 镜像正常运行时间比例 | TOC + TOB | +| 云API调用成功率 | 云服务商API调用成功率 | TOC + TOB | +| 资源利用率 | 镜像资源使用效率 | TOC + TOB | +| 自动登录成功率 | 镜像自动登录成功率 | TOC + TOB | +| 多云切换成功率 | 云服务商切换成功率 | TOC + TOB | +| 成本优化率 | 多云部署带来的成本优化比例 | TOC + TOB | + +#### 商品主数据闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------ | ------------ | --------- | +| 数据标准化率 | 标准化处理的商品数据比例 | TOC + TOB | +| 数据一致性 | 多平台数据一致性程度 | TOC + TOB | +| 主数据准确率 | 商品主数据的准确性 | TOC + TOB | +| 数据同步时效 | 数据从采集到同步的时间 | TOC + TOB | +| 数据质量评分 | 商品数据质量综合评分 | TOC + TOB | + +#### SKU变体与结构闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| -------- | ------------ | --------- | +| SKU映射准确率 | 多平台SKU映射的准确性 | TOC + TOB | +| SKU生成时效 | SKU生成的平均时间 | TOC + TOB | +| 变体管理效率 | 变体属性管理的效率 | TOC + TOB | +| 库存同步准确率 | 多SKU库存同步的准确性 | TOC + TOB | + +#### 订单拆分与合并闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| -------- | -------------- | --------- | +| 拆分/合并准确率 | 订单拆分/合并的准确性 | TOC + TOB | +| 拆分/合并时效 | 订单拆分/合并的处理时间 | TOC + TOB | +| 物流成本优化率 | 拆分/合并带来的物流成本节约 | TOC + TOB | +| 客户满意度 | 拆分/合并订单的客户满意度 | TOC + TOB | + +#### 异常订单处理闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------ | ------------ | --------- | +| 异常处理率 | 成功处理的异常订单比例 | TOC + TOB | +| 异常处理时效 | 异常订单处理的平均时间 | TOC + TOB | +| 异常解决率 | 成功解决的异常订单比例 | TOC + TOB | +| 客户满意度 | 异常订单处理的客户满意度 | TOC + TOB | + +#### 物流策略与渠道选择闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ---------- | --------- | +| 物流成本节约率 | 物流成本节约的比例 | TOC + TOB | +| 物流时效达标率 | 按时送达的订单比例 | TOC + TOB | +| 渠道选择准确率 | 物流渠道选择的准确性 | TOC + TOB | +| 物流跟踪覆盖率 | 可跟踪的物流订单比例 | TOC + TOB | + +#### 利润核算闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ------------ | --------- | +| 利润计算准确率 | 利润计算的准确性 | TOC + TOB | +| 利润核算时效 | 利润核算的平均时间 | TOC + TOB | +| 成本分摊准确性 | 成本分摊的准确性 | TOC + TOB | +| 利润率达标率 | 达到目标利润率的订单比例 | TOC + TOB | + +#### 用户/客户资产闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ------------- | --------- | +| 用户画像准确率 | 用户画像与实际行为的匹配度 | TOC + TOB | +| 客户价值提升率 | 客户平均价值增长比例 | TOC + TOB | +| 复购率 | 客户重复购买比例 | TOC + TOB | +| 客户留存率 | 客户持续活跃的比例 | TOC + TOB | +| 营销转化率 | 营销活动的转化效果 | TOC + TOB | + +#### A/B测试与策略优化闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ------------ | --------- | +| 测试执行效率 | 测试从设计到完成的时间 | TOC + TOB | +| 测试结果显著性 | 测试结果的统计显著性 | TOC + TOB | +| 策略优化效果 | 优化后业务指标的改善程度 | TOC + TOB | +| 测试覆盖率 | 覆盖的业务策略比例 | TOC + TOB | +| 决策支持准确率 | 测试结果对决策的支持程度 | TOC + TOB | + +*** + +### 🔍 追踪与审计 + +- **追踪四元组**: + - `tenantId`:租户 ID(业务隔离) + - `shopId`:店铺 ID(平台/店铺隔离) + - `taskId`:任务 ID(任务/规则触发归档) + - `traceId`:链路追踪 ID(全链路唯一标识) + - `businessType`:业务类型(TOC/TOB) +- **审计要求**: + - 每一笔操作必须绑定 `traceId` 和 `businessType` + - 所有功能需通过 Shadow-Test(最小冒烟测试) + - 关键操作必须生成 AuditLog + +*** + +### 📋 业务审核状态机 + +- **通用审核流程**:`SUBMITTED` (提交) → `PENDING_REVIEW` (人工审核) → `EXECUTED` / `REJECTED` +- **适用场景**: + - TOC:大额订单、价格变动、退款 + - TOB:大额企业订单、阶梯价审批、信用审批 + +*** + +### 💡 说明 + +1. 业务闭环文档是**最高层文档**,不涉及具体前端或模块实现细节。 +2. 下层模块功能、接口、算法、UI 都是这个闭环的落地实现。 +3. 形成从**采集 → 决策 → 执行 → 反馈 → 风控**的完整业务链。 +4. 每个闭环都有明确的输入、输出、流程和决策点,确保业务流程的完整性和可控性。 +5. 各闭环之间通过数据流转和依赖关系形成完整的业务生态系统。 +6. 所有业务操作均需遵循项目特定规则,确保系统安全和数据一致性。 +7. **“闭环写入规则:只要逻辑上能闭环就写,落地方式后置”** +8. **系统层级结构**: + - L1(业务闭环):交易系统核心流程 + - L2(系统决策层):定价、风控、健康度等系统级能力 + - L3(数据中台层):商品主数据、成本基准等数据管理能力 + - L4(自动化与增长):任务调度、A/B测试、用户资产等高级能力 +9. **横切能力**:账号健康度、任务调度、权限审计等能力贯穿所有业务闭环,确保系统稳定性和安全性。 + +*** + diff --git a/docs1/Task_Overview.md b/docs1/Task_Overview.md new file mode 100644 index 0000000..21e3efb --- /dev/null +++ b/docs1/Task_Overview.md @@ -0,0 +1,509 @@ +# 🗂 Crawlful Hub AI开发任务总览(Task Overview) + +> **说明**:本任务表基于30个业务闭环拆解,专为100% AI开发设计,包含完整的任务依赖、数据流、触发条件和状态管理。 + +--- + +## 📋 状态定义 + +| 状态 | 图标 | 描述 | 适用场景 | +|------|------|------|----------| +| pending | ⏳ | 未认领任务 | 新创建的任务 | +| claimed | 🔒 | AI已认领,生成代码/配置中 | AI正在处理任务 | +| in_progress | 🟡 | 运行/部署中 | 任务正在执行 | +| completed | ✅ | 执行成功 | 任务完成并通过验证 | +| failed | ❌ | 失败,触发自动修复或回滚 | 任务执行失败 | +| blocked | 🚫 | 被依赖任务阻塞 | 等待前置任务完成 | +| retry | 🔄 | 重试中 | 失败后正在重试 | + +--- + +## 🎯 优先级定义 + +| 优先级 | 图标 | 描述 | 处理时效 | +|--------|------|------|----------| +| P0 - 紧急 | 🔴 | 阻塞核心业务流程 | 立即处理 | +| P1 - 高 | 🟠 | 影响重要功能 | 4小时内 | +| P2 - 中 | 🟡 | 功能增强或优化 | 24小时内 | +| P3 - 低 | 🟢 | 非关键功能 | 48小时内 | + +--- + +## 📊 任务统计 + +| 模块 | 总任务数 | 已完成 | 进行中 | 待处理 | 失败 | 完成率 | +|------|----------|--------|--------|--------|------|--------| +| 前端模块 | 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% | +| 数据模块 | 10 | 2 | 0 | 8 | 0 | 20% | +| 运维模块 | 3 | 2 | 0 | 1 | 0 | 67% | +| **总计** | **95** | **24** | **4** | **67** | **0** | **25%** | + +--- + +## 🚀 1️⃣ 前端模块(用户交互 / 状态展示) + +### 1.1 商品管理前端 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-P001 | 商品刊登闭环 | 渲染商品列表页面 | 用户ID, 筛选条件 | 商品列表数据 | 页面加载 | ✅ completed | P1 | - | 4h | AI-Frontend-1 | +| FE-P002 | 商品刊登闭环 | 渲染商品详情页面 | 商品ID | 商品详情数据 | 点击商品 | ⏳ pending | P1 | FE-P001 | 3h | AI-Frontend-1 | +| FE-P003 | 商品刊登闭环 | 商品上架表单 | 商品基础信息 | 上架请求 | 点击上架 | ⏳ pending | P1 | FE-P002 | 2h | AI-Frontend-2 | +| FE-P004 | 素材管理闭环 | 素材上传组件 | 文件对象 | 素材URL | 选择文件 | ⏳ pending | P2 | FE-P002 | 1.5h | AI-Frontend-2 | + +### 1.2 订单管理前端 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-O001 | 订单履约闭环 | 渲染订单列表页面 | 用户ID, 筛选条件 | 订单列表数据 | 页面加载 | 🟡 in_progress | 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 | + +### 1.3 广告计划与营销前端【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-AD001 | 广告计划与营销闭环 | 广告计划管理页面 | 广告ID, 筛选条件 | 广告计划列表 | 页面加载 | ⏳ pending | P0 | - | 12h | AI-Frontend-4 | +| FE-AD002 | 广告计划与营销闭环 | 广告投放界面 | 广告ID, 投放参数 | 投放结果 | 点击投放 | ⏳ pending | P0 | FE-AD001 | 10h | AI-Frontend-4 | +| FE-AD003 | 广告计划与营销闭环 | ROI分析页面 | 广告ID, 时间范围 | ROI报告 | 点击查看 | ⏳ pending | P0 | FE-AD001 | 8h | AI-Frontend-4 | + +### 1.4 售后逆向前端【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-SR001 | 售后逆向闭环 | 退货申请页面 | 订单ID, 退货原因 | 退货申请 | 点击退货 | ⏳ pending | P0 | - | 10h | AI-Frontend-5 | +| FE-SR002 | 售后逆向闭环 | 退款处理界面 | 退款ID, 处理结果 | 退款记录 | 点击处理 | ⏳ pending | P0 | FE-SR001 | 8h | AI-Frontend-5 | +| FE-SR003 | 售后逆向闭环 | 售后客服界面 | 工单ID, 客服消息 | 客服记录 | 点击查看 | ⏳ pending | P0 | FE-SR001 | 12h | AI-Frontend-5 | + +### 1.5 B2B / TOB 贸易前端【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-TOB001 | B2B / TOB 贸易管理闭环 | 企业报价页面 | 客户ID, 商品ID | 报价单 | 点击报价 | ⏳ pending | P0 | - | 12h | AI-Frontend-6 | +| FE-TOB002 | B2B / TOB 贸易管理闭环 | 批量订单界面 | 客户ID, 商品列表 | 批量订单 | 点击提交 | ⏳ pending | P0 | FE-TOB001 | 10h | AI-Frontend-6 | +| FE-TOB003 | B2B / TOB 贸易管理闭环 | 合同管理页面 | 合同ID, 状态 | 合同详情 | 点击查看 | ⏳ pending | P0 | FE-TOB001 | 8h | AI-Frontend-6 | + +### 1.6 合规与证书管理前端【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-COM001 | 合规与证书管理闭环 | 证书管理页面 | 证书ID, 筛选条件 | 证书列表 | 页面加载 | ⏳ pending | P1 | - | 10h | AI-Frontend-7 | +| FE-COM002 | 合规与证书管理闭环 | 合规检查界面 | 商品ID, 平台ID | 合规结果 | 点击检查 | ⏳ pending | P1 | FE-COM001 | 8h | AI-Frontend-7 | +| FE-COM003 | 合规与证书管理闭环 | 证书到期提醒 | 证书ID, 到期时间 | 提醒通知 | 定时触发 | ⏳ pending | P1 | FE-COM001 | 6h | AI-Frontend-7 | + +### 1.7 物流策略与渠道选择前端【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-LOG001 | 物流策略与渠道选择闭环 | 物流选择界面 | 订单ID, 目的地 | 物流方案 | 点击选择 | ⏳ pending | P1 | - | 8h | AI-Frontend-8 | +| FE-LOG002 | 物流策略与渠道选择闭环 | 物流跟踪页面 | 订单ID, 物流单号 | 物流信息 | 点击跟踪 | ⏳ pending | P1 | FE-LOG001 | 6h | AI-Frontend-8 | +| FE-LOG003 | 物流策略与渠道选择闭环 | 运费计算页面 | 商品ID, 数量, 目的地 | 运费报价 | 点击计算 | ⏳ pending | P1 | FE-LOG001 | 6h | AI-Frontend-8 | + +### 1.8 用户/客户资产前端【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-UA001 | 用户/客户资产闭环 | 用户资产页面 | 用户ID, 筛选条件 | 资产数据 | 页面加载 | ⏳ pending | P1 | - | 8h | AI-Frontend-9 | +| FE-UA002 | 用户/客户资产闭环 | 积分管理界面 | 用户ID, 积分操作 | 积分记录 | 点击操作 | ⏳ pending | P1 | FE-UA001 | 6h | AI-Frontend-9 | +| FE-UA003 | 用户/客户资产闭环 | 会员等级页面 | 用户ID, 等级 | 会员权益 | 点击查看 | ⏳ pending | P1 | FE-UA001 | 6h | AI-Frontend-9 | + +### 1.9 A/B测试与策略优化前端【P2 中优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-AB001 | A/B测试与策略优化闭环 | A/B测试配置页面 | 测试ID, 参数 | 配置结果 | 点击配置 | ⏳ pending | P2 | - | 6h | AI-Frontend-10 | +| FE-AB002 | A/B测试与策略优化闭环 | 测试结果展示 | 测试ID, 时间范围 | 测试报告 | 点击查看 | ⏳ pending | P2 | FE-AB001 | 6h | AI-Frontend-10 | + +### 1.10 认证服务前端【P2 中优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| FE-AUTH001 | 认证服务 | 登录页面 | 用户名, 密码 | 登录结果 | 点击登录 | ⏳ pending | P2 | - | 6h | AI-Frontend-11 | +| FE-AUTH002 | 认证服务 | 注册页面 | 用户信息 | 注册结果 | 点击注册 | ⏳ pending | P2 | FE-AUTH001 | 6h | AI-Frontend-11 | +| FE-AUTH003 | 认证服务 | 密码重置页面 | 用户名, 新密码 | 重置结果 | 点击重置 | ⏳ pending | P2 | FE-AUTH001 | 4h | AI-Frontend-11 | + +--- + +## 🔧 2️⃣ 后端模块(业务逻辑 / 数据处理) + +### 2.1 商品管理后端 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-P001 | 商品主数据闭环 | 商品主数据管理接口 | 商品基础信息 | 商品ID, 状态 | 前端提交 | ✅ completed | P0 | - | 2h | AI-Backend-1 | +| 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 | + +### 2.2 订单管理后端 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-O001 | 订单履约闭环 | 订单创建接口 | 用户ID, 商品ID, 数量 | 订单ID, 状态 | 前端提交 | ✅ completed | P0 | BE-P001 | 2h | AI-Backend-1 | +| BE-O002 | 订单集中管理闭环 | 多平台订单归集接口 | 平台账号, 时间范围 | 订单数据 | 定时任务 | ✅ completed | P0 | BE-O001 | 3h | AI-Backend-3 | +| BE-O003 | 订单拆分与合并闭环 | 订单拆分逻辑 | 订单ID, 拆分规则 | 子订单列表 | 库存不足 | ✅ completed | P1 | BE-O001 | 2h | AI-Backend-3 | +| BE-O004 | 异常订单处理闭环 | 异常订单识别与处理 | 订单ID | 处理结果 | 定时扫描 | ✅ completed | P1 | BE-O001 | 2.5h | AI-Backend-2 | + +### 2.3 财务管理后端 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-F001 | 资金对账闭环 | 对账接口 | 时间范围, 平台ID | 对账结果 | 定时任务 | ✅ completed | P0 | BE-O001 | 2h | AI-Backend-2 | +| BE-F002 | 回款与财务闭环 | 回款管理接口 | 订单ID, 回款金额 | 回款记录 | 回款事件 | ✅ completed | P1 | BE-F001 | 1.5h | AI-Backend-2 | +| BE-F003 | 利润核算闭环 | 利润计算接口 | 订单ID, 成本数据 | 利润数据 | 订单完成 | ✅ completed | P1 | BE-F001 | 2h | AI-Backend-3 | + +### 2.4 库存管理后端 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-I001 | 库存与仓储管理闭环 | 库存同步引擎 | 商品ID, 库存变化 | 库存状态 | 库存变化事件 | ✅ completed | P0 | BE-P001 | 2h | AI-Backend-1 | +| BE-I002 | 海外仓/本土仓闭环 | 多仓库库存分配 | 订单ID, 仓库列表 | 分配方案 | 订单创建 | ✅ completed | P1 | BE-I001 | 2.5h | AI-Backend-3 | +| BE-I003 | 供应链与供应商管理闭环 | 补货建议生成 | 商品ID, 库存阈值 | 补货建议 | 库存预警 | ✅ completed | P2 | BE-I001 | 2h | AI-Backend-3 | + +### 2.5 用户与账户管理后端 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-U001 | 客户/商家押金闭环 | 押金管理接口 | 客户ID, 金额 | 押金余额 | 押金操作 | ✅ completed | P1 | BE-O001 | 1.5h | AI-Backend-2 | +| BE-U002 | 用户/客户资产闭环 | 用户资产统计 | 用户ID | 资产数据 | 定时任务 | ✅ completed | P2 | BE-U001 | 2h | AI-Backend-2 | + +### 2.6 治理与风控后端 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-G001 | 治理与审批中心闭环 | 审批流程引擎 | 审批类型, 数据 | 审批结果 | 审批请求 | ✅ completed | P1 | BE-O001 | 2.5h | AI-Backend-3 | +| BE-G002 | 合规与风控闭环 | 风控规则引擎 | 订单ID, 用户ID | 风险评分 | 订单创建 | ✅ completed | P0 | BE-O001 | 2h | AI-Backend-2 | +| BE-G003 | 账号/店铺健康度闭环 | 健康度监控 | 店铺ID | 健康度评分 | 定时任务 | ✅ completed | P1 | BE-G002 | 2h | AI-Backend-3 | + +### 2.7 广告计划与营销后端【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-AD001 | 广告计划与营销闭环 | 广告计划创建接口 | 广告参数 | 广告ID | 前端提交 | ⏳ pending | P0 | - | 12h | AI-Backend-4 | +| BE-AD002 | 广告计划与营销闭环 | 广告投放引擎 | 广告ID, 投放参数 | 投放状态 | 定时任务 | ⏳ pending | P0 | BE-AD001 | 16h | AI-Backend-4 | +| BE-AD003 | 广告计划与营销闭环 | ROI计算接口 | 广告ID, 时间范围 | ROI数据 | 定时任务 | ⏳ pending | P0 | BE-AD001 | 10h | AI-Backend-4 | + +### 2.8 售后逆向后端【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-SR001 | 售后逆向闭环 | 退货处理接口 | 订单ID, 退货原因 | 退货ID | 前端提交 | ⏳ pending | P0 | - | 12h | AI-Backend-5 | +| BE-SR002 | 售后逆向闭环 | 退款流程引擎 | 退货ID, 审批结果 | 退款状态 | 审批完成 | ⏳ pending | P0 | BE-SR001 | 14h | AI-Backend-5 | +| BE-SR003 | 售后逆向闭环 | 售后工单系统 | 退货ID, 工单信息 | 工单ID | 退货创建 | ⏳ pending | P0 | BE-SR001 | 16h | AI-Backend-5 | + +### 2.9 B2B / TOB 贸易后端【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-TOB001 | B2B / TOB 贸易管理闭环 | 阶梯价计算接口 | 商品ID, 数量 | 阶梯价 | 前端请求 | ⏳ pending | P0 | - | 12h | AI-Backend-6 | +| BE-TOB002 | B2B / TOB 贸易管理闭环 | 批量订单处理 | 客户ID, 商品列表 | 批量订单ID | 前端提交 | ⏳ pending | P0 | BE-TOB001 | 16h | AI-Backend-6 | +| BE-TOB003 | B2B / TOB 贸易管理闭环 | 账期管理 | 客户ID, 账期设置 | 账期记录 | 前端提交 | ⏳ pending | P0 | BE-TOB001 | 10h | AI-Backend-6 | + +### 2.10 合规与证书管理后端【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-COM001 | 合规与证书管理闭环 | 证书存储接口 | 证书信息 | 证书ID | 前端提交 | ⏳ pending | P1 | - | 12h | AI-Backend-7 | +| BE-COM002 | 合规与证书管理闭环 | 合规检查引擎 | 商品ID, 平台ID | 合规结果 | 前端请求 | ⏳ pending | P1 | BE-COM001 | 14h | AI-Backend-7 | +| BE-COM003 | 合规与证书管理闭环 | 证书更新提醒 | 证书ID, 到期时间 | 提醒通知 | 定时任务 | ⏳ pending | P1 | BE-COM001 | 8h | AI-Backend-7 | + +### 2.11 物流策略与渠道选择后端【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-LOG001 | 物流策略与渠道选择闭环 | 物流策略引擎 | 订单ID, 目的地 | 物流方案 | 订单创建 | ⏳ pending | P1 | - | 14h | AI-Backend-8 | +| BE-LOG002 | 物流策略与渠道选择闭环 | 渠道选择算法 | 订单ID, 物流方案 | 渠道ID | 订单创建 | ⏳ pending | P1 | BE-LOG001 | 12h | AI-Backend-8 | +| BE-LOG003 | 物流策略与渠道选择闭环 | 运费计算接口 | 商品ID, 数量, 目的地 | 运费 | 前端请求 | ⏳ pending | P1 | BE-LOG001 | 10h | AI-Backend-8 | + +### 2.12 用户/客户资产后端【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-UA001 | 用户/客户资产闭环 | 用户资产计算接口 | 用户ID | 资产数据 | 前端请求 | ⏳ pending | P1 | - | 10h | AI-Backend-9 | +| BE-UA002 | 用户/客户资产闭环 | 积分管理引擎 | 用户ID, 积分操作 | 积分记录 | 前端提交 | ⏳ pending | P1 | BE-UA001 | 10h | AI-Backend-9 | +| BE-UA003 | 用户/客户资产闭环 | 会员等级系统 | 用户ID, 等级规则 | 等级信息 | 定时任务 | ⏳ pending | P1 | BE-UA001 | 12h | AI-Backend-9 | + +### 2.13 A/B测试与策略优化后端【P2 中优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-AB001 | A/B测试与策略优化闭环 | A/B测试引擎 | 测试ID, 参数 | 测试实例 | 前端提交 | ⏳ pending | P2 | - | 12h | AI-Backend-10 | +| BE-AB002 | A/B测试与策略优化闭环 | 流量分配算法 | 测试ID, 用户ID | 实验组 | 用户访问 | ⏳ pending | P2 | BE-AB001 | 10h | AI-Backend-10 | +| BE-AB003 | A/B测试与策略优化闭环 | 效果统计接口 | 测试ID, 时间范围 | 统计结果 | 定时任务 | ⏳ pending | P2 | BE-AB001 | 8h | AI-Backend-10 | + +### 2.14 认证服务后端【P2 中优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| BE-AUTH001 | 认证服务 | 用户认证接口 | 用户名, 密码 | 认证令牌 | 前端提交 | ⏳ pending | P2 | - | 10h | AI-Backend-11 | +| BE-AUTH002 | 认证服务 | 权限管理 | 用户ID, 权限 | 权限列表 | 前端请求 | ⏳ pending | P2 | BE-AUTH001 | 8h | AI-Backend-11 | +| BE-AUTH003 | 认证服务 | 会话管理 | 用户ID, 令牌 | 会话信息 | 请求验证 | ⏳ pending | P2 | BE-AUTH001 | 8h | AI-Backend-11 | + +--- + +## 🔌 3️⃣ 插件模块(外部平台操作 / 调度) + +### 3.1 平台采集插件 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| PL-C001 | 数据采集与清洗闭环 | 多平台商品采集 | 平台账号, 采集配置 | 原始商品数据 | 定时任务 | ✅ completed | P0 | - | 3h | AI-Plugin-1 | +| PL-C002 | 数据采集与清洗闭环 | DOM解析逻辑 | HTML内容 | 结构化数据 | 采集完成 | � in_progress | P1 | PL-C001 | 2h | AI-Plugin-2 | +| PL-C003 | 订单集中管理闭环 | 多平台订单采集 | 平台账号, 时间范围 | 订单数据 | 定时任务 | ⏳ pending | P0 | PL-C001 | 3h | AI-Plugin-1 | + +### 3.2 自动化操作插件 + +| 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 | + +### 3.3 售后逆向插件【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| PL-SR001 | 售后逆向闭环 | 平台退货同步 | 平台账号, 退货ID | 退货数据 | 定时任务 | ⏳ pending | P0 | PL-C003 | 8h | AI-Plugin-4 | +| PL-SR002 | 售后逆向闭环 | 退款状态查询 | 平台账号, 退款ID | 退款状态 | 定时任务 | ⏳ pending | P0 | PL-SR001 | 6h | AI-Plugin-4 | + +### 3.4 物流策略插件【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| PL-LOG001 | 物流策略与渠道选择闭环 | 物流状态同步 | 订单ID, 物流单号 | 物流信息 | 定时任务 | ⏳ pending | P1 | PL-A002 | 6h | AI-Plugin-5 | +| PL-LOG002 | 物流策略与渠道选择闭环 | 物流API对接 | 物流商, API配置 | 对接结果 | 配置更新 | ⏳ pending | P1 | PL-LOG001 | 8h | AI-Plugin-5 | + +### 3.5 广告计划插件【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| PL-AD001 | 广告计划与营销闭环 | 广告投放操作 | 平台账号, 广告ID | 投放结果 | 定时任务 | ⏳ pending | P0 | PL-C001 | 10h | AI-Plugin-6 | +| PL-AD002 | 广告计划与营销闭环 | 广告数据同步 | 平台账号, 广告ID | 广告数据 | 定时任务 | ⏳ pending | P0 | PL-AD001 | 8h | AI-Plugin-6 | + +### 3.6 B2B / TOB 贸易插件【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| PL-TOB001 | B2B / TOB 贸易管理闭环 | 批量订单提交 | 平台账号, 订单列表 | 提交结果 | 定时任务 | ⏳ pending | P0 | PL-C003 | 12h | AI-Plugin-7 | +| PL-TOB002 | B2B / TOB 贸易管理闭环 | 合同状态同步 | 平台账号, 合同ID | 合同状态 | 定时任务 | ⏳ pending | P0 | PL-TOB001 | 8h | AI-Plugin-7 | + +--- + +## 🤖 4️⃣ AI模块(智能决策 / 自动化) + +### 4.1 智能分析AI + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| AI-A001 | 定价与利润决策闭环 | 套利机会识别 | 商品价格, 成本数据 | 套利建议 | 数据更新 | ✅ completed | P1 | BE-P001 | 3h | AI-Analysis-1 | +| AI-A002 | 广告计划与营销闭环 | 广告ROI分析 | 广告数据, 销售数据 | ROI报告 | 定时任务 | ✅ completed | P2 | BE-O001 | 2.5h | AI-Analysis-1 | +| AI-A003 | 报表与分析闭环 | 数据大屏分析 | 业务数据 | 分析报告 | 定时任务 | ✅ completed | P2 | BE-F001 | 2h | AI-Analysis-2 | + +### 4.2 自动化决策AI + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| AI-D001 | 定价与利润决策闭环 | 自动调价决策 | 套利建议 | 调价指令 | 套利机会生成 | ⏳ pending | P1 | AI-A001 | 2h | AI-Decision-1 | +| AI-D002 | 异常订单处理闭环 | 异常自动修复 | 失败任务ID | 修复结果 | 任务失败 | ⏳ pending | P1 | BE-O004 | 2.5h | AI-Decision-1 | + +### 4.3 广告计划与营销AI【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| AI-AD001 | 广告计划与营销闭环 | 广告智能优化 | 广告数据, 市场数据 | 优化建议 | 定时任务 | ⏳ pending | P0 | BE-AD001 | 14h | AI-Analysis-3 | +| AI-AD002 | 广告计划与营销闭环 | 自动出价策略 | 广告ID, 竞争数据 | 出价建议 | 定时任务 | ⏳ pending | P0 | AI-AD001 | 12h | AI-Analysis-3 | +| AI-AD003 | 广告计划与营销闭环 | 广告效果预测 | 广告ID, 历史数据 | 预测结果 | 定时任务 | ⏳ pending | P0 | AI-AD001 | 14h | AI-Analysis-3 | + +### 4.4 B2B / TOB 贸易AI【P0 阻塞核心业务】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| AI-TOB001 | B2B / TOB 贸易管理闭环 | B2B客户分析 | 客户ID, 交易数据 | 客户画像 | 定时任务 | ⏳ pending | P0 | BE-TOB001 | 14h | AI-Analysis-4 | +| AI-TOB002 | B2B / TOB 贸易管理闭环 | 批量折扣策略 | 客户ID, 商品ID | 折扣建议 | 定时任务 | ⏳ pending | P0 | AI-TOB001 | 12h | AI-Analysis-4 | +| AI-TOB003 | B2B / TOB 贸易管理闭环 | 信用风险评估 | 客户ID, 交易数据 | 风险评分 | 定时任务 | ⏳ pending | P0 | AI-TOB001 | 14h | AI-Analysis-4 | + +### 4.5 用户/客户资产AI【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| AI-UA001 | 用户/客户资产闭环 | 用户价值分析 | 用户ID, 行为数据 | 价值评分 | 定时任务 | ⏳ pending | P1 | BE-UA001 | 12h | AI-Analysis-5 | +| AI-UA002 | 用户/客户资产闭环 | 个性化推荐 | 用户ID, 商品数据 | 推荐列表 | 用户访问 | ⏳ pending | P1 | AI-UA001 | 12h | AI-Analysis-5 | + +### 4.6 A/B测试与策略优化AI【P2 中优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| AI-AB001 | A/B测试与策略优化闭环 | 测试策略推荐 | 测试目标, 数据 | 策略建议 | 测试创建 | ⏳ pending | P2 | BE-AB001 | 10h | AI-Analysis-6 | +| AI-AB002 | A/B测试与策略优化闭环 | 自动优化算法 | 测试结果, 优化目标 | 优化建议 | 测试完成 | ⏳ pending | P2 | AI-AB001 | 12h | AI-Analysis-6 | + +--- + +## 📊 5️⃣ 数据模块(数据采集 / 清洗 / 分析) + +### 5.1 数据处理 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| DT-P001 | 数据采集与清洗闭环 | 数据清洗引擎 | 原始数据 | 清洗后数据 | 采集完成 | ✅ completed | P0 | PL-C001 | 2h | AI-Data-1 | +| DT-P002 | 数据采集与清洗闭环 | 数据标准化 | 清洗后数据 | 标准化数据 | 清洗完成 | ✅ completed | P1 | DT-P001 | 1.5h | AI-Data-1 | + +### 5.2 数据分析 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| DT-A001 | 报表与分析闭环 | 核心报表生成 | 业务数据 | 报表数据 | 定时任务 | ⏳ pending | P2 | BE-F001 | 2h | AI-Data-2 | +| DT-A002 | A/B测试与策略优化闭环 | A/B测试分析 | 测试数据 | 测试结果 | 测试完成 | ⏳ pending | P3 | DT-A001 | 2.5h | AI-Data-2 | + +### 5.3 合规与证书数据【P1 高优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| DT-COM001 | 合规与证书管理闭环 | 证书数据库 | 证书信息 | 证书记录 | 证书创建 | ⏳ pending | P1 | BE-COM001 | 10h | AI-Data-3 | +| DT-COM002 | 合规与证书管理闭环 | 合规规则库 | 规则配置 | 规则记录 | 规则更新 | ⏳ pending | P1 | BE-COM002 | 10h | AI-Data-3 | + +### 5.4 数据库设计与表定义【P3 低优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| DT-DB001 | 数据库设计 | 核心表结构定义 | 表结构定义 | SQL脚本 | 设计完成 | ⏳ pending | P3 | - | 12h | AI-Data-4 | +| DT-DB002 | 数据库设计 | 数据库ERD图 | 表关系 | ERD图 | 设计完成 | ⏳ pending | P3 | DT-DB001 | 8h | AI-Data-4 | +| DT-DB003 | 数据库设计 | 索引设计文档 | 表结构, 查询模式 | 索引设计 | 设计完成 | ⏳ pending | P3 | DT-DB001 | 6h | AI-Data-4 | + +### 5.5 测试用例与质量保证【P3 低优先级】 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| DT-QA001 | 测试用例与质量保证 | 单元测试用例 | 代码模块 | 测试用例 | 代码完成 | ⏳ pending | P3 | - | 12h | AI-Data-5 | +| DT-QA002 | 测试用例与质量保证 | 集成测试用例 | 业务流程 | 测试用例 | 功能完成 | ⏳ pending | P3 | DT-QA001 | 14h | AI-Data-5 | +| DT-QA003 | 测试用例与质量保证 | 测试报告模板 | 测试结果 | 测试报告 | 测试完成 | ⏳ pending | P3 | DT-QA002 | 8h | AI-Data-5 | + +--- + +## 🛠️ 6️⃣ 运维模块(监控 / 部署 / 维护) + +### 6.1 系统监控 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| OP-M001 | 账号/店铺健康度闭环 | 系统健康监控 | 系统指标 | 健康状态 | 定时任务 | ✅ completed | P1 | - | 2h | AI-Ops-1 | +| OP-M002 | 合规与风控闭环 | 异常告警系统 | 异常事件 | 告警通知 | 异常发生 | ✅ completed | P0 | BE-G002 | 1.5h | AI-Ops-1 | + +### 6.2 部署与维护 + +| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | +|---------|----------|----------|------|------|----------|------|--------|------|----------|--------| +| OP-D001 | 店铺隔离与自动化闭环 | 自动部署脚本 | 代码版本 | 部署结果 | 代码提交 | ⏳ pending | P2 | - | 2h | AI-Ops-2 | +| OP-D002 | 系统维护 | 数据备份与恢复 | 备份配置 | 备份文件 | 定时任务 | ⏳ pending | P1 | - | 1.5h | AI-Ops-2 | + +--- + +## 🔗 全局依赖与接口定义 + +### 核心接口列表 + +| 接口名称 | 模块 | 输入参数 | 输出参数 | 调用频率 | 状态 | +|----------|------|----------|----------|----------|------| +| createProduct | 后端 | 商品基础信息 | 商品ID, 状态 | 用户提交 | ✅ completed | +| getProductList | 后端 | 筛选条件, 分页 | 商品列表 | 页面加载 | ✅ completed | +| createOrder | 后端 | 用户ID, 商品ID, 数量 | 订单ID, 状态 | 用户提交 | 🟡 in_progress | +| getOrderList | 后端 | 用户ID, 筛选条件 | 订单列表 | 页面加载 | 🟡 in_progress | +| syncInventory | 后端 | 商品ID, 库存变化 | 库存状态 | 库存变化 | ✅ completed | +| reconcileFinance | 后端 | 时间范围, 平台ID | 对账结果 | 定时任务 | 🟡 in_progress | +| fetchPlatformData | 插件 | 平台账号, 配置 | 原始数据 | 定时任务 | ✅ completed | +| analyzeArbitrage | AI | 商品价格, 成本 | 套利建议 | 数据更新 | ⏳ pending | +| createAdPlan | 后端 | 广告参数 | 广告ID | 前端提交 | ⏳ pending | +| executeAdCampaign | 后端 | 广告ID, 投放参数 | 投放状态 | 定时任务 | ⏳ pending | +| calculateAdROI | 后端 | 广告ID, 时间范围 | ROI数据 | 定时任务 | ⏳ pending | +| processReturn | 后端 | 订单ID, 退货原因 | 退货ID | 前端提交 | ⏳ pending | +| processRefund | 后端 | 退货ID, 审批结果 | 退款状态 | 审批完成 | ⏳ pending | +| calculateTieredPrice | 后端 | 商品ID, 数量 | 阶梯价 | 前端请求 | ⏳ pending | +| processBatchOrder | 后端 | 客户ID, 商品列表 | 批量订单ID | 前端提交 | ⏳ pending | +| manageCreditPeriod | 后端 | 客户ID, 账期设置 | 账期记录 | 前端提交 | ⏳ pending | +| storeCertificate | 后端 | 证书信息 | 证书ID | 前端提交 | ⏳ pending | +| checkCompliance | 后端 | 商品ID, 平台ID | 合规结果 | 前端请求 | ⏳ pending | +| selectLogisticsStrategy | 后端 | 订单ID, 目的地 | 物流方案 | 订单创建 | ⏳ pending | +| calculateShippingFee | 后端 | 商品ID, 数量, 目的地 | 运费 | 前端请求 | ⏳ pending | +| calculateUserAssets | 后端 | 用户ID | 资产数据 | 前端请求 | ⏳ pending | +| manageUserPoints | 后端 | 用户ID, 积分操作 | 积分记录 | 前端提交 | ⏳ pending | +| manageMembershipLevel | 后端 | 用户ID, 等级规则 | 等级信息 | 定时任务 | ⏳ pending | +| createABTest | 后端 | 测试ID, 参数 | 测试实例 | 前端提交 | ⏳ pending | +| allocateTraffic | 后端 | 测试ID, 用户ID | 实验组 | 用户访问 | ⏳ pending | +| authenticateUser | 后端 | 用户名, 密码 | 认证令牌 | 前端提交 | ⏳ pending | +| managePermissions | 后端 | 用户ID, 权限 | 权限列表 | 前端请求 | ⏳ pending | +| manageSession | 后端 | 用户ID, 令牌 | 会话信息 | 请求验证 | ⏳ pending | + +--- + +## 📈 里程碑与关键路径 + +### Phase 1: 核心功能(Week 1-2) +- ✅ 商品管理基础功能 +- 🟡 订单管理基础功能 +- ⏳ 库存管理基础功能 +- ⏳ 基础财务对账 +- ⏳ 广告计划与营销闭环【P0】 +- ⏳ 售后逆向闭环【P0】 +- ⏳ B2B / TOB 贸易管理闭环【P0】 + +### Phase 2: 扩展功能(Week 3-4) +- ⏳ 多平台订单集中管理 +- ⏳ 素材管理系统 +- ⏳ AI智能定价 +- ⏳ 风控系统 +- ⏳ 合规与证书管理闭环【P1】 +- ⏳ 物流策略与渠道选择闭环【P1】 +- ⏳ 用户/客户资产闭环【P1】 + +### Phase 3: 高级功能(Week 5-6) +- ⏳ 海外仓管理 +- ⏳ 数据大屏与分析 +- ⏳ 自动化运维 +- ⏳ A/B测试与策略优化闭环【P2】 +- ⏳ 认证服务模块【P2】 + +### Phase 4: 基础设施(Week 7-8) +- ⏳ 数据库设计与表定义【P3】 +- ⏳ 测试用例与质量保证【P3】 +- ⏳ 系统监控与告警优化 + +--- + +## 🎯 质量指标 + +| 指标 | 目标值 | 当前值 | 状态 | +|------|--------|--------|------| +| 任务完成率 | 100% | 25% | 🟡 需提升 | +| 代码测试覆盖率 | 80% | 30% | 🟡 需提升 | +| 接口响应时间 | <200ms | - | ⏳ 待测试 | +| 系统可用性 | 99.9% | - | ⏳ 待监控 | +| AI决策准确率 | 95% | - | ⏳ 待验证 | + +--- + +## 📝 使用说明 + +### AI Agent使用流程 +1. **任务认领**:AI Agent从pending任务中选择符合能力的任务 +2. **状态更新**:认领后更新为claimed,开始生成代码 +3. **执行部署**:代码生成后更新为in_progress,开始执行 +4. **完成验证**:执行成功后更新为completed,失败则更新为failed +5. **依赖检查**:检查依赖任务状态,确保执行顺序正确 + +### 任务依赖规则 +- **直接依赖**:任务必须在依赖任务完成后才能开始 +- **间接依赖**:通过依赖链传递,确保整体流程正确 +- **循环依赖**:禁止任务间存在循环依赖 + +### 失败处理机制 +- **自动重试**:失败任务自动重试3次 +- **人工干预**:重试失败后标记为failed,等待人工处理 +- **回滚机制**:关键任务失败时自动回滚相关操作 + +--- + +**最后更新时间**:2026-03-18 +**维护者**:Crawlful Hub AI Team \ No newline at end of file diff --git a/docs1/临时修改建议.MD b/docs1/临时修改建议.MD new file mode 100644 index 0000000..d44daef --- /dev/null +++ b/docs1/临时修改建议.MD @@ -0,0 +1,78 @@ +Crawlful_Hub/ +│ +├─ 00_Business/ +│ ├─ Business_ClosedLoops.md # 你当前已有的闭环文档 +│ ├─ Business_KPIs.md # 关键绩效指标文档 +│ ├─ Business_Rules.md # 核心业务规则 +│ └─ Business_DecisionPoints.md # 决策点汇总 +│ +├─ 01_Architecture/ +│ ├─ System_Architecture.md # 总体架构图与说明 +│ ├─ Module_Responsibilities.md # 各模块职责与接口 +│ ├─ AI_Agent_Interaction.md # AI agent 协作说明 +│ ├─ Data_Flow_Diagrams/ # 数据流与依赖图 +│ └─ Sequence_Flow_Diagrams/ # 业务流程图 +│ +├─ 02_Backend/ +│ ├─ Backend_Design.md # 架构设计 & 模块说明 +│ ├─ API_Specs/ # 所有后端 API 规范 +│ │ ├─ Product_API.md +│ │ ├─ Order_API.md +│ │ └─ Finance_API.md +│ ├─ Database/ +│ │ ├─ ERD.md # 数据库设计图 +│ │ └─ Table_Definitions.md +│ ├─ Services/ # 后端服务模块说明 +│ └─ Backend_Automation.md # AI 自动化生成后端说明 +│ +├─ 03_Frontend/ +│ ├─ Frontend_Design.md # 架构设计 & 技术栈 +│ ├─ UI_Components.md # UI组件库说明 +│ ├─ Pages_Flow.md # 页面流转/路由 +│ ├─ API_Consumption.md # 前端调用 API 规范 +│ └─ Frontend_Automation.md # AI 自动生成前端说明 +│ +├─ 04_Plugin/ +│ ├─ Plugin_Design.md # 插件端架构说明 +│ ├─ DOM_Interaction.md # 插件操作 DOM 规范 +│ ├─ Automation_Scripts.md # 插件脚本说明 +│ └─ Plugin_Agent_Integration.md # AI agent 与插件交互 +│ +├─ 05_AI/ +│ ├─ AI_Strategy.md # AI agent 分工与策略 +│ ├─ AI_Context.md # 上下文与知识库管理 +│ ├─ AI_Tasks.md # AI 任务表(pending/claimed/in_progress/completed) +│ ├─ AI_Training_Data/ # AI训练数据 & 样例 +│ └─ AI_Model_Integration.md # 模型接口与调用说明 +│ +├─ 06_ETL/ +│ ├─ ETL_Pipelines.md # 数据采集、清洗、处理流程 +│ ├─ ETL_Scripts/ # 脚本文件 +│ └─ ETL_Data_Samples/ # 样例数据 +│ +├─ 07_Testing/ +│ ├─ Test_Strategy.md # 测试策略 & 用例设计 +│ ├─ Unit_Tests/ # 单元测试说明 +│ ├─ Integration_Tests/ # 集成测试说明 +│ └─ Test_Reports/ # 测试结果输出 +│ +├─ 08_Deployment/ +│ ├─ Deployment_Guide.md # 部署说明 +│ ├─ CI_CD_Pipelines.md # 持续集成/持续交付 +│ └─ Environment_Configs/ # 配置文件 (dev/staging/prod) +│ +├─ 09_Operations/ +│ ├─ Monitoring.md # 监控指标、报警策略 +│ ├─ Logging.md # 日志规范与存储 +│ ├─ Exception_Handling.md # 异常处理 & 自愈策略 +│ └─ Maintenance_Guide.md # 运维手册 +│ +├─ 10_Documents_Global/ +│ ├─ PROJECT_MAP.md # 全局模块关系图 +│ ├─ README.md # 项目总览 +│ └─ Changelog.md # 文档 & 开发更新记录 +│ +└─ 11_References/ + ├─ Platform_API_Docs/ # 平台文档 (Amazon, Shopee, TikTok 等) + ├─ Regulatory_Requirements.md # 合规要求 + └─ Glossary.md # 术语汇总 \ No newline at end of file diff --git a/docs11/00-documentation-layer.md b/docs11/00-documentation-layer.md index 3997b6c..b0070b1 100644 --- a/docs11/00-documentation-layer.md +++ b/docs11/00-documentation-layer.md @@ -20,19 +20,26 @@ 14. [报表与分析闭环](#1️⃣4️⃣-报表与分析闭环reporting--analytics-loop) 15. [定价与利润决策闭环](#1️⃣5️⃣-定价与利润决策闭环pricing--profit-decision-loop) 16. [账号/店铺健康度闭环](#1️⃣6️⃣-账号/店铺健康度闭环accountshop-health-loop) -17. [任务调度/自动化执行闭环](#1️⃣7️⃣-任务调度自动化执行闭环task-scheduling--automation-loop) -18. [数据标准化/商品主数据闭环](#1️⃣8️⃣-数据标准化商品主数据闭环data-standardization--mdm-loop) -19. [价格/汇率/成本基准闭环](#1️⃣9️⃣-价格汇率成本基准闭环priceexchange-ratecost-benchmark-loop) -20. [用户/客户资产闭环](#2️⃣0️⃣-用户客户资产闭环usercustomer-asset-loop) -21. [A/B测试与策略优化闭环](#2️⃣1️⃣-ab测试与策略优化闭环ab-testing--strategy-optimization-loop) -22. [权限与审计闭环](#2️⃣2️⃣-权限与审计闭环permission--audit-loop) -23. [异常检测与自愈闭环](#2️⃣3️⃣-异常检测与自愈闭环anomaly-detection--self-healing-loop) -24. [统一闭环依赖](#🔹-统一闭环依赖toc--tob) -25. [闭环依赖关系](#🔗-闭环依赖关系toc--tob) -26. [关键绩效指标](#📊-关键绩效指标kpi) -27. [追踪与审计](#🔍-追踪与审计) -28. [业务审核状态机](#📋-业务审核状态机) -29. [说明](#💡-说明) +17. [店铺隔离与自动化闭环](#1️⃣7️⃣-店铺隔离与自动化闭环shop-isolation--automation-loop) +18. [订单集中管理闭环](#1️⃣8️⃣-订单集中管理闭环order-centralized-management-loop) +19. [客户/商家押金与账户管理闭环](#1️⃣9️⃣-客户商家押金与账户管理闭环customer-merchant-deposit--account-management-loop) +20. [商家选择发货闭环](#2️⃣0️⃣-商家选择发货闭环merchant-selective-fulfillment-loop) +21. [回款与财务闭环](#2️⃣1️⃣-回款与财务闭环payment--financial-reconciliation-loop) +22. [海外仓/本土仓 & 多品类支持闭环](#2️⃣2️⃣-海外仓本土仓--多品类支持闭环overseaslocal-warehouse--multi-category-support-loop) +23. [商品主数据闭环](#2️⃣3️⃣-商品主数据闭环product-master-data-loop--mdm) +24. [SKU变体与结构闭环](#2️⃣4️⃣-sku变体与结构闭环sku-variant--structure-loop) +25. [订单拆分与合并闭环](#2️⃣5️⃣-订单拆分与合并闭环order-split--merge-loop) +26. [异常订单处理闭环](#2️⃣6️⃣-异常订单处理闭环exception-order-handling-loop) +27. [物流策略与渠道选择闭环](#2️⃣7️⃣-物流策略与渠道选择闭环logistics-strategy--channel-selection-loop) +28. [利润核算闭环](#2️⃣8️⃣-利润核算闭环profit-calculation-loop) +29. [用户/客户资产闭环](#2️⃣9️⃣-用户客户资产闭环usercustomer-asset-loop) +30. [A/B测试与策略优化闭环](#3️⃣0️⃣-ab测试与策略优化闭环ab-testing--strategy-optimization-loop) +31. [统一闭环依赖](#🔹-统一闭环依赖toc--tob) +32. [闭环依赖关系](#🔗-闭环依赖关系toc--tob) +33. [关键绩效指标](#📊-关键绩效指标kpi) +34. [追踪与审计](#🔍-追踪与审计) +35. [业务审核状态机](#📋-业务审核状态机) +36. [说明](#💡-说明) *** @@ -273,24 +280,187 @@ *** -## 1️⃣7️⃣ 任务调度/自动化执行闭环(Task Scheduling & Automation Loop) +## 1️⃣7️⃣ 店铺隔离与自动化闭环(Shop Isolation & Automation Loop) -- **目标**:作为系统操作系统(OS层),调度和自动化执行各业务闭环的任务。 +- **目标**: + 1. 确保每个 TOC / TOB 店铺环境隔离,防止账号关联导致封禁 + 2. 自动化执行 API 不支持或无 API 的操作(刊登、采集、调价、库存同步等) + 3. 支持多云环境,可灵活选择云服务商(阿里云、腾讯云、AWS、Azure 等) - **流程**: - - 事件监听 → 任务调度 → 执行监控 → 结果反馈 + 1. **镜像/虚拟机管理** + - 每个店铺对应独立云镜像或虚拟机(Win/Linux 可选) + - 云商 API 对接: + - 镜像购买 / 续费 + - 快照 / 重置 + - 开机 / 关机 / 重启 + - 支持多云商切换,可根据价格、性能、地理位置灵活部署 + 2. **预置环境配置** + - 浏览器、自动化脚本、指纹管理工具、VPN 或固定 IP 配置 + - 自动登录店铺账户,无需人工干预 + 3. **任务调度与自动化执行** + - 脚本调度可使用 JS / Python / 后端 API 方式控制 + - 支持平台无 API 操作(如商品采集、库存更新、手动刊登模拟等) + - 自动执行任务后状态反馈至任务调度闭环,并记录日志 + 4. **监控与异常自愈** + - 云镜像健康监控(在线状态、资源使用、脚本异常) + - 自动重启 / 快照恢复 / 切换备用镜像 + - 异常信息反馈至异常检测与自愈闭环 - **决策点**: - - 任务优先级设定 - - 资源分配策略 - - 异常处理机制 -- **输入**:业务事件(新商品、订单、库存不足、ROI变化) + - 店铺隔离等级(独立镜像、不同 IP、不同指纹) + - 云商选择与成本控制 + - 异常处理策略(自动恢复或人工介入) +- **输入**: + - 店铺列表、业务需求(采集、刊登、广告等) + - 云商账户与资源配置 + - 自动化脚本 / 后端控制接口 - **输出**: - - 自动执行任务(刊登、补货、调价、广告投放) - - 任务执行状态 - - 异常处理结果 + - 各店铺独立镜像环境 + - 自动化执行日志与状态报告 + - 异常修复记录 +- **闭环价值**: + 1. 高度隔离,降低账号封禁与关联风险 + 2. 自动化落地,提高效率与可扩展性 + 3. 支持多云部署,增强业务弹性和成本优化能力 *** -## 1️⃣8️⃣ 数据标准化/商品主数据闭环(Data Standardization & MDM Loop) +## 1️⃣8️⃣ 订单集中管理闭环(Order Centralized Management Loop) + +- **目标**:跨平台订单统一抓取、集中展示和管理,支持 TOC/TOB 订单流转。 +- **流程**: + 1. **多平台订单采集** + - 支持 TikTok、Shopee、Temu 等平台订单抓取 + - 通过 API 或自动化脚本采集 + 2. **订单集中展示** + - 产品信息:名称、数量、实收价格、订单时间、状态 + - 支持平台/客户/品类/订单状态筛选 + - 可选漏斗分析:订单流转、发货完成率 + 3. **订单状态管理** + - 状态流转:`available → requested → shipped → completed` + - 订单分配与跟踪 +- **决策点**: + - 订单抓取频率 + - 订单优先级设置 + - 异常订单处理策略 +- **输入**: + - 多平台订单数据 + - 店铺信息 + - 客户/商家信息 +- **输出**: + - 集中管理的订单数据 + - 订单状态报告 + - 异常订单标记 + +*** + +## 1️⃣9️⃣ 客户/商家押金与账户管理闭环(Customer/Merchant Deposit & Account Management Loop) + +- **目标**:管理客户预缴押金、账户余额,支持订单抵扣和提现。 +- **流程**: + 1. **押金管理** + - 客户预缴押金(例:100 元抵 2 单) + - 押金余额、已抵扣订单数量记录 + 2. **账户管理** + - 客户可查看:可申请发货订单、历史回款、押金/余额状态 + - 自动扣减押金或余额完成发货操作 + 3. **提现管理** + - 检查账户余额 → 生成提现单 → 审核 → 打款 +- **决策点**: + - 押金抵扣规则 + - 提现审核流程 + - 余额管理策略 +- **输入**: + - 客户押金信息 + - 订单数据 + - 提现申请 +- **输出**: + - 押金/余额状态 + - 提现处理结果 + - 财务流水记录 + +*** + +## 2️⃣0️⃣ 商家选择发货闭环(Merchant Selective Fulfillment Loop) + +- **目标**:商家可选择自己有库存的订单发货,剩余由平台/公司发货。 +- **流程**: + 1. **订单选择** + - 商家登录落地页选择自己有货的订单发货 + 2. **系统检查** + - 押金或余额是否足够覆盖订单 + - 时效性(保证订单不过期) + 3. **订单状态更新** + - 状态流转:`available → requested → shipped → completed` + - 剩余无货订单由平台/公司自己发货 +- **决策点**: + - 订单分配规则 + - 库存检查策略 + - 时效保证机制 +- **输入**: + - 商家库存信息 + - 订单数据 + - 押金/余额状态 +- **输出**: + - 订单分配结果 + - 发货状态更新 + - 异常订单标记 + +*** + +## 2️⃣1️⃣ 回款与财务闭环(Payment & Financial Reconciliation Loop) + +- **目标**:管理客户付款、押金抵扣、回款记录和提现,确保财务透明。 +- **流程**: + 1. **收款管理** + - 客户付款到店铺账户或系统自动扣押金/余额 + 2. **财务流水记录** + - 类型(押金/回款/提现)、金额、订单ID、状态 + - 状态流转:`pending → approved → completed` + 3. **财务对账** + - 店铺收入 ↔ 客户账户余额 + - 异常订单/回款标记 → 自动或人工处理 +- **决策点**: + - 回款确认机制 + - 对账频率 + - 异常处理流程 +- **输入**: + - 客户付款信息 + - 订单数据 + - 押金/余额状态 +- **输出**: + - 财务流水记录 + - 对账结果 + - 提现处理结果 + +*** + +## 2️⃣2️⃣ 海外仓/本土仓 & 多品类支持闭环(Overseas/Local Warehouse & Multi-Category Support Loop) + +- **目标**:统一管理海外仓和本土仓库存,支持多品类分配和上下游分析。 +- **流程**: + 1. **库存管理** + - 海外仓和本土仓库存统一管理 + - 可按品类、仓库位置、时效性分配发货 + 2. **上下游分析** + - 供应商价格对比 + - 成本/利润/ROI 分析 + - 同行发货/库存策略参考 +- **决策点**: + - 仓库选择策略 + - 品类分配规则 + - 供应链优化策略 +- **输入**: + - 仓库库存数据 + - 供应商信息 + - 订单数据 +- **输出**: + - 库存分配方案 + - 供应链分析报告 + - 成本优化建议 + +*** + +## 2️⃣3️⃣ 商品主数据闭环(Product Master Data Loop / MDM) - **目标**:建立统一的商品主数据管理体系,确保数据一致性。 - **流程**: @@ -308,24 +478,93 @@ *** -## 1️⃣9️⃣ 价格/汇率/成本基准闭环(Price/Exchange Rate/Cost Benchmark Loop) +## 1️⃣9️⃣ SKU变体与结构闭环(SKU Variant & Structure Loop) -- **目标**:建立全局统一的成本计算标准,确保定价和利润分析的准确性。 +- **目标**:管理商品的变体和多平台SKU映射,确保库存和订单的一致性。 - **流程**: - - 外部数据采集 → 基准数据维护 → 成本计算 → 数据分发 + - SPU创建 → SKU生成 → 平台SKU映射 → 同步管理 - **决策点**: - - 基准数据更新频率 - - 汇率风险控制策略 - - 成本分摊规则 -- **输入**:汇率数据、物流成本、平台费用、税费标准 + - 变体属性定义 + - 多平台SKU规则适配 + - 库存同步策略 +- **输入**:商品主数据、平台SKU规则 - **输出**: - - 实时成本基准 - - 汇率风险评估 - - 成本分摊结果 + - 多SKU结构(颜色/尺寸/套装) + - 各平台SKU映射 + - 统一库存管理 *** -## 2️⃣0️⃣ 用户/客户资产闭环(User/Customer Asset Loop) +## 2️⃣0️⃣ 订单拆分与合并闭环(Order Split & Merge Loop) + +- **目标**:处理多仓发货、多订单合并、部分缺货等场景,优化物流成本和时效。 +- **流程**: + - 订单分析 → 拆分/合并决策 → 子订单生成 → 履约执行 +- **决策点**: + - 拆分类型(仓/SKU/库存) + - 合并条件 + - 优先级策略 +- **输入**:订单数据、库存状态、物流成本 +- **输出**: + - 子订单 + - 合并订单 + - 物流方案 + +*** + +## 2️⃣1️⃣ 异常订单处理闭环(Exception Order Handling Loop) + +- **目标**:处理地址错误、海关卡单、物流丢件、无法发货等履约异常。 +- **流程**: + - 异常检测 → 分类处理 → 解决方案执行 → 结果反馈 +- **决策点**: + - 异常类型识别 + - 处理优先级 + - 人工介入条件 +- **输入**:订单数据、物流状态、异常事件 +- **输出**: + - 异常处理结果 + - 售后触发 + - 风控预警 + +*** + +## 2️⃣2️⃣ 物流策略与渠道选择闭环(Logistics Strategy & Channel Selection Loop) + +- **目标**:基于成本、时效和可靠性,选择最优物流方案。 +- **流程**: + - 订单分析 → 物流渠道评估 → 方案选择 → 执行监控 +- **决策点**: + - 仓选择 + - 物流方式(空运/海运/快递) + - 渠道选择 +- **输入**:订单数据、库存分布、物流成本、时效要求 +- **输出**: + - 物流渠道选择 + - 成本估算 + - 时效承诺 + +*** + +## 2️⃣3️⃣ 利润核算闭环(Profit Calculation Loop) + +- **目标**:精确计算真实利润,支持定价和决策优化。 +- **流程**: + - 成本汇总 → 收入匹配 → 利润计算 → 分析报告 +- **决策点**: + - 成本分摊规则 + - 汇率处理 + - 利润阈值设定 +- **输入**:商品成本、运费、广告费、平台佣金、税费、汇率数据 +- **输出**: + - 订单级利润 + - 商品级利润 + - 店铺级利润 + - 利润分析报告 + +*** + +## 2️⃣4️⃣ 用户/客户资产闭环(User/Customer Asset Loop) - **目标**:沉淀和管理用户资产,支持精准营销和客户价值提升。 - **流程**: @@ -344,7 +583,7 @@ *** -## 2️⃣1️⃣ A/B测试与策略优化闭环(A/B Testing & Strategy Optimization Loop) +## 2️⃣5️⃣ A/B测试与策略优化闭环(A/B Testing & Strategy Optimization Loop) - **目标**:通过实验验证和数据驱动,持续优化业务策略。 - **流程**: @@ -361,100 +600,15 @@ *** -## 2️⃣2️⃣ 权限与审计闭环(Permission & Audit Loop) - -- **目标**:确保系统操作的可追溯性和安全性,满足合规要求。 -- **流程**: - - 操作记录 → 审计日志生成 → 合规检查 → 异常处理 -- **决策点**: - - 权限等级设定 - - 审计范围确定 - - 异常处理流程 -- **输入**:系统操作记录、权限变更、敏感操作 -- **输出**: - - 详细审计日志 - - 权限变更记录 - - 合规检查报告 - - 异常告警 - -*** - -## 2️⃣3️⃣ 异常检测与自愈闭环(Anomaly Detection & Self-Healing Loop) - -- **目标**:实时监测系统异常,自动触发修复机制,提高系统稳定性。 -- **流程**: - - 数据监控 → 异常检测 → 根因分析 → 自动修复 -- **决策点**: - - 异常阈值设定 - - 修复策略制定 - - 人工介入条件 -- **输入**:API调用状态、刊登状态、广告投放数据、ROI变化 -- **输出**: - - 异常告警 - - 自动修复执行 - - 系统健康报告 - - 优化建议 - -*** - ### 🔹 统一闭环依赖(TOC + TOB) ```text -采集 → 清洗 → 套利/利润评估 - │ - ▼ -数据标准化 & MDM ← 供应链 - │ -商品刊登 ← 素材管理 - │ - ▼ -定价与利润决策 - │ - ▼ -广告/营销 (TOC) / 企业营销 (TOB) - │ - ▼ -订单履约 (OMS) → 售后逆向 - │ │ - ▼ ▼ -库存 & WMS ← 资金对账 - │ - ▼ -供应链 & 补货 - │ - ▼ -B2B/TOB 贸易管理 (TOB) - │ - ▼ -用户/客户资产 - │ - ▼ -A/B测试 & 策略优化 - │ - ▼ -治理与审批中心 - │ - ▼ -合规 & 证书 - │ - ▼ -风控 - │ - ▼ -报表 & 分析 +[数据采集] ↓[数据清洗] ↓[套利/利润评估] ↓[商品主数据] ↓[SKU变体与结构] ↓[商品刊登] ←→ [素材管理] ↓[定价与利润决策] ↓[广告/营销 (TOC) / 企业营销 (TOB)] ↓[订单履约 (OMS)] ↓[订单拆分与合并] ↓[异常订单处理] ↓[物流策略与渠道选择] ↓[库存 & WMS] ←→ [供应链 & 补货] ↓[售后逆向] ↓[资金对账] ↓[利润核算] ↓[B2B/TOB 贸易管理 (TOB)] ↓[用户/客户资产] ↓[A/B测试 & 策略优化] ↓[治理与审批中心] ↓[合规 & 证书] ↓[风控] ↓[报表 & 分析] ↺(反馈所有环节) -横切能力层: -┌─────────────────────┐ -│ 账号/店铺健康度 │ -├─────────────────────┤ -│ 任务调度/自动化 │ -├─────────────────────┤ -│ 价格/汇率/成本基准 │ -├─────────────────────┤ -│ 权限与审计 │ -├─────────────────────┤ -│ 异常检测与自愈 │ -└─────────────────────┘ +外挂三条线: +用户资产 ← 订单 / 售后 → 广告 / B2B +店铺健康度 ← 所有行为 → 限制商品 / 广告 +店铺隔离与自动化 ← 店铺操作 → 所有店铺相关行为 ``` **说明**: @@ -462,63 +616,64 @@ A/B测试 & 策略优化 - 实线箭头表示核心业务流程 - 括号内标注了TOC/TOB的主要差异点 - B2B/TOB贸易管理为TOB特有闭环 -- 横切能力层:贯穿所有业务闭环的系统级能力 +- 横切能力:账号/店铺健康度贯穿所有业务闭环 *** ### 🔗 闭环依赖关系(TOC + TOB) -1. **数据采集与清洗闭环** → **商品刊登闭环**:提供清洗后的可售商品数据 +1. **数据采集与清洗闭环** → **商品主数据闭环**:提供原始商品数据 2. **数据采集与清洗闭环** → **素材管理闭环**:提供采集的商品图片和视频素材 -3. **数据采集与清洗闭环** → **数据标准化/商品主数据闭环**:提供原始商品数据 -4. **数据采集与清洗闭环** → **定价与利润决策闭环**:提供成本和市场数据 -5. **商品刊登闭环** → **素材管理闭环**:触发素材需求,生成商品主图和详情图 -6. **素材管理闭环** → **商品刊登闭环**:提供处理后的商品素材(图片、视频) -7. **素材管理闭环** → **广告计划与营销闭环**:提供广告投放所需的素材库 -8. **商品刊登闭环** → **广告计划与营销闭环**:提供已刊登商品列表 -9. **商品刊登闭环** → **订单履约闭环**:提供商品库存和状态信息 -10. **商品刊登闭环** → **定价与利润决策闭环**:提供商品成本信息 -11. **订单履约闭环** → **售后逆向闭环**:提供订单和物流信息 -12. **售后逆向闭环** → **资金对账闭环**:提供退款记录 -13. **订单履约闭环** → **资金对账闭环**:提供销售记录 -14. **广告计划与营销闭环** → **资金对账闭环**:提供广告费用记录 -15. **订单履约闭环** → **库存与仓储管理闭环**:触发库存扣减和物流操作 -16. **库存与仓储管理闭环** → **订单履约闭环**:提供库存状态和物流信息 -17. **库存与仓储管理闭环** → **供应链与供应商管理闭环**:触发补货需求 -18. **供应链与供应商管理闭环** → **库存与仓储管理闭环**:提供采购入库信息 -19. **供应链与供应商管理闭环** → **数据标准化/商品主数据闭环**:提供供应商商品数据 -20. **商品刊登闭环** → **B2B / TOB 贸易管理闭环**:提供商品信息用于报价 -21. **B2B / TOB 贸易管理闭环** → **订单履约闭环**:生成 B2B 订单 -22. **B2B / TOB 贸易管理闭环** → **资金对账闭环**:提供 B2B 交易记录 -23. **所有敏感操作** → **治理与审批中心闭环**:触发审批流程 -24. **治理与审批中心闭环** → **所有业务闭环**:提供审批结果 -25. **订单履约闭环** → **合规与证书管理闭环**:触发证书生成 -26. **合规与证书管理闭环** → **订单履约闭环**:提供合规证书 -27. **订单履约闭环** → **用户/客户资产闭环**:提供订单和用户行为数据 -28. **用户/客户资产闭环** → **广告计划与营销闭环**:提供用户画像和营销建议 -29. **用户/客户资产闭环** → **B2B / TOB 贸易管理闭环**:提供企业客户信息 -30. **广告计划与营销闭环** → **A/B测试与策略优化闭环**:提供广告策略数据 -31. **商品刊登闭环** → **A/B测试与策略优化闭环**:提供商品定价和展示数据 -32. **A/B测试与策略优化闭环** → **报表与分析闭环**:提供测试结果和优化建议 -33. **定价与利润决策闭环** → **商品刊登闭环**:提供建议售价和上架决策 -34. **定价与利润决策闭环** → **广告计划与营销闭环**:提供可投放 ROI 区间和最大可承受 CPA -35. **所有业务闭环** → **账号/店铺健康度闭环**:提供违规记录、发货延迟、差评率、退款率等数据 -36. **账号/店铺健康度闭环** → **广告计划与营销闭环**:提供是否暂停广告、降预算的决策 -37. **账号/店铺健康度闭环** → **商品刊登闭环**:提供是否限制上新、下架高风险商品的决策 -38. **所有闭环** → **任务调度/自动化执行闭环**:提供业务事件(新商品、订单、库存不足、ROI变化) -39. **任务调度/自动化执行闭环** → **所有闭环**:触发自动执行任务(刊登、补货、调价、广告投放) -40. **外部数据** → **价格/汇率/成本基准闭环**:提供汇率、物流、平台费等数据 -41. **价格/汇率/成本基准闭环** → **定价与利润决策闭环**:提供成本基准数据 -42. **价格/汇率/成本基准闭环** → **广告计划与营销闭环**:提供成本基准数据 -43. **价格/汇率/成本基准闭环** → **报表与分析闭环**:提供成本基准数据 -44. **数据标准化/商品主数据闭环** → **所有业务闭环**:提供统一的商品主数据 -45. **所有操作** → **权限与审计闭环**:提供操作记录 -46. **权限与审计闭环** → **合规与风控闭环**:提供审计日志 -47. **所有闭环** → **异常检测与自愈闭环**:提供API调用状态、刊登状态、广告投放数据、ROI变化等数据 -48. **异常检测与自愈闭环** → **任务调度/自动化执行闭环**:触发自动修复任务 -49. **所有闭环** → **合规与风控闭环**:提供全流程数据用于风险监控 -50. **所有业务闭环** → **报表与分析闭环**:提供各闭环的输出数据用于报表生成和分析 -51. **报表与分析闭环** → **所有业务闭环**:反馈数据异常、业务波动、优化建议,指导各闭环的操作调整 +3. **数据采集与清洗闭环** → **定价与利润决策闭环**:提供成本和市场数据 +4. **商品主数据闭环** → **SKU变体与结构闭环**:提供商品基础信息 +5. **SKU变体与结构闭环** → **商品刊登闭环**:提供多SKU结构和平台映射 +6. **商品刊登闭环** → **素材管理闭环**:触发素材需求,生成商品主图和详情图 +7. **素材管理闭环** → **商品刊登闭环**:提供处理后的商品素材(图片、视频) +8. **素材管理闭环** → **广告计划与营销闭环**:提供广告投放所需的素材库 +9. **商品刊登闭环** → **广告计划与营销闭环**:提供已刊登商品列表 +10. **商品刊登闭环** → **订单履约闭环**:提供商品库存和状态信息 +11. **商品刊登闭环** → **定价与利润决策闭环**:提供商品成本信息 +12. **定价与利润决策闭环** → **商品刊登闭环**:提供建议售价和上架决策 +13. **定价与利润决策闭环** → **广告计划与营销闭环**:提供可投放 ROI 区间和最大可承受 CPA +14. **订单履约闭环** → **订单拆分与合并闭环**:提供订单数据用于拆分/合并 +15. **订单拆分与合并闭环** → **物流策略与渠道选择闭环**:提供拆分/合并后的订单数据 +16. **物流策略与渠道选择闭环** → **订单履约闭环**:提供物流方案 +17. **订单履约闭环** → **异常订单处理闭环**:提供异常订单数据 +18. **异常订单处理闭环** → **售后逆向闭环**:触发售后处理 +19. **异常订单处理闭环** → **合规与风控闭环**:提供风控预警 +20. **订单履约闭环** → **售后逆向闭环**:提供订单和物流信息 +21. **售后逆向闭环** → **资金对账闭环**:提供退款记录 +22. **订单履约闭环** → **资金对账闭环**:提供销售记录 +23. **广告计划与营销闭环** → **资金对账闭环**:提供广告费用记录 +24. **订单履约闭环** → **库存与仓储管理闭环**:触发库存扣减和物流操作 +25. **库存与仓储管理闭环** → **订单履约闭环**:提供库存状态和物流信息 +26. **库存与仓储管理闭环** → **供应链与供应商管理闭环**:触发补货需求 +27. **供应链与供应商管理闭环** → **库存与仓储管理闭环**:提供采购入库信息 +28. **供应链与供应商管理闭环** → **商品主数据闭环**:提供供应商商品数据 +29. **商品刊登闭环** → **B2B / TOB 贸易管理闭环**:提供商品信息用于报价 +30. **B2B / TOB 贸易管理闭环** → **订单履约闭环**:生成 B2B 订单 +31. **B2B / TOB 贸易管理闭环** → **资金对账闭环**:提供 B2B 交易记录 +32. **资金对账闭环** → **利润核算闭环**:提供收入和成本数据 +33. **利润核算闭环** → **报表与分析闭环**:提供利润数据 +34. **订单履约闭环** → **用户/客户资产闭环**:提供订单和用户行为数据 +35. **售后逆向闭环** → **用户/客户资产闭环**:提供售后记录 +36. **用户/客户资产闭环** → **广告计划与营销闭环**:提供用户画像和营销建议 +37. **用户/客户资产闭环** → **B2B / TOB 贸易管理闭环**:提供企业客户信息 +38. **广告计划与营销闭环** → **A/B测试与策略优化闭环**:提供广告策略数据 +39. **商品刊登闭环** → **A/B测试与策略优化闭环**:提供商品定价和展示数据 +40. **A/B测试与策略优化闭环** → **报表与分析闭环**:提供测试结果和优化建议 +41. **所有敏感操作** → **治理与审批中心闭环**:触发审批流程 +42. **治理与审批中心闭环** → **所有业务闭环**:提供审批结果 +43. **订单履约闭环** → **合规与证书管理闭环**:触发证书生成 +44. **合规与证书管理闭环** → **订单履约闭环**:提供合规证书 +45. **所有业务闭环** → **账号/店铺健康度闭环**:提供违规记录、发货延迟、差评率、退款率等数据 +46. **账号/店铺健康度闭环** → **广告计划与营销闭环**:提供是否暂停广告、降预算的决策 +47. **账号/店铺健康度闭环** → **商品刊登闭环**:提供是否限制上新、下架高风险商品的决策 +48. **所有店铺操作** → **店铺隔离与自动化闭环**:提供店铺操作数据 +49. **店铺隔离与自动化闭环** → **所有店铺相关行为**:提供隔离环境和自动化执行能力 +50. **所有闭环** → **合规与风控闭环**:提供全流程数据用于风险监控 +51. **所有业务闭环** → **报表与分析闭环**:提供各闭环的输出数据用于报表生成和分析 +52. **报表与分析闭环** → **所有业务闭环**:反馈数据异常、业务波动、优化建议,指导各闭环的操作调整 *** @@ -672,17 +827,23 @@ A/B测试 & 策略优化 | 违规率 | 违规事件发生频率 | 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 | +| 镜像可用性 | 镜像正常运行时间比例 | TOC + TOB | +| 云API调用成功率 | 云服务商API调用成功率 | TOC + TOB | +| 资源利用率 | 镜像资源使用效率 | TOC + TOB | +| 自动登录成功率 | 镜像自动登录成功率 | TOC + TOB | +| 多云切换成功率 | 云服务商切换成功率 | TOC + TOB | +| 成本优化率 | 多云部署带来的成本优化比例 | TOC + TOB | -#### 数据标准化/商品主数据闭环 +#### 商品主数据闭环 | KPI 指标 | 描述 | 适用业务类型 | | ------ | ------------ | --------- | @@ -692,15 +853,50 @@ A/B测试 & 策略优化 | 数据同步时效 | 数据从采集到同步的时间 | TOC + TOB | | 数据质量评分 | 商品数据质量综合评分 | TOC + TOB | -#### 价格/汇率/成本基准闭环 +#### SKU变体与结构闭环 -| KPI 指标 | 描述 | 适用业务类型 | -| --------- | ------------ | --------- | -| 基准数据更新及时率 | 基准数据按时更新的比例 | TOC + TOB | -| 成本计算准确率 | 成本计算的准确性 | TOC + TOB | -| 汇率风险控制效果 | 汇率波动对利润的影响程度 | TOC + TOB | -| 基准数据覆盖率 | 覆盖的成本类型比例 | TOC + TOB | -| 成本分摊准确性 | 成本分摊的准确性 | TOC + TOB | +| KPI 指标 | 描述 | 适用业务类型 | +| -------- | ------------ | --------- | +| SKU映射准确率 | 多平台SKU映射的准确性 | TOC + TOB | +| SKU生成时效 | SKU生成的平均时间 | TOC + TOB | +| 变体管理效率 | 变体属性管理的效率 | TOC + TOB | +| 库存同步准确率 | 多SKU库存同步的准确性 | TOC + TOB | + +#### 订单拆分与合并闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| -------- | -------------- | --------- | +| 拆分/合并准确率 | 订单拆分/合并的准确性 | TOC + TOB | +| 拆分/合并时效 | 订单拆分/合并的处理时间 | TOC + TOB | +| 物流成本优化率 | 拆分/合并带来的物流成本节约 | TOC + TOB | +| 客户满意度 | 拆分/合并订单的客户满意度 | TOC + TOB | + +#### 异常订单处理闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------ | ------------ | --------- | +| 异常处理率 | 成功处理的异常订单比例 | TOC + TOB | +| 异常处理时效 | 异常订单处理的平均时间 | TOC + TOB | +| 异常解决率 | 成功解决的异常订单比例 | TOC + TOB | +| 客户满意度 | 异常订单处理的客户满意度 | TOC + TOB | + +#### 物流策略与渠道选择闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ---------- | --------- | +| 物流成本节约率 | 物流成本节约的比例 | TOC + TOB | +| 物流时效达标率 | 按时送达的订单比例 | TOC + TOB | +| 渠道选择准确率 | 物流渠道选择的准确性 | TOC + TOB | +| 物流跟踪覆盖率 | 可跟踪的物流订单比例 | TOC + TOB | + +#### 利润核算闭环 + +| KPI 指标 | 描述 | 适用业务类型 | +| ------- | ------------ | --------- | +| 利润计算准确率 | 利润计算的准确性 | TOC + TOB | +| 利润核算时效 | 利润核算的平均时间 | TOC + TOB | +| 成本分摊准确性 | 成本分摊的准确性 | TOC + TOB | +| 利润率达标率 | 达到目标利润率的订单比例 | TOC + TOB | #### 用户/客户资产闭环 @@ -722,26 +918,6 @@ A/B测试 & 策略优化 | 测试覆盖率 | 覆盖的业务策略比例 | 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 | - *** ### 🔍 追踪与审计 diff --git a/docs11/临时修改建议.MD b/docs11/临时修改建议.MD deleted file mode 100644 index 042eb7c..0000000 --- a/docs11/临时修改建议.MD +++ /dev/null @@ -1,410 +0,0 @@ - -下面这些是**你现在没覆盖,但实际运营一定会补的模块**👇 - ---- - -# 🧱 一、商品侧:你缺“变体 / 多平台适配” - ---- - -## 1️⃣ SKU变体与映射(必须有,不然后面全炸) - -### ❗问题 - -你现在默认: - -> 一个商品 = 一个SKU - -现实是: - -* 颜色 / 尺码 / 套装 -* 不同平台 SKU规则不同 - ---- - -### ✅ 必补结构 - -**新增闭环:SKU映射与变体管理** - -补关系: - -**47️⃣ 商品主数据 → SKU变体闭环** -→ 生成: - -* SPU -* 多SKU(颜色/尺寸) - -**48️⃣ SKU变体闭环 → 商品刊登闭环** -→ 输出: - -* 各平台SKU结构(Shopee / TikTok / Lazada) - ---- - -### 💡 不做会怎样 - -* 无法同步库存 -* 无法统一订单 -* ROI全错 - ---- - -# 📦 二、订单侧:你缺“拆单 / 合单 / 异常单处理” - ---- - -## 2️⃣ 订单拆分与合并(跨境必炸点) - ---- - -### ❗现实情况 - -一个订单可能: - -* 多仓发货(拆单) -* 多订单合并发(省运费) -* 部分缺货(部分发) - ---- - -### ✅ 必补 - -**49️⃣ 订单履约 → 订单拆分闭环** - -**50️⃣ 订单拆分闭环 → 仓储 / 履约** - ---- - -### 💡 数据层必须有字段 - -```text -parent_order_id -sub_order_id -split_type (仓/SKU/库存) -``` - ---- - -## 3️⃣ 异常订单处理(不是售后,是履约异常) - ---- - -### ❗区别 - -不是退款那种售后,而是: - -* 地址错误 -* 海关卡单 -* 物流丢件 -* 无法发货 - ---- - -### ✅ 必补 - -**51️⃣ 订单履约 → 异常订单闭环** - -**52️⃣ 异常订单闭环 →** - -* 售后 -* 风控 -* 客服 - ---- - ---- - -# 🚚 三、物流侧:你缺“物流策略与渠道选择” - ---- - -## 4️⃣ 物流路由决策(非常关键) - ---- - -### ❗问题 - -现在你是: - -> 有订单 → 发货 - -但现实要做: - -* 哪个仓发? -* 用什么物流? -* 走空运/海运? -* 是否海外仓? - ---- - -### ✅ 必补 - -**53️⃣ 订单履约 → 物流策略闭环** - -**54️⃣ 物流策略闭环 → 仓储 / 履约** - -输出: - -* 物流渠道(4PX / YunExpress 等) -* 时效 -* 成本 - ---- - -### 💡 不做会怎样 - -* 运费爆炸 -* 时效不可控 -* ROI直接崩 - ---- - -# 💰 四、资金侧:你缺“利润真实核算(不是流水)” - ---- - -## 5️⃣ 利润核算闭环(你现在只有对账) - ---- - -### ❗问题 - -你现在是: - -* 收入 ✔ -* 广告 ✔ -* 退款 ✔ - -但缺: - -👉 **真实利润** - ---- - -### ✅ 必补 - -**55️⃣ 所有成本来源 → 利润核算闭环** - -包括: - -* 商品成本 -* 运费 -* 广告费 -* 平台佣金 -* 汇率损耗 - ---- - -**56️⃣ 利润核算 → 报表 / 定价系统** - ---- - -### 💡 必须细到: - -```text -profit = revenue - product_cost - shipping - ads - platform_fee - tax -``` - ---- - -# 🧾 五、平台侧:你缺“多平台适配层(很关键)” - ---- - -## 6️⃣ 平台适配闭环(API差异统一) - ---- - -### ❗问题 - -不同平台: - -* 字段不同 -* 类目不同 -* API不同 - ---- - -### ✅ 必补 - -**57️⃣ 所有业务 → 平台适配层** - -**58️⃣ 平台适配层 → 外部平台** - ---- - -### 💡 本质 - -你需要一个: - -> **Platform Adapter Layer(适配器层)** - -否则: - -* 每接一个平台重写一套系统 - ---- - -# 🤖 六、AI侧:你缺“AI结果校验机制” - ---- - -## 7️⃣ AI结果校验闭环(非常关键) - ---- - -### ❗问题 - -你现在: - -* AI写标题 -* AI做图 -* AI定价 - -但没有: - -👉 **校验** - ---- - -### ✅ 必补 - -**59️⃣ AI输出 → AI校验闭环** - -校验: - -* 标题是否违规 -* 图片是否侵权 -* 定价是否异常 - ---- - -**60️⃣ 校验闭环 → 审批 / 风控** - ---- - -### 💡 不做后果 - -👉 AI会稳定帮你“批量犯错” - ---- - -# 🧑‍💻 七、人工介入点(必须设计,不然AI死循环) - ---- - -## 8️⃣ 人工兜底闭环 - ---- - -### ❗问题 - -你现在是全自动思路,但现实: - -* 一定会卡住 -* 一定需要人 - ---- - -### ✅ 必补 - -**61️⃣ 所有异常 → 人工处理闭环** - -提供: - -* 待处理任务池 -* 操作界面 -* 一键修复 - ---- - ---- - -# 🔄 八、缓存与队列(技术层,但必须业务化) - ---- - -## 9️⃣ 消息队列闭环(事件驱动核心) - ---- - -### ❗问题 - -你现在是“流程驱动”,但应该是: - -👉 **事件驱动** - ---- - -### ✅ 必补 - -**62️⃣ 所有闭环 → 消息队列** - -事件例子: - -* 商品创建 -* 订单生成 -* ROI变化 - ---- - -**63️⃣ 消息队列 → 各闭环订阅执行** - ---- - ---- - -# 🧨 九、你最容易忽略但最致命的点 - -我直接给你结论级: - ---- - -## ❗TOP 5 必补(优先级最高) - -1. **SKU变体系统(不做=后面全部推翻)** -2. **利润核算(不做=你不知道赚没赚钱)** -3. **物流策略(不做=必亏)** -4. **任务调度(不做=无法自动化)** -5. **平台适配层(不做=无法扩平台)** - ---- - -# 🧠 最后给你一个架构级判断 - -你现在的问题不是“少功能”,而是: - -👉 **缺几个“控制中枢”** - ---- - -## ✔ 真正应该收敛成 6个核心中心: - -1. 商品中心(含SKU) -2. 订单中心(含拆单) -3. 库存与供应链中心 -4. 资金与利润中心 -5. 调度与自动化中心 -6. 风控与健康中心 - ---- - -其他全部: - -👉 都应该挂在这6个下面 - ---- - -# 🚀 一句话结论 - -你现在已经不是“缺功能”,而是: - -> ❗**缺“可扩展架构骨架”** - ---- - -如果你下一步继续做,我建议你做这个(非常关键): - -👉 我可以帮你把这 **63条关系压缩成数据库表结构 + 事件流图(可直接开发)** - -这个阶段再乱加功能,就会开始失控了。