Files

wurenzhi 0dac26d781 feat: 添加MSW模拟服务和数据源集成

refactor: 重构页面组件移除冗余Layout组件

feat: 实现WebSocket和事件总线系统

feat: 添加队列和调度系统

docs: 更新架构文档和服务映射

style: 清理重复接口定义使用数据源

chore: 更新依赖项配置

feat: 添加运行时系统和领域引导

ci: 配置ESLint边界检查规则

build: 添加Redis和WebSocket依赖

test: 添加MSW浏览器环境入口

perf: 优化数据获取逻辑使用统一数据源

fix: 修复类型定义和状态管理问题

2026-03-19 01:39:34 +08:00

125 KiB

Raw Blame History

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

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

📑 目录

数据采集与清洗闭环
商品刊登闭环
素材管理闭环
广告计划与营销闭环
订单履约闭环
售后逆向闭环
资金对账闭环
库存与仓储管理闭环
供应链与供应商管理闭环
B2B / TOB 贸易管理闭环
治理与审批中心闭环
合规与证书管理闭环
合规与风控闭环
报表与分析闭环
定价与利润决策闭环
账号/店铺健康度闭环
店铺隔离与自动化闭环
订单集中管理闭环
客户/商家押金与账户管理闭环
商家选择发货闭环
回款与财务闭环
海外仓/本土仓 & 多品类支持闭环
商品主数据闭环
SKU变体与结构闭环
订单拆分与合并闭环
异常订单处理闭环
物流策略与渠道选择闭环
利润核算闭环
用户/客户资产闭环
A/B测试与策略优化闭环
多商户入驻与认证闭环
商户店铺管理闭环
多商户订单闭环
多商户库存同步闭环
多商户结算与财务闭环
商户权限与角色闭环
商户数据与分析闭环
异常处理闭环
功能模块化与权限控制闭环
功能开通与支付闭环
恶意买家黑名单闭环
高退货率SKU自动下架/改进建议闭环
商业化与增长闭环
服务编排与执行闭环
增长飞轮闭环
技术基础设施闭环
客户服务闭环
跨境电商闭环
AI驱动智能决策闭环
核心服务优先级闭环
多商户收益排行榜系统（信任引擎） 🆕
策略市场（Strategy Marketplace） 🆕
自动选品+自动上架系统（增长引擎） 🆕
AI店铺托管（AutoPilot） 🆕
跨平台套利系统 🆕
AI动态定价系统 🆕
多店铺管理闭环 🆕
多租户层级管理闭环 🆕
统一闭环依赖
闭环依赖关系
关键绩效指标
追踪与审计
业务审核状态机
说明

附录A：前端交互设计规范

说明：本附录补充前端交互设计规范，定义全局状态机、页面路由、按钮操作等交互标准，确保前端实现与业务闭环一致。

A.1 全局状态机定义

商品状态机（Product State Machine）

状态	含义	可操作按钮	状态颜色
DRAFT	草稿	编辑、定价、删除	灰色
PRICED	已定价	查看、定价、上架	蓝色
LISTED	已上架	查看、下架、同步	绿色
SYNCING	同步中	查看（其他禁用）	黄色
LIVE	已在线	查看、下架、同步	绿色
SYNC_FAILED	同步失败	查看、重试同步	红色
OFFLINE	已下架	查看、重新上架	灰色

状态流转图：

DRAFT → PRICED → LISTED → SYNCING → LIVE → OFFLINE
  ↓       ↓        ↓          ↑
删除    定价     上架      重试同步
              ↓ SYNC_FAILED ↑

状态流转规则：

DRAFT → PRICED：完成定价后自动转换
PRICED → LISTED：点击上架按钮后转换
LISTED → SYNCING：点击同步按钮后转换
SYNCING → LIVE：同步成功后自动转换
SYNCING → SYNC_FAILED：同步失败后转换
LISTED/LIVE → OFFLINE：点击下架按钮后转换
OFFLINE → LISTED：点击重新上架后转换

任务状态机（Task State Machine）

状态	含义	可操作按钮	状态颜色
PENDING	待执行	取消	灰色
RUNNING	执行中	查看日志	蓝色
SUCCESS	执行成功	查看结果	绿色
FAILED	执行失败	重试、查看日志	红色

状态流转图：

PENDING → RUNNING → SUCCESS
    ↓         ↓
  取消      FAILED → 重试 → RUNNING

订单状态机（Order State Machine）

状态	含义	可操作按钮	适用场景
PENDING	待处理	确认、取消	新订单
CONFIRMED	已确认	发货、取消	确认后
SHIPPED	已发货	查看物流	发货后
DELIVERED	已送达	完成、售后	送达后
COMPLETED	已完成	查看详情	完成后
CANCELLED	已取消	查看详情	取消后
REFUNDING	退款中	查看进度	售后中
REFUNDED	已退款	查看详情	退款完成

A.2 页面路由结构

全局路由定义

// 路由配置
const routes = [
  // 工作台
  { path: '/dashboard', component: 'Dashboard' },
  
  // 商品中心
  { path: '/products', component: 'ProductLayout', routes: [
    { path: '/products/list', component: 'ProductList' },
    { path: '/products/detail/:id', component: 'ProductDetail' },
    { path: '/products/create', component: 'ProductCreate' },
    { path: '/products/edit/:id', component: 'ProductEdit' },
  ]},
  
  // 订单中心
  { path: '/orders', component: 'OrderLayout', routes: [
    { path: '/orders/list', component: 'OrderList' },
    { path: '/orders/detail/:id', component: 'OrderDetail' },
    { path: '/orders/exception', component: 'ExceptionOrder' },
  ]},
  
  // 执行中心
  { path: '/tasks', component: 'TaskLayout', routes: [
    { path: '/tasks/list', component: 'TaskList' },
    { path: '/tasks/detail/:id', component: 'TaskDetail' },
    { path: '/tasks/logs', component: 'TaskLogs' },
  ]},
  
  // 数据中心
  { path: '/analytics', component: 'AnalyticsLayout', routes: [
    { path: '/analytics/overview', component: 'AnalyticsOverview' },
    { path: '/analytics/products', component: 'ProductAnalytics' },
    { path: '/analytics/orders', component: 'OrderAnalytics' },
    { path: '/analytics/profit', component: 'ProfitAnalytics' },
  ]},
  
  // 合规中心
  { path: '/compliance', component: 'ComplianceLayout', routes: [
    { path: '/compliance/certificates', component: 'CertificateManage' },
    { path: '/compliance/check', component: 'ComplianceCheck' },
    { path: '/compliance/risk', component: 'RiskMonitor' },
  ]},
  
  // 系统设置
  { path: '/settings', component: 'SettingsLayout', routes: [
    { path: '/settings/platform', component: 'PlatformSettings' },
    { path: '/settings/currency', component: 'CurrencySettings' },
    { path: '/settings/cost-template', component: 'CostTemplateSettings' },
    { path: '/settings/win-node', component: 'WinNodeSettings' },
  ]},
];

路由权限控制

路由	所需权限	角色
/products/*	product:read	ADMIN, MANAGER, OPERATOR
/products/create	product:create	ADMIN, MANAGER
/products/edit/*	product:update	ADMIN, MANAGER
/orders/*	order:read	ADMIN, MANAGER, OPERATOR
/orders/exception	order:exception	ADMIN, MANAGER
/tasks/*	task:read	ADMIN, MANAGER, OPERATOR
/analytics/*	analytics:read	ADMIN, MANAGER, ANALYST
/compliance/*	compliance:read	ADMIN, MANAGER
/settings/*	settings:read	ADMIN

A.3 按钮操作规范

商品列表页操作按钮

按钮	显示条件	点击行为	状态变更	权限要求
新增商品	始终显示	打开创建弹窗	创建新商品(DRAFT)	product:create
编辑	状态=DRAFT	打开编辑弹窗	更新商品信息	product:update
定价	状态=DRAFT/PRICED	打开定价抽屉	状态→PRICED	product:update
上架	状态=PRICED	确认弹窗→上架	状态→LISTED	product:update
同步	状态=LISTED/LIVE	触发同步任务	状态→SYNCING	product:sync
下架	状态=LISTED/LIVE	确认弹窗→下架	状态→OFFLINE	product:update
重试同步	状态=SYNC_FAILED	重新触发同步	状态→SYNCING	product:sync
重新上架	状态=OFFLINE	确认弹窗→上架	状态→LISTED	product:update
删除	状态=DRAFT	确认弹窗→删除	删除商品	product:delete

订单列表页操作按钮

按钮	显示条件	点击行为	状态变更	权限要求
确认订单	状态=PENDING	确认弹窗→确认	状态→CONFIRMED	order:confirm
发货	状态=CONFIRMED	打开发货弹窗	状态→SHIPPED	order:ship
查看物流	状态=SHIPPED	打开物流追踪	-	order:read
完成订单	状态=DELIVERED	确认弹窗→完成	状态→COMPLETED	order:complete
取消订单	状态=PENDING/CONFIRMED	确认弹窗→取消	状态→CANCELLED	order:cancel
售后处理	状态=COMPLETED/DELIVERED	打开售后弹窗	状态→REFUNDING	order:refund

任务列表页操作按钮

按钮	显示条件	点击行为	状态变更	权限要求
重试	状态=FAILED	重新执行任务	状态→PENDING	task:retry
取消	状态=PENDING	取消任务	任务取消	task:cancel
查看日志	始终显示	打开日志详情	-	task:read
查看结果	状态=SUCCESS	打开结果详情	-	task:read

A.4 用户操作流程

商品上架完整流程

Step 1: 进入商品列表页
  → 查看现有商品列表
  → 使用筛选条件查找商品

Step 2: 新增/编辑商品
  → 点击【新增商品】或【编辑】
  → 填写商品基础信息（标题、SKU、图片等）
  → 填写供应信息（供应商、成本等）
  → 保存后状态=DRAFT

Step 3: 商品定价
  → 点击【定价】按钮
  → 输入成本信息（进货价、运费、汇率）
  → 系统自动计算建议售价、利润、ROI
  → 确认后状态=PRICED

Step 4: 商品上架
  → 点击【上架】按钮
  → 确认上架信息
  → 状态变为LISTED

Step 5: 同步到平台
  → 点击【同步】按钮
  → 创建同步任务
  → 状态变为SYNCING
  → 同步成功后状态=LIVE

Step 6: 监控与调整
  → 查看同步记录
  → 如需调整，点击【定价】或【下架】

订单处理完整流程

Step 1: 订单获取
  → 系统自动从平台拉取订单
  → 订单状态=PENDING

Step 2: 订单确认
  → 查看订单详情
  → 检查库存和地址
  → 点击【确认订单】
  → 状态=CONFIRMED

Step 3: 订单发货
  → 点击【发货】按钮
  → 选择物流方式
  → 填写物流单号
  → 状态=SHIPPED

Step 4: 物流追踪
  → 点击【查看物流】
  → 实时追踪物流状态

Step 5: 订单完成
  → 客户签收后
  → 状态=DELIVERED
  → 点击【完成订单】
  → 状态=COMPLETED

售后处理完整流程

Step 1: 接收售后申请
  → 客户提交退货/退款申请
  → 创建售后工单

Step 2: 审核售后申请
  → 查看订单信息和售后原因
  → 判断是否同意售后

Step 3: 处理退货
  → 客户寄回商品
  → 确认收货并检查商品

Step 4: 处理退款
  → 确认退款金额
  → 执行退款操作
  → 状态=REFUNDED

Step 5: 库存调整
  → 退货商品重新入库
  → 更新库存数量

附录B：前端页面映射

说明：本附录定义各业务闭环对应的前端页面结构，为前端开发提供明确的页面组织指导。

B.1 商品中心页面映射

对应闭环：数据采集与清洗闭环、商品刊登闭环、定价与利润决策闭环

商品列表页 (/products/list)

页面目标：商品管理的核心入口，支持商品的增删改查和批量操作

页面结构：

ProductListPage
├─ PageHeader (页面标题)
│   └─ 标题：商品管理
│   └─ 副标题：管理您的所有商品
├─ FilterBar (筛选区)
│   ├─ 关键词搜索 (输入框)
│   ├─ 状态筛选 (下拉选择：全部/草稿/已定价/已上架/已在线/已下架)
│   ├─ 平台筛选 (下拉选择：Amazon/eBay/Shopee/TikTok/全部)
│   ├─ ROI区间 (范围选择器)
│   └─ 重置筛选 (按钮)
├─ ActionBar (操作区)
│   ├─ 新增商品 (主按钮)
│   ├─ 批量导入 (按钮)
│   └─ 采集导入 (按钮)
├─ ProductTable (商品表格)
│   ├─ 选择列 (复选框)
│   ├─ 商品信息列 (图片+标题+SKU)
│   ├─ 成本列 (进货价+运费)
│   ├─ 售价列 (建议售价+实际售价)
│   ├─ ROI列 (ROI百分比+利润)
│   ├─ 状态列 (状态标签)
│   ├─ 平台状态列 (各平台状态图标)
│   └─ 操作列 (按钮组)
└─ BatchActionBar (批量操作栏，选中后显示)
    ├─ 已选中X项 (文本)
    ├─ 批量定价 (按钮)
    ├─ 批量上架 (按钮)
    ├─ 批量同步 (按钮)
    └─ 批量删除 (按钮)

数据字段：

字段	类型	说明	来源
id	string	商品ID	cf_product.id
title	string	商品标题	cf_product.title
sku	string	SKU编码	cf_product.sku
image	string	主图URL	cf_product.images[0]
cost_price	decimal	成本价	cf_product.cost_price
shipping_cost	decimal	运费	cf_product.shipping_cost
sale_price	decimal	售价	cf_product.sale_price
profit	decimal	利润	计算字段
roi	decimal	ROI	计算字段
status	enum	状态	cf_product.status
platform_status	json	各平台状态	cf_product.platform_status

商品详情页 (/products/detail/:id)

页面目标：展示商品全生命周期信息，支持商品信息查看和编辑

页面结构：

ProductDetailPage
├─ PageHeader
│   ├─ 返回按钮
│   ├─ 商品标题
│   └─ 操作按钮组 (编辑、上架/下架、同步)
├─ Tabs (标签页)
│   ├─ Tab: 概览
│   │   ├─ 基础信息卡片
│   │   │   ├─ 商品图片 (轮播)
│   │   │   ├─ 商品标题
│   │   │   ├─ SKU信息
│   │   │   ├─ 商品描述
│   │   │   └─ 供应信息
│   │   ├─ 定价信息卡片
│   │   │   ├─ 成本结构 (进货价、运费、其他成本)
│   │   │   ├─ 售价信息 (建议售价、实际售价)
│   │   │   ├─ 利润分析 (利润额、利润率、ROI)
│   │   │   └─ 定价策略 (保守/激进)
│   │   └─ 快捷操作卡片
│   │       ├─ 定价按钮
│   │       ├─ 上架/下架按钮
│   │       └─ 同步按钮
│   ├─ Tab: 平台状态
│   │   ├─ 平台列表
│   │   │   ├─ 平台名称
│   │   │   ├─ 平台商品ID
│   │   │   ├─ 平台状态
│   │   │   ├─ 平台售价
│   │   │   └─ 同步时间
│   │   └─ 同步操作按钮
│   └─ Tab: 同步记录
│       ├─ 同步历史表格
│       │   ├─ 同步时间
│       │   ├─ 平台
│       │   ├─ 操作类型
│       │   ├─ 状态
│       │   ├─ 日志摘要
│       │   └─ 查看详情
│       └─ 分页器

商品编辑弹窗 (ProductEditModal)

页面目标：创建或编辑商品基础信息

页面结构：

ProductEditModal
├─ ModalHeader
│   ├─ 标题：新增商品/编辑商品
│   └─ 关闭按钮
├─ Form (表单)
│   ├─ 基本信息
│   │   ├─ 商品标题 (输入框，必填)
│   │   ├─ SKU编码 (输入框，必填)
│   │   ├─ 商品图片 (上传组件)
│   │   └─ 商品描述 (富文本编辑器)
│   ├─ 供应信息
│   │   ├─ 供应商 (选择器)
│   │   ├─ 进货价 (数字输入，必填)
│   │   ├─ 运费 (数字输入)
│   │   └─ 其他成本 (数字输入)
│   └─ 平台信息
│       ├─ 目标平台 (多选)
│       └─ 平台特定字段 (动态)
├─ ModalFooter
│   ├─ 取消按钮
│   └─ 保存按钮

定价抽屉 (PricingDrawer)

页面目标：为商品设置价格和查看利润分析

页面结构：

PricingDrawer
├─ DrawerHeader
│   ├─ 标题：商品定价
│   └─ 关闭按钮
├─ DrawerContent
│   ├─ 成本输入区
│   │   ├─ 进货价 (数字输入)
│   │   ├─ 运费 (数字输入)
│   │   ├─ 汇率 (数字输入，可自动获取)
│   │   └─ 其他成本 (数字输入)
│   ├─ 实时计算区
│   │   ├─ 总成本 (自动计算)
│   │   ├─ 建议售价 (自动计算)
│   │   ├─ 预计利润 (自动计算)
│   │   ├─ 利润率 (自动计算)
│   │   └─ ROI (自动计算)
│   ├─ 策略选择区
│   │   ├─ 定价策略 (单选：保守/均衡/激进)
│   │   └─ 策略说明 (文本)
│   └─ 售价调整区
│       ├─ 实际售价 (数字输入，默认建议售价)
│       └─ 调整后的利润预览
└─ DrawerFooter
    ├─ 取消按钮
    └─ 保存定价按钮

B.2 订单中心页面映射

对应闭环：订单履约闭环、订单集中管理闭环、售后逆向闭环

订单列表页 (/orders/list)

页面目标：订单管理的核心入口，支持订单的查看、确认、发货等操作

页面结构：

OrderListPage
├─ PageHeader
│   ├─ 标题：订单管理
│   └─ 副标题：管理所有平台订单
├─ FilterBar
│   ├─ 订单号搜索
│   ├─ 平台筛选
│   ├─ 状态筛选
│   ├─ 时间范围
│   └─ 金额范围
├─ OrderTable
│   ├─ 订单号
│   ├─ 平台
│   ├─ 商品信息
│   ├─ 买家信息
│   ├─ 金额
│   ├─ 状态
│   ├─ 下单时间
│   └─ 操作列
└─ Pagination

订单详情页 (/orders/detail/:id)

页面目标：展示订单完整信息和处理历史

页面结构：

OrderDetailPage
├─ PageHeader
│   ├─ 返回按钮
│   ├─ 订单号
│   └─ 状态标签
├─ OrderInfo
│   ├─ 买家信息
│   ├─ 收货地址
│   ├─ 商品列表
│   ├─ 金额明细
│   └─ 操作按钮组
├─ Timeline
│   └─ 订单处理时间线
└─ ActionLog
    └─ 操作日志列表

B.3 执行中心页面映射

对应闭环：服务编排与执行闭环

任务列表页 (/tasks/list)

页面目标：查看和管理所有执行任务

页面结构：

TaskListPage
├─ PageHeader
│   ├─ 标题：执行中心
│   └─ 副标题：管理所有自动化任务
├─ FilterBar
│   ├─ 任务类型筛选
│   ├─ 状态筛选
│   ├─ 平台筛选
│   └─ 时间范围
├─ TaskTable
│   ├─ 任务ID
│   ├─ 任务类型
│   ├─ 关联商品/订单
│   ├─ 平台
│   ├─ 状态
│   ├─ 创建时间
│   ├─ 完成时间
│   └─ 操作列
└─ Pagination

任务详情页 (/tasks/detail/:id)

页面目标：查看任务执行详情和日志

页面结构：

TaskDetailPage
├─ PageHeader
│   ├─ 返回按钮
│   ├─ 任务ID
│   └─ 状态标签
├─ TaskInfo
│   ├─ 任务类型
│   ├─ 关联对象
│   ├─ 平台
│   ├─ 创建时间
│   ├─ 开始时间
│   ├─ 完成时间
│   └─ 执行时长
├─ ExecutionLog
│   └─ 执行日志 (代码块展示)
└─ ResultInfo
    └─ 执行结果 (成功/失败详情)

B.4 数据中心页面映射

对应闭环：报表与分析闭环

数据概览页 (/analytics/overview)

页面目标：展示核心业务指标和数据趋势

页面结构：

AnalyticsOverviewPage
├─ PageHeader
│   ├─ 标题：数据中心
│   └─ 时间范围选择器
├─ KPI Cards
│   ├─ 总销售额
│   ├─ 总利润
│   ├─ 平均ROI
│   ├─ 订单数量
│   └─ 商品数量
├─ Charts
│   ├─ 销售趋势图
│   ├─ 利润趋势图
│   └─ 平台分布图
└─ TopLists
    ├─ 热销商品TOP10
    └─ 高利润商品TOP10

B.5 合规中心页面映射

对应闭环：合规与证书管理闭环、合规与风控闭环

证书管理页 (/compliance/certificates)

页面目标：管理商品合规证书

页面结构：

CertificateManagePage
├─ PageHeader
│   ├─ 标题：证书管理
│   └─ 上传证书按钮
├─ FilterBar
│   ├─ 证书类型筛选
│   ├─ 状态筛选
│   └─ 到期时间筛选
├─ CertificateTable
│   ├─ 证书名称
│   ├─ 证书类型
│   ├─ 关联商品
│   ├─ 有效期
│   ├─ 状态
│   └─ 操作列
└─ Pagination

B.6 系统设置页面映射

平台账号设置页 (/settings/platform)

页面目标：管理各电商平台账号

页面结构：

PlatformSettingsPage
├─ PageHeader
│   ├─ 标题：平台账号设置
│   └─ 添加账号按钮
├─ PlatformList
│   └─ 平台卡片列表
│       ├─ 平台Logo
│       ├─ 平台名称
│       ├─ 账号状态
│       ├─ 店铺数量
│       └─ 操作按钮

附录C：前端组件规范

说明：本附录定义前端组件的设计规范，包括组件分类、命名规范、状态管理和API交互规范。

C.1 组件分类与命名

组件分类

分类	说明	示例	存放路径
页面组件	完整页面	ProductList, OrderDetail	src/pages/
布局组件	页面布局	PageHeader, Sidebar	src/layouts/
业务组件	业务相关	ProductTable, OrderForm	src/components/business/
通用组件	通用UI	StatusTag, ConfirmModal	src/components/common/
图表组件	数据可视化	SalesChart, ProfitChart	src/components/charts/

命名规范

类型	命名规则	示例
组件文件	PascalCase	ProductList.tsx
组件名	PascalCase	ProductList
Props类型	组件名+Props	ProductListProps
State类型	组件名+State	ProductListState
样式文件	组件名.module.less	ProductList.module.less
Hook	use+功能	useProductList

C.2 状态管理规范

全局状态

// src/models/product.ts
export interface ProductState {
  list: Product[];
  detail: Product | null;
  loading: boolean;
  pagination: {
    current: number;
    pageSize: number;
    total: number;
  };
  filters: ProductFilters;
}

export default {
  namespace: 'product',
  state: {
    list: [],
    detail: null,
    loading: false,
    pagination: { current: 1, pageSize: 20, total: 0 },
    filters: {},
  },
  effects: {
    *fetchList({ payload }, { call, put }) {
      yield put({ type: 'setLoading', payload: true });
      const response = yield call(getProductList, payload);
      yield put({ type: 'setList', payload: response.data });
      yield put({ type: 'setPagination', payload: response.pagination });
      yield put({ type: 'setLoading', payload: false });
    },
  },
  reducers: {
    setList(state, { payload }) {
      return { ...state, list: payload };
    },
    setLoading(state, { payload }) {
      return { ...state, loading: payload };
    },
  },
};

页面级状态

// src/pages/products/list/index.tsx
const ProductListPage: React.FC = () => {
  // 页面级状态
  const [selectedRows, setSelectedRows] = useState<Product[]>([]);
  const [modalVisible, setModalVisible] = useState(false);
  const [drawerVisible, setDrawerVisible] = useState(false);
  const [currentProduct, setCurrentProduct] = useState<Product | null>(null);
  
  // 全局状态
  const { list, loading, pagination } = useSelector((state: RootState) => state.product);
  const dispatch = useDispatch();
  
  // ...
};

C.3 API交互规范

请求封装

// src/services/product.ts
import request from '@/utils/request';

export async function getProductList(params: ProductListParams) {
  return request('/api/products', {
    method: 'GET',
    params,
  });
}

export async function getProductDetail(id: string) {
  return request(`/api/products/${id}`, {
    method: 'GET',
  });
}

export async function createProduct(data: CreateProductData) {
  return request('/api/products', {
    method: 'POST',
    data,
  });
}

export async function updateProduct(id: string, data: UpdateProductData) {
  return request(`/api/products/${id}`, {
    method: 'PUT',
    data,
  });
}

export async function deleteProduct(id: string) {
  return request(`/api/products/${id}`, {
    method: 'DELETE',
  });
}

export async function updateProductPrice(id: string, data: PricingData) {
  return request(`/api/products/${id}/price`, {
    method: 'POST',
    data,
  });
}

export async function syncProductToPlatform(id: string, platform: string) {
  return request(`/api/products/${id}/sync`, {
    method: 'POST',
    data: { platform },
  });
}

错误处理

// src/utils/request.ts
import { notification } from 'antd';

const request = extend({
  errorHandler: (error: ResponseError) => {
    const { response, data } = error;
    
    if (response && response.status) {
      const errorText = data?.message || codeMessage[response.status];
      
      notification.error({
        message: `请求错误 ${response.status}`,
        description: errorText,
      });
      
      // 401 未授权，跳转到登录页
      if (response.status === 401) {
        window.location.href = '/login';
      }
    }
    
    throw error;
  },
});

C.4 路由与权限规范

路由配置

// config/routes.ts
export default [
  {
    path: '/',
    component: '@/layouts/BasicLayout',
    routes: [
      { path: '/', redirect: '/dashboard' },
      {
        path: '/dashboard',
        name: '工作台',
        icon: 'DashboardOutlined',
        component: '@/pages/dashboard',
      },
      {
        path: '/products',
        name: '商品中心',
        icon: 'ShoppingOutlined',
        routes: [
          {
            path: '/products/list',
            name: '商品列表',
            component: '@/pages/products/list',
            access: 'product:read',
          },
          {
            path: '/products/detail/:id',
            name: '商品详情',
            component: '@/pages/products/detail',
            hideInMenu: true,
            access: 'product:read',
          },
        ],
      },
      // ...
    ],
  },
];

权限控制

// src/access.ts
export default function(initialState: InitialState) {
  const { currentUser } = initialState || {};
  const permissions = currentUser?.permissions || [];
  
  return {
    // 商品权限
    'product:read': permissions.includes('product:read'),
    'product:create': permissions.includes('product:create'),
    'product:update': permissions.includes('product:update'),
    'product:delete': permissions.includes('product:delete'),
    'product:sync': permissions.includes('product:sync'),
    
    // 订单权限
    'order:read': permissions.includes('order:read'),
    'order:confirm': permissions.includes('order:confirm'),
    'order:ship': permissions.includes('order:ship'),
    'order:cancel': permissions.includes('order:cancel'),
    
    // ...
  };
}

补充说明：

本附录内容基于参考文档的前端交互设计规范，与现有50个业务闭环保持一致
所有状态机定义与业务闭环中的状态定义对应
页面映射与Task_Overview.md中的前端任务对应
组件规范遵循项目特定规则中的命名和技术约束

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

💰 钱流：
- 采集成本：API调用费用、代理IP费用、云服务费用
- 利润评估：采购成本 → 平台费用 → 物流费用 → 税费 → 广告费用 → 净利润
🔄 状态变化：
- RAW_DATA → CLEANED → ANALYZED → READY_FOR_LISTING
🔥 触发条件：
- 定时任务：按配置的采集频率自动触发
- 手动触发：用户手动发起采集任务
- 事件触发：商品价格变动、库存变动等事件触发重新采集

2️⃣ 商品刊登闭环（Product Listing Loop）

目标：将可售商品同步到各平台，建立销售基础（TOC）或生成报价单（TOB）。
流程：
1. 商品准备：
  - ERP 商品信息完善
  - 平台规则适配：标题、描述、图片、批量折扣（TOB）
  - 价格策略设置：基于套利分析或阶梯价策略
2. 刊登执行：
  - 批量或单条刊登，支持失败重试和全链路追踪
  - API 平台：走 Connector Bus
  - 无 API 平台：No-API Bridge + PENDING_REVIEW
3. 刊登后管理：
  - 库存同步、价格更新、商品状态监控
决策点：
- 必须通过前置套利/利润分析
- TOB 需遵循阶梯价审批策略
输入：清洗后的可售商品数据
输出：已刊登商品列表 + 平台状态 + 链接
💰 钱流：
- 刊登成本：平台费用、图片处理费用、人工费用
- 定价策略：成本价 → 平台费用 → 物流费用 → 预期利润 → 最终售价
🔄 状态变化：
- READY_FOR_LISTING → LISTING_IN_PROGRESS → LISTED → MONITORING → NEED_UPDATE → UPDATED
🔥 触发条件：
- 手动触发：用户手动发起刊登任务
- 事件触发：商品信息更新、价格变动、库存变动
- 定时任务：定期检查商品状态，更新价格和库存

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）

数据采集与清洗闭环 → 商品主数据闭环：提供原始商品数据
数据采集与清洗闭环 → 素材管理闭环：提供采集的商品图片和视频素材
数据采集与清洗闭环 → 定价与利润决策闭环：提供成本和市场数据
商品主数据闭环 → SKU变体与结构闭环：提供商品基础信息
SKU变体与结构闭环 → 商品刊登闭环：提供多SKU结构和平台映射
商品刊登闭环 → 素材管理闭环：触发素材需求，生成商品主图和详情图
素材管理闭环 → 商品刊登闭环：提供处理后的商品素材（图片、视频）
素材管理闭环 → 广告计划与营销闭环：提供广告投放所需的素材库
商品刊登闭环 → 广告计划与营销闭环：提供已刊登商品列表
商品刊登闭环 → 订单履约闭环：提供商品库存和状态信息
商品刊登闭环 → 定价与利润决策闭环：提供商品成本信息
定价与利润决策闭环 → 商品刊登闭环：提供建议售价和上架决策
定价与利润决策闭环 → 广告计划与营销闭环：提供可投放 ROI 区间和最大可承受 CPA
订单履约闭环 → 订单拆分与合并闭环：提供订单数据用于拆分/合并
订单拆分与合并闭环 → 物流策略与渠道选择闭环：提供拆分/合并后的订单数据
物流策略与渠道选择闭环 → 订单履约闭环：提供物流方案
订单履约闭环 → 异常订单处理闭环：提供异常订单数据
异常订单处理闭环 → 售后逆向闭环：触发售后处理
异常订单处理闭环 → 合规与风控闭环：提供风控预警
订单履约闭环 → 售后逆向闭环：提供订单和物流信息
售后逆向闭环 → 资金对账闭环：提供退款记录
订单履约闭环 → 资金对账闭环：提供销售记录
广告计划与营销闭环 → 资金对账闭环：提供广告费用记录
订单履约闭环 → 库存与仓储管理闭环：触发库存扣减和物流操作
库存与仓储管理闭环 → 订单履约闭环：提供库存状态和物流信息
库存与仓储管理闭环 → 供应链与供应商管理闭环：触发补货需求
供应链与供应商管理闭环 → 库存与仓储管理闭环：提供采购入库信息
供应链与供应商管理闭环 → 商品主数据闭环：提供供应商商品数据
商品刊登闭环 → B2B / TOB 贸易管理闭环：提供商品信息用于报价
B2B / TOB 贸易管理闭环 → 订单履约闭环：生成 B2B 订单
B2B / TOB 贸易管理闭环 → 资金对账闭环：提供 B2B 交易记录
资金对账闭环 → 利润核算闭环：提供收入和成本数据
利润核算闭环 → 报表与分析闭环：提供利润数据
订单履约闭环 → 用户/客户资产闭环：提供订单和用户行为数据
售后逆向闭环 → 用户/客户资产闭环：提供售后记录
用户/客户资产闭环 → 广告计划与营销闭环：提供用户画像和营销建议
用户/客户资产闭环 → B2B / TOB 贸易管理闭环：提供企业客户信息
广告计划与营销闭环 → A/B测试与策略优化闭环：提供广告策略数据
商品刊登闭环 → A/B测试与策略优化闭环：提供商品定价和展示数据
A/B测试与策略优化闭环 → 报表与分析闭环：提供测试结果和优化建议
所有敏感操作 → 治理与审批中心闭环：触发审批流程
治理与审批中心闭环 → 所有业务闭环：提供审批结果
订单履约闭环 → 合规与证书管理闭环：触发证书生成
合规与证书管理闭环 → 订单履约闭环：提供合规证书
所有业务闭环 → 账号/店铺健康度闭环：提供违规记录、发货延迟、差评率、退款率等数据
账号/店铺健康度闭环 → 广告计划与营销闭环：提供是否暂停广告、降预算的决策
账号/店铺健康度闭环 → 商品刊登闭环：提供是否限制上新、下架高风险商品的决策
所有店铺操作 → 店铺隔离与自动化闭环：提供店铺操作数据
店铺隔离与自动化闭环 → 所有店铺相关行为：提供隔离环境和自动化执行能力
所有闭环 → 合规与风控闭环：提供全流程数据用于风险监控
所有业务闭环 → 报表与分析闭环：提供各闭环的输出数据用于报表生成和分析
报表与分析闭环 → 所有业务闭环：反馈数据异常、业务波动、优化建议，指导各闭环的操作调整

📊 关键绩效指标（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

恶意买家黑名单闭环

KPI 指标	描述	适用业务类型
黑名单识别准确率	正确识别恶意买家的比例	TOC + TOB
风险评估准确率	风险等级评估的准确性	TOC + TOB
黑名单共享有效率	共享黑名单的有效利用比例	TOC + TOB
风险预警及时率	及时发出风险预警的比例	TOC + TOB
误报率	误判为恶意买家的比例	TOC + TOB

高退货率SKU自动下架/改进建议闭环

KPI 指标	描述	适用业务类型
退货率监控准确率	退货率计算的准确性	TOC + TOB
自动下架准确率	正确下架高风险SKU的比例	TOC + TOB
改进建议有效性	改进建议被采纳并实施的比例	TOC + TOB
重新上架成功率	改进后重新上架的成功比例	TOC + TOB
退货率改善率	改进后退货率下降的比例	TOC + TOB

3️⃣1️⃣ 多商户入驻与认证闭环（Merchant Registration & Authentication Loop）

目标：支持多商户入驻、资质认证、店铺创建，实现平台化运营。
流程：
1. 商户注册：
  - 商户自助注册（邮箱/手机/企业信息）
  - 资质文件上传（营业执照、法人身份证等）
  - 账户类型选择（企业/个人）
  - 初始密码设置和安全验证
2. 资质认证：
  - 自动审核 + 人工复核
  - 企业信息验证、信用检查
  - 行业资质合规检查
  - 审核进度实时更新
3. 店铺创建：
  - 店铺基础信息配置（名称、LOGO、描述）
  - 绑定平台店铺（Amazon、Shopee等）
  - 支付账户配置（收款方式、结算周期）
  - 店铺运营设置（退换货政策、客服信息）
4. 权限分配：
  - 初始角色设置（管理员、运营、财务）
  - 权限范围配置（可访问模块、操作权限）
  - 数据隔离设置（商户级数据隔离）
决策点：
- 资质审核标准（行业合规、信用评级）
- 商户等级划分（普通/优质/战略）
- 入驻门槛设置（不同等级商户的要求）
- 审核通过/拒绝的条件和流程
输入：商户注册信息、资质文件、企业证明
输出：商户ID、认证状态、店铺ID、权限配置
状态机：SUBMITTED → PENDING_REVIEW → APPROVED/REJECTED → ACTIVE

📋 技术实现指引：

层级	实现模块	关键文件	任务ID
后端	商户管理	`MerchantService.ts`	BE-M001
后端	资质验证	`VerificationService.ts`	BE-M002
后端	权限管理	`RBACService.ts`	BE-M003
前端	注册页面	`MerchantRegistration.vue`	FE-M001
前端	状态查询	`MerchantStatus.vue`	FE-M002

3️⃣2️⃣ 商户店铺管理闭环（Merchant Store Management Loop）

目标：支持商户管理自己的商品、库存、促销活动。
流程：
1. 商户创建店铺或子店铺。
2. 前端提供商品管理界面（新增、编辑、上下架）。
3. 后端管理库存、价格、SKU、分类。
4. 支持商户自定义促销规则（折扣、满减、优惠券）。
决策点：
- 库存不足 → 阻止下架或自动提醒。
- 促销策略冲突 → 系统自动合并或提示调整。
输入：商户店铺信息、商品信息
输出：管理的店铺和商品数据
状态机：CREATED → CONFIGURING → ACTIVE → INACTIVE

📋 技术实现指引：

层级	实现模块	关键文件	任务ID
后端	店铺管理	`StoreService.ts`	BE-S001
后端	商品管理	`ProductService.ts`	BE-P001
后端	库存管理	`InventoryService.ts`	BE-I001
前端	店铺管理页面	`StoreManagement.vue`	FE-S001
前端	商品管理页面	`ProductManagement.vue`	FE-P001

3️⃣3️⃣ 多商户订单闭环（Multi-Merchant Order Loop）

目标：支持多个商户订单独立处理，同时平台统一监控。
流程：
1. 客户下单 → 系统拆分订单至各商户。
2. 前端商户端显示新订单 → 可确认、拒单、修改发货信息。
3. 后端记录订单状态（待处理、已发货、完成、异常）。
4. 平台监控整体订单履约情况。
决策点：
- 商户拒单 → 系统可触发退款或自动分配给其他商户。
- 超时未处理 → 系统提醒或自动处理。
输入：客户订单数据
输出：拆分后的商户子订单，包含状态更新
状态机：PENDING → ACCEPTED → SHIPPED → COMPLETED → REFUNDED

📋 技术实现指引：

层级	实现模块	关键文件	任务ID
后端	订单管理	`OrderService.ts`	BE-O001
后端	订单拆分	`OrderSplitService.ts`	BE-O002
前端	商户订单页面	`MerchantOrderPage.vue`	FE-O001
前端	平台订单监控	`OrderMonitoringPage.vue`	FE-O002

3️⃣4️⃣ 多商户库存同步闭环（Multi-Merchant Inventory Sync Loop）

目标：确保平台和商户端库存实时同步。
流程：
1. 商户上传库存信息（API/手动）。
2. 平台统一汇总并分发给前端展示。
3. 当客户下单 → 自动扣减对应商户库存。
决策点：
- 库存不足 → 阻止下单或显示缺货。
- 库存异常 → 系统报警。
输入：商户库存数据、订单数据
输出：实时同步的库存状态
状态机：SYNCED → UPDATING → SYNCED → ERROR

📋 技术实现指引：

层级	实现模块	关键文件	任务ID
后端	库存管理	`InventoryService.ts`	BE-I001
后端	库存同步	`InventorySyncService.ts`	BE-I002
前端	库存管理页面	`InventoryManagement.vue`	FE-I001

3️⃣5️⃣ 多商户结算与财务闭环（Multi-Merchant Settlement & Finance Loop）

目标：自动计算商户收入、平台佣金、手续费及结算周期。
流程：
1. 后端计算订单收入、退款、佣金分成。
2. 系统生成结算账单 → 商户可查询。
3. 支持多结算方式（银行、电子钱包）。
4. 自动发起付款（周期结算或即时结算）。
决策点：
- 异常订单 → 暂停结算并标记。
- 多币种结算 → 汇率实时更新。
输入：订单数据、支付数据
输出：结算账单、付款记录
状态机：PENDING → CALCULATED → APPROVED → PAID

📋 技术实现指引：

层级	实现模块	关键文件	任务ID
后端	结算服务	`SettlementService.ts`	BE-S002
后端	财务管理	`FinanceService.ts`	BE-F001
前端	结算管理页面	`SettlementManagement.vue`	FE-S002

3️⃣6️⃣ 商户权限与角色闭环（Merchant Roles & Permissions Loop）

目标：控制商户内部操作权限，支持多角色管理。
流程：
1. 商户创建角色（管理员、仓库、客服等）。
2. 后端配置每个角色的访问权限。
3. 前端动态显示可操作模块。
决策点：
- 权限冲突 → 系统提示。
- 异常操作 → 记录日志和告警。
输入：商户角色配置
输出：权限配置，访问控制
📋 技术实现指引：

层级实现模块关键文件任务ID

后端权限服务 RBACService.ts BE-R001

前端权限管理页面 PermissionManagement.vue FE-R001

3️⃣7️⃣ 商户数据与分析闭环（Merchant Analytics & Reporting Loop）

目标：提供独立商户数据分析，同时平台可汇总整体业务指标。
流程：
1. 后端收集订单、流量、库存、评价数据。
2. 生成商户专属数据报表和趋势分析。
3. 平台可生成多商户对比分析。
决策点：
- 数据异常 → 自动报警。
- 需要合规报表 → 自动生成符合财务/税务规范的报表。
输入：商户业务数据
输出：商户报表、平台分析报告
状态机：RAW → PROCESSED → GENERATED → DISTRIBUTED

📋 技术实现指引：

层级	实现模块	关键文件	任务ID
后端	报表服务	`ReportService.ts`	BE-R002
后端	数据分析	`AnalyticsService.ts`	BE-A002
前端	商户报表页面	`MerchantReportPage.vue`	FE-R002
前端	平台分析页面	`PlatformAnalyticsPage.vue`	FE-A001

3️⃣8️⃣ 异常处理闭环（Exception & Dispute Loop）

目标：处理商户异常、客户投诉、退款退货。
流程：
1. 客户发起投诉/退货 → 系统分配给对应商户。
2. 商户处理 → 平台监控处理时效。
3. 处理结果同步前端和财务结算。
决策点：
- 超时未处理 → 系统自动介入。
- 争议订单 → 暂停结算，人工复核。
输入：投诉/退货请求
输出：处理结果，财务调整
状态机：SUBMITTED → PROCESSING → RESOLVED → ESCALATED

📋 技术实现指引：

层级	实现模块	关键文件	任务ID
后端	异常处理	`ExceptionService.ts`	BE-E001
后端	争议解决	`DisputeResolverService.ts`	BE-D001
前端	异常管理页面	`ExceptionManagement.vue`	FE-E001

3️⃣9️⃣ 功能模块化与权限控制闭环（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. 财务对账：
  - 商户账户流水核对
  - 异常交易处理（退款、纠纷等）
  - 财务报表生成（商户级、平台级）
  - 税务报表准备
5. 资金安全：
  - 资金流向监控
  - 异常资金预警
  - 资金冻结与解冻
决策点：
- 结算门槛（最低提现金额）
- 手续费规则（提现、转账等）
- 账期调整（根据商户等级）
- 分润比例设置
- 异常交易处理流程
输入：交易数据、商户结算规则、分润配置、银行账户信息
输出：结算单、账户余额、财务报表、分润记录
状态机：PENDING → PROCESSING → COMPLETED → FAILED

📋 技术实现指引：

层级	实现模块	关键文件	任务ID
后端	结算服务	`MerchantSettlementService.ts`	BE-F001
后端	财务管理	`FinanceService.ts`	BE-F002
后端	分润管理	`ProfitSharingService.ts`	BE-F003
前端	结算管理	`SettlementManagement.vue`	FE-F001
前端	财务报表	`FinanceReport.vue`	FE-F002

3️⃣5️⃣ 多商户商品与订单管理闭环（Multi-Merchant Product & Order Management Loop）

目标：多商户商品上架、订单分配、库存同步管理。
流程：
1. 商品管理：
  - 商户自有商品上传
  - 平台商品池共享
  - 商品审核（合规、质量）
2. 订单分配：
  - 订单智能分配（有库存优先/距离优先/评分优先）
  - 商户抢单模式
  - 异常订单人工处理
3. 库存同步：
  - 多商户库存汇总
  - 实时库存同步
  - 预占/扣减机制
4. 多商户物流：
  - 商户自有物流或平台物流
  - 物流轨迹共享
  - 签收确认
决策点：
- 商品上架审核标准
- 订单分配策略
- 库存超卖防护
输入：商品数据、订单数据、库存数据
输出：商品状态、订单分配结果、物流信息

3️⃣6️⃣ 恶意买家黑名单闭环（Malicious Buyer Blacklist Loop）

目标：识别、管理和共享恶意买家信息，降低交易风险。
流程：
1. 黑名单管理
  - 手动添加恶意买家（欺诈、拒付、滥用等）
  - 自动识别高风险买家（基于行为模式）
  - 黑名单等级划分（低/中/高风险）
2. 风险评估
  - 基于买家行为的综合风险评分
  - 多维度风险因素分析（退货率、投诉率、拒付率等）
  - 实时风险预警
3. 黑名单共享
  - 跨租户黑名单共享机制
  - 共享规则配置（自动接受/人工审核）
  - 共享状态同步
决策点：
- 黑名单阈值设定
- 共享范围控制
- 风险等级判定标准
输入：买家信息、交易记录、行为数据
输出：黑名单记录、风险评分、共享结果
状态机：SUGGESTED → PENDING_REVIEW → ACTIVE / REJECTED → EXPIRED

3️⃣7️⃣ 高退货率SKU自动下架/改进建议闭环（High Return Rate SKU Auto-Delist & Improvement Loop）

目标：监控高退货率SKU，自动下架风险商品并提供改进建议。
流程：
1. 退货率监控
  - 实时计算SKU退货率
  - 多维度分析（按平台/店铺/类目）
  - 趋势监控和预警
2. 自动下架
  - 阈值触发自动下架
  - 多平台下架支持（Amazon/Shopee/Lazada/TikTok）
  - 自动重新上架功能
3. 改进建议
  - 基于退货原因的智能分析
  - 分类建议生成（质量/描述/图片/包装/物流等）
  - 实施步骤指导和ROI预估
决策点：
- 退货率阈值设定
- 自动下架规则配置
- 改进优先级排序
输入：订单数据、退货记录、SKU信息
输出：高风险SKU列表、下架结果、改进建议
状态机：MONITORED → HIGH_RISK → AUTO_DELISTED → IMPROVEMENT_SUGGESTED → RE_LISTED

3️⃣8️⃣ 商业化与增长闭环（Monetization & Growth Loop）

目标：实现系统持续盈利与收入增长（非SaaS模式）

收费模型

1. 功能收费（Feature-based）

高级分析
自动化能力
API调用

2. 交易抽成（Transaction-based）

TOC：订单抽佣（3~10%）
TOB：大单服务费

3. 服务收费（Service-based）

代发货
仓储服务
数据服务

4. 资金沉淀（Deposit Float）

押金沉淀收益
账期资金

收费触发点

功能调用
订单完成
商家使用服务
API请求

收入放大机制

ROI分析 → 推荐开功能
利润分析 → 推荐加广告
订单增长 → 引导升级套餐

决策点

免费 vs 付费边界
抽成比例
功能定价策略

输入

用户行为
订单数据
利润数据

输出

收入增长
用户付费转化

3️⃣9️⃣ 服务编排与执行闭环（Service Orchestration Loop）

目标：将业务闭环转化为可执行的后端服务流

核心原则

每个业务闭环必须对应一个 Service Flow
所有逻辑必须走 Service 层

执行流程

Frontend → Controller → Service（核心编排） → Repository / External API → 返回结果

示例

功能开通

Controller → FeatureService.openFeature → PaymentService.create → PaymentCallback → PermissionService.grant

决策点

服务拆分粒度
是否异步（消息队列）
是否需要补偿机制

输出

可执行后端服务
业务状态流转

4️⃣0️⃣ 增长飞轮闭环（Growth Flywheel Loop）

目标：让系统自动变强、自动赚钱

飞轮逻辑

数据 → 利润分析 → 推荐 → 用户行动 → 收入 → 更多数据

核心路径

商品数据 → 利润分析
利润高 → 推广广告
广告带订单
订单产生数据
数据优化策略

TOB路径

询盘 → 报价 → 成交 → 复购 → 信用提升 → 更大订单

决策点

推荐策略
自动化程度
AI参与程度

输出

GMV增长
ROI提升
用户粘性

🔍 追踪与审计

追踪五元组：
- tenantId：租户 ID（业务隔离）
- shopId：店铺 ID（平台/店铺隔离）
- taskId：任务 ID（任务/规则触发归档）
- traceId：链路追踪 ID（全链路唯一标识）
- businessType：业务类型（TOC/TOB）
审计要求：
- 每一笔操作必须绑定 traceId 和 businessType
- 所有功能需通过 Shadow-Test（最小冒烟测试）
- 关键操作必须生成 AuditLog

4️⃣6️⃣ 技术基础设施闭环（Technical Infrastructure Loop）

目标：提供稳定、高效、可扩展的技术基础设施，支撑核心业务流程的运行。
流程：
1. 服务管理：
  - 服务注册与发现
  - 服务健康检查与监控
  - 服务版本管理与部署
2. 数据管理：
  - 缓存策略与优化
  - 数据库性能优化
  - 数据备份与恢复
3. 消息处理：
  - 消息队列管理
  - 异步操作处理
  - 事件总线管理
4. 安全与合规：
  - 数据传输加密
  - 访问控制与权限管理
  - 日志审计与追踪
决策点：
- 服务健康状态评估
- 性能瓶颈识别与优化
- 安全风险评估与应对
输入：系统配置、服务状态数据、性能指标
输出：技术基础设施状态报告、优化建议、安全审计报告

4️⃣7️⃣ 客户服务闭环（Customer Service Loop）

目标：提供高效、专业的客户服务，解决客户问题，提升客户满意度。
流程：
1. 客户咨询处理：
  - 咨询接收与分类
  - 智能客服响应
  - 人工客服介入
2. 争议与投诉处理：
  - 争议接收与评估
  - 证据收集与分析
  - 解决方案制定与执行
3. 售后服务：
  - 退货退款处理
  - 产品质量问题处理
  - 售后跟踪与反馈
4. 客户反馈管理：
  - 反馈收集与分析
  - 改进建议生成
  - 服务质量评估
决策点：
- 争议类型识别与处理策略
- 退款审批与执行
- 服务质量评估与改进
输入：客户咨询、争议信息、售后请求、客户反馈
输出：服务响应、争议解决方案、售后处理结果、客户满意度报告

4️⃣8️⃣ 跨境电商闭环（Cross-Border E-Commerce Loop）

目标：支持跨境电商全流程，解决清关、物流、支付等痛点。
流程：
1. 跨境商品管理：
  - 商品合规性检查
  - 关税计算与预估
  - 商品分类与HS编码管理
2. 清关服务：
  - 自动生成清关文件
  - 海关申报与追踪
  - 关税和税费处理
3. 跨境物流：
  - 国际物流渠道选择
  - 运费计算与优化
  - 物流轨迹追踪
  - 跨境仓储管理
4. 跨境支付：
  - 多币种支付支持
  - 汇率管理与优化
  - 跨境支付安全
5. 合规管理：
  - 出口/进口法规遵守
  - 税务合规与申报
  - 产品认证与标准
决策点：
- 物流渠道选择（成本vs时效）
- 清关策略（自行清关vs代理清关）
- 支付方式选择（安全性vs便捷性）
- 合规风险评估
输入：商品信息、订单数据、目的地国家/地区、支付信息
输出：清关文件、物流信息、支付状态、合规报告
状态机：PENDING → PROCESSING → CLEARANCE → SHIPPING → DELIVERED

4️⃣9️⃣ AI驱动智能决策闭环（AI-Driven Smart Decision Loop）

目标：利用AI技术提升运营效率和决策准确性，实现"AI主导决策 + 人类验证 + 操作执行 + 日志记录"的智能化运营。
核心理念：
- AI建议为主：AI生成策略、推荐操作、人类只作为参考或最终确认
- 人类介入可控：前期可高干预，AI越强介入越低，最后趋近于完全自动
- 操作可追踪：每次AI建议、用户操作和系统执行都要有LOG，保证可审计性

流程概览

[AI生成决策建议] → [人类确认/修改] → [系统执行操作] → [日志记录]

详细流程

1. AI生成决策建议

输入：历史数据 + 实时数据 + 规则库

输出示例：

{
  "action": "调整价格",
  "params": {"sku": "A123", "new_price": 88.5},
  "confidence": 0.92,
  "risk_level": "low",
  "alternative_solutions": [
    {"action": "促销折扣", "params": {"sku":"A123", "discount":10}, "confidence":0.85}
  ]
}

设计要点：
- 每个建议带 置信度、风险等级、替代方案
- 支持多维度评分（收益、风险、用户体验）

2. 人类确认/修改

UI/插件端展示：
- 建议动作、参数、风险提示
- 支持修改参数或拒绝
- 可选"自动执行模式"，允许置信度高于阈值自动执行
记录内容：
- 谁确认/修改
- 修改内容及理由
- 时间戳

3. 系统执行操作

执行方式：API调用 / 脚本执行 / 自动化任务
失败重试策略：
- 可配置重试次数
- 超时或失败记录到日志
成功后：返回执行状态，更新状态数据库

4. 日志记录

全链路ID关联：每条操作有唯一ID，AI建议→人操作→系统执行关联

日志结构示例：

{
  "operation_id": "20260319-001",
  "ai_suggestion": {
    "action": "调整价格",
    "params": {"sku": "A123", "new_price": 88.5},
    "confidence": 0.92,
    "timestamp": "2026-03-19T00:00:00"
  },
  "human_review": {
    "operator": "操作员姓名",
    "modified_params": {"new_price": 89.0},
    "reason": "小幅提升利润",
    "timestamp": "2026-03-19T00:05:00"
  },
  "system_execution": {
    "status": "success",
    "timestamp": "2026-03-19T00:06:00"
  }
}

自动化程度演进

阶段	AI角色	人类角色	说明
初期	建议生成	审核确认	人工操作占主导
中期	自动执行（高置信度）	异常处理	对置信度高、低风险的操作可自动执行
后期	全链路决策	仅异常介入	AI全链路决策 + 自动执行

角色与权限

角色	权限	备注
AI Agent	决策生成、数据分析、风险评估	输出建议，带置信度
人类操作者	审核/修改/确认	前期高干预，后期可降低
系统执行层	自动化操作执行	仅执行经过确认的操作
日志管理系统	全链路记录	可回溯，每条操作打时间戳

智能决策应用场景

智能定价与动态调价
智能库存预测与补货
智能广告投放与优化
智能客户服务与售后
智能风控与异常检测

决策点：
- 模型选择（监督学习vs无监督学习）
- 预测结果置信度阈值
- 人工干预时机
- 模型更新频率
- 自动执行阈值设定
输入：业务数据、市场数据、用户行为数据
输出：智能决策建议、预测结果、优化方案、执行日志
状态机：DATA_COLLECTION → AI_SUGGESTION → HUMAN_REVIEW → EXECUTION → LOGGING → FEEDBACK
关键指标：
- AI建议采纳率
- 自动执行比例
- 人工干预次数
- 决策准确率
- 执行成功率

5️⃣0️⃣ 核心服务优先级闭环（Core Service Priority Loop）

目标：确定核心业务服务的优先级顺序，确保资源合理分配。
流程：
1. 服务评估：
  - 业务价值评估
  - 技术复杂度评估
  - 资源需求评估
  - 风险评估
2. 优先级排序：
  - 基于业务价值的排序
  - 基于依赖关系的排序
  - 基于时间窗口的排序
3. 资源分配：
  - 人力分配
  - 技术资源分配
  - 时间规划
4. 执行监控：
  - 进度跟踪
  - 资源使用监控
  - 风险预警
决策点：
- 优先级调整时机
- 资源重新分配决策
- 项目范围变更管理
输入：服务需求、业务目标、资源状况
输出：优先级排序结果、资源分配计划、执行进度报告
状态机：ASSESSMENT → PRIORITIZATION → RESOURCE_ALLOCATION → EXECUTION → MONITORING

5️⃣1️⃣ 多商户收益排行榜系统（信任引擎）（Merchant Leaderboard Loop）🆕

目标：让用户看到"别人赚钱了" → 促进付费，建立信任和转化
流程：
1. 数据采集：
  - 收集商户订单数据
  - 收集广告数据
  - 收集ROI数据
  - 收集利润数据
2. 数据汇总：
  - 计算总收入
  - 计算总成本
  - 计算净利润
  - 计算ROI
3. 排行计算：
  - 收益榜排序
  - ROI榜排序
  - 增长榜排序
4. 防作弊处理：
  - 过滤异常订单
  - ROI上限限制
  - 新用户单独榜单
5. 榜单展示：
  - TOP 10 商户展示
  - ROI展示
  - 使用策略标签
决策点：
- 排行计算频率（每10分钟）
- 防作弊阈值设定
- 榜单展示策略
输入：商户订单数据、广告数据、ROI数据
输出：排行榜数据、TOP 10 商户、榜单类型
状态机：DATA_COLLECTION → DATA_AGGREGATION → RANKING_CALCULATION → ANTI_CHEAT → LEADERBOARD_DISPLAY
关键指标：
- 商户总数
- 活跃商户数
- 平均ROI
- 最高ROI
- 榜单更新频率
数据表：
- cf_merchant_metrics：商户指标汇总表
- cf_leaderboard：排行榜表
- cf_leaderboard_history：排行榜历史表

5️⃣2️⃣ 策略市场（Strategy Marketplace Loop）🆕

目标：AI赚钱能力商品化，实现功能收费闭环
流程：
1. 策略创建：
  - 策略类型定义（广告/定价/选品）
  - 策略配置schema
  - 策略定价模式
  - 策略ROI预估
2. 策略发布：
  - 策略审核
  - 策略上架
  - 策略分类
3. 策略推荐：
  - 基于商户数据推荐
  - 基于ROI推荐
  - 基于使用场景推荐
4. 策略激活：
  - 商户选择策略
  - 权限验证
  - 费用扣除
  - 策略激活
5. 策略使用：
  - 策略执行
  - 使用记录
  - 效果追踪
  - ROI计算
6. 策略优化：
  - 使用次数统计
  - ROI统计
  - 策略调整
决策点：
- 策略定价策略
- 策略推荐算法
- 策略使用权限
输入：策略配置、商户数据、使用记录
输出：策略列表、推荐策略、激活状态、使用统计
状态机：STRATEGY_CREATION → STRATEGY_PUBLISH → STRATEGY_RECOMMENDATION → STRATEGY_ACTIVATION → STRATEGY_USAGE → STRATEGY_OPTIMIZATION
关键指标：
- 策略总数
- 活跃策略数
- 策略使用次数
- 平均ROI
- 策略收益
数据表：
- cf_strategies：策略表
- cf_merchant_strategies：商户策略关联表
- cf_strategy_usage：策略使用记录表
- cf_strategy_metrics：策略指标表

5️⃣3️⃣ 自动选品+自动上架系统（增长引擎）（Auto Product Selection & Listing Loop）🆕

目标：自动找到赚钱商品 → 自动卖，实现自动化增长
流程：
1. 商品采集：
  - 多平台商品采集（1688/Amazon/TikTok）
  - 商品数据清洗
  - 商品数据标准化
2. 商品池管理：
  - 商品入库
  - 商品分类
  - 商品去重
3. AI选品：
  - 商品评分计算
  - ROI预估
  - 市场需求分析
  - 竞争度分析
4. 选品决策：
  - ROI阈值判断
  - 评分阈值判断
  - 预算范围判断
5. 自动上架：
  - 创建商品任务
  - 商品定价
  - 平台同步
6. 效果追踪：
  - 销售数据追踪
  - ROI计算
  - 选品效果评估
决策点：
- 选品算法参数
- ROI阈值设定
- 预算范围设定
- 自动上架策略
输入：平台商品数据、选品配置、预算范围
输出：选中商品、上架商品、效果报告
状态机：PRODUCT_COLLECTION → PRODUCT_POOL_MANAGEMENT → AI_SELECTION → SELECTION_DECISION → AUTO_LISTING → EFFECT_TRACKING
关键指标：
- 商品池大小
- 选品成功率
- 平均ROI
- 上架成功率
- 自动化率
数据表：
- cf_products_pool：商品池表
- cf_merchant_products：商户商品表
- cf_product_selection_logs：选品记录表
- cf_product_metrics：商品指标表

5️⃣4️⃣ AI店铺托管（AutoPilot Loop）🆕

目标：替用户运营店铺，实现全自动运营
流程：
1. 托管配置：
  - 策略选择（选品/定价/广告）
  - 预算设置
  - 风险控制
  - 托管范围设定
2. 托管启动：
  - 权限验证
  - 资源分配
  - 托管服务启动
3. 自动运营：
  - 自动选品
  - 自动定价
  - 自动广告
  - 自动库存管理
4. 实时监控：
  - 销售数据监控
  - ROI监控
  - 风险监控
  - 异常检测
5. 智能决策：
  - 策略调整
  - 预算调整
  - 风险控制
  - 紧急停止
6. 报告生成：
  - 运营报告
  - ROI报告
  - 决策日志
决策点：
- 托管策略选择
- 预算分配策略
- 风险控制策略
- 紧急停止条件
输入：托管配置、商户数据、市场数据
输出：运营报告、ROI报告、决策日志
状态机：AUTOPILOT_CONFIG → AUTOPILOT_START → AUTO_OPERATION → REAL_TIME_MONITORING → SMART_DECISION → REPORT_GENERATION
关键指标：
- 托管商户数
- 自动化运营率
- 平均ROI
- 风险事件数
- 紧急停止次数
数据表：
- cf_autopilot_config：托管配置表
- cf_autopilot_status：托管状态表
- cf_autopilot_logs：托管日志表
- cf_autopilot_decisions：托管决策表

5️⃣5️⃣ 跨平台套利系统（Cross-Platform Arbitrage Loop）🆕

目标：低买高卖，实现跨平台套利
流程：
1. 价格监控：
  - 多平台价格采集
  - 价格对比分析
  - 价格趋势分析
2. 套利机会识别：
  - 价格差计算
  - ROI计算
  - 利润计算
  - 风险评估
3. 套利决策：
  - 利润阈值判断
  - ROI阈值判断
  - 风险评估
4. 自动执行：
  - 采购下单
  - 平台上架
  - 库存同步
5. 套利监控：
  - 订单状态监控
  - 利润追踪
  - 风险监控
6. 套利结算：
  - 利润核算
  - 费用扣除
  - 收益分配
决策点：
- 套利阈值设定
- 风险控制策略
- 执行策略（自动/手动）
- 结算策略
输入：多平台价格数据、套利配置、风险参数
输出：套利机会、套利订单、利润报告
状态机：PRICE_MONITORING → ARBITRAGE_OPPORTUNITY → ARBITRAGE_DECISION → AUTO_EXECUTION → ARBITRAGE_MONITORING → ARBITRAGE_SETTLEMENT
关键指标：
- 套利机会数
- 套利成功率
- 平均利润
- 平均ROI
- 风险事件数
数据表：
- cf_arbitrage_products：套利商品表
- cf_arbitrage_opportunities：套利机会表
- cf_arbitrage_orders：套利订单表
- cf_arbitrage_profits：套利利润表

5️⃣6️⃣ AI动态定价系统（AI Dynamic Pricing Loop）🆕

目标：在竞争中最大化利润，实现博弈级定价
流程：
1. 市场监控：
  - 竞争对手价格监控
  - 市场需求分析
  - 库存水平监控
  - 转化率监控
2. 定价模型：
  - 需求预测
  - 竞争分析
  - 价格弹性计算
  - 最优价格计算
3. 定价决策：
  - 提价策略
  - 降价策略
  - 保持策略
  - A/B测试定价
4. 价格执行：
  - 价格更新
  - 平台同步
  - 库存调整
5. 效果追踪：
  - 销售数据追踪
  - 利润追踪
  - 转化率追踪
  - ROI计算
6. 模型优化：
  - 效果分析
  - 模型调整
  - 策略优化
决策点：
- 定价策略选择
- 提价/降价阈值
- A/B测试策略
- 模型更新频率
输入：市场数据、竞争对手价格、销售数据
输出：最优价格、定价决策、效果报告
状态机：MARKET_MONITORING → PRICING_MODEL → PRICING_DECISION → PRICE_EXECUTION → EFFECT_TRACKING → MODEL_OPTIMIZATION
关键指标：
- 价格调整次数
- 平均利润率
- 转化率
- ROI
- 定价准确率
数据表：
- cf_pricing_decisions：定价决策表
- cf_pricing_history：定价历史表
- cf_competitor_prices：竞争对手价格表
- cf_pricing_metrics：定价指标表

5️⃣7️⃣ 多店铺管理闭环（Multi-Shop Management Loop）🆕

目标：实现多店铺、多商户、多部门的统一管理与数据隔离，支持独立站/外部独立站/报表等一对多交互

层级架构：

商户(Merchant) → 部门(Department) → 店铺(Shop)
     ↓                ↓                ↓
  商户级数据        部门级数据        店铺级数据

流程：
1. 店铺注册与配置：
  - 店铺类型划分（独立站/平台店/外部独立站）
  - 平台账号绑定
  - 店铺基础信息配置
  - 店铺状态管理
2. 权限配置：
  - 层级权限继承
  - 数据访问范围控制
  - 操作权限分配
  - 角色管理
3. 数据隔离：
  - 店铺级数据隔离
  - 部门级数据聚合
  - 商户级数据汇总
  - 跨店铺数据访问控制
4. 业务操作：
  - 商品管理（单店/批量）
  - 订单管理（单店/聚合）
  - 库存管理（单店/同步）
  - 价格管理（单店/批量）
5. 报表聚合：
  - 单店报表
  - 部门聚合报表
  - 商户汇总报表
  - 跨店对比分析
决策点：
- 店铺类型划分标准
- 数据权限边界定义
- 报表聚合规则
- 跨店操作权限
输入：店铺信息、商户信息、部门信息、用户角色
输出：
- 店铺管理界面
- 跨店铺数据报表
- 权限控制策略
- 数据隔离配置
状态机：SHOP_REGISTERED → SHOP_CONFIGURED → SHOP_ACTIVE → SHOP_SUSPENDED → SHOP_CLOSED
关键指标：
- 店铺数量
- 活跃店铺数
- 跨店订单量
- 数据隔离有效性
- 报表生成效率
数据表：
- cf_shop：店铺主表（含层级关系）
- cf_department：部门表
- cf_merchant：商户表
- cf_shop_config：店铺配置表
- cf_shop_permission：店铺权限表

📋 技术实现指引：

层级	实现模块	关键文件	任务ID
后端	数据隔离服务	`DataIsolationService.ts`	BE-MT001
后端	层级权限中间件	`HierarchyAuthMiddleware.ts`	BE-MT002
后端	订单聚合服务	`OrderAggregationService.ts`	BE-ORDER-MS001
后端	报表聚合服务	`ShopReportAggregationService.ts`	BE-SHOP-REP001
前端	层级选择器组件	`HierarchySelector.tsx`	FE-MT001
前端	多店铺管理页面	`MerchantManage.tsx, ShopManage.tsx`	FE-MT002
前端	订单多店铺页面	`OrderMultiShopList.tsx, OrderAggregate.tsx`	FE-ORDER-MS001, FE-ORDER-MS002
前端	多店铺报表页面	`MultiShopReport.tsx`	FE-SHOP-REP001

5️⃣8️⃣ 多租户层级管理闭环（Multi-Tenant Hierarchy Loop）🆕

目标：实现商户→部门→店铺三层架构的完整管理，确保数据隔离和权限控制

层级模型：

┌─────────────────────────────────────────────────────────┐
│                      商户(Merchant)                      │
│  - 商户ID (merchantId)                                  │
│  - 商户名称、联系方式、认证状态                           │
│  - 商户级配置、计费信息                                  │
└────────────────────┬────────────────────────────────────┘
                     │ 1:N
         ┌───────────┴───────────┐
         ▼                       ▼
┌─────────────────┐     ┌─────────────────┐
│   部门(Department)   │     │   部门(Department)   │
│  - 部门ID (deptId)    │     │  - 部门ID (deptId)    │
│  - 部门名称、负责人    │     │  - 部门名称、负责人    │
└────────┬────────┘     └────────┬────────┘
         │ 1:N                   │ 1:N
         ▼                       ▼
┌─────────────────┐     ┌─────────────────┐
│    店铺(Shop)        │     │    店铺(Shop)        │
│  - 店铺ID (shopId)   │     │  - 店铺ID (shopId)   │
│  - 平台、店铺类型     │     │  - 平台、店铺类型     │
└─────────────────┘     └─────────────────┘

流程：
1. 商户入驻：
  - 商户注册与认证
  - 商户信息完善
  - 商户计费配置
  - 商户权限初始化
2. 部门创建：
  - 部门信息录入
  - 部门负责人分配
  - 部门权限配置
  - 部门成员管理
3. 店铺绑定：
  - 店铺创建/导入
  - 店铺归属部门
  - 店铺类型配置
  - 店铺权限设置
4. 层级数据隔离：
  - 商户级：所有下属数据可见
  - 部门级：本部门及下属店铺数据可见
  - 店铺级：仅本店铺数据可见
5. 跨层级操作：
  - 上级可查看下级数据
  - 下级不可查看上级数据
  - 同级数据相互隔离
决策点：
- 层级深度限制
- 数据继承规则
- 权限传递规则
- 跨层级操作审批
输入：商户信息、部门信息、店铺信息、用户角色
输出：
- 层级结构管理界面
- 数据隔离配置
- 权限分配结果
- 层级报表
状态机：
- 商户：MERCHANT_PENDING → MERCHANT_VERIFIED → MERCHANT_ACTIVE → MERCHANT_SUSPENDED
- 部门：DEPT_CREATED → DEPT_ACTIVE → DEPT_SUSPENDED
- 店铺：SHOP_REGISTERED → SHOP_ACTIVE → SHOP_SUSPENDED
关键指标：
- 商户数量
- 部门数量
- 店铺数量
- 层级数据隔离有效性
- 权限配置准确性
数据表：
- cf_merchant：商户主表
- cf_department：部门表（含商户ID、父部门ID）
- cf_shop：店铺表（含商户ID、部门ID）
- cf_user_hierarchy：用户层级关系表

📋 技术实现指引：

层级	实现模块	关键文件	任务ID
后端	层级服务	`HierarchyService.ts`	BE-MT001
后端	层级权限中间件	`HierarchyAuthMiddleware.ts`	BE-MT002
前端	层级选择器	`HierarchySelector.tsx`	FE-MT001
前端	层级管理页面	`HierarchyManage.tsx`	FE-MT002

📋 业务审核状态机

通用审核流程：SUBMITTED (提交) → PENDING_REVIEW (人工审核) → EXECUTED / REJECTED
适用场景：
- TOC：大额订单、价格变动、退款
- TOB：大额企业订单、阶梯价审批、信用审批

💡 说明

业务闭环文档是最高层文档，不涉及具体前端或模块实现细节。
下层模块功能、接口、算法、UI 都是这个闭环的落地实现。
形成从采集 → 决策 → 执行 → 反馈 → 风控的完整业务链。
每个闭环都有明确的输入、输出、流程和决策点，确保业务流程的完整性和可控性。
各闭环之间通过数据流转和依赖关系形成完整的业务生态系统。
所有业务操作均需遵循项目特定规则，确保系统安全和数据一致性。
“闭环写入规则：只要逻辑上能闭环就写，落地方式后置”
系统层级结构：
- L1（业务闭环）：交易系统核心流程
- L2（系统决策层）：定价、风控、健康度等系统级能力
- L3（数据中台层）：商品主数据、成本基准等数据管理能力
- L4（自动化与增长）：任务调度、A/B测试、用户资产等高级能力
横切能力：账号健康度、任务调度、权限审计等能力贯穿所有业务闭环，确保系统稳定性和安全性。

🗄️ 数据库规范与约束

表命名规范

规则	要求	示例
表前缀	所有表必须以 `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` 等破坏性操作

层级	实现模块	关键文件	任务ID
后端	权限服务	`RBACService.ts`	BE-R001
前端	权限管理页面	`PermissionManagement.vue`	FE-R001

125 KiB Raw Blame History Unescape Escape

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

📑 目录

附录A：前端交互设计规范

A.1 全局状态机定义

商品状态机（Product State Machine）

任务状态机（Task State Machine）

订单状态机（Order State Machine）

A.2 页面路由结构

全局路由定义

路由权限控制

A.3 按钮操作规范

商品列表页操作按钮

订单列表页操作按钮

任务列表页操作按钮

A.4 用户操作流程

商品上架完整流程

订单处理完整流程

售后处理完整流程

附录B：前端页面映射

B.1 商品中心页面映射

商品列表页 (/products/list)

商品详情页 (/products/detail/:id)

商品编辑弹窗 (ProductEditModal)

定价抽屉 (PricingDrawer)

B.2 订单中心页面映射

订单列表页 (/orders/list)

订单详情页 (/orders/detail/:id)

B.3 执行中心页面映射

任务列表页 (/tasks/list)

任务详情页 (/tasks/detail/:id)

B.4 数据中心页面映射

数据概览页 (/analytics/overview)

B.5 合规中心页面映射

证书管理页 (/compliance/certificates)

B.6 系统设置页面映射

平台账号设置页 (/settings/platform)

附录C：前端组件规范

C.1 组件分类与命名

组件分类

命名规范

C.2 状态管理规范

全局状态

页面级状态

C.3 API交互规范

请求封装

错误处理

C.4 路由与权限规范

路由配置

权限控制

1️⃣ 数据采集与清洗闭环（Product Data Collection & Cleansing）

2️⃣ 商品刊登闭环（Product Listing Loop）

3️⃣ 素材管理闭环（Media & Asset Management Loop）

4️⃣ 广告计划与营销闭环（Marketing & Ad Management Loop）

5️⃣ 订单履约闭环（Order Fulfillment Loop / OMS）

6️⃣ 售后逆向闭环（Returns & Refunds Loop）

7️⃣ 资金对账闭环（Finance Reconciliation Loop）

8️⃣ 库存与仓储管理闭环（Inventory & Warehouse Management Loop / WMS）

9️⃣ 供应链与供应商管理闭环（Supply Chain & Supplier Management Loop）

🔟 B2B / TOB 贸易管理闭环（B2B / TOB Trade Management Loop）

1️⃣1️⃣ 治理与审批中心闭环（Governance & Approval Center Loop）

1️⃣2️⃣ 合规与证书管理闭环（Compliance & Certificate Management Loop）

1️⃣3️⃣ 合规与风控闭环（Compliance & Risk Control Loop）

1️⃣4️⃣ 报表与分析闭环（Reporting & Analytics Loop）

1️⃣5️⃣ 定价与利润决策闭环（Pricing & Profit Decision Loop）

1️⃣6️⃣ 账号/店铺健康度闭环（Account/Shop Health Loop）

1️⃣7️⃣ 店铺隔离与自动化闭环（Shop Isolation & Automation Loop）

1️⃣8️⃣ 订单集中管理闭环（Order Centralized Management Loop）

1️⃣9️⃣ 客户/商家押金与账户管理闭环（Customer/Merchant Deposit & Account Management Loop）

2️⃣0️⃣ 商家选择发货闭环（Merchant Selective Fulfillment Loop）

2️⃣1️⃣ 回款与财务闭环（Payment & Financial Reconciliation Loop）

2️⃣2️⃣ 海外仓/本土仓 & 多品类支持闭环（Overseas/Local Warehouse & Multi-Category Support Loop）

2️⃣3️⃣ 商品主数据闭环（Product Master Data Loop / MDM）

1️⃣9️⃣ SKU变体与结构闭环（SKU Variant & Structure Loop）

2️⃣0️⃣ 订单拆分与合并闭环（Order Split & Merge Loop）

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）

125 KiB

Raw Blame History