wurenzhi/makemd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
795b03b728754df9a00a47329dfd3e52db69be8e
makemd/docs/00_Business/Business_ClosedLoops.md
wurenzhi 037e412aad feat: 新增多模块功能与服务实现 
新增广告计划、用户资产、B2B交易、合规规则等核心模型
实现爬虫工作器、贸易服务、现金流预测等业务服务
添加RBAC权限测试、压力测试等测试用例
完善扩展程序的消息处理与内容脚本功能
重构应用入口与文档生成器
更新项目规则与业务闭环分析文档
2026-03-18 09:38:09 +08:00

1279 lines
57 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 📌 Crawlful Hub 业务闭环（TOC + TOB Unified Business Loops）
> **说明**：本闭环文档是战略层业务流程，关注"做什么、为什么做、顺序和决策点"，为下层模块功能和系统实现提供指引。TOC（零售/前端）和 TOB（B2B贸易）共享通用模块，特有流程用 `businessType` 标记。共 **35个业务闭环**。
## 📑 目录
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. [多商户入驻与认证闭环](#3️⃣1️⃣-多商户入驻与认证闭环merchant-registration--authentication-loop)
32. [功能模块化与权限控制闭环](#3️⃣2️⃣-功能模块化与权限控制闭环feature-modularization--permission-control-loop)
33. [功能开通与支付闭环](#3️⃣3️⃣-功能开通与支付闭环feature-activation--payment-loop)
34. [多商户结算与财务闭环](#3️⃣4️⃣-多商户结算与财务闭环multi-merchant-settlement--finance-loop)
35. [多商户商品与订单管理闭环](#3️⃣5️⃣-多商户商品与订单管理闭环multi-merchant-product--order-management-loop)
36. [统一闭环依赖](#🔹-统一闭环依赖toc--tob)
37. [闭环依赖关系](#🔗-闭环依赖关系toc--tob)
38. [关键绩效指标](#📊-关键绩效指标kpi)
39. [追踪与审计](#🔍-追踪与审计)
40. [业务审核状态机](#📋-业务审核状态机)
41. [说明](#💡-说明)
***
## 1️⃣ 数据采集与清洗闭环（Product Data Collection & Cleansing）
- **目标**：收集多平台商品信息，确保数据完整、有效、可用于盈利分析（TOC）或报价计算（TOB）。
- **采集策略矩阵**：
| 平台类型 | 采集方式 | 执行位置 | 登录要求 | 反爬策略 |
| --------------------------------- | ----- | ---- | -------- | --------- |
| **有API平台** (Amazon MWS, eBay API) | 官方API | 后端 | OAuth/密钥 | 频率限制 |
| **无API平台** (TikTok Shop, Temu) | 浏览器插件 | 插件 | 需登录 | 指纹隔离+IP代理 |
| **公开数据** (1688公开页) | 浏览器插件 | 插件 | 无需登录 | 频率控制 |
| **需登录数据** (供应商后台) | 浏览器插件 | 插件 | 需登录 | 店铺隔离 |
- **流程**：
1. **多平台采集**：
- **有API平台**（Amazon MWS、eBay API、Shopee Open API）：
- 后端通过官方API获取数据
- 使用 `PlatformApiService` 统一对接
- 支持 OAuth 认证和密钥管理
- **无API平台**（TikTok Shop、Temu、部分1688页面）：
- **严禁后端直接爬取**（IP封禁风险、法律合规）
- 通过浏览器插件在用户端采集
- 插件使用店铺隔离环境（独立指纹+代理IP）
- **采集字段**：标题、价格、库存、SKU、图片、描述、评价、供应商信息（TOB）
2. **数据清洗**：
- 去重：平台+productId 唯一约束
- 格式化：统一字段格式和单位
- 字段标准化：规范属性名和值
- 剔除无效商品：库存异常、价格异常、描述缺失
3. **前置套利 / 利润评估**：
- TOC：评估单件盈利、ROI、定价区间
- TOB：评估阶梯价利润、批量折扣、信用额度风险
- 考虑平台费、物流费、税费、汇率、售后成本、广告摊销
- **决策点**：
- TOC：B2C 利润率 < 20% 触发风控
- TOB：B2B 利润率 < 15% 禁止报价
- **输入**：平台商品原始数据
- **输出**：清洗后的可售商品/报价数据，包含完整套利/利润分析
- **⚠️ 重要约束**：
- **后端严禁直接爬取电商平台页面**（IP封禁、法律风险）
- 所有网页级采集必须通过浏览器插件在用户端执行
- 插件必须实现店铺隔离（一店一IP一指纹）
- **📋 技术实现指引**：
| 层级 | 实现模块 | 关键文件 | 任务ID |
| -- | ------- | -------------------------------------- | ------------------------- |
| 后端 | 平台API对接 | `PlatformApiService.ts` | BE-P005, BE-P006, BE-P007 |
| 后端 | 数据清洗引擎 | `DataPipelineService.ts` | DT-P001, DT-P002 |
| 插件 | 网页采集器 | `crawlerService.ts` | PL-C001, PL-C002 |
| 插件 | DOM解析 | `amazonCrawler.ts`, `tiktokCrawler.ts` | PL-C002 |
| AI | 套利分析 | `ArbitrageService.ts` | AI-A001 |
***
## 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. 支持多云部署，增强业务弹性和成本优化能力
- **📋 技术实现指引**：
| 层级 | 实现模块 | 关键文件 | 任务ID |
| -- | ------- | ------------------------- | ---------------- |
| 后端 | 店铺隔离管理 | `ShopIsolationService.ts` | BE-G003 |
| 后端 | 云镜像管理 | `CloudInstanceService.ts` | BE-G003 |
| 后端 | 任务调度器 | `TaskScheduler.ts` | BE-G003 |
| 插件 | 浏览器指纹管理 | `fingerprintService.ts` | PL-A001 |
| 插件 | 代理IP管理 | `proxyService.ts` | PL-A001 |
| 插件 | 自动化执行器 | `automationService.ts` | PL-A001, PL-A002 |
| 运维 | 健康监控 | `HealthMonitor.ts` | OP-M001 |
- **🔗 插件管理架构**：
```
┌─────────────────────────────────────────────────────────────┐
│ 插件生命周期管理 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ 安装/更新 │───►│ 配置初始化 │───►│ 店铺绑定 │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ 任务接收 │◄──►│ 任务执行 │◄──►│ 结果上报 │ │
│ │ (Backend) │ │ (Extension) │ │ (Backend) │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ 状态同步 │◄──►│ 异常处理 │◄──►│ 日志归档 │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
```
- **📡 插件通讯协议**：
| 通讯方向 | 协议 | 用途 | 消息类型 |
| ------- | -------------- | ------- | ------------------------------ |
| 后端 → 插件 | WebSocket | 实时任务下发 | `TASK_ASSIGN`, `CONFIG_UPDATE` |
| 插件 → 后端 | HTTP POST | 执行结果上报 | `TASK_COMPLETE`, `TASK_FAILED` |
| 插件 ↔ 后端 | HTTP GET | 状态查询/心跳 | `HEARTBEAT`, `STATUS_QUERY` |
| 插件内部 | Chrome Message | 组件间通讯 | `CRAWL_DATA`, `AUTO_ACTION` |
***
## 1️⃣8️⃣ 订单集中管理闭环（Order Centralized Management Loop）
- **目标**：跨平台订单统一抓取、集中展示和管理，支持 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 |
#### 多商户入驻与认证闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ----------- | --------- |
| 入驻转化率 | 注册到入驻成功的比例 | TOC + TOB |
| 资质审核时效 | 资质审核的平均时间 | TOC + TOB |
| 认证通过率 | 通过认证的商户比例 | TOC + TOB |
| 店铺绑定成功率 | 成功绑定平台店铺的比例 | TOC + TOB |
| 商户活跃度 | 商户月活跃比例 | TOC + TOB |
#### 功能模块化与权限控制闭环
| KPI 指标 | 描述 | 适用业务类型 |
| -------- | ---------- | --------- |
| 模块使用率 | 各功能模块的使用比例 | TOC + TOB |
| 权限配置准确率 | 权限配置的准确性 | TOC + TOB |
| 数据隔离有效性 | 数据隔离的成功率 | TOC + TOB |
| 功能开关响应时效 | 功能开关生效的时间 | TOC + TOB |
| 配额利用率 | 商户使用配额的比例 | TOC + TOB |
#### 功能开通与支付闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ---------- | --------- |
| 支付成功率 | 支付成功的比例 | TOC + TOB |
| 开通时效 | 从支付到开通的时间 | TOC + TOB |
| 续费率 | 功能到期后续费的比例 | TOC + TOB |
| 退款率 | 申请退款的比例 | TOC + TOB |
| 发票开具及时率 | 发票按时开具的比例 | TOC + TOB |
#### 多商户结算与财务闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | --------- | --------- |
| 结算准确率 | 结算金额的准确性 | TOC + TOB |
| 结算时效 | 从交易到结算的时间 | TOC + TOB |
| 分润准确率 | 分润计算的准确性 | TOC + TOB |
| 提现成功率 | 提现申请成功的比例 | TOC + TOB |
| 对账差异率 | 财务对账的差异比例 | TOC + TOB |
#### 多商户商品与订单管理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ----------- | --------- |
| 商品审核通过率 | 通过审核的商品比例 | TOC + TOB |
| 订单分配准确率 | 订单分配的准确性 | TOC + TOB |
| 库存同步准确率 | 多商户库存同步的准确性 | TOC + TOB |
| 超卖率 | 库存超卖的比例 | TOC + TOB |
| 物流轨迹覆盖率 | 可追踪物流的订单比例 | TOC + TOB |
***
## 3️⃣1️⃣ 多商户入驻与认证闭环（Merchant Registration & Authentication Loop）
- **目标**：支持多商户入驻、资质认证、店铺创建，实现平台化运营。
- **流程**：
1. **商户注册**：
- 商户自助注册（邮箱/手机/企业信息）
- 资质文件上传（营业执照、法人身份证等）
- 账户类型选择（企业/个人）
2. **资质认证**：
- 自动审核 + 人工复核
- 企业信息验证、信用检查
- 行业资质合规检查
3. **店铺创建**：
- 店铺基础信息配置
- 绑定平台店铺（Amazon、Shopee等）
- 支付账户配置
- **决策点**：
- 资质审核标准（行业合规、信用评级）
- 商户等级划分（普通/优质/战略）
- 入驻门槛设置
- **输入**：商户注册信息、资质文件、企业证明
- **输出**：商户ID、认证状态、店铺ID
***
## 3️⃣2️⃣ 功能模块化与权限控制闭环（Feature Modularization & Permission Control Loop）
- **目标**：将系统功能模块化，支持按商户收费，精细化权限控制。
- **流程**：
1. **功能模块定义**：
- 基础功能（商品管理、订单管理）
- 增值功能（广告投放、数据分析）
- 高级功能（API对接、定制化开发）
2. **模块配置**：
- 功能开关控制
- 使用配额限制
- 计费规则配置
3. **权限体系**：
- 角色定义（管理员、运营、财务等）
- 细粒度权限分配
- 数据隔离（租户/商户/店铺）
- **决策点**：
- 模块定价策略
- 权限继承规则
- 数据隔离级别
- **输入**：商户ID、功能需求、角色配置
- **输出**：功能模块列表、权限配置、数据隔离规则
***
## 3️⃣3️⃣ 功能开通与支付闭环（Feature Activation & Payment Loop）
- **目标**：商户选购功能模块、支付费用、开通服务。
- **流程**：
1. **功能选购**：
- 展示功能模块和价格
- 选择订阅周期（月/季/年）
- 选择配套服务（培训、技术支持）
2. **费用计算**：
- 基础费用 + 增值服务费用
- 使用量计费（订单数、商品数等）
- 优惠活动计算
3. **支付流程**：
- 在线支付（支付宝、微信、银行卡）
- 账户余额扣款
- 发票开具
4. **服务开通**：
- 支付成功后自动开通
- 配置生效通知
- 服务期开始计时
- **决策点**：
- 支付方式选择
- 发票类型（普通/增值税）
- 续费提醒策略
- **输入**：商户ID、选购功能、支付方式
- **输出**：开通记录、支付凭证、服务状态
***
## 3️⃣4️⃣ 多商户结算与财务闭环（Multi-Merchant Settlement & Finance Loop）
- **目标**：多商户资金结算、收益分润、账务核对。
- **流程**：
1. **交易清算**：
- 订单收入汇总
- 平台服务费扣除
- 商户应得收益计算
2. **结算周期**：
- 按日/周/月结算
- 自动打款或申请提现
- 结算单生成
3. **分润管理**：
- 分润规则配置
- 多级分销/代理分润
- 分润计算与发放
4. **财务对账**：
- 商户账户流水核对
- 异常交易处理
- 财务报表生成
- **决策点**：
- 结算门槛（最低提现金额）
- 手续费规则
- 账期调整
- **输入**：交易数据、商户结算规则、分润配置
- **输出**：结算单、账户余额、财务报表
***
## 3️⃣5️⃣ 多商户商品与订单管理闭环（Multi-Merchant Product & Order Management Loop）
- **目标**：多商户商品上架、订单分配、库存同步管理。
- **流程**：
1. **商品管理**：
- 商户自有商品上传
- 平台商品池共享
- 商品审核（合规、质量）
2. **订单分配**：
- 订单智能分配（有库存优先/距离优先/评分优先）
- 商户抢单模式
- 异常订单人工处理
3. **库存同步**：
- 多商户库存汇总
- 实时库存同步
- 预占/扣减机制
4. **多商户物流**：
- 商户自有物流或平台物流
- 物流轨迹共享
- 签收确认
- **决策点**：
- 商品上架审核标准
- 订单分配策略
- 库存超卖防护
- **输入**：商品数据、订单数据、库存数据
- **输出**：商品状态、订单分配结果、物流信息
***
### 🔍 追踪与审计
- **追踪五元组**：
- `tenantId`：租户 ID（业务隔离）
- `shopId`：店铺 ID（平台/店铺隔离）
- `taskId`：任务 ID（任务/规则触发归档）
- `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. **横切能力**：账号健康度、任务调度、权限审计等能力贯穿所有业务闭环，确保系统稳定性和安全性。
***
### 🗄️ 数据库规范与约束
#### 表命名规范
| 规则 | 要求 | 示例 |
| -------- | --------------- | --------------------------------------- |
| **表前缀** | 所有表必须以 `cf_` 开头 | `cf_product`, `cf_order`, `cf_shop` |
| **模块标识** | 按模块添加子前缀 | `cf_ai_` (AI模块), `cf_logistics_` (物流) |
| **命名风格** | 小写 + 下划线分隔 | `cf_consumer_orders`, `cf_ad_campaigns` |
#### 核心表清单
| 表名 | 模块 | 说明 | 五元组追踪 |
| -------------------- | --- | ----- | --------------------------- |
| `cf_tenant` | 租户 | 租户信息 | ✅ tenantId |
| `cf_shop` | 店铺 | 店铺信息 | ✅ tenantId, shopId |
| `cf_product` | 商品 | 商品主数据 | ✅ tenantId, shopId, traceId |
| `cf_product_sku` | 商品 | SKU变体 | ✅ tenantId, shopId, traceId |
| `cf_consumer_orders` | 订单 | C端订单 | ✅ tenantId, shopId, traceId |
| `cf_supplier` | 供应链 | 供应商信息 | ✅ tenantId, traceId |
| `cf_inventory` | 库存 | 库存记录 | ✅ tenantId, shopId, traceId |
| `cf_user` | 用户 | 系统用户 | ✅ tenantId |
| `cf_audit_log` | 审计 | 操作日志 | ✅ 五元组完整 |
#### 字段规范
| 字段类型 | 规范 | 禁止 |
| ---------- | ----------------------------- | -------------- |
| **金额** | `decimal(10,2)` | ❌ float/double |
| **物理属性** | 长度(cm), 重量(kg), 体积(m³) | - |
| **JSON数据** | 序列化存储，解析后使用 | - |
| **时间戳** | `created_at`, `updated_at` 必填 | - |
#### 追踪五元组字段（所有业务表必须）
```typescript
{
tenantId: string; // 租户ID - 业务隔离
shopId: string; // 店铺ID - 平台/店铺隔离
taskId: string; // 任务ID - 任务追踪
traceId: string; // 链路追踪ID - 全链路唯一
businessType: 'TOC' | 'TOB'; // 业务类型
}
```
#### 数据完整性约束
| 约束 | 要求 |
| -------- | ------------------------------------------- |
| **唯一约束** | `cf_product` 表必须保证 (platform, productId) 唯一 |
| **外键约束** | 关键关联必须建立外键 |
| **幂等性** | 所有建表语句必须使用 `db.schema.hasTable` 前置校验 |
| **安全约束** | **⚠️ 严禁** 执行 `DROP`, `TRUNCATE` 等破坏性操作 |
***
Reference in New Issue View Git Blame Copy Permalink