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

57 KiB
Raw Blame History

📌 Crawlful Hub 业务闭环（TOC + TOB Unified Business Loops）

说明：本闭环文档是战略层业务流程，关注"做什么、为什么做、顺序和决策点"，为下层模块功能和系统实现提供指引。TOC（零售/前端）和 TOB（B2B贸易）共享通用模块，特有流程用 businessType 标记。共 35个业务闭环。

📑 目录

  1. 数据采集与清洗闭环
  2. 商品刊登闭环
  3. 素材管理闭环
  4. 广告计划与营销闭环
  5. 订单履约闭环
  6. 售后逆向闭环
  7. 资金对账闭环
  8. 库存与仓储管理闭环
  9. 供应链与供应商管理闭环
  10. B2B / TOB 贸易管理闭环
  11. 治理与审批中心闭环
  12. 合规与证书管理闭环
  13. 合规与风控闭环
  14. 报表与分析闭环
  15. 定价与利润决策闭环
  16. 账号/店铺健康度闭环
  17. 店铺隔离与自动化闭环
  18. 订单集中管理闭环
  19. 客户/商家押金与账户管理闭环
  20. 商家选择发货闭环
  21. 回款与财务闭环
  22. 海外仓/本土仓 & 多品类支持闭环
  23. 商品主数据闭环
  24. SKU变体与结构闭环
  25. 订单拆分与合并闭环
  26. 异常订单处理闭环
  27. 物流策略与渠道选择闭环
  28. 利润核算闭环
  29. 用户/客户资产闭环
  30. A/B测试与策略优化闭环
  31. 多商户入驻与认证闭环
  32. 功能模块化与权限控制闭环
  33. 功能开通与支付闭环
  34. 多商户结算与财务闭环
  35. 多商户商品与订单管理闭环
  36. 统一闭环依赖
  37. 闭环依赖关系
  38. 关键绩效指标
  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）

[数据采集]   ↓[数据清洗]   ↓[套利/利润评估]   ↓[商品主数据]   ↓[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 必填 -

追踪五元组字段（所有业务表必须）

{
  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